找不到命令，或找错了二进制
安装器很高兴但没有 claude，多半是旧终端，或 ~/.local/bin 不在 PATH。
which claude 和 claude --version 必须对上你刚装的那份。残留的 Node 全局包是常见冒名顶替。
Windows 原生和 WSL 不共享家目录。只有两边都装过，才两边都查。
- 换新终端。
- 打印 PATH 和 which claude。
- 删掉或改名过期的那份。
把 claude doctor 当成工单来读
doctor 打印安装健康、设置错误和建议，但不会开始写代码。请在你关心的项目目录跑。
把警告当清单。不要把完整输出贴到公共聊天；里面可能有路径和服务器名。
doctor 干净而模型仍然迟钝，那是提示或仓库问题，不是安装器问题。
- 在仓库根跑。
- 先修第一条错误，再跑一次。
- 日志保持私密。
浏览器打转和账号门槛
登录会开浏览器。若回不来，换浏览器、关掉拦截，或按当天文档的文本模式说明来。
对话能进、Code 被拒，两者可以同时成立。那是账号门槛。我们不会发明一个套餐名当修复。
环境里的 API 密钥只有在你批准后才会跳过浏览器。坏密钥看起来像安装不稳。
- 账号要正确。
- 仓库里没有密钥。
- 重装之前先换干净网络再试登录。
一次装了两份
原生加 Homebrew 再加全局包，是经典乱局。doctor 常会指出你没料到的启动器。
用当初的安装方法卸载。再装之前，which claude 应该是空的。
- 列出 PATH 上每一个 claude。
- 卸掉多余的。
- 一种方法，一份二进制。
看不见 MCP
确认当前入口实际读取的配置文件。重启。在同一个 shell 检查环境变量。
挂起的服务器不能靠更长的提示修好。杀掉，再缩小查询。
- 语法。
- 环境变量。
- 进程起来。
- 只读证据。
技能不触发
目录不对、会话打开的不是放技能的项目，或描述太含糊。
新会话之后，用名字在小任务上调用。
- 路径存在。
- 新会话。
- 描述足够具体。
糟糕的编辑和失控会话
先撤回。再缩小文件列表。不要在同一棵脏树上让它“修好你刚弄坏的一切”。
它在同一工具上打转就打断。检查钩子或 MCP 是否在喂垃圾。
- 撤回。
- 更小的请求。
- 打断循环。
修理阶段的错法
不看 which claude 就重装三次。
把 doctor 输出和 API 密钥贴进公开 issue。
- 忽略 PATH。
- 混用 WSL 和原生。
- 用改提示来修安装故障。
做到这样就够了
doctor 干净到能干活，which claude 唯一，并且你能开始会话。
- 一份二进制。
- 读过 doctor。
- 登录可用，或已确认是账号门槛。
- 先能启动再查 MCP/技能。
- 工单里没有密钥。
回到教程或目录
若你从安装章过来，回到第一个任务。若系列已经读完，把修理包收进书签。
本教程和你的机器打架时，以官方安装排错页为准。