Windows 系统安装与使用 Claude Code 全攻略

Claude Code 作为一款高效的 AI 编程辅助工具，深受开发者青睐，但由于其本身不支持 Windows 文件系统，在 Windows 系统上使用需要借助 WSL（适用于 Linux 的 Windows 子系统）。下面为你详细介绍在 Windows 系统上安装和使用 Claude Code 的完整流程。

什么是 WSL

WSL（Windows Subsystem for Linux，适用于 Linux 的 Windows 子系统）是微软于 2016 年在 Windows 10 平台发布的功能，它能让用户在 Windows 操作系统上运行 ELF 格式的 Linux 可执行文件，为在 Windows 上运行原本不支持该系统的程序提供了便利。

安装前的准备

在安装 WSL 进而部署 Claude Code 之前，需要满足一些前置条件：

• 系统版本：Windows 11 或 Windows 10 21H2 以上，且必须是专业版、工作站版或企业版（非家庭版，因为需要支持 Hyper-V）。
• CPU 要求：CPU 需支持虚拟化技术，并且已在 BIOS/UEFI 中启用虚拟化功能，否则安装过程中可能会出现未知错误。

安装步骤

步骤一：安装 WSL

1. 开启相关功能：打开控制面板，依次进入 “程序与功能”“打开或关闭 Windows 功能”，启动 “Virtual Machine Platform（虚拟机平台）” 和 “Windows Subsystem for Linux Support（WSL1）” 这两个功能。
2. 下载 WSL 安装包：根据自己的系统版本选择对应的安装包，复制链接到浏览器进行下载。推荐 64 位的 WSL-2.5.9.0 版本，下载链接为vip.123pan.cn/1831946356/…；ARM64 版本的下载链接为vip.123pan.cn/1831946356/…；ARM64_MicrosoftStore 版本的下载链接为vip.123pan.cn/1831946356/…。也可以直接访问 GitHub安装最新版本。
3. 运行安装包：下载完成后，运行安装包，按照提示完成 WSL 的安装。

步骤二：安装虚拟机

安装完 WSL 后，可以在微软应用商店中安装最新的 Ubuntu 24.04 LTS，也可以通过以下命令安装：

wsl --install -d Ubuntu - 24.04

也可以通过wsl -l -o命令选择其他系统版本进行安装。安装完成后，在终端（或 PowerShell）输入wsl即可访问安装的操作系统，首次使用需要设置用户名和密码。如果通过开始菜单的应用访问一次后直接关闭窗口而不输入用户名和密码，下次访问将使用 root 用户。

步骤三：安装 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命令检查 Node.js 和 npm 是否可用。

接下来安装 Claude Code 包，根据自身情况二选一：

• A. 全局安装官方 Claude Code：如果你有官方 Claude Pro 账号，使用以下命令：

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

• B. 全局安装中转站 Claude Code：如果是中转站用户，选择这个：

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

如果是 Claude Duck 中转站用户，且已经安装了官方的 Claude Code 包，需要先卸载，两者有冲突，卸载命令如下：

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

步骤四：运行 Claude Code

安装完成后，访问项目文件夹，在该目录下的终端输入以下命令即可运行 Claude Code：

mkdir claude - test - demo
cd claude - test - demo
claude

相关说明

• 没有 Claude Pro 或者 Max 账号的用户，在国内可以直接使用中转站，Claude code 镜像使用指南可参考swjqc4r0111.feishu.cn/docx/CJT6db…
• 安装过程中出现问题，都可以发送任意邮件到 ClaudeCode@163.com 获取帮助，相关信息会实时更新。
• 首次使用 WSL 的用户，可以在弹出的 “欢迎使用 WSL” 页面了解帮助，也可以在【WSL 设置】中找到入口。
• WSL 不仅是命令行版本的 Linux 操作系统，它有对应的桌面环境。
• 如果使用的 IDE 编程工具是 VSCode、Cursor 之类的，可以使用 VSCode 的 WSL 插件，链接并使用 WSL。安装完插件之后，使用code .启动 VSCode，这样可以使用 Claude Code IDE 插件。