Codex 排障：从现象定位配置、环境与改动
排障从一个具体失败开始：在哪个运行端、哪个工作目录、执行什么操作、期望什么结果、实际返回什么。先保留错误摘要，再逐项缩小条件。
规则或配置没生效
核对启动目录、适用的 AGENTS.md 链、项目是否可信，以及命令行有没有覆盖配置。只检查与本次问题相关的配置键，避免通过清空整个配置文件掩盖原因。
命令无法执行
区分命令不存在、依赖未安装、测试失败与沙箱拒绝。先确认项目在普通开发环境里能否按文档运行，再核对 Agent 的实际环境。新 worktree 不会自动拥有主目录中的全部依赖和本地环境。
不要把授权问题当作命令语法问题，也不要反复执行相同失败命令期待结果改变。权限相关见 审批与沙箱。
工具未出现或访问失败
先确认 MCP 服务初始化、工具列表和认证，再试一条明确允许的只读操作。工具能被发现但目标记录拒绝访问时，检查业务系统权限，而不是只重启客户端。
差异比预期多
客户端的差异视图可能包含原有 Git 工作区改动，并不全是本轮生成。对照任务前的 git status --short 和任务后差异，必要时使用客户端提供的本轮视图。
不要为得到“干净状态”覆盖未知改动。反馈时提供最小复现、版本、错误和必要文件路径，不附整个凭据配置或生产原始数据。
修复一个原因后，只复验受影响的路径；明确区分已修复、检查通过和仍未验证。
最后更新于