OpenAI Codex CLI 部署

本文介绍如何安装 OpenAI Codex CLI 并接入 KvioAI 中转站。

前置条件： 系统已安装 Node.js 18+ 和 npm。如未安装，请参考 Node.js 安装指南。

第一步：安装 Codex CLI

npm install -g @openai/codex

安装完成后运行 codex --version 确认安装成功。

第二步：配置 API Key 和 Base URL

从 KvioAI 控制台获取的 Key 是 JSON 数组格式：

[{"_type":"newapi_channel_conn","key":"sk-xxxxx...xxxxx","url":"https://kvioai.cloud"}]

你需要从中提取：

• key 字段的值 → 用于 OPENAI_API_KEY
• url 字段加上 /v1 → 用于 OPENAI_BASE_URL（即 https://kvioai.cloud/v1）

方式一：环境变量（推荐）

nano ~/.bashrc   # 或 ~/.zshrc

添加以下内容：

export OPENAI_API_KEY="你的key值"
export OPENAI_BASE_URL="https://kvioai.cloud/v1"

保存后执行 source ~/.bashrc（或 source ~/.zshrc）使其生效。

方式二：项目级 .env 文件

在项目根目录创建 .env 文件：

cd ~/your-project
cat > .env << EOF
OPENAI_API_KEY=你的key值
OPENAI_BASE_URL=https://kvioai.cloud/v1
EOF

Codex CLI 在该目录下启动时会自动读取 .env 文件。

第三步：运行 Codex CLI

codex

Codex CLI 会自动读取环境变量，通过 KvioAI 中转站连接 AI 模型。

指定默认模型

通过环境变量指定默认模型：

export OPENAI_MODEL=gpt-4o

可选模型包括：gpt-4o、gpt-4o-mini、o3、o4-mini 等。

验证连接

curl -s -X POST "https://kvioai.cloud/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d '{"model":"gpt-4o-mini","max_tokens":50,"messages":[{"role":"user","content":"Hi"}]}'

返回有效 JSON 响应即表示连接正常。

常见问题

提示认证失败 / 401 错误？

• 确认 Key 值正确，只复制 key 字段的值，不要带入 JSON 的引号或多余字符
• 确认环境变量已生效（运行 echo $OPENAI_API_KEY 检查）

连接超时？

• 确认 OPENAI_BASE_URL 包含了 /v1 后缀
• 检查网络是否正常

📱 获取帮助 使用过程中如有问题，请添加微信 xgckck 获取技术支持。