用 Responses API 把 Codex 接入国产模型

先说结论

当前 Codex 的 wire_api 只支持 "responses"。 "chat" 已被移除，填写它会导致启动配置报错。KimiSeek 提供 /v1/responses，可以使用下文的配置直接接入。

30 秒决策表

为什么 Codex 默认走 responses

Codex 向 /responses 发送请求，并处理 Responses 的工具调用和流式事件。Chat Completions 的请求与事件结构不同；只改 wire_api 不能让当前 Codex 调用 Chat Completions。模型能力还取决于上游模型与网关实现，接口返回成功并不等于每项工具能力都已验证。

前置条件

• Node.js 20 或以上
• Codex CLI：npm install -g @openai/codex
• 一个 KimiSeek API Key（ks- 开头），在控制台创建

Step 1 · 写配置文件

配置文件在 ~/.codex/config.toml，没有就新建：

model = "deepseek-v4-pro-0813"
model_provider = "kimiseek"

[model_providers.kimiseek]
name = "KimiSeek"
base_url = "https://api.kimiseek.app/v1"
env_key = "KIMISEEK_API_KEY"
wire_api = "responses"

三个容易踩的点：

1. base_url 必须带 /v1。Codex 会在 base_url 后面直接拼 /responses，少写 /v1 就会打到 https://api.kimiseek.app/responses，得到 404。
2. env_key 是环境变量名，不是 key 本身。这里写的是变量名 KIMISEEK_API_KEY，真正的值放环境变量里。
3. model 必须用 catalog 里真实存在的 id。写错会拿到 model not found，已下线的模型同样会报这个错。

Step 2 · 设置环境变量并启动

export KIMISEEK_API_KEY="ks-your-key"

codex

想临时换模型，直接改 config.toml 里的 model，或者用 codex --model <id> 覆盖。

Step 3 · 确认 key 有效

curl https://api.kimiseek.app/v1/models \
  -H "Authorization: Bearer ${KIMISEEK_API_KEY:?Set KIMISEEK_API_KEY before running this command}"

返回里能看到模型列表，说明 key 与网络都没问题。这一步的意义是把「鉴权问题」和「协议问题」分开——否则 404 时你分不清是 key 错了还是路径错了。

Step 4 · 30 秒探测 responses

curl https://api.kimiseek.app/v1/responses \
  -H "Authorization: Bearer ${KIMISEEK_API_KEY:?Set KIMISEEK_API_KEY before running this command}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-pro-0813",
    "input": "Explain what a base URL is in one sentence.",
    "max_output_tokens": 256,
    "stream": false
  }'

• 返回 200，JSON 中包含 output 数组 → Responses 路由可用，接着验证实际任务和工具调用。
• 返回 404 → 检查 base_url 是否包含 /v1，再检查返回体是路由不存在还是模型不存在；不能仅凭状态码判定协议支持。
• 返回 401 → 回到 Step 3，检查凭证。

如果网关只有 Chat Completions

保持 wire_api = "responses"。需要换到提供 /v1/responses 的网关，或在中间配置兼容 Responses 的转换层。不要改成已移除的 "chat"。

常见报错

更多协议层报错见 报错对照表。

成本

Codex 的用量特点是输入远大于输出：每次执行都要把上下文重新发一遍。DeepSeek V4 Pro 定价按峰谷两档、人民币每百万 tokens 计：

峰谷差正好一倍。跑批量的重构任务，排在谷时能省一半。具体模型与实时价格以 价格页 为准，那里直接读的是模型目录的配置。

适用版本与核查

配置已在 Codex CLI 0.154.0 验证；核查日期：2026-10-26。协议支持以官方配置说明为准。