常见问题与排错

遇到问题时，不要一上来重装。先按问题类型缩小范围：账号、密钥、配置、网络、权限、项目本身。

无法登录

优先检查：

1. 当前网络是否能正常访问 ChatGPT / OpenAI
2. 代理节点是否稳定
3. 账号是否有可用套餐或权限
4. 是否可以在浏览器中正常打开 Codex 入口

API Key 无效

如果使用 Code8 API Key，检查：

1. auth.json 是否是合法 JSON
2. OPENAI_API_KEY 是否完整
3. API Key 前后是否有多余空格
4. Code8 账号余额是否充足
5. 是否已经重启 Codex

配置方式参考：订阅 Code8。

配置不生效

常见原因是文件路径不对。Windows 通常是：

%userprofile%\.codex\config.toml
%userprofile%\.codex\auth.json

macOS / Linux 通常是：

~/.codex/config.toml
~/.codex/auth.json

命令执行失败

先让 Codex 解释它要运行的命令，再确认是否允许。遇到依赖安装、网络访问、删除文件、部署命令时尤其要谨慎。

任务结果不理想

可以把任务拆小：

1. 先让 Codex 读代码并总结
2. 再让它提出修改计划
3. 然后只改一个模块
4. 最后运行验证命令

更多任务习惯参考：用 Codex 完成第一个任务。