因为 Claude Code 本身并不支持 Windows 的文件系统，而 Windows 要运行 Claude Code 稍微复杂一些，需要借助在 WSL 上运行。
下面将教你学会如何在 Windows 上安装和部署 Claude Code 工具。
什么是WSL？
WSL（Windows Subsyetem for Linux，适用于 Linux 的 Windows 子系统），是 Microsoft 公司于 2016 年在 Windows 10 平台发布的一项功能，其使得用户可以在 Windows 操作系统上运行 ELF 格式的 Linux 可执行文件。
Claude Code 在 WSL 上部署
安装WSL，必须满足以下要求：
- Windows 11 或 Windows 10 21H2以上，专业版/工作站版/企业版（非家庭版，需支持Hyper-V）
- CPU 需支持且已在 BIOS/UEFI 中启用虚拟化
（1）按照以下步骤安装WSL：
安装之前需要打开虚拟化，否则过程会出现未知的错误。
打开路径：控制面板 -> 程序与功能 -> 打开或关闭 Windows 功能 启动以下功能：
- Virtual Machine Platform（虚拟机平台）
- Windows Subsystem for Linux Support（WSL1）
下载和安装对应版本的 WSL， 选择您的系统版本，复制到浏览器进行下载 WSL 安装包:
- 64-Bit WSL-2.5.9.0 [推荐]
https://vip.123pan.cn/1831946356/links/wsl.2.5.9.0.x64.msi
- ARM64 WSL-2.5.9.0
https://vip.123pan.cn/1831946356/links/wsl.2.5.9.0.arm64.msi
- ARM64_MicrosoftStore WSL-2.5.9.0
https://vip.123pan.cn/1831946356/links/Microsoft.WSL_2.5.9.0_x64_ARM64.msixbundle
你也可以不用上面的安装包，直接访问 GitHub 安装最新的版本：
https://github.com/microsoft/WSL/releases
（2）安装虚拟机：
安装完WSL之后，你可以在微软应用商店中安装最新的Ubuntu 24.04 LTS 或者 通过以下命令安装：
wsl --install -d Ubuntu-24.04
你也可通过 wsl -l -o 命令选择其他系统版本。
安装完 Ubuntu 之后，你可以在终端（或PowerShell）输入wsl访问安装的操作系统：
- 首次用需要设置用户名和密码：
如果您通过开始菜单的应用访问一次，直接关闭窗口而不输入用户名和密码，下次访问将使用root用户
- Windows将安装的操作系统虚拟机视作一个应用，如Ubuntu 24.04 LTS 会出现在你的开始菜单
（3）Claude Code 安装
Claude Code 是用 Node.js 开发的，所以依赖 Node.js 环境，可以通过以下方式安装对应的环境（Node.js 18+）：
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash - sudo apt-get install -y nodejs node --version npm --version
确保你的npm与 Node.js可用后，通过以下命令安装Claude Code。
Claude Code 包 二选一：
A. 全局安装 Claude Code （这个是官⽅的）, 你有官⽅Claude Pro 账号就⽤这个指令
cd ~ npm install -g @anthropic-ai/claude-code
B. 全局安装 Claude Code （这个是中转站的）, 如果是中转站⽤户,选这个!
cd ~ npm install -g https://gaccode.com/claudecode/install --registry=https://registry.npmmirror.com
如果 GAC Claude Code 中转站用户，有安装了官方的Claude Code 包的话，还需要卸载掉，两者有冲突。
npm uninstall -g @anthropic-ai/claude-code
安装完之后，你就可以访问你的项目文件夹，并在该目录下的终端输入以下命令直接运行 Claude Code:
mkdir claude-test-demo cd claude-test-demo claude
运行后
使用中转站的用户
没有 Claude Pro 或者 Max 账号的伙伴，在国内可以直接使用中转站。
Claude code镜像使用指南：https://h5ma.cn/bxa
Claude code镜像权限获取：http://h5ma.cn/gaccode
安装过程出现的问题，都可以在发送任意邮件到ClaudeCode@163.com获取帮助，实时更新。
对 WSL 使用的一些说明
如果你是首次使用 WSL，可以在弹出的 “欢迎使用WSL” 页面了解帮助，你也可以在 【WSL设置】 中找到入口。
WSL 不只是命令行版本的Linux操作系统，它是有对应的桌面环境的！
如果你使用的IDE编程工具是VSCode、Cursor之类的，可以使用VSCode的WSL插件，链接并使用你的WSL。
安装完插件之后，使用 code . 启动VSCode，这样启动可以使用 Claude Code IDE 插件。
灵活使用方法有很多种，你也可以单独直接在IDE上开启终端，执行你的 Claude Code 都行！
恭喜您！您已经完成了 Claude Code的安装与部署 🎉🎉🎉
