当 Codex 出现报错时，恢复默认设置最稳妥的方法通常是先重置 config.toml：先完全关闭程序，把 config.toml 重命名为 config_backup.toml，然后重新启动，系统会自动生成一份新的默认配置文件。如果遇到 401 错误，可以删除 auth.json，或者手动重新创建；如果想彻底清空本地数据与配置，直接删除整个 .codex 目录，再重新初始化即可。

当 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、登录成功后立刻报错，或 API 认证异常，通常说明 auth.json 中可能存在多余字段、格式错误或异常换行。此时直接删除该文件，重启 Codex 后会重新触发登录流程，这也是处理 401 报错最简单、最彻底的方式。

方法二：手动重建 auth.json
在配置目录下新建一个文本文件，命名为 auth.json，内容严格只保留一行：
{"OPENAI_API_KEY":"sk-xxx"}（将 sk-xxx 替换为你的真实密钥，前后不要保留空格或换行）。保存完成后重新启动 Codex。

彻底清除全部用户数据（含缓存与历史）

这一步会清空所有本地会话记录、审批策略、沙盒设置、缓存数据以及模型偏好，仅保留最基础的可运行状态：

① 完全退出 Codex 客户端及其后台进程；

② 删除整个 .codex 目录（路径同上）；

③ 重新执行 codex login 或重新启动桌面端，系统会自动重建空白配置结构；

④ 如果使用 CLI，还需要重新配置 API Key，并执行 codex init 完成项目级初始化设置。