Windows 安装配置 Claude Code 并接入中转教程

Claude Code 的教程大多默认你在 macOS 或 Linux 上，Windows 用户照着抄命令，经常卡在环境变量和 PATH 上。其实 Windows 上跑 Claude Code 早就没有障碍：原生 PowerShell 可以直接装，配两个环境变量就能接入 Zivv 中转按量计费。这篇从安装讲到接入，再把 Windows 特有的报错整理成对照表，照做即可。

安装前确认

Windows 10 或 11，PowerShell 可用
网络可以访问安装源
准备好 Zivv 的 API Key（注册后在控制台创建，sk- 开头）

本文所有命令默认在 PowerShell 里执行。分不清 PowerShell 和 CMD 的话：开始菜单搜「PowerShell」，或者装微软商店里的 Windows Terminal，它默认打开的就是 PowerShell。CMD 的环境变量语法完全不同，照抄本文命令会报错。

Claude Code 在 Windows 上有两条路：原生安装和 WSL。先讲原生，绝大多数人用原生就够了；WSL 适合本来就在 WSL 里开发的用户，文末单独说明。

第一步：安装 Claude Code

方式一：官方安装脚本（推荐）。打开 PowerShell 执行：

irm https://claude.ai/install.ps1 | iex

方式二：npm 安装。如果你已经装了 Node.js 18 及以上版本：

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

两种方式怎么选：没装过 Node 的直接用官方脚本，一条命令完事；已经有 Node 环境、习惯用 npm 管全局工具的用 npm 方式，后续升级一条 npm update -g 就行。两种方式装出来是同一个东西，但不要两种都装——两个版本抢 PATH 会出现「明明升级了版本号却没变」这类怪问题。

装完后关掉当前终端，重新开一个 PowerShell 窗口（让 PATH 生效），执行：

claude --version

能输出版本号说明安装成功。如果提示「无法将 claude 识别为 cmdlet」，先看下文报错对照表，多数是 PATH 没刷新。

另外建议装一个 Git for Windows：Claude Code 的部分能力依赖 Git 环境，装了体验更完整，这也是 Windows 开发的基础件。

第二步：配置环境变量接入 Zivv

Claude Code 通过两个环境变量决定请求发到哪里、用什么凭证。指向 Zivv 只需要：

ANTHROPIC_BASE_URL = https://zivv.pro
ANTHROPIC_AUTH_TOKEN = 你的 sk- Key

注意两点：Anthropic 协议的地址是根域名，不要画蛇添足加 /v1；变量名是 AUTH_TOKEN，不是 API_KEY，写错了会一直 401。

临时生效（当前窗口）

先用临时方式验证链路，PowerShell 中执行：

$env:ANTHROPIC_BASE_URL="https://zivv.pro"
$env:ANTHROPIC_AUTH_TOKEN="sk-your-key-here"
claude "用一句话解释什么是闭包"

能正常返回内容，说明安装和接入都通了。这种写法只对当前窗口有效，关掉就没了，适合先验证。

永久生效（推荐 setx）

验证通过后，把变量写进用户环境变量：

setx ANTHROPIC_BASE_URL "https://zivv.pro"
setx ANTHROPIC_AUTH_TOKEN "sk-your-key-here"

setx 有一个所有人都会踩一次的特性：它只对之后新开的窗口生效，当前窗口读不到。执行完必须关掉终端重开，再运行 claude 验证。也可以不用命令行，在「系统设置 → 高级系统设置 → 环境变量」里手动添加这两个用户变量，效果相同。

改完想确认变量到底有没有生效，新窗口里执行：

echo $env:ANTHROPIC_BASE_URL

输出 https://zivv.pro 即为生效。

多把 Key 与多项目

如果你同时有多把 Key（比如公司项目和个人项目分开计费），不建议都写进系统环境变量。更灵活的做法是给不同项目建启动脚本，进入项目时按需加载：

# work.ps1
$env:ANTHROPIC_BASE_URL="https://zivv.pro"
$env:ANTHROPIC_AUTH_TOKEN="sk-company-key"
claude

个人项目再建一个 personal.ps1 换另一把 Key。系统环境变量保持干净，切换身份就是换一个脚本，也避免了「误用公司 Key 跑个人任务」这类事故。注意这类脚本含有 Key，不要提交进 Git 仓库，记得加进 .gitignore。

第三步：日常使用

配置完成后，Windows 上的用法和其他平台完全一致：在项目目录打开 PowerShell 或 Windows Terminal，输入 claude 进入交互模式即可。VS Code 用户直接在内置终端里运行也没有任何区别。更多参数和进阶配置见 Claude Code 配置文档。

几个 Windows 侧的使用建议：

用 Windows Terminal 替代老式控制台窗口，长输出和中文渲染都更好
项目放在本地磁盘的普通目录，不要放在网盘、同步盘的实时同步目录里，同步进程的文件锁会干扰 Claude Code 改写文件
出现中文乱码时先检查终端编码是否为 UTF-8，这与 API 链路无关

如果之前用官方账号登录过 Claude Code，设置环境变量后请求会走环境变量指定的入口。想彻底确认，跑一次任务后到 Zivv 控制台看用量记录有没有增长——有增长就说明流量确实走了中转。

WSL 用户须知

如果你的代码和工具链都在 WSL（Ubuntu 等）里，就在 WSL 里装 Claude Code，别用 Windows 侧的安装。关键点是：WSL 是独立的 Linux 环境，Windows 的 setx 设置不会自动传进去，需要在 WSL 里单独配：

echo 'export ANTHROPIC_BASE_URL=https://zivv.pro' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN=sk-your-key-here' >> ~/.bashrc
source ~/.bashrc
claude --version

