Free Claude Code（FCC）：聚合 56 个免费提供商、支持 11 种编码代理的 AI 编码网关

Free Claude Code（简称 FCC）是一个开源的 AI 编码代理“网关 / 聚合器”。它在本地跑一个代理服务，把 56 个提供商（覆盖免费层、付费、订阅、本地自托管）的模型汇成一个可搜索的模型目录，再让你的编码代理去调用——包括 Claude Code、Codex、Pi、OpenCode、Cline 等在内的 11 种代理，一套模型目录全都能用。

截至 2026-09-27，项目在 GitHub 上已有 5.6 万+ Star、8,963 Fork，最新版本 v6.4.2，主语言 Python，采用自定义许可协议（非标准开源许可证，使用前建议自行阅读）。项目方称这些提供商的免费额度合计每月可达 13 亿+ Token——注意这是项目自身的口径，并非独立核实过的数字。它也不是官方产品，仓库首页明确写着“Independent open-source project. Not affiliated with or endorsed by Anthropic.”。

一、Free Claude Code 是什么？

一句话：它是一个“翻译层 + 路由器”。一端连着你熟悉的编码代理，另一端连着几十家模型提供商，中间由 FCC 负责协议转换、模型路由和请求优化。

它有三种入口，覆盖不同使用习惯：

• 终端启动器：用 fcc-claude、fcc-codex、fcc-pi 等命令，把官方 CLI 指到 FCC 的本地代理上，模型随便换。
• 桌面客户端：macOS 和 Windows 上直接打开图形界面，管理提供商与密钥。
• 浏览器 Admin UI：在浏览器里配置提供商、跑原生 Code 会话（可以选文件夹、实时或后台运行、同一会话内切换模型）。

需要澄清一个边界：FCC 不是 Claude、也不是 Anthropic 的官方工具，它只是把“任何兼容 Anthropic / OpenAI 接口的模型”接到了 Claude Code 这类代理上。你用的还是原来的代理，换的是背后的模型。想先对比几个“免费大模型入口”的读者，也可以看看我们之前写过的 DeepSider 侧边栏 AI 助手，以及专注免费模型的 EchoBird 精简版。

二、它能做什么？核心能力一览

根据项目 README（截至 2026-09-27 的 v6.4.2），FCC 主打这几件事：

• 56 个 ToS 友好提供商、每月 13 亿+ 免费 Token（项目口径）。项目声称遵循各提供商条款，一旦某个集成不再被允许就会移除。
• 11 种编码代理，共用一个模型目录：Claude Code、Codex、Pi、OpenCode、Cline、Hermes、DeepSeek Harness、Grok Build、Muse Code、Aider、VS Code Chat。
• 模型失败自动回退：当重试耗尽后，FCC 会自动尝试你配置的下一个模型，不用你重启这一轮对话。
• 最高减少 90% 的终端输出 Token：通过可选的 RTK 与五项优化（配额探测、命令前缀识别、标题、建议、文件路径等不再调用提供商）。
• 浏览器里的原生 Code 会话：在浏览器选一个文件夹就能跑 Codex，支持实时 / 后台、会话内切换模型。
• 终端、桌面、IDE 或手机：原生启动器、VS Code、Codex App、JetBrains，甚至 Discord 或 Telegram 机器人。
• 语音笔记转代码：用本地 Whisper 或 NVIDIA NIM 把语音转写后丢给代理。
• 代理能力完整保留：流式响应、工具调用、原生交错思考（interleaved thinking）、发送图像，以及 Fable / Opus / Sonnet / Haiku 的分层路由。

三、支持哪些编码代理与提供商？

先说代理。README 列出了 11 种，涵盖主流的 CLI 与 IDE 型编码代理：

编码代理	类型 / 宿主	说明
Claude Code	终端 CLI	Anthropic 官方编码代理，经 fcc-claude 接入网关
Codex	终端 CLI	OpenAI Codex，经 fcc-codex 接入
Pi	终端 CLI	经 fcc-pi 启动
OpenCode	终端 CLI	经 fcc-opencode 启动
Cline	VS Code 扩展	在扩展里把接口指向网关
VS Code Chat	VS Code 内置	把 VS Code 聊天接进同一模型目录
Hermes	编码代理	统一模型目录 / 回退策略同样适用
DeepSeek Harness	编码代理	同上
Grok Build	编码代理	同上
Muse Code	编码代理	Windows 有原生安装脚本 install-muse.ps1
Aider	终端 CLI	老牌命令行编码代理

