37 · 常见问题排查：安装、登录与权限

安装失败、无法登录、不修改文件、沙箱报错、网络和配置异常的定位顺序与解决方法，按现象快速排查。

出问题是常态，会排查才不慌。这一篇把最常见的几类问题，按「现象 → 定位 → 解决」的顺序整理给你。

「安装失败」：最常见的原因是网络不通或权限不足。先确认网络能连到官方源，再确认安装位置有没有写权限。

「无法登录」：多半是网络问题或授权流程没走完。确认浏览器能打开授权页、确认授权后回执能回到终端。

「不修改文件」：这通常不是坏了，而是权限卡住了——它被限制在只读、或者某个操作等你审批你没批。先看是不是权限/审批的问题，再怀疑别的。

「沙箱报错」：说明它要做的动作超出了当前沙箱的允许范围。要么放宽沙箱，要么换个更受限的操作方式。

「网络异常」：贯穿上面所有问题的元凶之一。很多「奇怪报错」追到底，都是网络不通或不稳。

「配置异常」：改了 config 之后出问题，先想想是不是配置写错了。回退到上一个能用的配置，逐个排查。

「定位顺序」的总原则是：先看是不是「环境问题」（网络、权限、配置），再看是不是「用法问题」。绝大多数问题，追到最后都是这两类之一。

最后建议：报错原文要保存好。报错信息里往往就写着原因和提示，比盲目搜索靠谱得多。

一个自查清单：当你读完这一篇时，可以问自己三个问题——它解决的是什么具体问题？我当前的工作/学习里有没有这个场景？下一步我该学哪一篇？把这三个问题答清楚，你就知道自己有没有真正吃透。

五分钟练习：① 找一个一分钟能完成的代码任务 ② 用这一篇的方法描述给 Codex ③ 看它执行时有没有触发你刚学的那个机制 ④ 验证结果是否符合预期。这一轮做下来，你对这一篇的理解会深 3 倍。

延伸阅读：学完这一篇，你可以看本组里的下一篇，把相邻的概念连起来读；也可以跳到更后面的组学 MCP、子代理、Skills 这些更深的能力。知识是网状的，多跳几篇会理解更深。

一页速览：如果只能记三件事，① {一}。② {二}。③ {三}。其他细节以后需要再翻这一篇查。