Windows 常见安装问题

本页面收集了 Windows 系统上安装 Claude Code 时的常见问题和解决方案。

Node.js 安装问题

问题：无法安装 Node.js

症状： 双击 .msi 文件后安装程序无响应或报错。

解决方案：

1. 确保从官方网站下载安装包
2. 以管理员身份运行安装程序
3. 暂时关闭杀毒软件
4. 检查系统是否有足够的磁盘空间

问题：node 命令无法识别

症状： 在 PowerShell 或 CMD 中输入 node --version 提示 "不是内部或外部命令"。

解决方案：

1. 重启终端窗口
2. 检查环境变量 PATH 是否包含 Node.js 路径
3. 重新安装 Node.js，确保勾选 "Add to PATH" 选项

Claude Code 安装问题

问题：npm install 权限错误

症状： 运行 npm install -g @anthropic-ai/claude-code 时提示权限不足。

解决方案：

1. 以管理员身份运行 PowerShell
2. 右键点击 PowerShell，选择 "以管理员身份运行"
3. 重新执行安装命令

问题：安装速度很慢或超时

症状： npm 安装过程卡住或报网络错误。

解决方案：

1. 切换 npm 镜像源：

   npm config set registry https://registry.npmmirror.com

2. 检查网络连接
3. 重试安装命令

问题：claude 命令无法识别

症状： 安装成功后，输入 claude --version 提示找不到命令。

解决方案：

1. 重启 PowerShell 窗口
2. 检查全局 npm 包路径是否在 PATH 中：

   npm config get prefix

3. 确认 Claude Code 已成功安装：

   npm list -g @anthropic-ai/claude-code

环境变量问题

问题：设置环境变量后不生效

症状： 使用 PowerShell 设置环境变量后，Claude Code 仍然无法连接。

解决方案：

1. 确保关闭并重新打开 PowerShell 窗口
2. 验证环境变量是否正确设置：

   echo $env:ANTHROPIC_BASE_URL
   echo $env:ANTHROPIC_AUTH_TOKEN

3. 使用永久设置方法重新配置

问题：API 密钥包含特殊字符导致错误

症状： 设置包含特殊字符的密钥时报错。

解决方案： 确保在 PowerShell 中使用引号包裹密钥：

$env:ANTHROPIC_AUTH_TOKEN = "sk-your-key-here"

其他问题

问题：防火墙阻止连接

症状： Claude Code 无法连接到服务器。

解决方案：

1. 检查 Windows 防火墙设置
2. 在防火墙中允许 Node.js 访问网络
3. 临时关闭防火墙测试是否是防火墙问题

问题：杀毒软件误报

症状： 杀毒软件阻止 Claude Code 运行。

解决方案：

1. 将 Node.js 和 Claude Code 添加到杀毒软件白名单
2. 临时关闭杀毒软件进行安装
3. 安装完成后重新启用杀毒软件

仍然无法解决？

如果以上方法都无法解决你的问题，请：

1. 查看 通用常见问题
2. 联系技术支持
3. 提供详细的错误信息和系统版本