OpenAI Codex CLI 接入

OpenAI 官方命令行 AI 编程工具，支持自主执行代码任务，通过自定义 Model Provider 接入 Calgine Tokens。

Codex CLI 是 OpenAI 官方推出的命令行 AI 编程代理，支持在终端中通过自然语言完成代码生成、重构、调试、文件编辑和系统命令执行等任务，具备完整的沙箱隔离能力和细粒度的权限控制。

前置准备

1. 前往 Calgine Tokens 控制台 注册账号。
2. 进入 工作台 → API 令牌，点击「添加令牌」，创建成功后复制 API Key（以 sk- 开头）。

配置项	值
base_url	https://api.calgine.com.cn/v1
OPENAI_API_KEY	您在控制台创建的 API 令牌

安装与配置

1. 检查 Node.js 版本：需要 Node.js 22+：

   node -v

2. 安装 Codex CLI：

   npm install -g @openai/codex

3. 设置 API Key 环境变量（任选其一）：

   macOS / Linux (zsh)

   echo 'export OPENAI_API_KEY="sk-your-token"' >> ~/.zshrc
   source ~/.zshrc

   macOS / Linux (bash)

   echo 'export OPENAI_API_KEY="sk-your-token"' >> ~/.bash_profile
   source ~/.bash_profile

   Windows (PowerShell)

   [Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-your-token", "User")

4. 创建配置文件：

   mkdir -p ~/.codex

   在 ~/.codex/config.toml 中写入以下内容：

   # ~/.codex/config.toml
   model = "gpt-4o"
   model_provider = "calgine"          # 关键：指定默认 Provider
   disable_response_storage = true
   
   [model_providers.calgine]
   name = "Calgine Tokens"
   base_url = "https://api.calgine.com.cn/v1"
   env_key = "OPENAI_API_KEY"          # 环境变量名称（不是 Key 本身）
   wire_api = "responses"              # Responses API 协议（唯一支持的值）

   三个关键配置，缺一不可：

   • model_provider = "calgine" — 如果不设置，Codex 会把 gpt-4o 等已知模型名直接路由到 OpenAI 官方
   • wire_api = "responses" — Codex 唯一支持的协议，使用 Responses API
   • env_key = "OPENAI_API_KEY" — 这里填的是环境变量名称，不是 Key 值本身

验证配置

codex

首次启动时需要选择审批模式，控制 Codex 执行操作时的权限策略：

模式	配置值	说明
建议模式	untrusted	默认模式。Codex 只能读取文件，所有写入和命令执行都需要您确认
自动执行	on-request	自动执行沙箱内的安全操作，需要权限提升时才确认
全自动	never	无需任何确认，Codex 自主完成所有操作。适合信任的开发环境

启动后输入任意任务（例如「介绍一下当前目录结构」），能正常返回结果即表示接入成功。也可以执行 /status 查看当前模型、Token 消耗和配置信息。

常用命令

命令	说明
codex	启动交互式会话
codex "任务描述"	直接执行一次性任务
codex --model gpt-4o "任务"	指定模型执行任务
codex --image screenshot.png "修复这个 bug"	附加图片作为上下文
/model	会话内切换使用的模型
/approvals	调整当前会话的审批策略
/compact	压缩对话历史，释放上下文窗口

推荐模型

场景	推荐模型	说明
日常编程辅助	gpt-4o	速度与能力均衡，适合大多数任务
复杂代码重构	o4-mini	推理能力强，适合需要深度思考的任务
快速轻量任务	gpt-4o-mini	响应速度快，成本低

常见问题排查

401 Unauthorized — 仍然连接 api.openai.com

未设置 model_provider = "calgine"，Codex 将已知模型名（如 gpt-4o）路由到内置 OpenAI Provider。确认 config.toml 顶层有 model_provider = "calgine"。如果之前通过 ChatGPT 登录过 Codex，还需要清除缓存凭证：

rm -f ~/.codex/auth.json

env_key 配置无效

env_key 应填写环境变量的名称（如 "OPENAI_API_KEY"），而不是 API Key 值本身。确认已通过 export OPENAI_API_KEY="sk-..." 设置环境变量。

提示

Codex CLI 的自主模式会频繁调用模型并执行系统命令，Token 消耗远高于普通对话，请注意控制台的额度与速率限制，详见速率限制。

下一步

• Gemini CLI：Google 官方命令行 AI 工具
• Zed Editor：内置 AI 助手的高性能编辑器
• Codex CLI 官方文档：了解更多高级配置