Codex报错99%是配置问题：先确认codex --version能运行，再检查~/.codex/auth.json（仅一行{"OPENAI_API_KEY":"sk-xxx"}）和config.toml（关键配置必须置于文件最上方），最后重启终端或客户端。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在使用 Codex 时遇到报错，比如 401、无响应、超时或模型调用失败，问题大概率不出在安装包本身，而是配置文件写错、放错位置或内容混杂。直接重装不仅浪费时间，还可能覆盖掉原本正确的配置路径。你需要按真实生效顺序，一层层确认配置是否被读取、是否写对、是否干净。
先确认配置文件是否被正确读取
打开终端，执行：codex --version。如果命令无法识别，说明根本没走到配置读取这一步，先别碰 auth.json 或 config.toml——此时问题在环境层。
若能输出版本号，再执行：ls -la ~/.codex/（Mac/Linux）或在资源管理器中手动定位到 C:\Users\你的用户名\.codex\（Windows），确认目录下确实存在 auth.json 和 config.toml 两个文件，且没有隐藏的扩展名（如 auth.json.txt）。文件名错误会导致 Codex 完全忽略该配置。
VSCode 插件或桌面客户端可能读取的是另一套路径，不要假设 CLI 和 Desktop 共享同一份配置。CLI 默认读 ~/.codex/，而某些桌面版会优先读取 ~/Library/Application Support/Codex/（Mac）或 %APPDATA%\Codex\（Windows）——务必查清你当前用的是哪个入口。
检查 config.toml 是否放在最上方且无冲突
第一步：用文本编辑器打开 ~/.codex/config.toml，确保以下内容位于文件最开头，前面不能有任何空行、注释或旧配置：
model_provider = "letaicode"<br>model = "gpt-5.5"<br>model_reasoning_effort = "high"<br>disable_response_storage = true<br>preferred_auth_method = "apikey"<br>[model_providers.letaicode]<br>name = "letaicode"<br>base_url = "https://letaicode.cn/codex"<br>wire_api = "responses"<br>requires_openai_auth = false
⚠️ 如果你在文件中间或底部粘贴了这段配置，Codex 仍会优先读取顶部已存在的旧 provider 设置，导致模型切换失效、base_url 不生效。删掉所有其他 provider 块，只保留 letaicode 这一组。
第二步：逐项核对关键字段是否拼写准确。例如 model_provider 写成 model_provider_name、base_url 少了 s（写成 base_url → base_ur）、wire_api 拼错为 wire_apy，都会让整个配置块被跳过。Codex 不报语法错误，而是静默忽略错误字段。
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
检查 auth.json 是否只保留一行有效密钥
方法一：直接替换法（推荐）
用记事本或 VS Code 打开 ~/.codex/auth.json，全选 → 删除全部内容 → 粘贴这一行：{"OPENAI_API_KEY":"sk-xxx"}，把 sk-xxx 替换为你从 LetAiCode 平台生成的真实密钥（注意：不是 OpenAI 的 Key，也不是 Claude 的 Key）。
方法二：格式校验法
复制当前 auth.json 全文到 JSONLint.com 在线验证。只要出现“Unexpected token”或“Trailing comma”，就说明有多余逗号、引号不闭合、换行符残留或 BOM 头。Mac 用户用 TextEdit 打开容易插入不可见字符，务必改用 VS Code 或 Sublime Text 编辑。
【重要前提】 密钥必须在 LetAiCode 平台创建时选择分组为 codex，否则即使内容完全正确，也会返回 401。不要复用其他工具的密钥，也不要在同一文件里混存多个 Key。
验证修改是否真正生效
第一步：关闭所有正在运行的 Codex 相关进程——包括终端里的 codex serve、VSCode 中的插件后台、桌面客户端窗口。Mac 用户可在活动监视器中搜索 “codex” 强制退出；Windows 用户用任务管理器结束所有 Node.js 和 Codex 进程。
第二步：重新打开一个全新终端窗口（不要复用旧 tab），执行：codex --version → codex chat → 输入任意一句话测试响应。不要跳过重启步骤，Codex 不会热重载配置文件。
第三步：如果仍失败，在终端中执行：codex chat --debug，观察控制台输出的请求 URL、Header 和响应状态码。看到 401 Unauthorized 就回到 auth.json；看到 fetch failed 就检查 base_url 是否可访问（用浏览器或 curl 测试 https://letaicode.cn/codex）；看到 model not found 就确认 model 字段值是否为平台当前支持的型号（如 gpt-5.5、gpt-5.4）。
