Free Claude Code

开源代理工具，在 Claude Code 和 Anthropic API 之间加转发层，将请求路由到免费或低价大模型，让 Claude Code 零改动即可免费使用

简介

Free Claude Code（FCC）是一个开源代理工具，GitHub 星标超过 34k。它的核心思路是在 Claude Code 客户端和 Anthropic API 之间插入一个本地代理服务器，把原本发往 Anthropic 的 API 请求转发到其他大模型提供商上。对 Claude Code 而言，这个过程完全透明——客户端不需要任何修改，仍然以为自己在和 Anthropic API 通信。

这种方案属于”API 协议转换代理”模式：通过中间层将一种 API 格式翻译成另一种，让依赖特定 API 的工具能够接入多个后端。与直接修改 Claude Code 源码或使用第三方客户端不同，FCC 保持了 Claude Code 的完整功能（包括 streaming、tool calls、thinking blocks），同时将成本从 Anthropic 定价转移到用户选择的其他提供商。

FCC 的定位是降低 Claude Code 的使用门槛。对于想体验 Claude Code 但不愿支付 Anthropic 订阅费的开发者，或者需要在本地离线环境中使用 AI 编程辅助的场景，FCC 提供了一条低成本甚至零成本的路径。

关键信息

• 类型：工具
• 领域：AI 编程 / API 代理 / 开发工具
• 官方网站：https://github.com/Alishahryar1/free-claude-code
• 定价/开源状态：开源免费
• GitHub 星标：34k+
• 相关概念：Claude Code、DeepSeek、Ollama、Gemini、OpenRouter

核心特性

三层代理架构

FCC 的技术架构分为三层，每层负责不同的转换职责：

• 路由层：根据模型等级（Opus/Sonnet/Haiku/自定义）决定将请求发到哪个提供商。这允许用户按任务复杂度分配不同成本的模型——复杂任务走最强模型，简单任务走免费或本地模型。
• 传输层：每个提供商有一个独立适配器，负责将 Anthropic 格式的请求转换为目标 API 的格式。部分走 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：本地模型方案，完全离线运行

模型等级分流

支持按 Claude Code 的模型等级概念进行智能路由：Opus 级任务走最强付费模型，Sonnet 级走免费模型，Haiku 级走本地小模型。用户可以在管理面板中配置每个等级对应的后端。

管理面板

启动后提供 Web 管理界面（默认 http://127.0.0.1:8082/admin），可选择提供商、填入 API Key、验证连接并应用配置。

不同素材中的观点

• 2026-06-13-free-claude-code-proxy：掘金作者镜泉实测后认为 FCC “用起来还不错”，重点介绍了三层架构设计和 17 个提供商的覆盖范围。同时指出了两个常见坑：安装后选不到模型、fcc-server 报 401，根因是旧 .claude 配置残留，需要删除后执行 /logout。文章还提到项目支持 Discord 和 Telegram 机器人，可在手机上发起编码任务。

实用信息

安装方式

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

基本用法

1. 执行 fcc-server 启动代理服务器
2. 访问 http://127.0.0.1:8082/admin 管理面板
3. 选择提供商（如 OpenRouter），填入 API Key，点击 Validate → Apply → 保存
4. 另开终端执行 fcc-claude 启动 Claude Code
5. fcc-server 必须保持运行

IDE 配置

VS Code 在 settings.json 中添加：

"claudeCode.environmentVariables": [
  { "name": "ANTHROPIC_BASE_URL", "value": "http://localhost:8082" },
  { "name": "ANTHROPIC_AUTH_TOKEN", "value": "freecc" }
]

JetBrains 修改 ~/.jetbrains/acp.json 中的环境变量，配置相同。

注意事项/避坑指南

• fcc-server 不能关闭，关闭后 Claude Code 无法正常工作
• 如果安装后选不到模型或持续 401，删除 .claude 目录后在 Claude 中执行 /logout
• 旧版 Claude Code 的配置文件可能导致冲突，建议清理后重新配置
• 免费提供商有速率限制和额度限制，重度使用可能需要付费方案

相关页面

• Claude Code
• DeepSeek
• Ollama
• Gemini
• AI编程开发