Codex 问题排查
Codex 的排查重点是 OpenAI 兼容接口。一般按 Base URL、Key、模型名、当前 Provider 是否生效这个顺序排查。
先确认什么
| 检查项 | 怎么看 | 为什么 |
|---|---|---|
| 服务商支持 OpenAI 兼容接口 | 后台能看到 API 地址、Base URL、OpenAI 兼容等说明 | Codex 需要能请求到兼容接口 |
| Base URL | 复制服务商给出的 API 链接 | 是否需要 /v1 以后台示例为准，不要自己猜 |
| Key 状态 | Key 未禁用、未过期、账户余额正常 | 401 多数先从 Key 查起 |
| 模型名 | 按后台模型列表照抄 | 模型名大小写、短横线、版本号写错都会失败 |
常见报错
| 现象 | 优先检查 | 处理方法 |
|---|---|---|
| 401 / Unauthorized | API Key | 重新生成或复制 Key，确认 Key 未禁用、未过期、账户余额正常。 |
| 404 / model not found | 模型名 | 不要凭印象写模型名；按服务商后台模型列表照抄。如果支持获取模型列表，先获取列表；失败时再手动添加。 |
| Base URL 相关报错 | API 链接是否完整 | Base URL 就是服务商给的 API 链接。是否需要 /v1 以后台示例为准，不要自己猜。 |
| 请求走不通但 Key 正常 | 协议是否匹配 | 确认当前服务商提供的是 OpenAI 兼容接口，而不是 Claude、Gemini 或只支持网页聊天的接口。 |
| 用 CC-Switch 后不生效 | 目标工具选择 | 确认 Provider 应用到 Codex，而不是 Claude Code；重开终端或客户端后再测试。 |
最小测试
先用最短问题确认请求能走通，再处理真实项目。
Codex 最小测试
codex "请只回复：Codex 配置测试成功"反馈模板
给服务商反馈时这样写
工具名称：Codex 系统版本： 服务商后台 Base URL： 模型 ID / 模型名： 报错原文： 我已经检查过：Key 没有空格 / 余额正常 / 模型名照抄 / Base URL 按后台填写 / 已经重开终端