再说提供商。README 的 Provider catalog 一共 56 家，覆盖面很广：既有 OpenRouter、Groq、DeepSeek、Gemini、Mistral、NVIDIA NIM、Cerebras、Hugging Face 这类云端推理平台，也有 GitHub Copilot、ChatGPT、Grok 这类订阅型账号，还包含 Ollama、LM Studio、llama.cpp 这类本地模型。下面挑一批常见的示例（完整 56 家请见仓库 Provider catalog 表）：

提供商	接入方式	备注
OpenRouter	OPENROUTER_API_KEY	聚合多家免费模型，如 openrouter/free
Groq	GROQ_API_KEY	超高速推理，含免费额度
Google AI Studio（Gemini）	GEMINI_API_KEY	Gemini 免费层
NVIDIA NIM	NVIDIA_NIM_API_KEY	模型库大，本例截图即用它演示
Cerebras	CEREBRAS_API_KEY	以推理速度见长
DeepSeek	DEEPSEEK_API_KEY	DeepSeek 官方接口
Mistral / Codestral	MISTRAL_API_KEY / CODESTRAL_API_KEY	欧洲系模型
Hugging Face	HUGGINGFACE_API_KEY	Inference Providers
Together AI / Fireworks / SambaNova	对应 *_API_KEY	托管开源模型
GitHub Copilot	Admin UI 里授权连接	复用你的 Copilot 订阅
OpenAI / ChatGPT	Admin UI 里授权连接	复用 ChatGPT 账号
xAI（Grok）	XAI_API_KEY	Grok 系列
Amazon Bedrock	AWS_BEARER_TOKEN_BEDROCK	企业级托管
Cloudflare Workers AI	CLOUDFLARE_API_TOKEN + ACCOUNT_ID	边缘推理
Ollama / LM Studio / llama.cpp	OLLAMA_BASE_URL 等	本地自托管，零 Token 成本

四、它是怎么工作的？

理解了架构，你就明白它为什么能“一个网关接一堆模型”。FCC 在本机跑一个代理服务（默认端口 8082），请求从代理进来后依次经过：

1. Response Classifier（响应分类器）：判断这个请求是 Claude 风格还是 Codex（OpenAI Responses）风格。
2. Model Router（模型路由器）：按 Fable / Opus / Sonnet / Haiku 的分层，把请求映射到你配置的目标模型。
3. Request Optimization（请求优化）：改写本地前缀等，减少不必要的 Token 消耗。
4. Protocol Normalizer（协议归一化）：统一处理流式输出、工具调用、思考（thinking）等差异。
5. Provider Adapter（提供商适配器）：转成 Anthropic 兼容或 OpenAI 兼容格式，发给最终提供商。

五、“免费 Token”到底从哪来？

这一点必须说清楚，免得误解：

• FCC 自己不发放 Token。 它做的是“汇总各提供商的免费层”，把这些免费额度接到同一个界面里。所以你用的是各提供商自己的免费额度。
• 免费额度由各提供商控制，可能随时变动。 README 原话：“Free-tier availability and limits are controlled by each provider and may change.”
• 自动回退可能跨多家扣额度。 一次失败的请求在成功前，可能先后到达并消耗不止一家提供商的用量。
• “13 亿+ Token / 月”是 56 家免费额度的汇总值，属于项目方统计口径；实际能拿到多少，取决于你注册并配置了哪几家、各自当期的免费政策。

换句话说：把它当成一个“免费额度的收纳盒”更准确，而不是一个永远免费的印钞机。

六、安装与部署

FCC 没有提供 Docker 方式，官方主推一行脚本安装。脚本开源可审查（install.sh / install.ps1），建议先看一眼再执行。

macOS / Linux：

curl -fsSL "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.sh" | sh

Windows（PowerShell）：

& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.ps1")))

装好之后，几个常用管理命令：

fcc-server      # 启动本地代理服务（Linux 下需保持终端打开）
fcc-update      # 更新
fcc-doctor      # 自检查询，排障用
uninstall.sh    # 卸载（Windows 为 uninstall.ps1）

配置文件位于 ~/.fcc/.env（Windows 为 C:\Users\你的用户名\.fcc\.env），提供商密钥、端口、鉴权 Token 等都在这里。默认监听 0.0.0.0:8082，并有一个默认的本地鉴权 Token——如果你把它暴露到公网，务必改掉默认 Token 并加访问控制（见第十节）。

七、快速上手：从安装到跑起来

四步就能跑通第一个代理：

