← 文档
Codex CLI 接入指南
1. 适用版本与验证日期
最近一次用版本 0.164.0 于 2026-10-26 实测。
2. 前置条件
需要账号、API key 和正余额。没有余额时请求返回 HTTP 402（insufficient_quota）。
3. 配置
目前没有上架的模型能用于 Codex CLI，所以没有可配置的内容。
4. 选模型
目前没有上架的模型能用于 Codex CLI，所以没有可配置的内容。
查看能用于 Codex CLI 的模型5. 自检
运行 codex 并随便问一句。若 Codex 不认识模型，会打印一条无害的警告。
6. 发第一条提示
发送这句提示：“Reply with the single word ready.”然后打开请求记录页：一分钟内会看到这条请求，含模型、token 数和费用。
打开请求记录7. 已知限制
Codex 只发 Responses 请求，所以只有带 Responses 接口的模型可用，Claude 模型在这里不可用。
8. 排错
| 症状 | 原因 | 修复 |
|---|---|---|
| 401 Unauthorized | key 填错、已吊销，或带了多余空格。 | 到 API keys 页重新复制完整的 key，并确认它是有效状态。 |
| 403 Forbidden | 这个 key 不能用该模型，或账户受限。 | 到 API keys 页检查 key 允许的模型，或换一个 key。 |
| 404 Not Found | 基础地址不对：/v1 重复或缺失。 | 原样使用示例里的地址。Claude Code 不带 /v1，其他工具带 /v1。 |
| model not found | 模型 ID 写错，或你的 key 不能用它。 | 从目录复制 ID，或用 GET /v1/models 查看 key 可用的模型。 |
| 400 Extra inputs are not permitted | 工具发了所选线路不接受的字段，多见于经转换的接口。 | 选一个提供该工具原生接口的模型（见模型页的卡片），或升级工具。 |
| 404 model `…` does not support /v1/responses | 模型存在，但不在工具使用的接口上。Codex CLI 只发 Responses 请求，所以用 Claude 模型会得到：model `claude-haiku-5-5` does not support /v1/responses; it is available on /v1/chat/completions, /v1/messages。Codex 会先重试五次（“Reconnecting… n/5”），然后才打印这条错误。 | 选一个提供 /v1/responses 的模型（第 4 步的列表），或改用能说错误信息里所列接口的工具。 |
| 返回 HTML 页面或 “Attention Required”，不是 JSON | 网关前面的网页防火墙拦截了请求体。 | 重试一次。反复出现时，带上时间和请求 ID 联系支持。 |
| 我传的某个参数好像没有生效 | 网关只转发该接口已知支持的字段，其余字段会被丢弃（不会报错）。 | 查看响应头 x-atr-ignored-fields：它列出了没有被转发的顶层字段。去掉这些字段，确实需要时联系支持。 |
9. 还原
从 ~/.codex/config.toml 删除 model_provider、model 两行和 [model_providers.tokenwave] 段，并移除 ATR_API_KEY。