算笔账吧： 如果你是个重度 AI 编程用户，Claude Pro 每月 $20 的订阅费根本不够用。 一旦切到 API 调用，稍微跑几个大项目、做几次全局重构，一天的 Token 消耗就能干掉几十美金。一个月下来，几百刀的账单，心都在滴血。直到我在 GitHub 上刷到了这个已经狂揽 30.3K+ Stars 的开源狠货：free-claude-code

看完它的源码和架构，我只想说：它不是简单地帮你“省钱”，它是直接把 Claude Code 的底层协议给扒了，让你实现了真正的“模型自由”。

🛑 等等，官方不是支持自定义模型吗？我知道你肯定在想：“Claude Code 官方明明支持通过修改 ANTHROPIC_BASE_URL 环境变量来接入第三方模型啊，这项目有啥稀奇的？”这就是最大的信息差。官方确实支持改 URL，但它支持的是 “理想状态”。 现实是，Claude Code 根本不是一个简单的“聊天机器人”，它是一个重度依赖工具调用（Tool Use）的 Agent。当你让它帮你改代码时，它和 API 的交互极其复杂：
它要解析 API 返回的工具调用指令（比如“读取文件”、“执行终端”）。它要处理流式输出（Streaming SSE）。它还要处理最新的思考块（Thinking blocks）。如果你直接填个 DeepSeek、Kimi 或者本地 Ollama 的地址，只要它们在工具调用的 JSON 结构、SSE 流式事件类型上跟 Anthropic 官方有一丝一毫的偏差，Claude Code 就会当场报错罢工。这就是 free-claude-code 真正牛逼的地方：它不是改个地址，它是一个“协议级的同声传译”和“智能路由网关”。

🔥 它到底在底层补全了什么？1. 协议级的“同声传译”（解决“接不上”和“容易崩”）它在本地起了一个 FastAPI 代理，拦截 Claude Code 的所有请求。向下兼容：把 Claude Code 发出的复杂 Anthropic 格式请求，精准翻译成 OpenAI 格式或其他 17+ 提供商能懂的格式。向上兼容：把第三方模型返回的响应，完美伪装成 Anthropic 官方的 SSE 流式格式。特别是把第三方的工具调用结果，重新打包成 Claude Code 期望的 tool_use 块。

free-claude-code/
├── server.py              # ASGI entry point
├── api/                   # FastAPI routes, service layer, routing, optimizations
├── core/                  # Shared Anthropic protocol helpers and SSE utilities
├── providers/             # Provider transports, registry, rate limiting
├── messaging/             # Discord/Telegram adapters, sessions, voice
├── cli/                   # Package entry points and Claude process management
├── config/                # Settings, provider catalog, logging
└── tests/                 # Unit and contract tests

结果：那些原本因为“协议细节不兼容”而根本没法接入的模型（如本地 Ollama、Groq、NVIDIA NIM、Gemini），现在可以丝滑无缝地驱动 Claude Code 执行复杂的 Agent 任务。2. 分层智能路由（这是最骚的操作）官方方式：你配了一个 URL，所有的请求（不管是写个 Hello World，还是重构整个系统）都走同一个模型。这个项目的补全：它支持按 Claude Code 内部的模型层级（Opus / Sonnet / Haiku）进行精准路由。

1. 快速安装如果缺少 Claude Code，请先安装；安装或更新 uv；然后安装 Python 3.14.0 并释放 Claude Code：macOS/Linux：

curl -fsSL "https://github.com/Alishahryar1/free-claude-code/blob/main/scripts/install.sh?raw=1" | sh

Windows PowerShell：

irm "https://github.com/Alishahryar1/free-claude-code/blob/main/scripts/install.ps1?raw=1" | iex

2. 启动代理

   fcc-server

   启动后，Uvicorn 会打印代理绑定地址，并且应用程序会记录管理员 URL：

   INFO:     Admin UI: http://127.0.0.1:8082/admin (local-only)

   
   在 Web 界面里，填入 DeepSeek、Kimi 或 Groq 的 Key，设置好对应的路由层级，点击“验证并应用”。（新用户注册这些平台基本都有免费额度送）。
   阿里百炼每个模型都有送1000000的tokenhttps://bailian.console.aliyun.com/
   搞定。 现在你的 Claude Code 已经是一个拥有“最强大脑（复杂任务）+ 免费劳动力（日常任务）+ 本地保安（隐私任务）”的超级 Agent 了。
   ⚠️ 说点实在的（避坑指南）别指望本地小模型能完美跑 Agent： Claude Code 的核心是 Agent 能力（频繁的工具调用）。如果你把路由切到本地的 8B 小模型，它大概率会因为“工具调用格式理解错误”而陷入死循环。建议：复杂任务一定要路由给 DeepSeek-V4、Kimi、Qwen3.7 这种具备强 Agent 能力的大模型。合法平替，不是非法破解： 这个项目用的是各大模型厂商公开的 API，完全合法合规。它的核心价值是“协议转换”和“路由管理”，帮你把原本用不上的免费/低价资源利用起来。敏感代码请用本地： 如果你在公司写核心业务逻辑，请在管理界面把模型路由到本地的 Ollama 或 llama.cpp。虽然笨一点，但数据绝对不出你的电脑，老板也挑不出毛病。最后，说句掏心窝的Claude Code 官方给你提供了一把极其锋利、但只能用官方昂贵磨刀石的宝剑。free-claude-code 则是一个万能磨刀石适配器 + 智能剑鞘。它通过底层的协议翻译和分层路由，彻底打破了单一 API 格式的强绑定，把模型的选择权、成本的控制权，真真正正地交还给了开发者。技术本该如此：把复杂留给自己，把自由和钱包留给用户。👇

项目地址：https://github.com/Alishahryar1/free-claude-code
去 Star 一下，看看它的源码里是怎么处理那些恶心的 SSE 流式转换和 Tool Use 协议的，对写 AI 应用绝对有启发如果本文对你有帮助动动你发财的小手点点分享，让你的朋友也能看到

原文链接 https://mp.weixin.qq.com/s/hfTArKQtzSWqtuo1N4V95Q