#23. 常见问题与解决

---

Codex 不理解我的项目结构

检查你是否在项目根目录启动了 Codex，以及项目中是否有 AGENTS.md。如果没有，运行一次项目概览对话帮助 Codex 建立初始理解，然后创建 AGENTS.md 固化这些信息。

Codex 修改了不该改的文件

在提示中明确限定范围："只修改 @src/api/users.ts，不要动其他文件。"同时检查 AGENTS.md 中是否有关于"不要修改"的说明。

命令执行被沙盒阻止

默认的沙盒没有网络访问权限。如果任务需要联网（如 npm install），需要在配置中开启网络访问，或使用 codex -s danger-full-access 临时解除限制（仅在安全环境中使用）。

Windows 上运行异常

Codex CLI 对 Windows 的原生支持还处于实验阶段。推荐在 WSL2 中使用，体验与 Linux 一致。确保 WSL2 已更新到最新版本。

认证循环，反复要求登录

先运行 codex logout，然后重新启动 Codex。如果问题持续，删除 ~/.codex/ 目录下的认证缓存文件后重试。如果使用 API Key，确认 OPENAI_API_KEY 环境变量正确设置。

额度用完了怎么办

ChatGPT 订阅用户达到消息上限后，可以在 ChatGPT 设置中购买额外额度继续使用，也可以切换到更轻量的模型（如 GPT-5.4-mini）来延长额度使用时间。API Key 用户则需要在 OpenAI 后台充值。

改动后测试失败

让 Codex 分析失败的测试输出，然后修复代码（而不是修改测试来适配错误的代码）。如果反复失败，考虑回退到修改前的状态，重新描述需求后让 Codex 尝试不同的实现方案。