在国内环境下通过 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 的强大能力了 🚀 赶紧动手试试吧！