很多人第一次装 Claude Code 都卡在同一堆坑上：官方要科学上网、要一张能付美元的信用卡、账号还动不动被判风控掉登录态；好不容易装好了，命令行里一堆 node 不是内部或外部命令、401 Missing API Key、ExecutionPolicy 报红，Windows 用户尤其难受——大部分教程都是 Mac 截图，反斜杠路径、环境变量残留、PowerShell 执行策略这些 Windows 独有的问题一句都不提。
这篇就把 Windows 系统从零开始，一路装到能在命令行里正常跟 Claude Code 对话讲透。做法是：本地照常装官方的 Claude Code 客户端，但把它的后端接口地址换成国内可直连的 apipifa 中转——不用翻墙、用人民币充值、一份 Key 就能跑 Claude + GPT/Codex + Grok 全套模型，走的是正规的第三方 API 服务，不碰官方账号登录态，也就不掺和官方那套封号风控。
全程保姆级编号步骤，配好每一段该敲的命令和该改的文件。跟着走，30 分钟内让 Windows 上的 Claude Code 跑起来。
说明：apipifa 是正规的人民币 API 中转服务，原生兼容 OpenAI / Anthropic 协议。本文教的是「合法接入第三方 API 服务」，不是破解或白嫖 OpenAI/Anthropic 官方账号。
Claude Code 本身是 Anthropic 官方发布的命令行工具（一个 npm 包）。它默认会去连 Anthropic 官方服务器、用你的官方登录态计费。我们要做的只有两件事：
就这么简单——客户端不换、只换后端。所有你在教程/视频里看到的 Claude Code 用法（改代码、跑命令、多轮对话）全都照旧，只是账单从「美元 + 官方风控」变成了「人民币 + 国内直连」。
先记住这两条关键信息，后面反复用：
https://api.apipifa.com/v1Claude Code 是用 Node.js 跑的，Windows 上必须先装 Node。
LTS（长期支持版）的那个 .msi 安装包，别下 Current 尝鲜版。.msi 一路 Next。中间有一步「Add to PATH」（添加到环境变量）默认是勾上的，保持勾选——这一步决定了你之后能不能在命令行里直接敲 node。按 Win + R，输入 powershell 回车，打开 PowerShell（蓝色窗口），依次敲：
node -v
npm -v
只要各自打印出一个版本号（例如 v22.x.x 和 10.x.x）就说明装成功了。
Node 版本建议 18 以上；如果你后面还想装 Codex（另一个客户端），Codex 要求 Node ≥ 22，所以直接装最新 LTS（22 或更高）最省心。 如果敲node -v报node 不是内部或外部命令—— 说明第 3 步的「Add to PATH」没生效或没重启。见文末 Windows 专项排错第 1 条。
Claude Code 的核心场景是帮你在项目里改代码，它跟 Git 配合得最好（能看 diff、按提交管理改动）。虽然不装 Git 也能装 Claude Code，但强烈建议装上。
git --version
打印出 git version 2.x.x 即成功。
只想快速体验、暂时不改代码，可以先跳过这一步，后面随时补装。
Node 装好后，用 npm 一条命令全局安装官方 Claude Code：
npm install -g @anthropic-ai/claude-code
国内网络下这一步可能很慢甚至卡住（npm 默认拉海外源）。加一个国内镜像加速：
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
装完验证：
claude --version
打印出版本号就说明客户端装好了。
如果claude报无法加载文件 ... 因为在此系统上禁止运行脚本—— 这是 Windows PowerShell 的执行策略在拦，不是你装错了，见文末 Windows 专项排错第 2 条，一条命令解决。
先别急着 claude 启动。 现在直接启动它会去连 Anthropic 官方、让你登录官方账号。我们要先做第四、五步的配置，把它掰到 apipifa 上，再启动。
打开 apipifa 官网注册登录，进后台：
auto 全模型通用池——意思是这一份 Key 能跑全部模型（Claude、GPT/Codex、Grok），系统按你实际请求的模型名自动路由和计费，不用手动分组、不用为不同模型建不同 Key。apipifa 一份 Key 通吃：今天用 Claude Code，明天想用 Codex 或在别的 OpenAI 兼容工具里调 GPT-5.5 / Grok，同一份 Key 直接用，无需另外申请。
当前 apipifa 上 Claude Code 常用的模型名（照抄，别写错）：
claude-opus-4-8（最强，复杂任务）claude-sonnet-5（均衡）claude-sonnet-4-6（Claude Code 日常常用）claude-haiku-4-5（最快最省，轻量任务，Claude Code 常用）这是最关键的一步。Claude Code 在 Windows 上读取的配置文件在你的用户目录下的 .claude 文件夹里。
Windows 上「用户目录」就是 C:\Users\你的用户名\。在 PowerShell 里可以用环境变量 $env:USERPROFILE 表示它。配置文件的完整路径是：
C:\Users\你的用户名\.claude\settings.json
也就是 %USERPROFILE%\.claude\settings.json。
在 PowerShell 里执行下面命令，自动创建 .claude 目录（如果还没有）并用记事本打开配置文件：
mkdir "$env:USERPROFILE\.claude" -Force
notepad "$env:USERPROFILE\.claude\settings.json"
记事本会提示「文件不存在，是否新建」，点是。
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apipifa.com/v1",
"ANTHROPIC_AUTH_TOKEN": "在这里粘贴你从apipifa后台复制的Key"
}
}
三个要点：
ANTHROPIC_BASE_URL 填 https://api.apipifa.com/v1，一字不差；ANTHROPIC_AUTH_TOKEN 填你在第三步补里复制的那串 apipifa Key，整串双引号包住；＂ 当成英文半角引号 " —— 记事本里手打引号有时会变全角，务必确认是英文半角 "。保存（Ctrl + S）后关掉记事本。
为什么用settings.json而不是设 Windows 系统环境变量？因为settings.json是 Claude Code 官方支持的项目/用户级配置，跟着工具走、不污染系统、也不会因为系统里残留的旧ANTHROPIC_*变量互相打架（那正是 Windows 上最常见的翻车点，见文末专项排错第 3 条）。
配好上一步后，大部分人直接就能用了。但有些 Windows 环境下，Claude Code 首次启动仍会卡在官方的联网 / 登录引导上（它想验证官方账号，而我们根本没有官方账号）。遇到这种情况，加两个小配置绕过它。
.claude.json 里标记已完成引导这个文件也在用户目录根下（注意不是 .claude 文件夹里，是外面那个 .claude.json）：
C:\Users\你的用户名\.claude.json
用记事本打开（不存在就新建）：
notepad "$env:USERPROFILE\.claude.json"
如果文件是空的，填入：
{
"hasCompletedOnboarding": true
}
如果文件里已经有内容（是个 { ... }），只需在里面加一行 "hasCompletedOnboarding": true,，别把原有内容删了。保存。
config.json 里塞一个占位 primaryApiKey路径在 .claude 文件夹里，和 settings.json 同级：
C:\Users\你的用户名\.claude\config.json
notepad "$env:USERPROFILE\.claude\config.json"
填入（这里的值随便一个字符串即可，真正生效的鉴权是第四步的 ANTHROPIC_AUTH_TOKEN）：
{
"primaryApiKey": "any-string"
}
保存。这两个文件加完，Claude Code 就不会再纠缠官方登录验证了。
如果你第一次启动没卡在验证上、直接能对话，这一步可以完全跳过。它是给「卡住的人」的兜底。
配置全部就绪，现在真正启动。先关掉所有旧的 PowerShell 窗口，重新开一个（让 settings.json 被干净地读取一次）。
cd 进到你想让 Claude Code 帮忙的项目文件夹，例如：cd C:\Users\你的用户名\Desktop\my-project
（先随便建个空文件夹练手也行。）
claude
你好，报一下你现在用的是哪个模型
只要它正常回话、没有报 401 / 连接错误，就说明Windows 上的 Claude Code 已经成功接上 apipifa 中转，跑通了。
在 Claude Code 会话里输入 /model，选择你要用的模型（对应上面那串 apipifa 模型名，如 claude-sonnet-4-6、claude-opus-4-8）。日常写代码用 sonnet-4-6 均衡省钱，遇到硬骨头切 opus-4-8，轻量问答用 haiku-4-5。
到这里，一份人民币 Key、免翻墙、Windows 原生环境下的 Claude Code 就完整跑通了。
401 / Missing API Key / No valid credentials / authentication_error？认证没过。按顺序排查：
settings.json，确认 ANTHROPIC_AUTH_TOKEN 的值是完整的 apipifa Key，没漏字符、没多空格、没把双引号弄成中文全角。env 块拼写完全正确：是 ANTHROPIC_AUTH_TOKEN（不是 API_KEY），是 ANTHROPIC_BASE_URL。claude，旧窗口读的是旧配置。model not found / 无可用渠道 / 模型相关错误？模型名写错了。apipifa 上 Claude Code 用的模型名必须是 claude-opus-4-8 / claude-sonnet-5 / claude-sonnet-4-6 / claude-haiku-4-5 这一类，照抄别改。注意 opus-4-6 / opus-4-7 这类旧名已下线，写了会找不到。在会话里用 /model 选，不容易拼错。
/v1？填 /v1。apipifa 的地址是 https://api.apipifa.com/v1，一字不差。少了 /v1 或者多个斜杠、把 https 写成 http，都可能连不上或 404。（注意：这跟某些老教程里"Claude Code 用根地址不加 /v1"的写法不同——apipifa 统一用带 /v1 的地址，OpenAI 和 Anthropic 协议共用这同一个 base。）
404 / not found / 路径类错误？多半是 Base URL 尾部拼错（多了 /、漏了 /v1、域名打错）。回第四步逐字符核对 ANTHROPIC_BASE_URL。
claude 命令找不到（不是内部或外部命令）？Node 的全局 bin 目录没进 PATH，或装完没重开窗口。见下方 Windows 专项排错第 1 条。
先确认能正常访问 https://api.apipifa.com （国内直连即可，不需要挂梯子——如果你此时正开着代理/VPN，反而可能因为代理把国内域名也绕出去而更慢，可以先关掉代理试试）。再确认 Key 有余额。
node / claude 命令找不到 —— PATH 没生效Win + R 输入 sysdm.cpl → 「高级」→「环境变量」，在「系统变量」的 Path 里确认有 Node 的安装路径（一般是 C:\Program Files\nodejs\）。没有就手动添加，确定后重开窗口。因为在此系统上禁止运行脚本 —— 执行策略拦截Windows 默认禁止运行未签名脚本，claude 是个 .ps1 脚本会被拦。以管理员身份打开 PowerShell（开始菜单搜 PowerShell → 右键「以管理员身份运行」），执行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
提示确认时输入 Y 回车。这条只放开「本机自己安装的脚本」，安全。改完重开普通 PowerShell 再 claude。
如果你以前折腾过 Claude Code、在 Windows 系统环境变量里手动设过 ANTHROPIC_API_KEY / ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN，它们会覆盖或干扰 settings.json，导致你怎么改 json 都不生效。
Win + R 输入 sysdm.cpl → 「高级」→「环境变量」。ANTHROPIC_ 开头的项，全部删除。settings.json 这一个配置源，最干净。配置文件里我们没让你写 Windows 路径，但如果你自己扩展配置、要在 JSON 里填路径，记住：JSON 里 \ 是转义符，Windows 路径的单反斜杠 C:\Users\... 会被 JSON 当成非法转义报错。要么写成双反斜杠 C:\\Users\\...，要么直接用正斜杠 C:/Users/...（Windows 也认）。URL 里用的是正斜杠 /，不受影响。
settings.json.txt用记事本新建文件时，Windows 会偷偷加 .txt 后缀，变成 settings.json.txt，Claude Code 读不到。
settings.json。.txt 删掉。走到这里 Windows 上的 Claude Code 已经跑通了。回头看，比起官方直连，apipifa 这条路对国内用户实打实省了几道坎：
https://api.apipifa.com/v1 国内网络直接可达，Windows 上不用为了跑 Claude Code 常年挂着梯子。Windows 从零到 Claude Code 跑通，核心就三件事：装 Node → npm install -g @anthropic-ai/claude-code → 改 settings.json 把 Base URL 指到 https://api.apipifa.com/v1 并填上 apipifa 的 Key。剩下的都是排错兜底。
现在就差一份 apipifa 的 Key。去 apipifa 官网注册，用支付宝 / 微信充一点额度、在后台新建一个默认（auto 全模型）令牌，把 Key 填回第四步的 settings.json —— 你的 Windows Claude Code 就能立刻用上 Claude 全系列，顺带解锁 GPT/Codex、Grok，全程人民币、免翻墙。
卡在某一步跑不通？把 PowerShell 里的完整报错原文截图，连同你改的 settings.json（记得把 Key 打码）一起发客服，比干着急描述快十倍。