首页

在 Windows 上安装 Claude Code

Claude Code 是一款运行在终端里的 AI 助手，能帮你编写、调试和理解代码。按照本指南，几分钟就能在 Windows 上完成原生安装并上手。如果想要更进阶的环境，指南末尾还介绍了可选的 WSL2 安装方法。

核心概念

• PowerShell - Windows 自带的命令行工具，本指南用它来安装和运行 Claude Code
• Git for Windows - 一款免费工具，自带 Claude Code 执行命令时使用的 shell Git Bash
• WSL（Windows Subsystem for Linux） - Windows 的一项可选功能，能在 Windows 里运行真正的 Linux 系统；指南末尾的进阶设置会用到

准备内容

• 一台 Windows 10 或 Windows 11 电脑
• Claude Pro/Max 订阅，或一个 API 密钥
• 5 - 10 分钟

步骤 1：安装 Git for Windows（可选，推荐）

Git for Windows 推荐但并非必需，它会提供 Claude Code 执行命令时使用的 shell Git Bash。如果跳过，Claude Code 会改用 PowerShell，因此你也可以直接进入步骤 2，以后再装 Git。

• 访问 git-scm.com/download/win，页面通常会自动开始下载，完成后打开安装程序
• 一路点击 Next，保持默认选项
• 点击 Install，最后点击 Finish

装好之后，Claude Code 启动时会自动识别 Git Bash。

步骤 2：安装 Claude Code

• 点击 Windows 开始按钮，输入 PowerShell，点击 Windows PowerShell
• 在 PowerShell 窗口里输入：

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

• 等待安装完成
• 关闭并重新打开 PowerShell，输入以下命令验证：

   claude --version
  

• 此时应该会显示 Claude Code 的版本号

步骤 3：在 VS Code 中打开 Claude Code

装好 Claude Code 之后，除了在终端里用，你还可以在 VS Code 里使用它。这通常是最方便的方式，因为不用离开编辑器，就能查看文件、修改代码、向它求助。

可以把 Claude Code 侧边栏想象成 VS Code 里的一个聊天窗口。你可以在同一个界面里边干活边提问、让它解释代码、请它帮忙。

如何打开 Claude Code 侧边栏

1. 打开 VS Code
2. 看向窗口最左侧
3. 如果还没看到 Claude Code 面板，点击 Extensions 图标
4. 在扩展市场里搜索 Claude Code
5. 如果还没安装，点击 Install
6. 安装完成后，在左侧边栏找到 Claude Code 图标

如果看不到 Claude Code 图标，可以试试这样做：

1. 按 Ctrl + Shift + P
2. 输入：Claude Code: Open Sidebar
3. 点击列表中对应的选项

如果还是没有出现，关掉 VS Code 再重新打开。有时扩展需要重启一次，侧边栏才会显示出来。

侧边栏能做什么

在 Claude Code 侧边栏里，你可以：

• 询问关于项目的问题
• 请它帮忙修复错误
• 让它解释看不懂的代码
• 创建或修改文件
• 不离开 VS Code，用更直观的方式工作

这样做的好处是，代码在编辑器里开着，同一个窗口里就能向 Claude 求助。

快速测试

侧边栏打开后：

• 输入：Explain this project to me
• 按 Enter

如果 Claude 回复了，就说明可以开始使用了。

提示：如果侧边栏还是不见踪影，请确认 Claude Code 扩展已经安装，并且已经重启过 VS Code。

步骤 4：连接 Anthropic 账户

选项 A. 使用 Claude Pro 或 Max 订阅

• 在 PowerShell 窗口里输入：

   claude
  

• Claude 会尝试打开浏览器。如果没能自动打开，按住 Ctrl 点击那一长串网址，或把网址复制到浏览器里打开
• 登录 Claude.ai 账户（用 Chrome 的话可能会自动登录）
• 点击 Authorize
• 看到一长串代码后，点击 Copy Code
• 回到终端窗口，右键单击后选择粘贴（或按 Ctrl+Shift+V）
• 看到成功提示后，按照提示完成后续设置

下面几种基于 API 的方式都在 PowerShell 里完成，用到的 setx 命令会把设置永久保存。运行 setx 之后，记得先关闭再重新打开 PowerShell 让设置生效，然后再启动 claude。

选项 B. 使用 Anthropic API 密钥

