推荐接入
Codex 使用 Jerry API
为 Codex CLI 添加名为 jerryapi 的自定义模型提供方，通过 Responses API 使用 Jerry API 的 GPT 模型。
1. 安装 Codex CLI
Terminal
npm install -g @openai/codex
codex --version已经安装时可直接进入下一步。建议使用较新的 Codex 版本，以获得完整的自定义 Provider 配置支持。
2. 设置 API Key
Codex 可以从环境变量读取 Jerry API Key，避免将密钥直接写进 config.toml。
macOS / Linux
export JERRY_API_KEY="YOUR_JERRY_API_KEY"Windows PowerShell
$env:JERRY_API_KEY="YOUR_JERRY_API_KEY"密钥不要提交到代码仓库
如果需要长期使用，请放到你自己的 Shell 环境或安全凭据管理工具中，不要写进项目内的 .codex/config.toml。
3. 编辑 Codex 配置
打开用户级配置文件 ~/.codex/config.toml。如果目录或文件不存在，可以先创建。
~/.codex/config.toml
model_provider = "jerryapi"
model = "gpt-5.4"
model_reasoning_effort = "medium"
[model_providers.jerryapi]
name = "Jerry API"
base_url = "https://www.jerryapi.com/v1"
env_key = "JERRY_API_KEY"
wire_api = "responses"为什么必须是 Responses
当前 Codex 自定义 Provider 使用 Responses 协议，wire_api 只能填写 responses。不要改成 chat 或 chat_completions。
4. 启动并验证
Terminal
cd /path/to/your/project
codex进入 Codex 后，让它执行一个低风险任务，例如“概览这个项目并列出测试命令”。然后到 Jerry API 使用记录中检查模型和消费。
- 当前模型显示为
gpt-5.4 - 请求不再跳转到 OpenAI 登录流程
- Jerry API 后台出现对应时间的请求记录
切换模型
只修改顶部的 model，Provider 配置保持不变。
轻量任务
model = "gpt-5.4-mini"复杂任务
model = "gpt-5.5"修改模型后请退出并重新启动 Codex，确保新会话加载最新配置。
常见问题
| 现象 | 原因 | 处理 |
|---|---|---|
| 提示缺少环境变量 | JERRY_API_KEY 未在当前终端生效 | 重新执行 export，再从同一个终端启动 Codex |
401 Unauthorized | API Key 错误或已停用 | 在密钥管理中确认状态并重新复制 |
404 或 Responses 报错 | Base URL 多写路径，或当前链路未正确处理 Responses | 确认地址只到 /v1；保留报错时间联系支持 |
| 修改配置未生效 | 编辑了项目配置，或旧进程仍在运行 | Provider 应放在用户级 ~/.codex/config.toml，随后重启 Codex |