Free Claude Code：GitHub 44K Stars，把Claude Code变成免费工具的代理层，支持30+模型自由切换最新版

一、项目概览

Alishahryar1/free-claude-code（简称 FCC）是一个 Python 编写的本地代理服务器，它能把 Claude Code、Codex 和 Pi 这类付费 AI 编程工具，桥接到 NVIDIA NIM、OpenRouter、DeepSeek、Ollama 等免费或本地模型上，让你不用付 Anthropic 订阅费也能用这些编程 Agent。

截至 2026 年 8 月 7 日（最后推送就在今天）：

• Stars：44,662 / Forks：7,385
• 创建时间：2026 年 1 月，持续活跃
• 技术栈：Python 3.14，MIT 许可证
• Commit 数：844，Open Issues 345

二、它的核心价值：绕过订阅费

Claude Code 官方需要付费订阅 Anthropic 才能使用。Free Claude Code 的思路是：

1. 在本地启动一个代理服务器（默认监听 127.0.0.1:8082）
2. 把 Claude Code 发出的 API 请求翻译成其他模型的格式（NVIDIA NIM、OpenRouter、DeepSeek 等）
3. Claude Code 本身不需要付费订阅，但能调用这些模型的能力

项目 README 里说：“Free Claude Code 将 Claude Code 的客户端协议流量路由到 NVIDIA NIM、Kimi、Wafer、OpenRouter、DeepSeek、LM Studio、llama.cpp 或 Ollama。在保持 Claude Code 客户端协议稳定的同时，让你选择免费、付费或本地模型。”

三、支持 30+ 模型提供商

FCC 支持的提供商分三类：

免费/低成本云端

付费云端（已有账号）

• OpenAI / ChatGPT（含官方订阅）
• Azure OpenAI
• Google AI Studio（Gemini）
• Google Vertex AI
• GitHub Models
• Hugging Face Inference
• Cohere
• Mistral / Codestral
• Vercel AI Gateway
• Amazon Bedrock

本地模型（零成本）

• Ollama：本地开源模型，Pull 即可用
• LM Studio：本地模型，图形界面
• llama.cpp：高性能本地推理
• Ollama Cloud：Ollama 官方云服务

四、技术架构

工作原理

FCC 不是一个 AI 模型，而是一个协议翻译代理层：

1. Claude Code → FCC 本地服务器（127.0.0.1:8082）
2. FCC 接收 Claude Code 的 API 请求
3. FCC 将请求格式转换为目标模型的 API 格式
4. 转发给选择的模型提供商
5. 将模型响应转换回 Claude Code 期望的格式
6. 返回给 Claude Code

内置优化（省 Token）

FCC 包含 5 个内置优化，在本地执行以节省 API 调用：

• Quota Probe 检测：识别何时触发速率限制
• Command-Prefix 检测：识别命令行参数
• Title 生成：在本地生成会话标题
• Suggestion Mode：建议模式处理
• Filepath 提取：从响应中提取文件路径

还可选择启用 RTK，在终端输出到达模型之前过滤噪音。

模型分级路由

可以设置 MODEL_FABLE、MODEL_OPUS、MODEL_SONNET、MODEL_HAIKU，让 Claude Code 的不同级别请求自动路由到不同模型：

# 示例路由策略
MODEL_OPUS    → nvidia_nim/nvidia/nemotron-3-super-120b  (最强模型)
MODEL_SONNET  → open_router/openrouter/free               (免费)
MODEL_HAIKU   → lmstudio/qwen3.5-coder                   (本地)
MODEL         → zai/glm-5.2                               (默认兜底)

五、使用方式

安装（一条命令）

# macOS / Linux
curl -fsSL "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.sh" | sh

# Windows PowerShell
& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.ps1")))

启动

# Windows: 从桌面快捷方式打开（或 Start Menu）
# macOS: 从 Applications 文件夹打开
# Linux: fcc-server

启动后运行在系统托盘（Windows/macOS）或后台（Linux），Admin UI 在 http://127.0.0.1:8082/admin。

配置 API Key（以 NVIDIA NIM 为例）

1. 到 build.nvidia.com/settings/api-keys 创建免费 API Key
2. 打开 Admin UI，粘贴到 NVIDIA_NIM_API_KEY
3. 模型默认选 nvidia_nim/nvidia/nemotron-3-super-120b-a12b
4. 点击 Validate → Apply

启动 Claude Code

fcc-claude   # 启动 Claude Code
fcc-codex    # 启动 Codex
fcc-pi       # 启动 Pi

六、IDE 集成

VS Code Claude Code 扩展

安装 VS Code 的 Claude Code 扩展后，修改 settings.json：

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

Discord 和 Telegram Bot

FCC 还支持通过 Discord 和 Telegram 使用，可以发送语音笔记——这意味着你可以在手机上通过 Discord 语音调用 Claude Code。

七、工程质量

• CI/CD：GitHub Actions 自动测试（pytest）
• 代码规范：Ruff 格式化 + Ty 类型检查
• 日志：Loguru 日志库
• Python 版本：3.14（前沿版本）
• Smoke Test：完整的端到端测试框架（smoke/ 目录）
• 文档：README 完整，包含所有提供商的详细配置说明
• 隐私：代理运行在本地，无第三方数据收集

八、合规性说明

FCC 是一个技术代理工具，它的合法性取决于使用方式：

• ✅ 接入自己的 API Key：NVIDIA NIM、DeepSeek、Kimi 等均有官方免费/付费 API，使用自己的 Key 完全合法
• ✅ 接入本地模型：Ollama / LM Studio / llama.cpp 完全本地运行，零成本，零合规风险
• ⚠️ Claude Code 客户端协议：Anthropic 的服务条款禁止绕过官方渠道使用 Claude Code，但 FCC 只是改变了模型提供商，不直接修改 Claude Code 本身

九、与 OpenClaw 的关系

README 描述这个项目时用了”like OpenClaw”——OpenClaw 也是支持 Discord/Telegram 接入 AI 编程 Agent 的工具。两者定位接近，但 FCC 更专注于模型提供商的选择和本地代理，而 OpenClaw 是一个完整的 Agent 运行时平台。

十、适合人群

强烈推荐：

• 想用 Claude Code 但不想付订阅费的用户（通过 NVIDIA NIM 完全免费）
• 希望在本地跑编程 Agent 的隐私敏感用户（Ollama / LM Studio 零成本）
• 需要同时用多个模型提供商的开发者（一个代理层，统一管理 30+ 提供商）
• Claude Code 重度用户（分级路由不同任务用不同模型，省钱）
• VS Code / JetBrains 用户（IDE 内置使用）

不太适合：

• 只想用官方 Claude Code 高级模型的深度用户（直接订阅更稳定）
• 不熟悉命令行和 API 配置的普通用户

十一、一句话总结

Free Claude Code 是 GitHub 上 Star 增速最快的编程 Agent 工具之一——它本质上是一个本地协议翻译代理，把 Claude Code/Codex/Pi 的流量桥接到 NVIDIA NIM（免费）、DeepSeek、Kimi、Ollama 等 30+ 提供商，让你用 Claude Code 的交互体验，省掉 Anthropic 的订阅账单。

GitHub 地址：https://github.com/alishahryar1/free-claude-code