如果你用的是 Anthropic API 密钥，而不是 Claude 订阅：

• 先到 Anthropic Console 获取 API 密钥
• 在 PowerShell 里输入（把 your-api-key-here 换成你自己的密钥）：

   setx ANTHROPIC_API_KEY "your-api-key-here"
  

• 关闭并重新打开 PowerShell 让设置生效，然后启动 Claude Code：

   claude
  

选项 C. 使用 OpenRouter API（可免费开始！）

OpenRouter 是一个统一的 API 网关，用一个密钥就能访问 500 多种大语言模型。它按用量计费，还能在不同价位的模型之间挑选，是一种比较省钱的 Claude Code 使用方式。

• 在 openrouter.ai 注册并登录
• 点击 Get API key，把密钥复制到安全的地方
• 在 PowerShell 里设置好这些环境变量：

   setx ANTHROPIC_BASE_URL "https://openrouter.ai/api"
   setx ANTHROPIC_AUTH_TOKEN "your-openrouter-api-key"
   setx ANTHROPIC_API_KEY ""
   setx ANTHROPIC_DEFAULT_SONNET_MODEL "openai/gpt-5.1-codex-max"
   setx ANTHROPIC_DEFAULT_OPUS_MODEL "openai/gpt-5.2-pro"
   setx ANTHROPIC_DEFAULT_HAIKU_MODEL "minimax/minimax-m2:exacto"
  

• 关闭并重新打开 PowerShell，再启动 Claude Code：

   claude
  

• 在 Claude Code 里输入 /status，确认连接是否成功

注意：

• 把 your-openrouter-api-key 换成你自己的 OpenRouter API 密钥
• ANTHROPIC_API_KEY 必须明确设为空值
• 想换用其他模型，它们必须支持工具调用（tool use）功能。可以这样覆盖默认模型：

   setx ANTHROPIC_DEFAULT_SONNET_MODEL "model-provider/model-name"
  

• 可用模型可在 openrouter.ai/models 查看
• 免费套餐每天有 50 次 API 请求额度
• 更多细节见官方 OpenRouter 指南

选项 D. 通过 Azure Foundry 使用 Anthropic API

在 PowerShell 里粘贴下面这段代码，定义相应的环境变量：

# Enable Microsoft Foundry integration
setx CLAUDE_CODE_USE_FOUNDRY 1
# Azure resource name
setx ANTHROPIC_FOUNDRY_RESOURCE "xxxx-eastus2"
# Set models to your resource's deployment names
setx ANTHROPIC_DEFAULT_OPUS_MODEL "claude-opus-4-5"
setx ANTHROPIC_DEFAULT_SONNET_MODEL "claude-sonnet-4-5"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "claude-haiku-4-5"
setx ANTHROPIC_FOUNDRY_API_KEY "your_api_key"

注意：把 xxxx-eastus2 换成你的 Foundry Resource 名称（不要填完整的基础 URL）；把 your_api_key 换成你在 Azure 门户里拿到的完整 API 密钥。

然后关闭并重新打开 PowerShell，再启动 Claude Code：

claude

这样就可以用 Azure 上部署的 Claude 模型来运行 Claude Code 了。

步骤 5：测试 Claude Code

全部搞定！在 PowerShell 里输入 claude，随便问它点什么，比如”解释一下量子计算”。

步骤 6：访问项目

• 如果已经有项目文件夹，在 PowerShell 里切换到该目录：

   cd ~/Documents/test_claude
  

• 然后启动 Claude：

   claude
  

• 可以先让 Claude 帮你讲解整个代码库，也可以让它直接帮你改代码
• 再用你惯用的 IDE 测试代码

注意：Claude 在项目文件夹里运行，并把设置保存在其中——这个文件夹就是它的工作区。

步骤 7：（可选）安装 WSL2 以获得完整的 Linux 体验

对大多数人来说，上面的原生设置已经够用了。不过 Claude Code 在 Linux 下会跑得更顺：WSL2 能在 Windows 里运行真正的 Linux 系统，带来 Bash 工具沙盒（一项安全特性），也能和各种 Linux 工具链配合得更好。它配置更花时间，还要重启电脑，所以只有在你确实想要完整 Linux 体验时再做这一步。

a) 检查虚拟化并安装 WSL

先检查虚拟化是否已启用：

