Codex CLI

OpenAI 官方 Codex 命令行工具。配 Codex 官方 渠道使用，走 Responses API 协议。

推荐渠道

Codex 官方——为 Codex CLI 和 OpenAI Responses API 优化。

安装

需要 Node.js 18+。

npm install -g @openai/codex

或下载 GitHub release 二进制。

配置

Codex CLI 用 ~/.codex/config.toml 配置 provider：

~/.codex/config.toml

model_provider = "OpenAI"
model = "gpt-5.4"

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://claude-api.org"
wire_api = "responses"
requires_openai_auth = true

环境变量

export OPENAI_API_KEY="sk-你的key"

Base URL 不带 /v1

Codex 用 OpenAI 的 Responses API（不是 ChatCompletions），路径是 /v1/responses，所以 base_url 写到 https://claude-api.org 即可，不要加 /v1。

验证

codex

进入交互模式后输入 Write a Python function to reverse a string，能给出代码即接入成功。

或 curl：

curl -sS https://claude-api.org/v1/responses \
  -H "Authorization: Bearer sk-你的key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "input": "ping",
    "max_output_tokens": 32
  }'

模型选择

模型	适合
gpt-5.4	主力，平衡能力与价格（默认）
gpt-5.3-codex	编码专项，写代码强
gpt-5.3-codex-spark	Codex 加速版，更快但稍弱
gpt-5.2-pro	长链路推理
gpt-5.5	最新版

启动时：

codex --model gpt-5.3-codex

或在 config.toml 里改 model =。

常见问题

401 Invalid API key

• Key 错了 / 没绑 OpenAI 类渠道。后台创建 Key 时渠道选 Codex 官方 或 OpenAI 兼容。
• 注意 Codex CLI 用的是 Authorization: Bearer ... 头，不是 x-api-key。

404 Not Found

• wire_api 写成了 chat（默认）→ Codex CLI 默认用 ChatCompletions，但我们 Codex 渠道是 Responses API，必须改成 responses。
• 或者 base_url 多了 /v1 → 去掉。

tool calls 失败 / 工具循环

Responses API 协议对部分 tool 调用形式有限制。如果你的 Codex 一直在工具死循环，切到 OpenAI 兼容 渠道用 ChatCompletions 协议重试。

更多见 FAQ。