Codex报错时优先重置config.toml文件:关闭程序→重命名config.toml为config_backup.toml→重启自动生成默认配置;401错误可删除auth.json或手动重建;彻底清除数据则需删除整个.codex目录并重新初始化。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Codex报错时无法启动、闪退或配置失效,多数情况是config.toml文件损坏或残留异常参数导致的,直接重置配置比逐项排查更快更可靠。
重命名 config.toml 恢复默认配置
第一步:关闭 Codex 客户端,确保后台进程已退出(Mac 在活动监视器中检查 codex 进程,Windows 在任务管理器中确认无 node.exe 或 codex.exe 常驻)。
第二步:打开配置目录:
• Windows 路径为 C:\Users\你的用户名\.codex\
• macOS 路径为 ~/.codex/
• Linux 路径为 ~/.codex/
第三步:找到 config.toml 文件,将其重命名为 config_backup.toml(不要删除,保留原始配置用于后续比对)。
第四步:重新启动 Codex。程序会检测到缺失 config.toml,自动创建一份全新默认配置文件,所有设置回归出厂状态。
连 auth.json 也一并重置(401 报错专用)
方法一:仅清理认证文件
当出现 401 Unauthorized 或登录后立即报错时,auth.json 内容可能混入多余字段或换行符。直接删除该文件,重启 Codex 后会触发重新登录流程——这是最干净的认证重置方式。
方法二:手动重建 auth.json
在配置目录下新建文本文件,命名为 auth.json,内容严格只写一行:{"OPENAI_API_KEY":"sk-xxx"}(sk-xxx 替换为你的真实密钥,前后不能有空格或换行)。保存后重启 Codex。
彻底清除全部用户数据(含缓存与历史)
这一步会清空所有本地会话记录、审批策略、沙盒设置和模型偏好,仅保留基础可运行状态:
① 完全退出 Codex 客户端及后台进程;
② 删除整个 .codex 目录(路径同上);
③ 重新执行 codex login 或启动桌面端,系统将重建空白配置结构;
④ 若使用 CLI,需重新配置 API Key 并运行 codex init 初始化项目级配置。


















