跳转到主要内容
🎉 限时免费 — MiniMax: MiniMax M3 Free 现在体验 🔥

Codex

Codex 是 OpenAI 的命令行 AI 编程助手。通过自定义 model_provider，可以将 Codex CLI 的 Responses API 请求发送到 ModelGo。

接入前准备

  • 已安装 Node.js 18 或更高版本。
  • 已在 ModelGo 控制台创建 API Key。
  • 已在模型广场确认一个当前 API Key 可调用的逻辑模型名。

1. 安装 Codex

在 macOS、Linux 或 Windows 终端中执行：

bash
npm install -g @openai/codex

安装完成后检查版本：

bash
codex --version

首次启动时，如果 Codex 提示有新版本可用，可以选择 Skip，先完成 ModelGo 配置。

跳过 Codex 升级提示

2. 配置 ModelGo

Codex 从用户目录下的 ~/.codex/config.toml 读取模型和 Provider 配置。先创建目录和配置文件：

macOS / Linux

bash
mkdir -p ~/.codex
touch ~/.codex/config.toml
${EDITOR:-vi} ~/.codex/config.toml

Windows PowerShell

powershell
New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex"
notepad "$env:USERPROFILE\.codex\config.toml"

将下面内容粘贴到 config.toml，并将 YOUR_MODELGO_MODEL 替换为模型广场中当前 API Key 可调用的逻辑模型名：

toml
model_provider = "modelgo"
model = "YOUR_MODELGO_MODEL"

[model_providers.modelgo]
name = "ModelGo"
base_url = "https://api.modelgo.com/v1"
env_key = "MODELGO_API_KEY"
wire_api = "responses"

其中，base_url 使用 ModelGo 的 OpenAI 兼容根地址，Codex 会自动请求 /v1/responses。

3. 设置 API Key

将 ModelGo API Key 保存到系统环境变量 MODELGO_API_KEY。不要把真实 API Key 直接写入 config.toml。

macOS / Linux（zsh）

bash
echo 'export MODELGO_API_KEY="YOUR_MODELGO_API_KEY"' >> ~/.zshrc
source ~/.zshrc

如果使用 Bash，将 ~/.zshrc 替换为 ~/.bashrc 或 ~/.bash_profile。

Windows PowerShell

powershell
[Environment]::SetEnvironmentVariable("MODELGO_API_KEY", "YOUR_MODELGO_API_KEY", "User")
$env:MODELGO_API_KEY = [Environment]::GetEnvironmentVariable("MODELGO_API_KEY", "User")

检查变量是否已生效（只输出是否存在，不要打印 Key 内容）：

bash
test -n "$MODELGO_API_KEY" && echo "MODELGO_API_KEY is set"

4. 启动并验证

进入一个本地项目目录，执行：

bash
cd /path/to/your/project
codex

首次进入项目时，按提示选择信任当前目录。看到 Codex 欢迎界面后，输入一条简单的编码需求，例如“用三句话介绍这个项目”。

Codex 首次进入项目的欢迎界面

能够正常返回模型结果，即表示 ModelGo 接入成功。

Codex 开始对话

如需先确认 API Key 可调用的模型，可以执行：

bash
curl https://api.modelgo.com/v1/models \
  -H "Authorization: Bearer $MODELGO_API_KEY"

常见问题

启动后提示找不到 Provider

确认配置文件路径是用户目录下的 ~/.codex/config.toml，并检查 model_provider = "modelgo" 与 [model_providers.modelgo] 的名称一致。

返回 401 或认证失败

检查当前终端是否已设置 MODELGO_API_KEY，并确认 API Key 没有多余空格或换行。

返回 403 或模型不可用

确认 model 使用模型广场中、且当前 API Key 策略允许调用的逻辑模型名。

返回 404 或接口路径错误

base_url 应填写 https://api.modelgo.com/v1。不要填写完整的 /responses 或 /v1/responses，Codex 会自动拼接路径。

出现 Chat wire API 弃用提示

在 [model_providers.modelgo] 中加入 wire_api = "responses"，并升级到最新 Codex CLI：

bash
npm install -g @openai/codex@latest

返回 400 invalid_encrypted_content

这通常说明当前会话携带了原上游账号生成的加密上下文，但本轮请求被另一个上游账号处理。

先检查是否更换过 API Key、Base URL，或者代理、号池是否切换了上游账号。发生过切换时，请新建会话，不要继续或恢复原会话。

相关文档