codex 报错绝大多数源于 config.toml 或 auth.json 配置错误:路径不对、内容错位、字段残留或格式污染,导致 401、sandbox 初始化失败、reconnecting 循环等问题;需先验证配置加载路径,再清空重写两个文件,并确保 auth.json 仅含 openai_api_key、config.toml 配置块置于文件最上方。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Codex 报错绝大多数和配置有直接关系,不是安装失败、不是网络断开、也不是模型本身故障,而是 config.toml 或 auth.json 文件位置不对、内容错位、字段残留、格式污染导致的——比如 401 Unauthorized、sandbox initialization failed、reconnecting 循环、模型不响应、命令找不到,全都能在两个文件里找到根因。
先确认配置文件是否真的被读取
打开终端,执行:codex --debug "test"。如果输出中出现 loading config from ~/.codex/config.toml(Mac/Linux)或 C:\Users\用户名\.codex\config.toml(Windows),说明路径正确;若显示 no config found 或路径指向项目目录、桌面、下载夹,则配置根本没加载。
这一步必须做,因为 VSCode 插件、CLI、桌面端可能各自读取不同路径的 .codex 文件夹,你改了 A 地方,B 工具根本看不到。
检查 auth.json 是否干净
方法一:直接删掉重来
进入 C:\Users\你的用户名\.codex\(Windows)或 ~/.codex/(Mac/Linux),找到 auth.json,把它彻底删除。
然后新建一个纯文本文件,命名为 auth.json,只写这一行(不能有多余空格、换行、逗号、注释、旧字段):
{"OPENAI_API_KEY":"sk-xxx"}
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
把 sk-xxx 替换成你从 LetAiCode 控制台生成的真实密钥,密钥分组必须选 codex,额度设为无限,模型不限制。
⚠️ 如果你之前用过 ChatGPT 账号登录,或者复制过别人配置,auth.json 里很可能混着 token、refresh_token、expires_at 等字段——这些会强制 Codex 走 OAuth 流程,但当前配置又设了 preferred_auth_method = "apikey",冲突直接触发 401。
重置 config.toml 的核心配置块
第一步:打开 config.toml,全选 → 删除全部内容。
第二步:粘贴以下配置,必须从文件最顶部开始,前面不能有任何空行、注释、旧配置:
model_provider = "letaicode"
model = "gpt-5.5"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
[model_providers.letaicode]
name = "letaicode"
base_url = "https://letaicode.cn/codex"
wire_api = "responses"
requires_openai_auth = false
第三步:保存文件,关闭所有终端窗口,重新打开一个全新终端。
第四步:执行 codex --version 验证 CLI 可运行,再执行 codex 启动。如果仍报错,说明问题出在 Node.js 环境或 PATH,而不是配置本身。