选哪边的原则很简单：项目文件在哪边，Claude Code 就装哪边。跨文件系统访问（在 Windows 侧读 WSL 里的项目，或反过来）性能差、路径问题多，尽量避免。

WSL 里的安装本身走 Linux 流程：装好 Node 后用 npm 安装，或使用官方 Linux 安装脚本，再按上面的 bash 写法配环境变量。Windows 侧和 WSL 侧可以共用同一把 Zivv Key，两边各配一遍即可；想分开统计用量，就各建一把 Key，控制台里一眼能看出哪边消耗多。

企业网络与代理

公司电脑常见的拦路虎是代理。典型症状：浏览器上网正常，但 claude 一直连接超时。PowerShell 里为当前窗口设置代理：

$env:HTTPS_PROXY="http://proxy.company.com:8080"

代理地址问网络管理员要，确认可用后同样可以用 setx 持久化。另一个常见坑是企业安全软件拦截 PowerShell 脚本，表现为安装脚本执行到一半静默退出——这种情况换 npm 方式安装通常能绕开，因为 npm 的安装行为在多数企业策略的白名单内。

Windows 常见报错对照表

报错 / 现象	原因	处理
无法将 claude 识别为 cmdlet	PATH 未刷新或未加入	重开终端；仍不行则检查安装目录是否在 PATH
禁止运行脚本 / 执行策略错误	PowerShell 执行策略限制	以当前用户放开：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
401 unauthorized	Key 错误，或用了 ANTHROPIC_API_KEY 变量名	换成 ANTHROPIC_AUTH_TOKEN，重新复制完整 Key
404 not found	Base URL 多写了 /v1 或写错域名	改回 https://zivv.pro
设置了变量但请求仍走官方	setx 后没有重开窗口	关闭所有终端窗口重开
Connection error / 超时	公司代理或防火墙拦截	配置代理环境变量或咨询网络管理员

排查时优先怀疑环境变量而不是网络：Windows 上九成的接入问题出在变量没生效、变量名拼错、终端没重开这三件事上，网络问题反而是少数。对照后仍解决不了的，把报错原文和错误码说明对一遍，基本都能定位。

为什么接中转而不是直连官方

对 Windows 个人开发者来说，接 Zivv 的直接收益有三个：不需要国际信用卡，人民币充值，汇率 ¥1 = $1；价格低至官方几折，重度使用差距非常明显；Claude MAX 分组基于订阅账号池调度，Claude Code 长任务几乎没有限速体感，不会写到一半被 rate limit 打断。限速问题的完整分析见 Claude Code 限速解决方案。

成本上可以粗算一笔账：按官方美元价加上汇率与手续费，重度使用一个月的 API 花销往往是中转价格的数倍；Zivv 按 ¥1 = $1 充值、按量扣费，同样的 Token 用量，账单是原来的几分之一。个人开发者省下的是钱，团队省下的还有对账的时间。

完整性检查清单

装完按这个清单过一遍，全部通过就是可用状态：

新开 PowerShell，claude --version 有输出
echo $env:ANTHROPIC_BASE_URL 输出 https://zivv.pro
claude "回复 OK" 能正常返回内容
控制台用量页能看到刚才这次请求的记录
重启电脑后重复第 2、3 步，仍然通过

第 5 步很多人省略，结果第二天开机发现变量没持久化，又白排查一轮。第 4 步则能确认请求真的走了 Zivv 而不是残留的官方登录态。清单全部通过后，这台机器的配置基本就可以长期不动了，后续只有换 Key 时需要再碰。

常见问题 FAQ

Q：必须装 WSL 才能用 Claude Code 吗？ A：不需要。现在原生 Windows 就能装能用，WSL 只是给本来就在 Linux 环境开发的人用的，不是前置条件。

Q：PowerShell 和 CMD 都可以吗？ A：推荐 PowerShell 或 Windows Terminal。CMD 设置环境变量的语法不同（set 命令），本文命令按 PowerShell 写。

Q：环境变量里放 Key 安全吗？ A：用户级环境变量只对当前 Windows 账号可见，日常够用。注意不要把 Key 写进代码仓库或截图外发，怀疑泄露就到控制台删掉重建。

Q：升级 Claude Code 会不会丢配置？ A：不会。环境变量存在系统里，与 Claude Code 版本无关。官方脚本安装的重跑一遍安装命令即可升级，npm 安装的执行 npm update -g 对应包名。

Q：怎么切换回官方账号？ A：删除这两个环境变量（或在系统设置里移除），重开终端即可恢复官方登录方式，两边随时互切。

Q：Windows 下能和 VS Code、Cursor 一起用吗？ A：可以。Claude Code 在任何终端里都能跑，包括 VS Code 内置终端；Cursor 的接入方法见 Cursor 接入教程，同一个 Zivv 账号建不同 Key 即可。

Q：公司电脑没有管理员权限能装吗？ A：可以。官方脚本和用户级环境变量都不需要管理员权限；npm 全局安装遇到权限问题时，改用官方脚本安装即可。

写在最后

Windows 上从零到跑通 Claude Code，实际只有三步：装（一条命令）、配（两个环境变量）、验（一句提问）。剩下的坑基本都集中在「setx 要重开窗口」和「变量名别写错」这两件事上。团队里 Windows 和 macOS 机器混用也不要紧：环境变量名完全相同，只是设置语法不同，内部文档写一份两系统对照即可。现在注册 Zivv 拿到 Key，十分钟内就能在 Windows 上把 Claude Code 稳定跑起来；团队多台机器统一接入的做法可以看团队模式。