Windows部署 Claude Code 第三方API接入教程

浏览:23次阅读
没有评论

Claude Code for Windows 当前不受支持,但您可以通过 WSL 在 Windows 上部署:

  • WSL(Windows Subsystem for Linux),微软开源的 Linux on Windows 框架。
  • 由于 Claude Code 并不支持 Windows 的文件系统,您不能在 Windows 的文件系统内部署。建议您的操作均基于 WSL 安装的虚拟操作系统(如 Ubuntu 24.04 LTS)
Windows部署 Claude Code 第三方API接入教程插图

安装 WSL,必须满足以下要求:

  • Windows 11 Pro/Workstation/Enterprises(非家庭版,需支持 Hyper-V
  • 已在 BIOS/UEFI 中启用虚拟化
  • 安装最新版 WSL:https://github.com/microsoft/WSL/releases 下载 wsl 最新版

Claude Code 安装

第一步:启用虚拟化核心组件

1. 按下 Win 键,搜索 控制面板,在控制面板中选择 启用或关闭 Windows 功能

Windows部署 Claude Code 第三方API接入教程插图1

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

Windows部署 Claude Code 第三方API接入教程插图2

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 某些版本可能存在兼容性问题)

  1. 打开 Windows Update 设置
  2. 选择 检查更新

第二步:使用 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 系统的命令窗口

Windows部署 Claude Code 第三方API接入教程插图3

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

Windows部署 Claude Code 第三方API接入教程插图4

在进入 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 报错   类似

Windows部署 Claude Code 第三方API接入教程插图5

这种报错   请先执行以下代码再安装

Bash
setx NPM_CONFIG_IGNORE_SCRIPTS true

第四步:获取 API Key 令牌

登录中转 API 平台:https://wolfai.top,平台按量扣费并赠送体验额度,其中 User 分组为 Claude code 渠道,支持 Claude 全模型,不降智,速度快;

获取 Auth Token:注册后在 API 令牌 页面点击 添加令牌 获得(以 sk- 开头)名称随意,额度建议设为无限额度,有效期选择永不过期

Windows部署 Claude Code 第三方API接入教程插图6

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

Windows部署 Claude Code 第三方API接入教程插图7

第五步: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) 命令窗口

Windows部署 Claude Code 第三方API接入教程插图8

输入命令 claude

如果发现请求无效,ctrl+ c 退出先,执行下列命令(其中替换 sk-... 为您上一步生成的 API 令牌)

# 设置 api 中转接入
export ANTHROPIC_BASE_URL="https://wolfai.top"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
claude

至此安装完毕!!!当你使用 Claude code 之前,需要先创建或打开项目目录!!!

Windows部署 Claude Code 第三方API接入教程插图9
  • 验证您的安装,在打开 Claude Code 后输入以下命令将会为当前目录下的项目生成Claude.md
/init
正文完
 0
评论(没有评论)