Free Claude Code：34k Star 的开源项目，让你免费使用 Claude Code
一个开源代理工具，在 Claude Code 和 Anthropic API 之间加了转发层，把请求路由到免费或低价大模型上，Claude Code 本身无需改动
基本信息
- 来源类型：网页文章
- 原文位置：raw/articles/2026-06-13-114455-tg-fb1f75.md
- 原文 URL：https://juejin.cn/post/7649764223339692083
- 消化日期：2026-06-13
- 作者：镜泉
核心观点
-
三层代理架构实现零侵入转发：Free Claude Code 在 Claude Code 和 Anthropic API 之间插入路由层、传输层、归一化层。路由层按模型等级（Opus/Sonnet/Haiku/自定义）决定发给哪个提供商；传输层将 Anthropic 格式请求转为 OpenAI Chat Completions 或 Anthropic Messages 格式；归一化层将响应翻译回 Anthropic 格式，包括 streaming、tool calls、thinking blocks。Claude Code 客户端完全无感知。
-
支持 17 个模型提供商，覆盖免费到低成本方案：包括 NVIDIA NIM（免费额度）、Google AI Studio Gemini（免费 tier）、OpenRouter（聚合多模型+免费列表）、DeepSeek（低价）、Ollama/LM Studio/llama.cpp（本地模型完全离线）。按模型等级分流：Opus 级走最强模型，Sonnet 级走免费模型，Haiku 级走本地小模型。
-
安装极简，三步完成：macOS/Linux 一行 curl 安装脚本，Windows 一行 PowerShell 脚本。启动代理
fcc-server后访问 localhost:8082 管理面板选提供商填 API Key，再用fcc-claude启动 Claude Code 即可。 -
VS Code / JetBrains 可通过环境变量接入：VS Code 在 settings.json 设置
ANTHROPIC_BASE_URL=http://localhost:8082和ANTHROPIC_AUTH_TOKEN=freecc；JetBrains 改~/.jetbrains/acp.json。项目还支持 Discord 和 Telegram 机器人。 -
常见问题集中在旧配置冲突：安装后选不到模型或 401 错误，通常是因为旧
.claude配置残留。解决方法是删除.claude目录后在 Claude 中执行/logout。
实操内容保留
代码/配置
安装（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启动代理：
fcc-server启动 Claude Code：
fcc-claudeVS Code 配置（settings.json）：
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "http://localhost:8082" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "freecc" }
]操作步骤
- 运行安装脚本
- 启动
fcc-server，访问 http://127.0.0.1:8082/admin - 选择提供商（如 OpenRouter），填入 API Key，点 Validate → Apply，点保存
- 保持 fcc-server 运行，另开终端执行
fcc-claude启动 Claude Code - 如遇 401 或选不到模型，删除
.claude目录后执行/logout
关键概念
- Claude Code — Free Claude Code 的核心依赖，代理层为其提供免费使用路径
- DeepSeek — 支持的低价模型提供商之一
- Ollama — 支持的本地模型方案之一，实现完全离线使用
- Gemini — Google AI Studio 免费 tier 作为可选后端
- API 代理转发 — 在客户端和 LLM API 之间加一层协议转换层的架构模式
- 模型等级分流 — 按 Opus/Sonnet/Haiku 等级将请求路由到不同能力和成本的模型
与其他素材的关联
- 与 2026-06-03-youtube-codex-vs-claude-code-comparison 的关系：Codex vs Claude Code 对比文章讨论了 Claude Code 的成本问题，Free Claude Code 正是解决这一痛点的方案
- 与 2026-06-02-koc-ollama-codex-local-model 的关系：该文介绍了用 Ollama 串接本地模型免费使用 Codex 的方案，Free Claude Code 的 Ollama 集成提供了类似的本地化路径
原文精彩摘录
Free Claude Code 是一个开源代理工具，在 Claude Code 和 Anthropic API 之间加了一层转发层。你把 API 请求指向这个本地代理，它会转发到其他大模型上，Claude Code 本身不需要任何改动。
技术架构分三层：路由层 — 根据模型等级（Opus/Sonnet/Haiku/自定义）决定将请求发到哪个提供商；传输层 — 每个提供商一个适配器，把 Anthropic 格式的请求转换为目标 API 的格式（部分走 OpenAI Chat Completions，部分走 Anthropic Messages）；归一化层 — 将各提供商的响应翻译回 Anthropic 格式，包括 streaming、tool calls、thinking blocks。
支持按模型等级分流：Opus 级任务走最强模型，Sonnet 级走免费模型，Haiku 级走本地小模型。