因为 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 ~
有安装了官方的Claude Code 包的话,还需要卸载掉,两者有冲突。
npm uninstall -g @anthropic-ai/claude-code
安装完之后,你就可以访问你的项目文件夹,并在该目录下的终端输入以下命令直接运行 Claude Code:
mkdir claude-test-demo cd claude-test-demo claude
运行后
使用国内包的用户
使用国内包的用户在终端执行claude之后,会跳到 Claude Code 镜像站上进行授权,所以记得先在镜像站官网登录。登录网址:https://h5ma.cn/bwz (没有账号就注册有一个,有就直接登录)
首次使用Claude Code时,系统会引导你完成订阅验证流程。
你需要通过自动弹出的浏览器窗口进行登录以验证订阅。请注意:此过程请勿使用代理网络,以确保验证顺利完成。
如果你是在远程服务器上操作,则需要手动复制终端中的链接,在本地浏览器中打开,并输入验证码来完成验证。
如果需要体验Claude code与订阅的话可以前往发送任意邮件到claudecode@163.com 获取,或访问https://h5ma.cn/bxa
验证完成后,将可以选择 Claude Code 的工作主题,并授权其访问当前目录下的文件。
之后就会来到正常的对话环境
到这里,恭喜您,Claude Code 已成功安装并部署完成!
最后感谢大家能够看到文章的最后,如果你觉得这篇文章对你有启发或者帮助,不妨点个关注,你的支持将是我最大的动力,谢谢!
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的安装与部署