跳转到内容

Codex 常见问题排查

这一页是排障手册的总入口。

如果你已经遇到问题,不要从头翻所有教程,先按问题类型进入对应页面。

模型问题不要只看最后一行报错。先判断是 API Key、Base URL、模型名、额度权限,还是本地网络问题。

Windows 用户遇到路径问题时,不要一上来就搬项目目录。先保留完整报错,让 Codex 判断是哪一层工具链出问题。

构建通过只说明代码能生成,不代表任务已经完成。还要看页面、功能、数据、diff 和用户目标是否一致。

  1. 保留完整报错,不要只截最后一行。
  2. 说明你刚刚做了什么。
  3. 告诉 Codex 当前目录和目标页面。
  4. 一次只改一个变量。
  5. 修改后让 Codex 说明检查结果。

排障不是把网上命令挨个试一遍,而是先把问题分类,再做最小验证。