疑难排查
Codex CLI 报错——Missing OPENAI_API_KEY、config.toml、stream error
Codex CLI 先读取 ~/.codex/config.toml，解析出一个模型提供商，然后通过 Responses API 进行流式请求。每个阶段的失败方式各不相同：缺失的环境变量、格式错误的 profile、失效的登录状态，或流式过程中的 HTTP 错误。下面的页面按这个顺序逐一讲解。
| 错误 | 含义 |
|---|---|
Missing OPENAI_API_KEY | 当提供商期望的环境变量未设置时，Codex 拒绝启动。config.toml 中 env_key 的工作方式、export 为什么在 shell 之间会消失，以及一份可用的 profile。 |
codex config.toml error | ~/.codex/config.toml 格式错误时 Codex 无法加载：未知的提供商名、错误的 wire_api、缺失的配置节。自定义提供商所需的确切结构。 |
codex auth.json error | Codex 的登录状态存放在 ~/.codex/auth.json，文件失效或缺失会导致登录提示和认证失败。何时需要重新登录，何时自定义提供商完全绕过它。 |
stream error: unexpected status 401 Unauthorized | Codex 里流式过程中的 HTTP 故障会打印为 stream error: unexpected status。401、404 和 429 在这里分别意味着什么，以及如何用 curl 复现来定位坏掉的那一半。 |
Codex CLI Missing OPENAI_API_KEY——自定义提供商配置方法
当提供商期望的环境变量未设置时，Codex 拒绝启动。config.toml 中 env_key 的工作方式、export 为什么在 shell 之间会消失，以及一份可用的 profile。
Codex config.toml 报错——可用的 model_providers 配置
~/.codex/config.toml 格式错误时 Codex 无法加载：未知的提供商名、错误的 wire_api、缺失的配置节。自定义提供商所需的确切结构。
Codex auth.json / 登录错误——改用 API 密钥认证
Codex 的登录状态存放在 ~/.codex/auth.json，文件失效或缺失会导致登录提示和认证失败。何时需要重新登录，何时自定义提供商完全绕过它。
Codex stream error: unexpected status 401/404 解决方法
Codex 里流式过程中的 HTTP 故障会打印为 stream error: unexpected status。401、404 和 429 在这里分别意味着什么，以及如何用 curl 复现来定位坏掉的那一半。