快速摘要： 在 Windows 上安装 Claude Code 需要设置 WSL2（Windows Subsystem for Linux），安装 Ubuntu，并运行一个简单的安装脚本。该过程允许 Windows 用户通过他们的终端访问 Anthropic 的 AI 编码助手。虽然有适用于 Windows 的原生二进制文件，但 WSL2 仍然是在 Windows 上安装的最佳实践。
Claude Code 是一款 AI 驱动的编码助手，可直接在终端中运行，帮助开发人员构建功能、修复 bug 和自动化开发任务。但对于 Windows 用户来说，有一个需要注意的地方。
Claude Code 可作为 Windows 原生可执行文件提供，并且可以通过 npm 或直接二进制文件下载安装，无需 WSL2。但是，它需要 Linux 的 Windows 子系统 (WSL2)，并且官方安装方法仍然依赖于 WSL2。
以下是在 Windows 11 或 Windows 10 上运行它的方法。
系统要求
在开始安装之前，请验证 Windows 机器是否满足以下要求：
- Windows 10 1809+ 或 Windows Server 2019+
- Windows 11 (任何版本)
- 至少有 4GB 可用 RAM
- 系统管理员权限
- 用于下载 WSL2 和 Ubuntu 的 Internet 连接
安装需要 WSL2、Ubuntu 和 Claude Code 的磁盘空间。
步骤 1：启用 Linux 的 Windows 子系统
WSL2 在 Windows 中直接提供了一个 Linux 环境。它是 Claude Code 运行的基础。
以管理员身份打开 PowerShell。在 Windows 11 上，右键单击“开始”按钮，然后选择“Windows PowerShell (管理员)”或“终端 (管理员)”。
运行以下命令：
wsl --install
此命令会启用必要的 Windows 功能，并安装 Ubuntu 作为默认的 Linux 发行版。系统可能会提示您重启。
重启后，WSL2 会自动完成设置。Ubuntu 会启动并要求您输入用户名和密码。这些凭据仅用于 Linux 环境，不需要与 Windows 凭据匹配。
步骤 2：验证 WSL2 安装
系统重启并完成 Ubuntu 的初始设置后，请验证 WSL2 是否正常运行。
打开 Ubuntu 终端（在开始菜单中搜索“Ubuntu”）并运行：
wsl --version
这将显示 WSL 版本信息。在输出中查找“WSL version: 2.x.x”。
如果命令显示的是 WSL1，请使用以下命令升级到 WSL2：
wsl --set-default-version 2
步骤 3：安装 Claude Code
现在是实际安装 Claude Code 的时候了。官方文档提供了一个单行安装脚本。
在 Ubuntu 终端中运行：
curl -fsSL claude.ai/install.sh | bash
该脚本会下载 Claude Code 二进制文件，设置必要的权限，并将其添加到系统 PATH。安装时间因网速和系统规格而异。
根据官方 Claude Code 文档，安装程序会自动检测系统架构并下载相应的二进制文件版本。
常见安装问题
一些 Windows 用户报告在安装后看到“command not found: claude”的错误。这通常是因为 PATH 变量尚未刷新。
关闭并重新打开 Ubuntu 终端，然后重试。如果问题仍然存在，以下路径配置可能有助于解决此非官方的临时问题：
echo 'export PATH="$HOME/.claude/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
步骤 4：认证 Claude Code
Claude Code 在使用前需要使用 Anthropic 账户进行认证。
运行以下命令：
claude
终端会显示一个 URL 并要求进行认证。个人用户和团队账户的流程略有不同：
| 账户类型 | 认证方法 | 所需内容 |
|---|---|---|
| 个人 | 个人 API 密钥 | 具有 API 访问权限的 Anthropic 账户 |
| 团队/组织 | 组织令牌 | 管理员提供的认证令牌 |
在浏览器中打开提供的 URL，登录 Anthropic 账户，然后授权 Claude Code。终端会确认认证成功。
在 WSL2 中处理 Windows 项目
这里情况会变得棘手。Windows 文件系统和 WSL2 文件系统是独立的。
Windows 文件可以通过 /mnt/c/（用于 C: 驱动器）、/mnt/d/（用于 D: 驱动器）等从 WSL2 访问。但会有性能损耗。社区讨论表明，在 Windows 挂载的目录和原生 WSL2 目录之间存在性能差异。
为了获得最佳性能，请将项目文件复制到 WSL2 的主目录中：
cp -r /mnt/c/Users/YourName/Projects/your-project ~/projects/your-project
权衡是什么？IDE 集成变得更加复杂。Visual Studio Code 通过其 Remote-WSL 扩展可以很好地处理这一点，但其他 IDE 可能会遇到困难。
测试安装
通过一个简单的测试来验证 Claude Code 是否正常工作。
导航到项目目录（或创建一个测试文件夹）：
mkdir ~/claude-test
cd ~/claude-test
claude "create a simple hello world Python script"
Claude Code 应该会响应，创建文件并显示代码。这确认了安装成功。
停止过度支付，先领取可用的 AI 积分
在 Windows 上安装 Claude Code 通常很快。真正的成本出现在开发者开始测试提示、运行脚本和将模型集成到应用程序之后。这种实验阶段可能会产生大量的 API 调用，许多团队在开始构建后才意识到成本。
在花费金钱用于使用之前，值得检查您是否符合 AI 积分或合作伙伴计划的资格。Get AI Perks 将这些机会汇集在一起，列出了来自 AI 提供商、云平台和开发工具的积分和折扣，以及如何领取它们的简单说明。
在运行您的第一个 Claude Code 项目之前，请访问 Get AI Perks 并领取可覆盖您开发成本的 AI 积分。
常见问题解答
Claude Code 可以原生运行在 Windows 上而无需 WSL2 吗？
是的，但 WSL2 仍然是在 Windows 上安装的最佳方法。
Claude Code 是否支持 Windows Terminal？
是的。Windows Terminal 可以打开 Ubuntu 标签页，从而无需切换到单独的 Ubuntu 窗口即可访问 Claude Code。在 Windows Terminal 中，单击下拉箭头，然后从配置文件列表中选择 Ubuntu。
我现有的 Windows 开发工具是否与 Claude Code 兼容？
这取决于工具。Visual Studio Code 通过 Remote-WSL 扩展可以很好地集成。JetBrains IDEs 和其他工具可能需要额外的配置。官方文档提到了 VS Code 和 JetBrains 作为支持的平台。
如何在 Windows 上更新 Claude Code？
Claude Code 默认会自动更新。要手动更新，请在 Ubuntu 终端中运行 `claude update`。在企业环境中，如果需要，可以通过配置文件禁用自动更新功能。
Claude Code 和 Claude API 有什么区别？
Claude Code 是一个基于终端的编码助手，用于执行命令和编辑文件。Claude API 为构建自定义应用程序提供了对 Claude 语言模型的编程访问。它们有不同的用途，需要不同的设置过程。
我可以在 Windows 上将 Claude Code 与 .NET 项目一起使用吗？
是的，但有一些注意事项。社区讨论表明，WSL2 中的 .NET SDK 支持可用，但需要在 Ubuntu 中安装 Linux 版本的 .NET SDK。从 WSL2 无法访问在 Windows 中安装的 .NET。
Claude Code 的费用是多少？
定价取决于使用情况和账户类型。请查阅 Anthropic 官方网站了解当前定价层级和团队计划，因为成本因 API 消耗量和组织要求而异。
安装后的下一步
安装 Claude Code 后，开始探索其功能。快速入门文档建议从简单的任务开始，例如代码解释，然后再进行更复杂的操作。
尝试以下命令来熟悉它：
- claude "explain this function" -- 获取代码解释
- claude commit -- 生成 Git commit 消息
- claude -c -- 继续最近的对话
官方文档提供了关于 IDE 集成、插件安装和高级配置选项的详细指南。对于团队而言，服务器管理设置和分析跟踪提供了对 Claude Code 部署的额外控制。
与原生 Windows 应用程序相比，WSL2 的设置可能看起来需要额外的步骤，但它目前是在 Windows 上运行 Claude Code 的唯一途径。好消息是？一旦配置完成，它运行起来就很顺畅，并且可以与大多数开发工作流集成。
