排查 ChatGPT 桌面端中的 Codex 问题时，先保存原始现象。记录当前项目、工作目录、失败动作和完整错误文字，再做最小的只读检查。一次改很多设置或反复重试，会让原因更难找。
本文依据 2026 年 8 月的官方文档整理。桌面端界面和权限选项可能变化，排查时以当前版本显示的路径、权限范围和命令输出为准。
401 / 429 / 超时先看分流表
登录失败、Incorrect API key、rate limit、usage limit、stream disconnected 这类错误：先按下面分流处理。完整手册见 401 / 429 / 超时排错。
| 现象 | 先做什么 |
|---|---|
401 / 鉴权失败 | 统一登录方式后重新 login；配置分层见 config.toml |
429 / 额度或限流 | 读重置时间；对照 重置雷达 与 额度窗口 |
| 超时 / 重连 | 查网络、代理、Base URL，并把任务拆小 |
本文后面的章节继续处理桌面端更常见的项目路径、权限、命令失败与结果异常。
先确认聊天进入了正确项目
结果里出现陌生文件，先查看项目关联的主文件夹。主文件夹决定新聊天的默认工作目录，也影响 Git 操作和项目配置发现。存在同名仓库时，让 Codex 返回绝对路径、当前分支和 Git 状态。
如果任务只需要一个目录，却挂载了多个无关文件夹，先新建范围更小的项目或聊天。不要依靠一句“只看这个目录”长期抵消过大的文件访问范围。
权限失败要看被拦住的动作
沙箱限制本地命令能够读取、修改和联网的范围。审批负责处理越过边界的请求。看到权限提示时，先读目标路径、命令和请求原因。当前任务只要求解释代码，却请求写文件或联网，应该先让 Codex 说明必要性。
合理操作仍被拒绝时，可以在项目边界内给一次较窄的许可。直接切到完全访问会丢掉排查线索，也扩大了后续命令的影响范围。
命令失败要保留第一条错误
测试、构建或安装命令失败时，保留命令原文、退出状态和第一段有效错误。先确认命令是否在仓库根目录运行，再检查依赖有没有安装、脚本名称是否存在、所需服务是否启动。
可以让 Codex 先解释错误和列出下一项只读检查。每次只验证一个假设。依赖缺失就检查锁文件和安装状态，端口占用就查看对应进程，配置缺少则确认示例文件和项目说明。不要在原因未知时删除缓存、重装全部环境或改动系统配置。
结果异常要回到原始验收条件
Codex 说完成但页面仍有问题，重新提供最短复现步骤和实际结果。附截图时指出需要看的区域，并说明期望状态。截图只能提供可见信息，路径、控制台错误和操作步骤仍要写清。
长任务卡住后，可以在同一聊天补充证据或纠正方向。新问题已经与原目标无关时，另开聊天会更清楚。使用 Goal mode 也不会扩大权限，遇到必须由你决定的操作仍会暂停。
应用状态异常时做最小对照
界面没有显示预期项目或命令时，先记录应用版本、登录方式和当前工作位置。新开一个空白聊天，测试同一个入口是否存在，可以帮助判断问题属于单个项目还是整个应用。旧聊天仍要保留，里面的路径、权限请求和失败记录可能是定位依据。
重启应用前先确认没有命令仍在运行，也没有等待保存的本地结果。重启以后只重复最短失败步骤。现象改变时记录差异，不要立刻恢复所有原操作。
恢复以后补一条记录
问题解决后，记下原因、有效修复和验证方式。若错误来自项目脚本、缺少说明或错误默认值，把对应文档或配置一起补好。下一次遇到相同现象时，先重跑最小检查，就不用从大范围清理开始。