Codex 通用排障
Codex 常见的通用问题：项目上下文、登录权限、Reconnecting、Windows 与切换 provider。
以下是从 Codex 实践中精选的通用问题；详细内容见后续教程板块。
Codex 找不到项目上下文
- 确认在正确的项目目录启动 Codex。
- 检查项目根目录的
AGENTS.md是否被正确读取。 - 使用
codex exec时显式传入需要参考的文件或目录。
登录或权限问题
- 使用 API Key 方式时，确认
auth.json中OPENAI_API_KEY与线路匹配。 - 确认 Key 未被删除、未过期、未开启「仅使用订阅额度」且额度不足。
- 网络能访问 API 线路。
Desktop 一直显示 Reconnecting
- 先检查网络与线路可达性。
- 完全退出 Codex 后重新打开。
- 确认本机时间正确，避免 TLS 握手失败。
Windows 桌面 App / CLI 专项
- 确认安装目录与 PowerShell 环境变量正确。
- CLI 在 WSL 中时，注意
~/.codex是 WSL 内的用户目录。 - 防火墙 / 代理可能影响连接，确认终端能访问 API 线路。
切换 provider 后旧会话不可见
- 切换 provider / 配置后，旧会话按配置目录隔离，属正常现象。
- 如需保留，先备份
~/.codex目录再切换。