Windows 安装 Claude Code 完全指南

本文由 Anthropic Claude Opus 4.6 模型自动生成。

Claude Code 是 Anthropic 官方推出的 AI 编程助手命令行工具（CLI），可在终端中以自然语言驱动代码编写、调试与重构。本文将详细介绍如何在 Windows 系统上完成安装与配置，并涵盖 VS Code 集成使用。

1. 环境要求

2. 前置准备：安装 Git

Claude Code 依赖 Git，所有安装方式均需要预先安装 Git for Windows。

1. 访问 Git 官网：https://git-scm.com/downloads/win
2. 下载并安装 Git for Windows，安装过程中建议勾选 "Git Bash Here" 上下文菜单选项。
3. 验证安装：

git --version

3. 安装 Claude Code CLI

提供三种安装方式，推荐程度由高到低排列。

方式一：PowerShell 一键安装（推荐）

这是官方推荐的 Windows 原生安装方式，无需预装 Node.js，且支持后台自动更新。

安装脚本会将 Claude Code 独立二进制文件下载至 C:\Users\<用户名>\.local\bin 目录，并自动将其添加到用户 PATH。

1. 打开 PowerShell（无需管理员权限）。
2. 执行以下命令：

irm https://claude.ai/install.ps1 | iex

3. 安装完成后，关闭并重新打开终端（PATH 更新需要新会话生效），然后验证安装：

claude --version

方式二：WinGet 安装

如果你的系统已内置 WinGet（Windows 10 1709+ / Windows 11 默认包含），可执行：

winget install Anthropic.ClaudeCode

与 PowerShell 一键安装类似，此方式同样无需 Node.js，支持自动更新。

方式三：npm 全局安装

适合已有 Node.js 开发环境、或需要精确锁定特定版本的用户。

前置步骤：安装 Node.js

1. 访问 Node.js 官网：https://nodejs.org/
2. 下载 LTS（长期支持版） 安装包（≥ 18.0）。
3. 运行安装程序，保持默认选项即可（建议勾选 "Add to PATH"）。
4. 验证安装：

node -v   # 应输出 v18.x.x 或更高版本
npm -v    # 应输出 npm 版本号

安装 Claude Code

打开 Git Bash 或 PowerShell，执行：

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

注意：

• 请勿使用 sudo。如遇权限错误（EACCES），应修复 npm 全局目录权限，而非提权安装。
• npm 方式不支持自动更新，需手动执行 npm update -g @anthropic-ai/claude-code 升级。

验证安装成功：

claude --version

三种安装方式对比

4. 身份认证

安装完成后，需要进行身份认证才能使用。

方式一：OAuth 浏览器登录（推荐）

适用于 Claude Pro / Max / Teams / Enterprise 订阅用户。

1. 在终端中启动 Claude Code：

claude

2. 首次运行时会自动打开默认浏览器，跳转至 Anthropic 授权页面。
3. 使用你的 Claude 账号登录并授权即可。

方式二：API Key 认证

适用于按量付费用户。

1. 前往 Anthropic Console 获取 API Key：https://console.anthropic.com/
2. 在「API Keys」页面创建新的密钥并妥善保存。
3. 设置环境变量（PowerShell）：

# 临时设置（仅当前会话有效）
$env:ANTHROPIC_API_KEY = "sk-ant-xxxxx"

# 永久设置（写入用户环境变量）
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-xxxxx", "User")

4. 启动 Claude Code：

claude

安全提示： 建议通过系统环境变量或密钥管理器存储 API Key，避免将其明文写入脚本或配置文件中。

方式三：通过 settings.json 配置文件

适用于使用第三方 API 中转服务或需要持久化配置的用户。

1. 找到用户级全局配置文件，路径为：

%USERPROFILE%\.claude\settings.json

即 C:\Users\<你的用户名>\.claude\settings.json。如果文件不存在，手动创建即可。

2. 在文件中通过 env 字段设置认证信息：

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-xxxxx"
  }
}

3. 如需指向自定义 API 端点（例如第三方中转服务），可同时配置 ANTHROPIC_BASE_URL：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxx",
    "ANTHROPIC_BASE_URL": "https://your-proxy-endpoint.example.com"
  }
}

说明：

• settings.json 中的 env 字段会在 Claude Code 启动时自动注入为环境变量，无需手动执行 export 或 $env: 设置。
• 该文件为用户级全局配置，对所有项目生效。如需项目级配置，可在项目根目录下创建 .claude/settings.local.json，结构相同。
• 此方式的优先级高于系统环境变量。

5. 在 VS Code 中使用 Claude Code

Claude Code 提供了官方 VS Code 扩展，可在编辑器内直接与 Claude 交互。

5.1 安装扩展

1. 打开 VS Code（要求版本 ≥ 1.98.0）。
2. 按 Ctrl + Shift + X 打开 扩展（Extensions） 面板。
3. 在搜索框中输入 "Claude Code"。
4. 找到由 Anthropic 发布的官方扩展，点击 Install 安装。

也可通过 VS Code Marketplace 页面直接安装：
https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code

5.2 登录认证

安装完成后：

1. VS Code 侧边栏（Activity Bar）会出现 Claude Code 图标。
2. 点击图标打开 Claude Code 面板。
3. 首次使用时，按提示完成 OAuth 登录或输入 API Key。

5.3 基本使用

5.4 常用工作流示例

用户：解释一下这段代码的作用
用户：给 calculateTotal 函数添加单元测试
用户：把这个组件从 Class 组件重构为函数组件
用户：查找项目中所有未处理的 Promise 异常

6. Windows 常见问题与注意事项

Q1：出现 "MSVCP140.dll was not found" 错误

原因： 缺少 Microsoft Visual C++ 运行时库。

解决方案： 下载并安装最新的 Visual C++ Redistributable：
https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist

Q2：MCP Server 在 Windows 上配置异常

在 Windows 下配置 MCP（Model Context Protocol）服务器时，需使用 cmd /c 包裹 npx 命令。在项目根目录的 .mcp.json 中：

{
  "mcpServers": {
    "example": {
      "command": "cmd",
      "args": ["/c", "npx", "your-mcp-server"]
    }
  }
}

Q3：npm 安装后 claude 命令无法识别

排查步骤：

1. 确认 npm 全局目录在系统 PATH 中：

   npm config get prefix

2. 将输出路径添加到系统环境变量 PATH。
3. 重新打开终端后重试。

Q4：代理/网络问题导致安装失败

如在公司网络或代理环境下安装失败，尝试配置 npm 代理：

npm config set proxy http://your-proxy:port
npm config set https-proxy http://your-proxy:port

7. 相关资源

本文档最后更新时间：2026 年 3 月