在国内环境下通过 WSL 部署 Claude Code 全流程指南【2025 最新】
# 在WSL上部署Claude Code:超详细指南(2025最新)
# 🚀 为什么选择在WSL上部署Claude Code?
Claude Code 官方推荐在 Ubuntu / MacOS 上使用,但如果您是 Windows 用户,也完全可以通过 WSL(Windows Subsystem for Linux)在 Windows 10/11 上轻松部署。
- 借助WSL,您可以无缝在Windows上运行原生Linux,避免兼容性问题。
- 使用WSL可以让您体验更接近Linux服务器的开发环境。
- 配合 VSCode WSL插件,开发效率直接拉满!
# 📝 安装WSL之前需要准备什么?
✅ 系统要求:
- Windows 11 或 Windows 10 21H2 以上版本(推荐专业版/企业版,需支持Hyper-V)
- CPU 必须支持并在 BIOS/UEFI 中开启虚拟化
✅ 基础技能:
- 熟悉常见的Linux命令行操作(不会也没关系,ChatGPT可以随时帮您)
# ⚙️ WSL安装详细步骤
# 1️⃣ 启用所需的Windows功能
在 控制面板 → 程序和功能 → 启用或关闭Windows功能
中,勾选以下选项:
- ✅ Virtual Machine Platform(虚拟机平台)
- ✅ Windows Subsystem for Linux(WSL1支持)
# 2️⃣ 安装WSL核心
您可以从Github官方WSL仓库 (opens new window)下载最新版,也可用以下推荐安装包:
# 3️⃣ 安装Linux发行版
我们推荐 Ubuntu 24.04 LTS(最新LTS版):
wsl --install -d Ubuntu-24.04
- 如果想看还有哪些可选系统:
wsl -l -o
安装完成后,首次进入需要设置用户名和密码(如果直接关闭窗口,WSL会默认为root)。
在Windows开始菜单里,Ubuntu会显示为一个应用,随时可点击进入。
# 🚀 部署Claude Code
# 4️⃣ 安装Node.js(Claude Code依赖Node.js)
Claude Code 需要 Node.js >= 18,我们推荐直接安装22版本:
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt-get install -y nodejs
验证安装:
node --version
npm --version
# 5️⃣ 安装Claude Code
🌟 Claude Code 已在中国区镜像(npmmirror)上提供代理,无需担心速度问题。
cd ~
npm install -g https://gaccode.com/claudecode/install --registry=https://registry.npmmirror.com
检查版本:
claude --version
🔁 如果您之前安装过旧版Claude Code,请先卸载:
npm uninstall -g @anthropic-ai/claude-code
# 🚀 开始使用Claude Code
在您的项目文件夹中执行:
mkdir test
cd test
claude
首次运行需要登录授权,浏览器会自动打开,按提示完成验证。
- 重要:请关闭代理再登录!
- 如果是在远程服务器,会生成一个命令行链接,您可用本地浏览器访问后输入验证码。
可以通过以下链接管理账户和订阅:
接着,选择主题,允许访问文件夹即可开箱即用 🎉
# ⚡ WSL使用高级建议
✅ 配合VSCode WSL插件使用:
- 安装VSCode WSL插件 (opens new window),在Linux环境中输入
code .
,就可直接用VSCode开发。
✅ 推荐WSL设置:
在WSL设置(Windows开始菜单可搜索“WSL设置”)里:
- 网络 > 网络模式 = Mirrored(共享本地端口与IP)
- 网络 > 已启用自动代理 = 打开(仅在您清楚如何配置代理时)
✅ 文件互通:
- Windows磁盘可通过
/mnt/
访问:
cd /mnt/c/Users/你的用户名
- 在Windows文件管理器里可通过
\\wsl.localhost\Ubuntu-24.04\
访问Linux文件。
📢 注意: 不要跨文件系统(WSL ↔ Windows)直接运行程序文件,容易引发奇怪bug。
# 🎯 小结:一分钟回顾部署流程
✅ 启用虚拟机平台 & WSL
✅ 安装WSL和Ubuntu 24.04
✅ 安装Node.js >= 18
✅ 使用npm安装Claude Code
✅ claude
启动,浏览器登录验证
✅ 搭配VSCode WSL插件高效开发
💡 如果遇到任何问题,随时来问 ChatGPT 或直接复制错误信息进行提问。
这样,您就可以在 Windows 上畅快体验 Claude Code 的强大能力了 🚀 赶紧动手试试吧!