Free Claude Code 是一款开源代理工具，将 Claude Code 的 Anthropic API 流量路由到 NVIDIA NIM、OpenRouter、DeepSeek、LM Studio 等免费或本地模型。六种后端支持、原生模型选择器、语音转录，一个工具全搞定。

🎤 引言

Claude Code 有多火？2026年1月，Anthropic 完成30亿美元融资，估值380亿美元。Claude Code 成为史上增长最快的开发者工具之一。但每月20美元以上的订阅费，让不少个人开发者望而却步。

Free Claude Code（19.8k Stars）来了！这个开源项目通过一个本地代理，让你可以用 NVIDIA NIM、OpenRouter、DeepSeek 等免费或本地模型替代 Anthropic API，轻松白嫖 Claude Code 的核心功能。

⭐ 核心功能

六种后端支持
Free Claude Code 支持六个主流 AI 模型提供商：

提供商特点默认模型示例
NVIDIA NIM性能强，有免费额度glm4.7、kimi-k2.5
OpenRouter模型多，部分免费step-3.5-flash:free
DeepSeek性价比高deepseek-chat
LM Studio本地运行，完全免费自定义模型
llama.cpp本地部署，隐私无忧自定义GGUF
Ollama简化本地部署llama3.1

按模型分级路由
可以给 Opus、Sonnet、Haiku 分别指定不同的提供商。比如 Opus 用 NVIDIA NIM，Sonnet 用 OpenRouter 免费模型，Haiku 用本地 Ollama。

完整协议兼容

  • Streaming 实时输出
  • 工具调用（Tool Use）
  • 思考块（Reasoning/Thinking）
  • 本地请求优化

可选附加功能

  • Discord/Telegram 机器人：远程编程会话
  • Whisper 语音转录：语音输入代码需求

📥 安装与使用

环境要求

  • Claude Code（需先安装）
  • Python 3.14
  • uv 包管理器

快速部署（macOS/Linux）

# 安装 uv
curl -LsSf https://astral.sh/uv/install.sh | sh
uv self update
uv python install 3.14

# 克隆项目
git clone https://github.com/Alishahryar1/free-claude-code.git
cd free-claude-code
cp .env.example .env

# 配置（以 NVIDIA NIM 为例）
echo 'NVIDIA_NIM_API_KEY="nvapi-your-key"' >> .env
echo 'MODEL="nvidia_nim/z-ai/glm4.7"' >> .env
echo 'ANTHROPIC_AUTH_TOKEN="freecc"' >> .env

# 启动代理
uv run uvicorn server:app --host 0.0.0.0 --port 8082

启动 Claude Code

# Bash
ANTHROPIC_AUTH_TOKEN="freecc" ANTHROPIC_BASE_URL="http://localhost:8082" claude

# PowerShell
$env:ANTHROPIC_AUTH_TOKEN="freecc"; $env:ANTHROPIC_BASE_URL="http://localhost:8082"; claude

搞定！Claude Code 现在走的是免费代理，完全不用管背后的模型是啥。

NVIDIA NIM 免费额度申请
去 build.nvidia.com/settings/api-keys 注册，每月有免费 token 额度，足够个人开发用。

OpenRouter 免费模型
OpenRouter 有部分模型完全免费，如 stepfun/step-3.5-flash:free，适合轻度使用。

🎯 适用场景

个人开发者白嫖
Claude Code 原价每月20美元起，用 Free Claude Code + 免费模型额度，基本可以零成本使用。

内网/隐私敏感环境
通过 LM Studio、Ollama、llama.cpp 完全本地运行，代码不外传，适合处理内部项目或敏感业务。

多模型对比测试
同时配置多个后端，用同一个界面测试不同模型的效果，方便选型。

🔍 对比与替代方案

方案成本部署难度隐私性推荐度
Free Claude Code免费~低价低高（本地模型）⭐⭐⭐⭐⭐
官方 Claude Code$20+/月无低⭐⭐⭐
Cursor$20/月低低⭐⭐⭐⭐
GitHub Copilot$10/月低低⭐⭐⭐⭐

Free Claude Code 的优势在于灵活——想免费用本地模型可以，想用高性能云端模型也行，而且都是标准接口，切换成本极低。

⚠️ 注意事项

API Key 安全
不要把真实的 ANTHROPIC_AUTH_TOKEN 广播出去。虽然是本地代理，但认证 token 最好定期更换。

模型能力差异
免费模型（如 OpenRouter free tier）在复杂任务上可能不如 Claude Opus。GitHub 上有用户反馈"AI 写代码第一稿 95% 都没用"，这类问题在免费模型上更明显。

上下文窗口限制
本地模型（尤其是 llama.cpp）默认上下文可能不够用。如果 Claude Code 返回 400 错误，需要在 llama-server 启动时增加 --ctx-size 参数。

最新版本更新频繁
这个项目目前非常活跃（561 commits），更新快意味着可能有 breaking change，生产环境使用前建议锁版本。

✅ 总结

优点：

  • 完全开源，可自托管
  • 六种后端自由切换，灵活度高
  • 本地模型完全免费，隐私有保障
  • 社区活跃，更新频繁

缺点：

  • 需要自己申请 API Key（虽然免费）
  • 本地模型效果因配置而异
  • 文档偏英文，中文社区资料少

推荐指数：⭐⭐⭐⭐

如果你是个人开发者，或者对数据隐私有要求，Free Claude Code 值得一试。19.8k Stars 的热度已经证明了它的价值——用免费或本地模型替代 Claude Code，既不损失太多体验，又能省下真金白银，何乐而不为？

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