Free Claude Code 最近在开发者圈子里热度不低，原因很简单：它让 Claude Code 这个原本高度依赖 Anthropic API 的工具，能通过本地中转层调用各种免费或低价的模型。换句话说，你可以继续用 Claude Code 的交互体验和工具链，但底层模型换成其他来源——甚至本地跑的小模型也行。下面就把这个项目的原理、安装步骤和实际踩过的坑拆开聊聊。
技术思路：三层转发架构
项目本质是一个开源的中转袋里，架在 Claude Code 和你选的模型提供商之间。它不碰 Claude Code 本身的代码，只负责拦截 API 请求并做格式转换。架构分三层：
- 路由层：根据模型等级（Opus、Sonnet、Haiku 或者自定义标签）决定请求该发给哪个提供商。比如可以把最复杂的推理任务路由到最强模型，简单任务丢给免费模型。
- 传输层：每个提供商对应一个适配器，把 Anthropic 格式的请求转成目标 API 能理解的形式。有的走 OpenAI 的 Chat Completions 接口，有的走 Anthropic 原生 Messages 接口。
- 归一化层：反向处理——把各提供商的响应再翻译回 Anthropic 格式，包括 streaming、tool calls 和 thinking blocks 这些特性都要做映射。
这个设计的好处是，Claude Code 端完全无感，它只知道自己在对 Anhtropic API 说话，但实际背后已经被换成别的模型了。
支持的模型与提供商
目前项目集成了 17 个模型提供商，其中高频使用的免费或低价方案包括：
- NVIDIA NIM：注册即送免费额度。
- Google AI Studio (Gemini)：利用 Gemini 的免费 tier。
- OpenRouter：聚合多个模型，有专门维护的免费模型列表。
- DeepSeek：成本极低。
- Ollama / LM Studio / llama.cpp：本地模型，完全离线运行。
还可以按模型等级做分流策略：Opus 级别任务绑定最强模型，Sonnet 级别走免费云模型，Haiku 级别直接调用本地小模型。这样既控制成本，又不牺牲复杂任务的质量。
安装和配置流程
第一步：安装袋里
macOS/Linux 直接跑：
curl -fsSL "https://github.com/Alishahryar1/free-claude-code/blob/main/scripts/install.sh?raw=1" | shWindows 用 PowerShell：
irm "https://github.com/Alishahryar1/free-claude-code/blob/main/scripts/install.ps1?raw=1" | iex第二步：启动服务器并配置 API Key
运行：
fcc-server
启动后浏览器访问 https://127.0.0.1:8082/admin。在这里选择一个提供商，填入对应的 API Key，点击 Validate 验证，再点 Apply 生效。
举个实际例子：选 OpenRouter 的某个免费模型。先去 OpenRouter 申请一个 API Key。
然后把 Key 填到输入框，别忘了点右下角的保存按钮。
注意：fcc-server 必须保持运行，不能关闭。
第三步：启动 Claude Code
在终端执行：
fcc-claude不出意外的话，Claude Code 会连接到本地袋里，底层模型已经切换到你选择的提供商了。
VS Code 集成
如果你在 VS Code 里面用 Claude Code 扩展，需要在 settings.json 里添加两项环境变量：
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "https://localhost:8082" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "freecc" }
]JetBrains 系列的 IDE 配置类似，改 ~/.jetbrains/acp.json 中的环境变量即可。另外项目还支持 Discord 和 Telegram 机器人，可以让你在手机上发起编码任务，算是一个有趣的小功能。
实际踩过的两个坑
配置过程中可能会遇到两个典型问题：
- 启动后明明已经配置了提供商，但 Claude Code 里选不到对应的模型。
- 模型倒是选上了，但 fcc-server 日志里反复弹出 401 请求未授权。
解决办法很直接：如果之前安装过 Claude 的旧版本，~/.claude 目录里会残留旧的配置文件。果断删掉这个文件夹，然后重新进入 Claude Code 执行 /logout 退出登录。之后再启动，通常就能正常工作了。核心就是确保环境变量和认证 Token 完全干净。
这个项目目前 GitHub 上已经 34k Star，社区活跃度很高。如果你正在寻找一种低成本甚至免费的 Claude Code 使用方式，值得花十分钟搭起来试试。
