FREE-CLAUDE-CODE：免费在终端和 VSCode 中使用 Claude Code

项目简介

FREE-CLAUDE-CODE 是今日 GitHub Trending 第一名，今日新增 2,638 stars，累计 10,004 stars。

这是一个轻量级代理服务器，将 Claude Code CLI / VSCode 扩展的 Anthropic API 调用无缝路由到多种免费或本地 LLM 提供商。无需任何 Anthropic API Key，只需配置 2 个环境变量，即可在终端、VSCode 或通过 Discord/Telegram 机器人免费使用 Claude Code 的完整能力。

核心特性

零成本多提供商支持：项目支持 5 个 LLM 提供商，覆盖从免费云端到完全离线的全场景需求：

NVIDIA NIM（推荐）：免费 40 次/分钟，支持 GLM-4.7、Kimi-K2.5 等模型
OpenRouter：数百个免费/付费模型，含 DeepSeek-R1、GPT-OSS-120B 等
DeepSeek：直接调用 deepseek-reasoner / deepseek-chat
LM Studio：完全本地运行，零成本，无需任何 API Key
llama.cpp：本地推理，完全离线

灵活的模型路由：Opus / Sonnet / Haiku 三种请求可分别映射到不同提供商和模型，甚至支持混合使用——例如用 NVIDIA NIM 处理 Opus 复杂推理，用本地 LM Studio 处理 Haiku 轻量请求。

思考令牌支持：自动解析 <thinking> 标签和 reasoning_content 为原生 Claude 思考块，保留推理模型的完整思维链输出。

智能请求优化：内置 5 类琐碎 API 调用本地拦截机制，配合主动滚动窗口限流和指数退避，有效节省配额和降低延迟。

Discord / Telegram 机器人：支持远程自主编程，具备树状线程管理、会话持久化和实时进度展示，配合语音笔记功能（本地 Whisper / NVIDIA NIM Whisper）实现语音驱动编程。

快速开始

方式一：克隆仓库

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# 1. 安装 uv 包管理器
pip install uv

# 2. 克隆并配置
git clone https://github.com/Alishahryar1/free-claude-code.git
cd free-claude-code
cp .env.example .env
# 编辑 .env 填入提供商 API Key 和模型配置

# 3. 启动代理服务器（终端1）
uv run uvicorn server:app --host 0.0.0.0 --port 8082

# 4. 运行 Claude Code（终端2）
ANTHROPIC_AUTH_TOKEN="freecc" ANTHROPIC_BASE_URL="http://localhost:8082" claude

方式二：全局安装（推荐）

1
2
3
4


uv tool install git+https://github.com/Alishahryar1/free-claude-code.git
fcc-init        # 创建 ~/.config/free-claude-code/.env
# 编辑配置后直接运行：
free-claude-code

NVIDIA NIM 配置示例（免费推荐）

1
2
3


NVIDIA_NIM_API_KEY="nvapi-your-key-here"
MODEL="nvidia_nim/z-ai/glm4.7"
ENABLE_THINKING=true

VSCode 扩展配置

在 settings.json 中添加：

1
2
3
4


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

工作原理

1
2
3
4
5
6


┌─────────────────┐        ┌──────────────────────┐        ┌──────────────────┐
│  Claude Code    │───────>│  Free Claude Code    │───────>│  LLM Provider    │
│  CLI / VSCode   │<───────│  Proxy (:8082)       │<───────│  NIM / OR / LMS  │
└─────────────────┘        └──────────────────────┘        └──────────────────┘
   Anthropic API                                             原生 Anthropic
   格式 (SSE)                                               或 OpenAI chat SSE

Claude Code 发送标准 Anthropic API 格式的 SSE 请求，代理层根据模型名称（Opus/Sonnet/Haiku）将请求路由到对应的后端提供商，并将响应转换回 Anthropic 格式返回给 Claude Code，全程对客户端透明。

为什么值得关注

Claude Code 是目前公认最强的 AI 编程工具之一，但其高昂的 API 费用让很多开发者望而却步。FREE-CLAUDE-CODE 通过代理层抽象，将这一专业工具的使用门槛降至零——NVIDIA NIM 每分钟 40 次免费调用对于日常开发已经完全够用，而本地 LM Studio 方案更是实现了完全零成本的私有化部署。

项目架构设计优雅，BaseProvider 和 MessagingPlatform 两个抽象类让扩展新提供商和消息平台极为简单。Discord/Telegram 机器人功能将 AI 编程能力延伸到移动端和群组协作场景，是目前同类工具中功能最完整的解决方案之一。

项目信息

仓库：https://github.com/Alishahryar1/free-claude-code
Stars：10,004（今日新增 2,638）
主要语言：Python 99.5% / Shell 0.5%
许可证：MIT License
技术栈：Python、FastAPI/Uvicorn、uv 包管理器