国内如何安装和使用 Claude Code 的教程 - Windows用户篇

因为 Claude Code 本身并不支持 Windows 的文件系统，而 Windows 要运行 Claude Code 稍微复杂一些，需要借助在 WSL 上运行。

下面将教你学会如何在 Windows 上安装和部署 Claude Code 工具，如果你跟我一样是Mac电脑用户，开箱即用。 可以看这期内容：《国内如何使用安装 Claude Code的教程 - Mac篇》

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 [推荐]
1
https://vip.123pan.cn/1831946356/links/wsl.2.5.9.0.x64.msi
  • ARM64 WSL-2.5.9.0
1
https://vip.123pan.cn/1831946356/links/wsl.2.5.9.0.arm64.msi
  • ARM64_MicrosoftStore WSL-2.5.9.0
1
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 或者 通过以下命令安装：

1
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+）：

1
2
3
4
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 账号就⽤这个指令

1
2
cd ~
npm install -g @anthropic-ai/claude-code

B. 全局安装 Claude Code （这个是中转站的, 推荐）, 如果是中转站⽤户,选这个!

1
2
cd ~
npm install -g https://gaccode.com/claudecode/install --registry=https://registry.npmmirror.com

如果 GAC Claude Code 中转站用户，有安装了官方的Claude Code 包的话，还需要卸载掉，两者有冲突。

1
npm uninstall -g @anthropic-ai/claude-code

安装完之后，你就可以访问你的项目文件夹，并在该目录下的终端输入以下命令直接运行 Claude Code:

1
2
3
mkdir claude-test-demo
cd claude-test-demo
claude

运行后

使用中转站的用户（推荐）

没有 Claude Pro 或者 Max 账号的伙伴，在国内可以直接使用中转站。无需魔法，直接可用，也不会封号。

GAC Claude Code 中转站 注册 和 兑换码 获取：https://chatshare.cc

月卡

推荐使用 Claude Code 的中转站，比较划算，可以在下面获取对应的试用兑换码。 关于更详细的积分说明，可以看我上一篇内容：《国内如何使用安装 Claude Code 以及 GAC Claude Code 直连镜像的兑换码获取方式》

对 WSL 使用的一些说明

如果你是首次使用 WSL，可以在弹出的 “欢迎使用WSL” 页面了解帮助，你也可以在 【WSL设置】 中找到入口。

WSL 不只是命令行版本的Linux操作系统，它是有对应的桌面环境的！

如果你使用的IDE编程工具是VSCode、Cursor之类的，可以使用VSCode的WSL插件，链接并使用你的WSL。

安装完插件之后，使用 code . 启动VSCode，这样启动可以使用 Claude Code IDE 插件。

灵活使用方法有很多种，你也可以单独直接在IDE上开启终端，执行你的 Claude Code 都行！

恭喜您！您已经完成了 Claude Code的安装与部署