7k stars！白嫖 Claude Code？这个开源项目让你零成本用上顶级 AI 编程助手！

维度评价🎯 解决的问题Claude Code 使用成本高、国内访问难🔧 实现方式本地代理转发 + 格式转换，无感替换后端模型💰 成本可做到完全零成本（NVIDIA NIM 免费额度 / 本地模型）🚀 上手难度中等，需要一定命令行基础⚠️ 注意事项替换的模型能力与真实 Claude 存在差距，复杂任务效果因模型而异free-claude-code 是一个典型的"以巧破力"式开源项目。

mymessageone

478人浏览 · 2026-04-25 07:00:00

mymessageone · 2026-04-25 07:00:00 发布

白嫖 Claude Code？这个开源项目让你零成本用上顶级 AI 编程助手

⭐ GitHub 5.1k Stars，842 Forks，一个让开发者直呼"真香"的开源神器

一、痛点：Claude Code 好用，但用不起

如果你是一名开发者，大概率已经听说过 Claude Code——Anthropic 推出的终端 AI 编程助手，能直接在命令行里帮你写代码、调 Bug、重构项目，被很多人称为"目前最强的 AI 编程工具"。

但现实是：

Claude Code 官方需要绑定 Anthropic API Key，按 Token 计费
Opus、Sonnet 等高端模型调用一次就是真金白银
国内开发者还面临访问、支付等重重障碍

于是很多人只能眼巴巴地看着别人用 Claude Code 飞速开发，自己却只能望洋兴叹。

直到这个项目出现了。

二、它是什么：一个"偷梁换柱"的代理层

free-claude-code 是 GitHub 用户 Alishahryar1（来自 Sunnyvale, CA）开发的一个开源 Python 项目。

它的核心思路非常聪明：

┌─────────────────┐    ┌──────────────────────┐    ┌──────────────────┐
│  Claude Code    │───>│  Free Claude Code    │───>│   真实 LLM 供应商  │
│  CLI / VSCode   │<───│  本地代理 (:8082)     │<───│  NIM / OR / 本地  │
└─────────────────┘    └──────────────────────┘    └──────────────────┘
     Anthropic API 格式                              OpenAI 兼容格式 (SSE)

简单说：它在本地启动一个代理服务器，拦截 Claude Code 发往 Anthropic 的请求，转发给其他免费/低价的 LLM 供应商，然后把返回结果转换成 Claude Code 能读懂的格式回传。

Claude Code 完全不知道自己其实在和别的模型说话。

无需修改 Claude Code CLI 或 VSCode 扩展本身，只需设置 2 个环境变量。
在这里插入图片描述

三、核心特性一览

🔀 灵活的模型路由

可以将 Claude Code 发出的 Opus、Sonnet、Haiku 三档请求，分别路由到不同的模型和供应商，按需搭配，自由混搭。

🆓 支持多种免费/低价供应商

供应商	是否需要 API Key	特点
NVIDIA NIM	需要（免费注册）	每分钟 40 次请求，推荐首选
OpenRouter	需要（免费层可用）	数百种模型可选，含大量免费模型
LM Studio	❌ 不需要	完全本地运行，离线可用
llama.cpp	❌ 不需要	本地运行 llama-server
DeepSeek	需要（极低价）	国产强模型，性价比极高

🛡️ 智能请求优化（节省额度）

项目内置了多种本地拦截优化，默认开启，能拦截 Claude Code 发出的"无意义"请求，避免浪费 API 额度：

跳过对话标题生成
跳过文件路径探测
跳过代码建议前缀检测
拦截 Task 工具，强制关闭后台子 Agent（防止失控）

🤖 Discord / Telegram 机器人支持

支持将 Claude Code 能力接入 Discord 或 Telegram，实现远程异步编程任务，有树状线程管理和会话持久化，类似 openclaw 的体验。

🎙️ 语音输入支持

通过集成 Whisper 模型（本地或 NVIDIA NIM），支持语音转文字输入指令。

四、怎么用：5 分钟上手教程

前提条件

已安装 Claude Code（npm install -g @anthropic-ai/claude-code）
已安装 uv（Python 包管理器）

方法一：直接安装（推荐）

# 安装 free-claude-code
uv tool install git+https://github.com/Alishahryar1/free-claude-code.git

# 初始化配置文件
fcc-init

这会在 ~/.config/free-claude-code/.env 生成配置模板，编辑它填入你的 API Key。

方法二：克隆源码

git clone https://github.com/Alishahryar1/free-claude-code.git
cd free-claude-code
cp .env.example .env

配置供应商（以 NVIDIA NIM 为例）

NVIDIA NIM 提供免费 API Key，注册即送，每分钟 40 次请求，是目前最推荐的免费方案。

编辑 .env 文件：

NVIDIA_NIM_API_KEY="nvapi-你的key"
MODEL_OPUS="nvidia_nim/z-ai/glm4.7"
MODEL_SONNET="nvidia_nim/moonshotai/kimi-k2-thinking"
MODEL_HAIKU="nvidia_nim/stepfun-ai/step-3.5-flash"
MODEL="nvidia_nim/z-ai/glm4.7"

配置供应商（以 OpenRouter 免费模型为例）

OPENROUTER_API_KEY="sk-or-你的key"
MODEL_OPUS="open_router/deepseek/deepseek-r1-0528:free"
MODEL_SONNET="open_router/openai/gpt-oss-120b:free"
MODEL_HAIKU="open_router/stepfun/step-3.5-flash:free"

配置供应商（完全本地，以 LM Studio 为例）

MODEL_OPUS="lmstudio/unsloth/MiniMax-M2.5-GGUF"
MODEL_SONNET="lmstudio/unsloth/Qwen3.5-35B-A3B-GGUF"
MODEL_HAIKU="lmstudio/unsloth/GLM-4.7-Flash-GGUF"

无需任何 API Key，纯本地运行，数据不出本机。

启动代理并使用

# 启动代理服务（默认监听 8082 端口）
uv run server.py

# 另开终端，设置环境变量后正常使用 Claude Code
export ANTHROPIC_BASE_URL="http://localhost:8082"
export ANTHROPIC_AUTH_TOKEN="任意字符串"
claude

也可以设置 alias 快速启动：

alias claude-free='ANTHROPIC_BASE_URL="http://localhost:8082" ANTHROPIC_AUTH_TOKEN="freecc" claude'

之后直接运行 claude-free 即可，体验与原版 Claude Code 完全一致。

五、总结

维度	评价
🎯 解决的问题	Claude Code 使用成本高、国内访问难
🔧 实现方式	本地代理转发 + 格式转换，无感替换后端模型
💰 成本	可做到完全零成本（NVIDIA NIM 免费额度 / 本地模型）
🚀 上手难度	中等，需要一定命令行基础
⚠️ 注意事项	替换的模型能力与真实 Claude 存在差距，复杂任务效果因模型而异