在国内环境下通过 WSL 部署 Claude Code 全流程指南【2025 最新】

2025/6/30 Claude CodeWSLWindows 本地化Ubuntu 24.04 LTSVSCode

# 在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插件使用

推荐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 的强大能力了 🚀 赶紧动手试试吧!