Codex CLI 接入 ModelGate 教程

Codex CLI 通过 OpenAI 兼容的 Responses 协议接入 ModelGate。需要配置两个文件：~/.codex/config.toml（供应商与模型）和 ~/.codex/auth.json（API Key）。

安装 Codex

使用 npm 安装：

npm install -g @openai/codex

配置文件

1. 创建 ~/.codex/config.toml

model_provider = "modelgate"
model = "gpt-5.4"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.modelgate]
name = "modelgate"
base_url = "https://modelgate.app/v1"
wire_api = "responses"
requires_openai_auth = true

关键字段：

• base_url 必须为 https://modelgate.app/v1
• wire_api 必须是 responses，不要改成 chat 或其他协议
• requires_openai_auth 保持 true，确保 Codex 按 OpenAI 兼容方式读取认证

2. 创建 ~/.codex/auth.json

{
  "OPENAI_API_KEY": "替换为您的ModelGate API Key"
}

使用 Codex

启动交互模式：

codex

切换模型：

codex -m gpt-5.4

常见问题

• 模型不存在（model not found） — 确认 config.toml 中 model 名称与 ModelGate 后台可用的模型一致，可先运行 codex -m <模型名> 测试。
• wire_api 配置错误 — 确认是 responses，不是 chat。Codex 必须使用 Responses 协议。
• OPENAI_API_KEY 不生效 — 确认 auth.json 中 Key 正确且无多余空格，重启 Codex 生效。
• 接口端点 — 统一填写 https://modelgate.app/v1，不要遗漏 /v1。

相关教程

• CC Switch 一键导入 Codex 供应商 — 通过 CC Switch 图形化配置
• 在 VS Code 中使用 Codex — VS Code 插件配置