排障：安装和登录失败

Claude Code 安装登录排障教程：登录失败时先判断命令、账号权限、浏览器授权、网络环境和模型服务是否正常。

先收集信息

安装和登录失败不要连续乱试。先把系统、安装方式、错误位置和关键日志收集清楚，再让 CC 分类。

Claude Code 安装或登录失败了。

请先帮我整理排查信息，不要让我重复试错：
1. 当前系统是什么。
2. 安装命令执行到了哪一步。
3. claude --version 是否可用。
4. claude doctor 是否有错误。
5. 登录时浏览器是否能打开。
6. 错误信息最关键的一行是什么。

请根据这些信息判断最可能原因。

先判断卡在哪一步

• 安装阶段：命令报错、包下载失败、权限不足。
• PATH 阶段：安装了但终端找不到 claude。
• 版本检查：claude --version 不可用或版本异常。
• 健康检查：claude doctor 有阻塞项。
• 登录阶段：浏览器打不开、登录后回不来、账号无权限。
• 网络阶段：请求超时、代理、DNS、证书问题。

排障要按顺序走，不要跳步：

常见原因

• 终端找不到 claude，通常是安装失败或 PATH 没生效。
• 登录后仍不可用，可能是账号没有 Claude Code 权限。
• 浏览器打不开，优先排查默认浏览器和网络。
• doctor 报错，先按阻塞项处理，不要继续配置模型。

直接让 CC 分类

请根据下面信息判断安装/登录失败类型。

系统：【Windows / macOS / Linux / WSL】
安装方式：【填写】
失败步骤：【安装 / version / doctor / 登录 / 启动】
错误信息：
【粘贴关键错误，不要粘贴密钥】

请输出：
1. 最可能原因。
2. 需要我确认的信息。
3. 按优先级排列的排查步骤。
4. 哪些动作不要做。
5. 什么时候再进入模型配置。

浏览器登录失败

Claude Code 浏览器登录失败，请帮我分类。

现象：
【浏览器打不开 / 登录后终端没反应 / 账号提示无权限 / 网络超时】

请判断：
1. 更像浏览器问题、账号权限问题、网络问题还是回调问题。
2. 是否需要重新打开终端。
3. 是否需要先运行 doctor。
4. 哪些信息不能粘贴，例如 token、cookie、授权码。

Windows 常见卡点

• 安装后新开终端再试，旧终端可能没有加载 PATH。
• PowerShell、CMD、Git Bash、WSL 可能是不同环境。
• 公司电脑可能限制脚本执行或网络访问。
• 默认浏览器无法唤起时，可以检查系统默认浏览器。

WSL 常见卡点

• Windows 和 WSL 是两个环境，安装位置不要混淆。
• 浏览器登录可能在 Windows 打开，但 CLI 在 WSL 等回调。
• 项目路径如果跨 /mnt/c，权限和性能可能不同。

公司电脑和代理环境

公司电脑经常多一层限制：

• 脚本执行策略。
• 代理或证书拦截。
• 浏览器登录限制。
• 终端访问外网限制。
• 安全软件拦截安装或回调。

可以这样问：

我可能在公司网络或受限电脑上安装 Claude Code。

请帮我判断：
1. 哪些问题可能来自公司策略。
2. 哪些步骤需要管理员或 IT 确认。
3. 哪些信息不能发给你。
4. 是否应该先在个人练习环境完成学习。

不要做什么

• 不要反复安装多个来源的版本。
• 不要把账号 token 粘给 CC。
• 不要在安装没成功时继续配置国内模型。
• 不要忽略 doctor 的阻塞项。

登录成功后的验证

请帮我确认 Claude Code 登录后是否可用。

要求：
1. 先确认版本和 doctor 状态。
2. 做一个只读对话测试。
3. 进入一个安全练习项目。
4. 让 CC 只读总结项目目录。
5. 如果失败，判断是登录、模型、网络还是项目权限问题。

排障结束后记录结论

请总结这次安装/登录排障结论。

请输出：
1. 最终卡点是什么。
2. 采取了哪些处理。
3. 当前是否已经可用。
4. 以后遇到同类问题先检查什么。
5. 是否可以进入模型配置和只读项目分析。

验收结果

• 能执行 claude --version。
• claude doctor 没有阻塞项。
• 能进入 Claude Code 对话。
• 能完成一次只读项目分析。