• 右键单击任务栏（屏幕最下方的那条栏），在菜单里点击任务管理器
• 如果打开的是精简窗口，点击底部的更多详细信息
• 依次点击顶部的性能选项卡和左侧的 CPU
• 找到虚拟化：那一行，看它是否显示已启用

如果显示”已禁用”：你需要进入电脑的 BIOS 设置开启虚拟化：

• 重启电脑，开机过程中按下进入 BIOS 的按键（通常是 F2、F10、Del 或 Esc，具体取决于电脑品牌）
• 找到”Virtualization Technology”、”Intel VT-x”、”AMD-V”或”SVM Mode”等相关选项并开启
• 保存并退出 BIOS（通常按 F10）

接下来安装 WSL：

• 点击 Windows 开始按钮，输入 PowerShell
• 右键单击 Windows PowerShell，选择以管理员身份运行
• 系统弹出”你要允许此应用对你的设备进行更改吗？”时，点击是
• 在 PowerShell 窗口里输入：

   wsl --install
  

• 你可能会看到”Installing: Windows Subsystem for Linux”“Installing: Ubuntu”之类的提示
• 安装完成后重启电脑

注意：wsl --install 需要 Windows 10 版本 2004 及以上，或 Windows 11。如果系统提示无法识别该命令，可能是你的 Windows 版本太旧了。

b) 设置 Ubuntu

电脑重启后，一个标题带有”Ubuntu”的终端窗口通常会在 2-5 分钟内自动弹出。如果没有，点击 Windows 开始按钮，输入 Ubuntu，再点击 Ubuntu 应用（橙色圆形图标）即可。

• 等待出现 Enter new UNIX username: 提示后，输入一个用户名（只用小写字母和数字，不要有空格），例如 john
• 看到 New password: 后，输入一个简单的密码（输入时屏幕不会显示任何字符，这是正常现象）
• 按提示再输入一次相同的密码

重要：记住这个用户名和密码，后面还会用到。

c) 在 WSL 中安装 Claude Code

• 在 Ubuntu 终端里输入：

   curl -fsSL https://claude.ai/install.sh | bash
  

• 输入以下命令验证：

   claude --version
  

• 输入 claude，按浏览器登录流程连接账户（和步骤 4 的选项 A 一样）。如果改用 API 密钥，则用 export ANTHROPIC_API_KEY="your-api-key-here" 来设置（WSL 里用的是 Linux 命令，而不是 setx）
• 要在 WSL 中打开 Windows 上的项目文件夹（把 Username 换成你实际的 Windows 用户名）：

   cd /mnt/c/Users/Username/Documents/test_claude
  

下一步

• 配置 VS Code：先按 VS Code Getting Started 指南操作，再用 Claude Code in VS Code (Windows) 把它和 Claude Code 连接起来
• 学习 Git 基础：用 Claude Code Git on Windows 给项目加上版本控制
• 动手做个项目：跟着 Writing a Research Paper with Claude Code 走一遍，看看 Claude Code 的实战效果

故障排除

第一步：运行 Claude Doctor

遇到问题时，先运行下面这条命令试试：

claude doctor

这个内置的诊断工具会检查你的安装，并报告常见问题。

找不到 Claude 命令（原生 Windows）

• 关闭并重新打开 PowerShell
• 重新运行一遍安装命令：

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

• 确认 PATH 环境变量里包含 Claude 的安装目录

“Please enable the Virtual Machine Platform Windows feature and ensure virtualization is enabled in the BIOS”

这个错误说明虚拟化还没开启：

• 在任务管理器里查看虚拟化是否已启用（参见上面可选的 WSL 部分）
• 如果是禁用状态，需要到电脑的 BIOS 里开启
• 开启后重启电脑，再次运行 wsl --install

“wsl –install” 不起作用

• 确认是以管理员身份运行的 PowerShell
• 确认系统是 Windows 10 版本 2004 及以上，或 Windows 11
• 先运行 wsl --update，再重新执行 wsl --install

重启后 Ubuntu 窗口未打开

• 点击 Windows 开始按钮，输入 Ubuntu，再点击 Ubuntu 应用手动打开

需要帮助？

• WSL 相关问题：Microsoft WSL Documentation
• Claude Code 相关问题：Claude Code GitHub

由 Steven Ge 创建于 2025 年 12 月 11 日。2026 年 6 月更新。