接入 OpenAI Codex

将 OpenAI Codex CLI 连接到 TokenCode，用统一的 OpenAI 兼容端点调用编程模型和通用大模型。

适用场景

Codex 是 OpenAI 推出的终端 AI 编程助手，适合在本地代码仓库中阅读、修改和验证代码。Codex 新版本优先使用 OpenAI Responses API；如果你使用旧版本或只支持 Chat Completions 的模型，可以切换到 Chat Completions 模式。

安装 Codex

先安装 Node.js 18 或更高版本，然后执行：

bash
npm install -g @openai/codex
codex --version

推荐方式：使用 TokenCode CLI 配置

安装 Codex 后，推荐先运行 TokenCode CLI 的交互式菜单向导：

bash
npm install -g @tokencode/tokencode
tokencode

在菜单中选择 Codex，按提示输入 TokenCode API Key 和默认模型即可。CLI 会自动写入 Codex 配置。

如果你已经熟悉参数，也可以一键写入：

bash
npx @tokencode/tokencode cx -k sk-your-api-key -m gpt-5.5

CLI 会写入 ~/.codex/config.toml，并把 API Key 写入 Codex 可读取的认证文件。Codex CLI 和 IDE 插件可以共用这份配置。

手动配置

如果你不想使用 TokenCode CLI，可以按下面方式手动配置。

配置 API Key

Codex 通过环境变量读取 API Key：

bash
export OPENAI_API_KEY="sk-your-api-key"

如果使用 zsh，可以写入 ~/.zshrc：

bash
echo 'export OPENAI_API_KEY="sk-your-api-key"' >> ~/.zshrc
source ~/.zshrc

Windows PowerShell 可以使用：

powershell
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-your-api-key", [EnvironmentVariableTarget]::User)

最新 Codex：Responses API

编辑 ~/.codex/config.toml：

toml
model_provider = "tokencode"
model = "gpt-5.5"

[model_providers.tokencode]
name = "TokenCode"
base_url = "https://tokencode.dev/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

如果你使用的是 Codex 专用模型，也可以把 model 改为模型列表中可用的 Codex 或推理模型 ID。

旧版 Codex：Chat Completions

部分旧版 Codex 或仅支持 Chat Completions 的模型需要使用 wire_api = "chat"。可以安装旧版 Codex：

bash
npm install -g @openai/[email protected]

然后配置：

toml
model_provider = "tokencode"
model = "gpt-5.5"

[model_providers.tokencode]
name = "TokenCode"
base_url = "https://tokencode.dev/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"

验证配置

重新打开一个终端窗口，在项目目录中执行：

bash
codex "请用一句话确认连接成功"

如需临时切换模型：

bash
codex --model gpt-5.5
codex --model claude-sonnet-4-6
codex --model gemini-2.5-pro

常见问题

wire_api = chat is no longer supported

这是 Codex 新版本的行为。请把配置改成 wire_api = "responses"，并确认 base_url 为 https://tokencode.dev/v1。

返回 401 Unauthorized

请检查：

  1. OPENAI_API_KEY 是否已经在当前终端生效。
  2. API Key 是否复制完整，没有前后空格。
  3. env_key 是否仍然写为 OPENAI_API_KEY。

返回 404 Not Found

通常是 base_url 或 wire_api 不匹配。OpenAI 兼容端点必须使用 https://tokencode.dev/v1；如果配置为 responses，Codex 会访问 /v1/responses；如果配置为 chat，会访问 /v1/chat/completions。

模型不适合 Codex

不同模型对工具调用、上下文长度、补丁生成和长任务稳定性的支持不同。编程任务建议优先选择模型列表中标注为代码、推理或 Codex 类的模型。