登录和权限
命令能跑但任务立刻失败，先看是否掉登录、账号是否仍能使用 Codex。网页能用、CLI 不能，多半是本机登录态而不是模型本身。
公司网络会挡 OAuth 或 WebSocket。先换网络验证。权限模式若过严，Agent 会像坏了一样拒绝改文件。
过严的权限模式会让 Agent 像坏了。重装之前先问一个只读问题。
- 重新登录一次。
- 网页对照是否仍开通。
- 再试只读任务。
命令找不到或立刻退出
which 或 Windows 上的 where 看 PATH。装在用户目录的二进制，图形终端常常看不见。
版本命令能跑、任务立刻崩，看 Codex 主目录里的日志，而不是先卸扩展。
图形终端常常看不见用户目录里的 PATH。打开安装说明里提到的那种终端。
- 新开终端。
- 核对可执行文件路径。
MCP 连上了但调用失败
先分清未连接和已连接但工具报错。未连接就查命令、参数、工作目录和 PATH。
已连接就看服务器日志。stdio 若在等交互，客户端只显示超时。把同一条命令在终端跑一遍。
打完幼儿就等待的服务器算不上连上。客户端只会超时。
- 终端手动拉起服务器。
- 收窄到只读工具。
- 检查允许目录和过期登录。
技能不出现或不遵守
确认文件夹里真有 SKILL.md，且在客户端会扫描的位置。改完重启。
能看见却不遵守，通常是描述不像触发器，或说明书里的禁区和技能打架。先点名调用。
两个同名技能通常不能一起选。改掉一个名字。
- 检查路径和文件名。
- 点名再试。
改了不该改的文件
先回退。再把路径禁区写进 AGENTS.md 顶部。不要靠下一句提示词补救。
范围太大时拆任务。Agent 在大仓库里会找“看起来相关”的文件。
乱改之后先回退，把路径禁区写进 AGENTS.md 顶部，下一轮只给一个目录。
- 回退。
- 写禁区。
- 下一轮只给一个目录。
重装之前先看哪
日志通常在 Codex 主目录。环境变量可以改位置。以当天文档为准，不要猜博客路径。
求助时只贴去敏后的片段，不要整个主目录。
- 先看 Codex 主目录。
- 分享前去掉令牌。
Windows 和 WSL 混在一起
仓库在哪边，Agent 就跑在哪边。穿越边界会像文件丢了。
官方扩展常常有是否走 WSL 的开关。装在 Windows 上的 CLI 不会神奇看见 Linux 路径。
- 和仓库在同一边。
- 检查扩展里的 WSL 开关。
排错时的错
先重装编辑器会挡住 PATH、登录和 MCP 进程问题。
对卡住的写操作连点重试，会把补丁贴两次。
- 一上来重装编辑器。
- 对卡住的写操作连点重试。
排错清单
从上往下：登录、二进制、一次只读调用，再是 MCP、技能和范围。
- 只读问题上登录能用。
- 新终端里能找到二进制。
- MCP 进程能手动拉起。
- 乱改已回退并写进禁区。
好了之后
回到第一课闭环。不要用加五条服务器来庆祝。
若同样的乱改再现，说明书里的禁区还太靠后。搬到前面。