Free Claude Code：先看清免费 Claude Code 的真实边界
Free Claude Code 不是 Claude 官方免费订阅，而是一个本地 gateway。它把 Claude Code、Codex 或 Pi 的请求转发给你自己的 API provider 或本地模型。
先说结论
Free Claude Code 值得研究，但它解决的不是“免费获得 Claude 额度”，而是“让 Claude Code、Codex 和 Pi 通过同一个本地入口连接不同模型”。
| 使用场景 | 判断 |
|---|---|
| 用自己的 API Key 统一接入多个 provider | ✅ 适合 |
| 把 Ollama、LM Studio 或 llama.cpp 接入 coding CLI | ✅ 适合 |
| 在隔离目录中测试免费模型和本地模型 | 🟡 可以 |
| 期待免费、稳定、等价于 Claude Opus 的服务 | ❌ 不现实 |
| 把公司代码和主力凭据直接交给陌生 provider | ❌ 不建议 |
本文以项目当前 README、架构文档和源码为依据。provider、免费额度和模型名称更新很快，实际使用前应重新核对官方仓库。
Free Claude Code 实际上是什么
它是一个运行在本机的 FastAPI proxy。Claude Code 和 Pi 使用 Anthropic Messages 兼容入口，Codex 使用 OpenAI Responses 兼容入口，FCC 再把请求转换到配置好的上游。
Claude Code / Codex / Pi
|
v
Free Claude Code
|
+--> OpenRouter / Gemini / DeepSeek / Mistral ...
+--> Ollama / LM Studio / llama.cpp项目还提供 Admin UI、模型发现、按 Opus/Sonnet/Haiku 档位路由、reasoning 设置，以及可选的 Discord、Telegram 和语音入口。
它为什么看起来像“免费 Claude Code”
搜索 claude code free 或 is claude code free 的用户，通常混淆了三件事：软件是否收费、模型额度是否免费、Claude Code 是否仍由 Anthropic 提供模型。
- FCC 软件本身采用 MIT License，可以免费安装。
- 上游 provider 可能有免费模型、试用额度或本地模型，但额度和可用性由 provider 决定。
- 使用 Claude Code 的界面，不代表后端仍是 Claude，也不代表拥有 Anthropic 账户权益。
因此，free claude code 更准确的解释是：免费使用一个本地代理，把 coding CLI 接到免费或自有模型资源。
主要功能
多 provider 与本地模型
README 列出了 OpenRouter、NVIDIA NIM、Gemini、DeepSeek、Mistral、Kimi、MiniMax、Groq、Cloudflare Workers AI 等 provider，也支持 Ollama、LM Studio 和 llama.cpp。
云端 provider 通常需要 API Key。接本地模型时，仍要确认模型有足够的上下文长度、工具调用能力和稳定的流式输出；“能聊天”不等于“能跑 coding agent”。
协议转换与模型路由
FCC 同时处理 Anthropic Messages 和 OpenAI Responses。它可以把客户端的模型档位映射到不同 provider，并提供模型列表供 Claude Code 或 Codex 的原生 picker 使用。
协议转换也会带来边界：工具调用、reasoning、图片输入、取消请求和长上下文，在不同 provider 上不一定完全等价。建议先用最小项目测试，再接入真实代码库。
Discord 与 Telegram 远程入口
可选 messaging bridge 会把聊天消息交给受控目录中的 Claude Code 任务。这个功能适合个人远程操作，但本质上扩大了攻击面：机器人账号、允许目录和本地子进程都需要单独保护，不应默认指向整个 home 目录。
安装前先看供应链风险
官方安装方式会从 GitHub 下载脚本，再安装 uv、Claude Code、Codex、可选的 Pi 和 FCC 本体。安装包默认从 main 分支压缩包获取，而不是固定 commit。
这不代表项目恶意，但意味着同一条安装命令未来可能获取不同代码。更稳妥的首次测试方式是：先下载并审查 installer，固定版本或 commit，用独立用户和低权限 API Key 运行。
和其他工具怎么选
| 工具 | 主要职责 | 适合的问题 |
|---|---|---|
| Free Claude Code | 本地 proxy、协议转换、provider 路由 | 统一接入 Claude Code、Codex、Pi 和多种模型 |
| CC Switch | 客户端配置管理 | 在多个 Base URL、Key 和 CLI 配置之间切换 |
| 9Router | 带 Dashboard 的本地 gateway | 账号、fallback、配额和多客户端路由 |
| CLIProxyAPI | CLI/OAuth/账号转 API | 自建账号池或给面板提供上游 API |
不要把这些工具都当成“免费模型服务”。它们最多改变请求入口和路由方式，无法保证上游额度、模型质量或平台合规。
第一次使用的保守路径
- 先选择 Ollama、LM Studio 或一个低额度云端 provider。
- 给 FCC 配置非空的代理认证 token，并让 Admin UI 保持 loopback 访问。
- 只在测试目录运行
fcc-claude或fcc-codex。 - 分别验证普通文本、流式响应、工具调用和长上下文。
- 确认 provider 的数据政策和使用条款后，再考虑 Discord/Telegram 或真实项目。
不要把 curl | sh、免费额度和“Claude Code 兼容”当成安全性、稳定性和官方模型权益的证明。
最终判断
Free Claude Code 是一个有实际工程价值的本地 AI coding gateway，适合研究多 provider、接入本地模型和统一 Claude Code/Codex 的入口。它不是 Claude 官方免费方案，也不是无限额度机器。
如果你的目标是降低接入多个模型的配置成本，可以试；如果你的目标是绕过订阅或稳定获得 Claude Opus，应该调整预期，并先把凭据、代码隐私、协议兼容和上游规则放在“免费”之前考虑。