Codex 常见报错排查：401、model not found 与连接失败

401 / Unauthorized

优先检查 API Key 是否复制完整、是否已经过期、是否被撤销，以及 Codex 实际读取的是哪一份凭据。

• 重新复制 Key，排除首尾空格。
• 确认 Key 属于当前使用的服务。
• 完全重启 Codex 后再次测试。

model not found

模型名必须与后台列表完全一致。显示名称、别名和实际请求 ID 可能不同，最稳妥的方式是直接从后台复制。

• 核对大小写、短横线和版本后缀。
• 确认当前 Key 有权使用该模型。
• 确认请求确实走向预期 provider。

connection failed / timeout

先检查 Base URL 是否为后台提供的基础地址，再检查网络、代理、证书和服务状态。不要把基础地址写成某一个具体接口路径。

# 仅验证域名与基础路径是否可达
curl -I YOUR_API_BASE_URL

配置不生效或仍走旧地址

检查当前用户目录、配置文件名、provider 名称和终端环境变量。升级或修改配置后，应完全退出旧进程并重新启动。

• 确认修改的是实际被读取的 config.toml。
• 检查 model_provider 与 [model_providers.xxx] 是否一致。
• 检查是否存在覆盖配置的旧环境变量。

最短排查顺序

按 Key → Base URL → 模型名 → provider → Responses API → 网络的顺序检查，每一步只改一个变量并记录结果。