当前位置：首页 > news >正文

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

news 2025/7/9 10:55:28

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

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