Codex 配置、安全与排错
Codex 权限、沙箱、第三方 API、更新、卸载、中文乱码、WSL2 和常见问题排错。
Codex 出现问题时，先判断故障发生在哪一层：安装与更新、账号和 API、权限与沙箱，还是终端与 Windows 环境。记录完整报错和操作入口，再进入对应教程，通常比直接重装更快。
按症状排查
| 症状 | 优先检查 |
|---|---|
| 不确定应该选择哪种权限模式 | Codex 权限管理 |
| 想了解文件、命令和网络的沙箱边界 | 沙箱与审批模式 |
| Windows sandbox setup、管理员沙箱或联网报错 | Windows 原生沙箱修复 |
| API Key 无效、Base URL 不生效 | 第三方 API 与中转配置 |
| 不确定修改哪个配置文件 | config.toml 与 auth.json |
| 更新失败、版本不一致或不知道安装来源 | Codex 更新与升级 |
| PowerShell、文件或 Codex 生成内容中文乱码 | Windows 中文乱码 |
| Windows 与 WSL2 的路径、登录或代理不同 | Codex WSL2 配置 |
推荐排错顺序
先查看 常见问题与排错总览，确认失败的是下载、启动、认证还是调用。只有在确认安装损坏、普通更新无法恢复时，再按 Codex 完整卸载与重新安装 清理；不要在没有备份配置和项目文件的情况下直接删除目录。