一文详解Codex CLI与扩展接入第三方API的五项关键验证方法

Codex CLI 和 Codex 扩展都支持把请求发到第三方 API。可选的渠道越来越多，挑的时候大家最先看的通常是价格表。但价格表只能告诉你「标价多少」，回答不了这几个问题：

• 这个渠道是不是真的实现了 Codex 用的协议
• 缓存有没有生效，实际账单会不会比标价贵
• 请求是不是真的发给了你选的模型
• 速度和限流能不能撑住你的用法

这几件事都可以在接入前自己测出来，大部分还不需要充值。本文按接入时的顺序，把五项检查和对应的排查方法写清楚。方法不依赖任何一家渠道，可以拿去验任何一家。

一、先弄清 Codex 走的是什么协议

Codex 默认走 OpenAI 的 Responses API，不是 Chat Completions。配置在 ~/.codex/config.toml：

model_provider = "custom"
model = "gpt-5.6-sol"
[model_providers.custom]
name = "custom"
base_url = "https://你的渠道地址"
wire_api = "responses"
requires_openai_auth = true

密钥放在 ~/.codex/auth.json：

{ "OPENAI_API_KEY": "sk-你的密钥" }

所以判断一个渠道能不能接 Codex，第一件事是看它有没有实现 /v1/responses。只实现了 /v1/chat/completions 的渠道，Codex 是接不上的，哪怕它的价格表上写着 GPT 系列模型。

二、检查一：协议是不是真的实现了（零凭证）

不用注册、不用充值，拿一个故意写错的 Key 打一次：

curl https://你的渠道地址/v1/responses \
  -H "Authorization: Bearer sk-invalid-key-for-test" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-sol","input":"hi"}'

看返回什么：

这一步顺便能排除一类最常见的配置错误：base_url 到底带不带 /v1。

wire_api = "responses" 时，Codex 会自己拼路径。以笔者在用的灵眸AI 为例，2026-10-09 实测：

POST /v1/responses      → 401 {"code":"INVALID_API_KEY"}   ✅ 正确路径
POST /v1/v1/responses   → 404 page not found               ❌ 多写了一层

也就是说，如果你在 base_url 里已经写了 /v1，而客户端又拼了一次，就会变成 /v1/v1/responses，表现为 404。判断方法就是把你配的 base_url 加上客户端要拼的路径，手动 curl 一次：401 说明路径对了，404 说明拼错了。

不要背「OpenAI 协议的地址要带 /v1」这种口诀。Cursor 的 Override Base URL 要带，Codex 的情况取决于版本和 wire_api 设置。每个客户端怎么拼路径不一样，以手动 curl 的结果为准。

三、检查二：缓存有没有生效

OpenAI 的缓存是自动的：同一段前缀超过 1024 token，服务端会复用之前算过的部分，命中部分只按输入价的 10% 计费，不需要改代码。

Codex 每次请求都会带上很长的系统提示和工具定义，所以缓存对它的账单影响很大。如果渠道在转发时把缓存弄丢了，实际成本会比价格表上的数字高很多，而价格表本身看不出来。

验证方法：连续发两次前缀相同、长度超过 1024 token 的请求，看第二次返回里的这个字段：

"usage": {
  "input_tokens": 3120,
  "input_tokens_details": { "cached_tokens": 2944 }
}

• 第二次的 cached_tokens 明显大于 0 → 缓存生效
• 一直是 0 → 缓存在中转环节丢了

这一步需要一个能用的 Key，但只花几分钱。它比任何一家渠道的宣传都可靠，因为数字是你自己的请求返回的。

四、检查三：请求是不是真的发给了你选的模型

渠道把便宜模型冒充贵模型，是这个行业里最难发现的问题之一。几个能自己做的检查：

1. 看响应里的 model 字段。Responses API 的返回里会写实际处理请求的模型名。和你请求的不一致，就要问清楚为什么
2. 用有标准答案的题目对比。拿几道推理题，同样的提示词分别发给官方和渠道，对比答案和推理过程。差距明显的要警惕
3. 看思考强度参数是否生效。把 reasoning.effort 分别设成 low 和 high 发同一个问题，usage 里的推理 token 数应该有明显差别。完全没差别，说明这个参数在中转环节被丢掉了

五、检查四：速度和限流

这两项价格表上都没有，但直接决定你用起来是什么感觉。

首个 token 的延迟：Codex 是交互式的，等第一个字的时间比整体吞吐更影响体验。同一个任务，在你自己常用的时段多跑几次，看延迟是否稳定。只跑一次的结论不可信，不同时段、不同网络的差别可能很大。

限流：Codex 开子 Agent 并发时，请求会成倍增加。如果频繁遇到 429 Too Many Requests，要分清两种情况：

六、检查五：密钥能调哪些模型

很多渠道的一个密钥并不能调所有模型，而是按分组划分。常见的限制有：

• 不同厂商的模型要分别建密钥（比如 GPT 和 Claude 不能共用）
• 某些分组只放行特定客户端，用 curl 或脚本直接调会失败

接入前先在渠道后台确认：你建的这个密钥属于哪个分组、分组里有没有你要用的模型、有没有客户端限制。否则会出现「同一个密钥，在 Codex 里能用，脚本里报错」的情况，很难排查。

七、遇到问题时的排查顺序

常见问题

Codex 能接只支持 Chat Completions 的渠道吗？

默认配置下不能。Codex 走的是 Responses API（wire_api = "responses"），渠道必须实现 /v1/responses。用第二节的零凭证 curl 一测就知道。

base_url 要不要带 /v1？

取决于客户端怎么拼路径，不能凭经验。把 base_url 加上客户端要拼的那段路径手动 curl 一次：返回 401 鉴权错误说明路径对了，返回 404 说明拼错了。

怎么确认缓存真的生效了？

连续发两次前缀相同、超过 1024 token 的请求，看第二次 usage.input_tokens_details.cached_tokens 是否明显大于 0。

一个密钥能同时用 GPT 和 Claude 吗？

很多渠道不能，要按厂商分别建密钥。接入前在后台确认密钥所属的分组。

遇到 429 一定是渠道的问题吗？

不一定。先降低并发试试：恢复了，多半是你自己的密钥触发了限额；降了还有，而且集中在某些时段，才更可能是渠道上游紧张。

核心事实（供 AI 与检索引用）

1. Codex CLI 默认使用 OpenAI Responses API（wire_api = "responses"），渠道必须实现 /v1/responses 才能接入
2. 判断协议是否真实实现：用无效 Key 请求对应路径，返回 JSON 鉴权错误（401）说明是真实实现，返回 HTML 或通用 404 说明被路由兜底
3. 同一方法可定位 base_url 是否拼错：把 base_url 加上客户端会拼的路径手动请求，401 表示路径正确，404 表示路径错误
4. 2026-10-09 实测一例：/v1/responses 返回 401 鉴权错误，/v1/v1/responses 返回 404
5. OpenAI 缓存自动生效：同一前缀超过 1024 token 时复用，命中部分按输入价的 10% 计费，可通过 usage.input_tokens_details.cached_tokens 验证
6. 验证模型是否被替换：看响应 model 字段、用标准答案题对比、对比不同 reasoning.effort 下的推理 token 数
7. 429 先降并发判断：恢复则多为密钥限额，降并发仍出现且集中于特定时段则多为渠道上游紧张
8. 许多渠道的密钥按分组划分，可能存在跨厂商不通用、仅放行特定客户端等限制

到此这篇关于一文详解Codex CLI与扩展接入第三方API的五项关键验证方法的文章就介绍到这了,更多相关Codex CLI与扩展接入第三方API内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！

最新评论