在 Windows 老机器上白嫖 Claude Code，我踩过的 5 个坑（附实测结论）

在 Windows 老机器上白嫖 Claude Code，我踩过的 5 个坑（附实测结论）在 Windows 老机器上白嫖 Claude Code，我踩过的 5 个坑（附实测结论）老规矩，先说结论：免费版 Claude Code 能跑起来，但有几个坑不提前知道会卡一下午。我在一台 Windows 10 Build 1703 的老机器上把 Alishahryar1/free-claude-code（FCC）完整走了一遍，以下全部是实测结果，不是搬运 README。

先回答最关心的问题：真的免费吗？

准确说法是「借第三方免费层零成本使用」，不是「永久免费」。

• 免费额度取决于上游（Google AI Studio / 智谱开放平台等）的政策；
• 2025 年 12 月 Google 曾无预告大幅削减免费配额，部分模型砍了 50%-80%（来源：Google AI Studio 产品经理说明，经 aifreeapi.com 2026-03 引述）；
• 免费层有限速，且 prompt 可能被用于改进产品，敏感代码慎用。

坑 1：仓库名就抄错了

网上教程大多写 Alishaharyar/free-claude-code，这个地址是 404。真实仓库是 Alishahryar1/free-claude-code（用户名末尾多个 1）。

坑 2：新版 Claude Code 在老 Windows 上直接崩

Claude Code 从 2.1.113 起改成原生二进制。我在 Windows 10 Build 15063（1703）上跑 2.1.296，直接 exit -10737415111（STATUS_ENTRYPOINT_NOT_FOUND）。

解法：固定装 2.1.112——这是最后一个 Node/cli.js 版本，老系统可用。

坑 3：安装方式已经变了，别再找 inst.sh

现行流程是两条命令：

uv tool install free-claude-code
fcc-server

配置不再走明文文件，而是存 SQLite（~/.fcc/fcc.db），通过 Admin UI（http://127.0.0.1:8082/admin）或 Admin API 管理。

坑 4：Provider 前缀写错一个字母就 Invalid provider

FCC 支持多家上游，但前缀有严格命名：智谱开放平台是 zai_api/，Z.ai Coding Plan 是 zai/，写成 zhipu、bigmodel、zai_com 都会报 Invalid provider。我是翻它的 provider_catalog.py 才确认的权威清单。另外 Admin API 的 api_key_list 字段必须带 revision 和 entries 结构，MODEL 字段反而要直接传字符串——两种格式混用会白白浪费半小时。

坑 5：协议链路可以先验证再填 Key

不用等 Key 到手才测试。空 Key 状态下按 Claude Code 原生格式 POST /v1/messages，如果返回 503 并提示 GEMINI_API_KEY is not set，说明请求已被正确路由到对应 provider，链路是通的，填上 Key 就能跑。

实测环境清单

• Claude Code 2.1.112 + FCC 6.16.0（uv 0.13.0，Python 3.14.8）
• 协议链路、Admin UI、PATH 持久化全部实测通过
• 项目许可证为 AGPL-3.0-only，README 声明与 Anthropic 无官方关系

总结：方案是真实可用的，但「永久免费」是营销话术。把上游免费层政策、版本兼容、provider 前缀这三件事搞清楚，半小时内能跑通。