Claude Code 安装指南 (Windows)

本文档详细介绍了如何在 Windows 环境下安装和配置 Claude Code CLI 工具。

1. 安装方式

方法一：使用 Winget (推荐)

Windows 10 和 Windows 11 自带 winget 包管理器，这是最简单的安装方式。

打开 PowerShell 或命令提示符 (CMD)，运行以下命令：

winget install Anthropic.ClaudeCode --accept-package-agreements --accept-source-agreements

方法二：使用 NPM (需要 Node.js)

如果您已经安装了 Node.js 环境：

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

2. 运行前的关键配置：网络代理

Claude Code 需要连接到 Anthropic 的服务器 (api.anthropic.com)。如果您在中国大陆地区使用，必须配置代理，否则会出现 ERR_BAD_REQUEST 或连接超时错误。

临时设置（仅当前终端窗口有效）

在启动 Claude Code 之前，请在 PowerShell 中运行以下命令（请将 7890 替换为您的代理软件实际使用的端口号）：

$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"

永久设置（推荐）

为了避免每次都要输入命令，建议设置系统环境变量：

1. 按 Win + S 搜索 "编辑系统环境变量"。
2. 点击 "环境变量" 按钮。
3. 在 "用户变量" 区域点击 "新建"，添加以下两项：
   • 变量名: HTTP_PROXY，变量值: http://127.0.0.1:7890
   • 变量名: HTTPS_PROXY，变量值: http://127.0.0.1:7890
4. 点击确定保存，并重启终端。

3. 启动 Claude Code

首次启动

如果安装后直接输入 claude 提示找不到命令，请尝试重启终端。如果仍然无法识别，可以使用完整路径启动：

& "$env:LOCALAPPDATA\Microsoft\WinGet\Packages\Anthropic.ClaudeCode_Microsoft.Winget.Source_8wekyb3d8bbwe\claude.exe"

常用命令

• claude：启动交互式会话
• claude doctor：检查环境和网络连接状态
• claude --version：查看当前版本

4. 身份验证流程

1. 启动 Claude Code 后，它会提示您按 Enter 键打开浏览器进行登录。
2. 浏览器将跳转到 Anthropic 授权页面，请登录您的账号并授权。
3. 授权完成后，终端会自动检测到登录状态并完成初始化。

5. 常见问题排查

Q: 报错 "Unable to connect to Anthropic services"

A: 这是网络问题。请确保您已开启代理软件，并按照本文第 2 节正确配置了 HTTP_PROXY 和 HTTPS_PROXY 环境变量。

Q: 报错 "claude : 无法将"claude"项识别为 cmdlet..."

A: 这是因为安装路径未添加到系统 PATH 环境变量中。

• 解决方法 1：重启终端（通常 Winget 安装后需要重启终端才能刷新 PATH）。
• 解决方法 2：使用上文提到的完整路径运行。
• 解决方法 3：手动将 %LOCALAPPDATA%\Microsoft\WinGet\Packages\Anthropic.ClaudeCode_Microsoft.Winget.Source_8wekyb3d8bbwe 添加到系统 PATH 环境变量中。