先检查这几项
- 优先用 OPENAI_API_KEY 和 OPENAI_BASE_URL 接入 OpenAI 兼容接口。
- config.toml 字符串必须加引号，base_url 使用 https://api.apizt.com/v1。
- auth.json 和环境变量混用时，旧登录状态可能覆盖新 Key。
正在打开页面…
正在加载内容，请稍候。
常见错误与配置项
OPENAI_API_KEY not foundCodex OPENAI_API_KEY not foundCodex OPENAI_API_KEY not found 但已 export 怎么办？无法加载 config.toml，因此此对话串无法继续。
model provider `custom` not found
其他独立错误：TOML parse errorCodex config.toml errorCodex config.toml error 怎样定位语法错误？auth.json errorCodex auth.json errorCodex auth.json error 要直接删除登录文件吗？model provider errorCodex model provider errorCodex model provider error 如何判断协议不匹配？Codex 任务中断怎么办Codex 工具调用失败
按失败位置逐项排查
报错检查与修复步骤
Codex 任务中断怎么办：工具失败、断流与恢复检查
Codex 任务中断怎么办，先保存会话和错误，再检查 git diff 与目标文件。工具可能已经执行、文件可能已修改；确认本地失败或请求状态后，从已完成步骤继续，避免重复外部操作。
查看检查与修复步骤
Codex OPENAI_API_KEY not found：env_key 与启动环境
Codex OPENAI_API_KEY not found 先看当前 Provider 要求读取的 env_key，检查它是否存在于实际启动 CLI 的环境。Key 名称、Provider 鉴权方式和运行进程需要匹配；不要只在无关终端设置变量。
查看报错修复快速判断
- 启动 Codex 立即提示 OPENAI_API_KEY not found
- 后台没有请求记录
Codex config.toml error：TOML 结构与 Provider 配置
Codex config.toml error 先处理无法解析的行、重复表和字段类型，再核对 model_provider 与对应 Provider 配置。备份原文件并保留已有设置；配置能加载后，才继续检查接口协议和模型请求。
查看报错修复快速判断
- 启动或打开对话时无法读取配置
- 错误提示 provider 名称不存在
Codex auth.json error：登录状态与网关鉴权
Codex auth.json error 先检查当前登录方式、文件格式和 Provider 所需鉴权。官方账号登录与网关 API Key 配置分开处理，备份后只修复对应入口；新会话核对真正使用的 Provider 与请求地址。
查看报错修复快速判断
- Codex 读取 auth.json 失败
- 明明 export 了 Key 仍使用旧账号
Codex model provider error：Responses 与路由排查
Codex model provider error 先记录底层状态、Provider、wire_api 和实际端点，分清配置解析、鉴权、模型授权与响应事件。普通 Chat 成功不能证明 Codex 所需 Responses 和工具流可用，修复后验收真实代码任务。
查看报错修复快速判断
- Codex 可启动但调用失败
- 错误包含 provider
Codex 报错怎么转成可用配置
不要只看错误码本身。先确认请求是否进入 apizt 后台，再按 API Key、Base URL、模型名、provider 类型排查。 这几个页面分别覆盖认证失败、连接失败、模型不存在、限流和工具配置覆盖问题。