1. 启动服务：macOS 打开桌面应用，或 Linux 终端执行 fcc-server。
2. 配置提供商：打开 Admin UI，在 Providers 里填一个提供商的 Key（新手可以用 NVIDIA NIM 或 OpenRouter 的免费模型起步）。
3. 选模型：在 Model Config 里选默认模型，或跑起来后用 /model 临时切换。
4. 启动代理：终端执行 fcc-claude / fcc-codex 等，就能用熟悉的方式开始写代码。

下面两张分别是 Claude Code 与 Codex 里切换模型的样子——注意模型列表都被标注为来自“Free Claude Code provider model”：

八、还能怎么用？浏览器、手机与语音

除了终端，FCC 把“入口”铺得很开，适合不同场景：

• 浏览器原生 Code 会话：不用装 IDE，浏览器里选个文件夹就能跑 Codex，支持同一会话内切换模型。
• IDE 集成：VS Code 与 JetBrains 都能接进同一模型目录。
• 手机 / 聊天工具：可接 Discord 或 Telegram 机器人，用手机下指令。
• 语音笔记转代码：语音先转写再交给代理，转写可用本地 Whisper（如 openai/whisper-large-v3）或 NVIDIA NIM。

九、常见问题（FAQ）

它和官方 Claude Code 是什么关系？

没有关系。Claude Code 是 Anthropic 的官方编码代理；FCC 是第三方开源项目，只是把 Claude Code 的接口指向了你自己配置的模型提供商。仓库明确声明“Not affiliated with or endorsed by Anthropic”。

真的完全免费吗？

不完全。FCC 本身免费开源，但它“免费”的部分来自各提供商的免费层——你仍需自行去各家注册、拿 Key，各家免费额度和政策随时可能变。想更彻底免费，可优先配置 Ollama / LM Studio 这类本地模型，或 OpenRouter、Groq 的免费模型。

会不会有封号风险？

项目声称只集成“ToS 友好”的提供商，并在集成不再被允许时移除，以此规避账户风险。但这属于项目方的说法；具体到每家提供商，条款与风控各不相同（例如 Kimi Code、QwenCloud Coding Plan 都注明“仅限本机个人交互式编码使用”）。建议：遵守各家的使用条款，别拿免费额度跑自动化批量任务。

能接本地大模型吗？

可以。README 明确支持 Ollama、LM Studio 与 llama.cpp，配置对应的 BASE_URL 即可，模型完全跑在你自己机器上。

请求失败会自动切换模型吗？

会。当重试耗尽后，FCC 会自动尝试你配置的下一个模型，不需要你重启这一轮对话——这也是它相比直接连单一提供商的主要卖点之一。

需要什么系统环境？

macOS、Linux、Windows 都支持；Linux 下以命令行服务方式运行，macOS / Windows 提供桌面应用。另外，代理要和你的编码代理客户端跑在同一台电脑、同一用户环境下。

十、使用边界与合规提醒

把话说在前面，避免踩坑：

• 它与 Anthropic 无关，Claude、Claude Code 是 Anthropic 的商标；FCC 只是第三方聚合器。
• 免费额度是动态的：由各提供商控制，随时可能调整或取消，不要把它当作长期稳定的生产依赖。
• 本地服务别裸奔：FCC 默认监听 0.0.0.0:8082 且带默认鉴权 Token。若你改动监听地址，请务必改掉默认 Token、加防火墙或反向代理鉴权，别把带密钥的网关直接暴露到公网。
• 留意条款：订阅型入口（GitHub Copilot、ChatGPT 等）与特定编码计划通常限个人使用，自动化、多用户或商业用途可能违反其条款。
• 敏感数据谨慎处理：经由第三方免费层的代码与提示词会离开你的本机，敏感项目建议改用本地模型（Ollama / LM Studio / llama.cpp）。

一句话建议：把它当“模型入口的聚合器 + 失败回退”来用，而不是当“永久免费的生产后端”。

十一、项目地址与相关阅读

• GitHub 仓库：github.com/Alishahryar1/free-claude-code
• 最新版本：v6.4.2（Releases 页）
• 安装脚本：install.sh / install.ps1（执行前建议先审查）
• 本站相关：ai-memory：让 Claude Code、Codex 与 Cursor 共享项目记忆 ｜ EchoBird 精简版：只保留免费模型的智能路由 ｜ 人人都能学的 AI 编程指南：Vibe Coding 教程

如果你更关心“多代理协作 / 记忆共享”，可以配合 ai-memory 一起用；如果只是想要一个干净的免费模型入口，EchoBird 或本站的 DeepSider 文章也值得一看。