Windows 11 环境部署 Claude Code 教程

在开始安装之前，请确保你的 Windows 11 系统满足以下基本要求：

操作系统：Windows 10 (Build 19041+) 或 Windows 11
硬件：至少 4GB RAM（推荐 8GB+），x64 或 ARM64 处理器
网络：稳定的互联网连接
依赖工具 ：建议提前安装 Git for Windows （Claude Code 依赖 Git Bash 执行 Shell 命令，官方推荐）
- 若未安装，可通过 Winget 快速安装：winget install Git.Git --source winget
账号：需要有效的 Anthropic 账号（Claude Pro / Max / Teams / Enterprise，免费版通常不支持 API 调用）

官方提供的原生安装器无需手动配置 Node.js，且支持后台自动更新，是最便捷的方式。

备选（CMD 命令行） ：如果你使用的是传统 CMD 而非 PowerShell，可使用：
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

如果你的项目依赖 Linux 工具链（如 make, gcc）或偏好 Linux 开发环境，建议在 WSL 2 中部署：

在 Ubuntu 终端中安装 Node.js (LTS 版本)：

bash 复制代码

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

使用 npm 全局安装 Claude Code：
bash 复制代码
```
npm install -g @anthropic-ai/claude-code
```
验证安装：
bash 复制代码
```
claude --version
```
注：在 WSL 中使用时，建议将项目代码存放在 WSL 文件系统（如 ~/projects/）而非 /mnt/c/ 下，以获得更好性能。

如果你已经在 Windows 上配置了 Node.js (LTS) 环境，也可以直接使用 npm 安装（需先确保 Node.js 已安装）：

powershell 复制代码

# 确认 Node.js 环境
node --version
npm --version

# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 验证
claude --version

注：此方式不会自动后台更新，需手动更新依赖 npm 机制。

安装完成后，需要配置 Anthropic API Key 或进行账号登录才能使用。

在终端直接运行：

powershell 复制代码

claude login

命令会自动拉起浏览器，登录你的 Anthropic 账号授权即可，终端会同步显示成功信息。

如果你有直接的 Anthropic API Key，可以通过环境变量配置（适用于 npm 或 WSL 安装场景）：

临时设置（仅当前 PowerShell 会话有效） ：
powershell 复制代码
```
$env:ANTHROPIC_API_KEY="sk-your-api-key-here"
```
永久设置（用户级环境变量） ：
powershell 复制代码
```
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-your-api-key-here", "User")
```
设置后需重启终端生效。
（备选）通过系统属性 -> 高级 -> 环境变量 -> 新建用户变量 ANTHROPIC_API_KEY 进行图形化配置。

claude 不是内部或外部命令 ：通常是因为安装后的 PATH 未刷新。尝试关闭并重新打开 PowerShell/终端；若原生安装器路径未自动添加，可手动将 %USERPROFILE%\.local\bin 添加到系统环境变量 Path 中。
Git 相关报错 ：确保在 Windows 原生模式下已正确安装 Git for Windows，且 Git Bash 路径可被识别（通常默认安装即可自动识别，路径一般为 C:\Program Files\Git\bin\bash.exe）。
网络/区域限制 ：如果在国内网络环境，可能需要配置合理的网络代理（可通过 HTTP_PROXY/HTTPS_PROXY 环境变量设置）或使用合规的 API 访问方式。