Claude Code for Windows 当前不受支持,但您可以通过 WSL 在 Windows 上部署:
- WSL(Windows Subsystem for Linux),微软开源的 Linux on Windows 框架。
- 由于 Claude Code 并不支持 Windows 的文件系统,您不能在 Windows 的文件系统内部署。建议您的操作均基于 WSL 安装的虚拟操作系统(如 Ubuntu 24.04 LTS)

安装 WSL,必须满足以下要求:
- Windows 11 Pro/Workstation/Enterprises(非家庭版,需支持 Hyper-V)
- 已在 BIOS/UEFI 中启用虚拟化
- 安装最新版 WSL:https://github.com/microsoft/WSL/releases 下载 wsl 最新版
Claude Code 安装
第一步:启用虚拟化核心组件
1. 按下 Win 键,搜索 控制面板,在控制面板中选择 启用或关闭 Windows 功能

2. 在Windows 功能界面,勾选以下两项(必须重启电脑):
✅ 虚拟机平台
✅ 适用于 Linux 的 Windows 子系统

3:强制启用虚拟化功能
在管理员模式下打开 PowerShell 或 Windows 命令提示符输入以下命令
dism.exe /Online /Enable-Feature /FeatureName:VirtualMachinePlatform /All
上述步骤完成后,如果 bug 未有消失,请继续下一步操作:
三个必要检查点:
- BIOS 中启用虚拟化技术(Intel VT-x/AMD-V)
- 使用管理员权限运行 PowerShell
- 确保系统盘剩余空间≥5GB
经实际验证,Windows 11 21H2 存在 Hyper-V 虚拟化栈 兼容性问题,升级到 23H2 版本可彻底解决该错误。(Windows 11 某些版本可能存在兼容性问题):
- 打开 Windows Update 设置
- 选择 检查更新
第二步:使用 WSL 在上安装 Linux
现在,可以使用单个命令安装运行 WSL 所需的所有内容。右键单击并选择“以管理员身份运行”,在 管理员 模式下打开 PowerShell 或 Windows 命令提示符,输入 wsl --install 命令,然后重新启动计算机。
wsl --install
此命令将启用运行 WSL 并安装 Linux 的 Ubuntu 分发所需的功能。重启电脑打开 Ubuntu 应该就没有问题了。接下来会让您输入账号密码以及确认密码,自行设置即可。
默认情况下,已安装的 Linux 分发版将为 Ubuntu。可以通过使用 -d
标志来更改这一点。
- 若要更改安装的分发版,请输入:
wsl --install -d <Distribution Name>
将<Distribution Name>
替换为您想要安装的分发版名称。 - 若要查看可通过在线商店下载的可用 Linux 分发版的列表,请输入:
wsl --list --online
或wsl -l -o
。 - 若要在初始安装后安装其他 Linux 分发版,也可以使用以下命令:
wsl --install -d <Distribution Name>
第三步:安装 Claude Code
打开一个新的 CMD 命令窗口,切换为 Ubuntu 系统的命令窗口

输入 sudo -i 命令,然后输入设置的用户密码,切换为 root 用户进行下一步的操作

在进入 Linux 环境 (Ubuntu) 后,您可以通过以下命令安装 Node.js 和 npm
Bash
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt-get install -y nodejs
node --version
npm --version
如果您已经安装 Node.js,请确保版本为 18.0 或更高版本的要求。确保您的 npm 与 Node.js 可用后,请您通过以下命令安装代理的 Claude Code:
Bash
#使用国内镜像源安装
npm install -g @anthropic-ai/claude-code
#检查是否成功安装
claude --version
如果您先前安装过 Claude Code,请您先通过以下命令卸载
Bash
npm uninstall -g @anthropic-ai/claude-code
如果安装时出现 WSL 报错 类似

这种报错 请先执行以下代码再安装
Bash
setx NPM_CONFIG_IGNORE_SCRIPTS true
第四步:获取 API Key 令牌
登录中转 API 平台:https://wolfai.top,平台按量扣费并赠送体验额度,其中 User 分组为 Claude code 渠道,支持 Claude 全模型,不降智,速度快;
获取 Auth Token:注册后在 API 令牌
页面点击 添加令牌
获得(以 sk-
开头)名称随意,额度建议设为无限额度,有效期选择永不过期

注意:令牌分组必须选择 User 分组 , 其他保持默认设置,最后点击提交,就获得了你的 API Key 令牌,直接复制使用即可。

第五步:API 接入 Claude Code
在您的项目目录下运行代码:其中替换 sk-...
为您上一步生成的 API 令牌:API 地址: ANTHROPIC_BASE_URL
:https://wolfai.top 就是平台的网站首页地址
export ANTHROPIC_AUTH_TOKEN=sk-...
export ANTHROPIC_BASE_URL=https://wolfai.top
claude
在这之后,您需要选择主题、允许使用 Bash 和当前所在目录。
- 选择你喜欢的主题 + Enter
- 确认安全须知 + Enter
- 使用默认 Terminal 配置 + Enter
- 信任工作目录 + Enter
恭喜您!您已经完成了 Claude Code 的安装与部署🎉🎉🎉
为避免每次重复输入,可以将配置写入环境文件:
echo "export ANTHROPIC_AUTH_TOKEN=sk-…" >> ~/.bashrc
echo "export ANTHROPIC_BASE_URL=https://wolfai.top" >> ~/.bashrc
source ~/.bashrc
配置完成后,您可以访问您的项目文件夹,并在该目录下的终端输入以下命令直接运行 Claude Code
cd your-project-folder
claude
VS Code 集成 Claude code 方法
打开 VS Code 客户端在扩展商店里搜索 WSL(注意该插件有些地区需要梯子才能安装)
之后打开终端,新建 Ubuntu(WSL) 命令窗口

输入命令 claude
如果发现请求无效,ctrl+ c 退出先,执行下列命令(其中替换 sk-...
为您上一步生成的 API 令牌)
# 设置 api 中转接入
export ANTHROPIC_BASE_URL="https://wolfai.top"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
claude
至此安装完毕!!!当你使用 Claude code 之前,需要先创建或打开项目目录!!!

- 验证您的安装,在打开 Claude Code 后输入以下命令将会为当前目录下的项目生成
Claude.md
/init