【free-claude-code】无需 API 密钥，免费用上 Claude Code 的智能代理方案
free-claude-code 是一个轻量级的本地代理服务，它让原本必须依赖 Anthropic 官方 API 才能运行的 Claude Code CLI 和 VSCode 插件，转而连接到多个免费或本地托管的大模型服务（如 NVIDIA NIM、OpenRouter、DeepSeek、LM Studio 和 llama.cpp），从而绕过付费门槛，真正实现“零成本使用 Claude 体验”。
主要功能包括：
– ✅ 零成本接入：开箱即用 NVIDIA NIM 免费额度（40 次/分钟），也支持 OpenRouter 免费模型、DeepSeek 直连、以及完全离线的 LM Studio 和 llama.cpp；
– ✅ 无缝替换：只需设置两个环境变量（ANTHROPIC_BASE_URL 和可选的 ANTHROPIC_AUTH_TOKEN），无需修改 Claude Code 任何代码或配置；
– ✅ 多模型灵活路由：可分别为 Claude Opus / Sonnet / Haiku 指定不同后端模型和提供商，甚至混搭使用；
– ✅ 原生思维块支持：自动将 <thinking> 标签和 reasoning_content 字段转换为 Claude 兼容的思考流程；
– ✅ 智能工具调用解析：对文本形式输出的工具调用（如 JSON-like 工具请求）进行自动结构化解析；
– ✅ 请求优化与节流：本地拦截 5 类高频低价值请求（如探针、标题生成），节省配额并降低延迟；同时提供滚动窗口限速 + 429 自动退避 + 并发控制；
– ✅ Discord / Telegram 远程编程助手：支持树状会话、语音转文字、实时进度流、多任务并发与会话持久化；
– ✅ 高度可扩展：通过抽象基类（BaseProvider / MessagingPlatform）轻松接入新模型平台或通讯渠道。
安装与快速启动步骤如下：
1. 安装依赖工具 uv：
bash
pip install uv
2. 克隆项目并配置环境：
bash
git clone https://github.com/Alishahryar1/free-claude-code.git
cd free-claude-code
cp .env.example .env
然后根据所选提供商（如 NVIDIA NIM 或 LM Studio）编辑 .env，填入对应 API Key（若需要）和模型路径；
3. 启动代理服务：
bash
uv run uvicorn server:app --host 0.0.0.0 --port 8082
4. 在终端中运行 Claude Code（以 Bash 为例）：
bash
ANTHROPIC_AUTH_TOKEN="freecc" ANTHROPIC_BASE_URL="http://localhost:8082" claude
VSCode 用户则在设置中添加 claudeCode.environmentVariables 即可一键启用。
该项目特别适合以下场景：
– 个人开发者与学生：想体验 Claude 风格的智能编码辅助，但不愿/无法开通 Anthropic 账户或支付费用；
– 注重隐私的用户：选择 LM Studio 或 llama.cpp，全程数据不离开本地设备；
– 模型探索者：希望快速切换不同后端（比如白天用 NVIDIA NIM，晚上跑本地 Qwen3.5），验证效果差异；
– 远程协作团队：通过 Discord Bot 实现非侵入式任务分发与进度同步，尤其适合轻量级自动化编程辅助。
总结：free-claude-code 是一个设计清晰、落地务实的开源代理工具——它不追求性能极限，也不堆砌炫技功能，而是精准解决了“想用 Claude Code 却被 API 门槛卡住”这一真实痛点。配置灵活、文档详实、扩展友好，是当前阶段最易上手、兼容性最强的 Claude 兼容层方案之一。建议访问其主页获取更详细信息。
