Appearance
37 · 常见问题排查：装不上、登不了、不肯改文件，挨个拆
遇到问题不要先玄学。 先按层排查。
这一篇就是排查路线图。
排查前先收集三样证据
遇到问题不要只说“坏了”。 先准备这三样：
- 你刚才做了什么。
- 页面或终端报了什么。
- 你希望它变成什么样。
这三样给到 Codex，它通常就能更快定位问题。
第一次练习：填一张“报错求助单”
下次出错时，不要只发一句“怎么不行”。 把下面这段直接复制给 Codex：
text
我遇到了一个问题，请先排查，不要直接修改。
我想完成：
我刚才做了：
我看到的完整报错：
我使用的系统和入口：
我已经尝试过：
请按下面顺序回答：
1. 先复述你对问题的理解
2. 列出最可能的 3 个原因
3. 告诉我先做哪个最小检查
4. 每次只检查一个原因填写时注意三件事：
- 报错尽量完整复制，不要只截最后一行。
- 密钥、密码、手机号先打码。
- 先排查原因，确认后再允许修改。
这张求助单的作用，是让 Codex 拿到证据，而不是陪你猜。
01 排查心法：先查这三样，再谈玄学
先查：
- 当前目录对不对。
- 登录和权限对不对。
- 错误信息是什么。
提示词：
text
请先帮我做三步排查：
1. 当前目录
2. 登录/权限状态
3. 最近错误信息
暂时不要修改任何文件。02 装不上、命令找不到
先看：
- 是否安装成功。
- 命令是否在 PATH。
- 终端是否重启。
- Windows 是否用了正确 shell。
不要反复安装。 先定位命令在哪。
03 登录失败、认证过期
常见原因：
- 账号状态失效。
- 浏览器登录态过期。
- 网络不稳定。
- 组织或权限限制。
处理思路：
text
请帮我判断这是登录态问题、网络问题，还是账号权限问题。
先列排查步骤，不要让我重复安装。04 网络转圈、要不要魔法上网
网络问题先分清：
- 是 Codex 服务连不上。
- 是某个外部网站连不上。
- 是本地预览打不开。
- 是代理配置导致的问题。
不要一句话归因。
05 模型选不对、找不到某个模型
模型可用性会变。
先看当前界面或官方说明。 不要照旧教程死找。
text
请告诉我当前可用模型应该在哪里查看。
如果某个模型不可见，可能有哪些原因？06 权限被卡、沙箱不让改文件
这不一定是坏事。 沙箱是在保护你。
先问：
text
这次权限被卡，是因为文件范围、命令风险，还是审批策略？
有没有更小权限的替代方案？07 MCP 连不上
排查：
- server 是否启动。
- 配置是否写对。
- 权限是否允许。
- API Key 是否可用。
- 工具是否在当前会话可见。
第一次只做只读测试。
08 上下文爆了、越聊越笨
表现：
- 它忘记前面约束。
- 回答开始跑题。
- 总是重复。
- 改动越来越大。
处理：
text
请先总结当前任务的目标、范围、已完成事项、未完成事项。
然后我们从这个摘要重新开始。09 费用 / 额度用超
先查官方后台或当前产品界面。 不要让 AI 猜价格。
排查：
- 哪个入口产生消耗。
- 是否用了高强度模型。
- 是否跑了自动化。
- 是否有团队共享额度。
10 Windows 专属坑、以及“它改错了怎么撤”
Windows 专属问题
常见：
- 路径中文或空格。
- 反斜杠。
- CRLF 换行提示。
- 权限警告。
它改错了怎么撤
先看 diff。
text
请告诉我当前有哪些未提交改动。
逐个解释每个文件改了什么。
不要撤回，等我确认。确认后再撤。
小结
排查不要靠猜。 按层来：
目录、登录、网络、权限、配置、上下文、改动。