最新实战，国内如何安装和使用Claude Code 教程！

因为 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//links/wsl.2.5.9.0.x64.msi

ARM64 WSL-2.5.9.0

https://vip.123pan.cn//links/wsl.2.5.9.0.arm64.msi

ARM64_MicrosoftStore WSL-2.5.9.0

https://vip.123pan.cn//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 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与订阅的话可以前往发送任意邮件到 获取，或访问https://h5ma.cn/bxa

验证完成后，将可以选择 Claude Code 的工作主题，并授权其访问当前目录下的文件。

之后就会来到正常的对话环境

到这里，恭喜您，Claude Code 已成功安装并部署完成！

最后感谢大家能够看到文章的最后，如果你觉得这篇文章对你有启发或者帮助，不妨点个关注，你的支持将是我最大的动力，谢谢！

Claude code镜像使用指南：https://h5ma.cn/bxa

Claude code镜像权限获取：http://h5ma.cn/gaccode

安装过程出现的问题，都可以在发送任意邮件到获取帮助，实时更新。

对 WSL 使用的一些说明

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

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

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

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

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

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