安装 Claude Code 时出现报错

运行安装命令之后，如果报错，多数情况是网络问题。（若不想折腾代理，可直接看 国内网络安装方式。）

常见有两类

• 当前网络环境没法正常访问
• 已开代理，但节点不稳定、不可用，或规则没配好

排查顺序

可以先按下面顺序排查：

1. 确认本机可以正常上网。
2. 若使用代理，先切换到更稳定的节点，并确认：虚拟网卡 / Tun 模式/增强模式已打开（不同软件叫法不同，是同一个功能，软件没有这个配置项就忽略）；安装前出站模式可先选全局
3. 网络正常后，关闭当前终端窗口，重新打开，再执行一次安装命令。
4. 安装完成后，代理可以关闭全局模式，切换回规则模式（如果你的软件有这个设置项的情况下）
5. Claude Code 安装是否顺利，既取决于 代理网络质量，也取决于 代理软件配置。若节点本身质量良好，但当前软件没有虚拟网卡 / Tun / 增强模式等选项，可将订阅链接导入 其他参考 中推荐的FlClash代理软件再试一下。
6. 仍不确定代理怎么配，可直接联系我协助。

报错关键词

如果报错里出现下面这些关键词，基本都可以先按网络问题处理

• Failed to download binary、操作已超时
• ECONNREFUSED、Failed to fetch version
• WebException、Invoke-RestMethod
• ParserError、Invoke-Expression
• 此语言版本中不支持"var"关键字