跟着这个教程,你可以轻松在自己的电脑上安装 Claude Code。
Claude Code 需要 Node.js 环境才能运行。
Windows 安装方法 (二选一,推荐方法一)
方法一:官网下载(推荐)
- 打开浏览器访问 Node.js 下载页面
- 点击 "LTS" 版本进行下载(推荐长期支持版本)
- 下载完成后双击
.msi
文件 - 按照安装向导完成安装,保持默认设置即可
方法二:使用包管理器
如果你安装了 Chocolatey 或 Scoop,可以使用命令行安装:
Windows 注意事项
- • 建议使用 PowerShell 而不是 CMD
- • 如果遇到权限问题,尝试以管理员身份运行
- • 某些杀毒软件可能会误报,需要添加白名单
验证安装是否成功
安装完成后,打开 PowerShell 或 CMD,输入以下命令:
如果显示版本号,说明安装成功了!
安装 Claude Code
如何打开 PowerShell:
- 按下键盘上的 Win + X 组合键
- 在弹出的菜单中选择"Windows PowerShell"或"终端"
- 或者:按 Win 键,输入"PowerShell",然后回车
打开 PowerShell 或 CMD 后,运行以下命令:
这个命令会从 npm 官方仓库下载并安装最新版本的 Claude Code。
常见报错:PowerShell 执行策略限制
如果在运行 npm 命令时出现以下错误:
解决方案:
- 以管理员身份打开 PowerShell:
- 右键点击开始菜单
- 选择"Windows PowerShell (管理员)"或"终端 (管理员)"
- 运行以下命令:Set-ExecutionPolicy RemoteSigned
- 确认更改:
当系统询问时,输入 Y 或者 A,然后按回车。
- 重新运行安装命令:
可以关闭管理员窗口,打开普通 PowerShell 窗口,再次运行 npm install -g @anthropic-ai/claude-code 命令。
✅ 完成后,npm 命令就可以正常使用了。
验证 Claude Code 安装
安装完成后,输入以下命令检查是否安装成功:
如果显示版本号,恭喜你!Claude Code 已经成功安装了。
⚠️ 提示:如果运行 claude --version 时提示需要 Git Bash,请参考下方"步骤 4"中的 Git 报错解决方案。
配置 Claude Code 环境变量
为了让 Claude Code 连接到你的中转服务,需要设置两个环境变量:
PowerShell 设置方法
永久设置(强烈推荐)
在 PowerShell 中运行以下命令设置用户级环境变量:
💡 设置后需要重新打开 PowerShell 窗口才能生效。
临时设置(当前会话有效,不推荐)
在 PowerShell 中运行以下命令:
⚠️ 关闭窗口后设置会失效。
CMD 设置方法
永久设置(强烈推荐)
在 CMD 中运行以下命令设置用户级环境变量:
💡 设置后需要重新打开 CMD 窗口才能生效。
临时设置(当前会话有效,不推荐)
在 CMD 中运行以下命令:
⚠️ 关闭窗口后设置会失效。
💡 记得将 "你的API密钥" 替换为实际密钥。
验证环境变量设置
设置完环境变量后,可以通过以下命令验证:
PowerShell:
CMD:
现在你可以开始使用 Claude Code 了!
启动 Claude Code
💡 首次启动提示:第一次启动 claude 时,会展示一些配置选项,直接按回车跳过即可,直到出现输入框可以输入内容。
在特定项目中使用
常见报错:缺少 Git Bash
如果在运行 claude 命令时出现以下提示:
解决方案:
- 下载 Git:
- 官方下载:访问 https://git-scm.com/download/win
- 备用链接:阿里云盘分享(如果官网下载慢)
- 安装 Git:
双击下载的安装包,一路点击"下一步",保持默认设置即可。
- 重新运行 claude:
安装完成后,重新打开 PowerShell 或 CMD,运行 claude 命令即可正常使用。
✅ Git 安装完成后,claude 命令就可以正常运行了。
安装时提示 "permission denied" 错误
这通常是权限问题,尝试以下解决方法:
- 以管理员身份运行 PowerShell
- 或者配置 npm 使用用户目录:
npm config set prefix %APPDATA%\npm
PowerShell 执行策略错误
如果遇到执行策略限制,运行:
环境变量设置后不生效
设置永久环境变量后需要:
- 重新启动 PowerShell 或 CMD
- 或者注销并重新登录 Windows
- 验证设置:
echo $env:ANTHROPIC_BASE_URL