free-claude-code是一个代理服务器，核心目的是让你免费使用 Claude Code（Anthropic 的 AI 编程助手 CLI 和 VSCode 扩展），不需要 Anthropic API Key。

一、这个项目是干什么的？

核心原理

Claude Code 默认会向 Anthropic 的 API 发送请求（需要付费 API Key）。这个项目搭建了一个本地代理服务器，拦截 Claude Code 的请求，将其转发到其他免费或低成本的 LLM 提供商，再把响应转回给 Claude Code。

支持的提供商（6个）

提供商	费用	速率限制	适用场景
NVIDIA NIM	免费	40 请求/分钟	日常主力，推荐
OpenRouter	免费/付费	因模型而异	模型选择多
DeepSeek	按量付费	因套餐而异	直连 DeepSeek
LM Studio	免费（本地）	无限制	隐私、离线
llama.cpp	免费（本地）	无限制	轻量本地推理
Ollama	免费（本地）	无限制	最简单的本地部署

主要特性

• 零成本：NVIDIA NIM 提供 40 req/min 的免费额度

• 即插即用：只需设置 2 个环境变量，无需修改 Claude Code 本身

• 按模型路由：Claude Opus/Sonnet/Haiku 可分别映射到不同提供商的不同模型

• 思考 Token 支持：自动解析 <think> 标签为 Claude 原生思考块

• 请求优化：拦截 5 类 trivial 请求（标题生成、配额探测等），节省 API 额度

• Discord/Telegram Bot：远程通过聊天软件控制 Claude Code

• 语音消息：支持发送语音消息，自动转录后处理

二、怎么用？

前置条件

1. 安装 Claude Code（Anthropic 官方 CLI 工具）

2. 安装 uv（Python 包管理器）

3. 获取对应提供商的 API Key（或准备本地模型）

安装步骤

1. 安装 uv 和 Python 3.14

# macOS/Linux
curl-LsSf https://astral.sh/uv/install.sh |sh
uv self update
uv python install3.14

powershell

# Windows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
uv self update
uv python install 3.14

2. 克隆项目并配置

bash

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

3. 编辑 .env 文件，选择提供商

方案 A：NVIDIA NIM（推荐，免费）

env

NVIDIA_NIM_API_KEY="nvapi-你的密钥"

MODEL="nvidia_nim/z-ai/glm4.7"
MODEL_OPUS="nvidia_nim/moonshotai/kimi-k2.5"
MODEL_SONNET="nvidia_nim/qwen/qwen3.5-397b-a17b"
MODEL_HAIKU="nvidia_nim/z-ai/glm4.7"

ENABLE_MODEL_THINKING=true

方案 B：OpenRouter（免费模型）

env

OPENROUTER_API_KEY="sk-or-你的密钥"

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"
MODEL="open_router/stepfun/step-3.5-flash:free"

方案 C：Ollama（完全本地，无需 API Key）

env

OLLAMA_BASE_URL="http://localhost:11434"

MODEL_OPUS="ollama/llama3.1"
MODEL_SONNET="ollama/llama3.1"
MODEL_HAIKU="ollama/llama3.1"
MODEL="ollama/llama3.1"

需要提前运行 ollama pull llama3.1 和 ollama serve

方案 D：混合提供商

env

NVIDIA_NIM_API_KEY="nvapi-xxx"
OPENROUTER_API_KEY="sk-or-xxx"

MODEL_OPUS="nvidia_nim/moonshotai/kimi-k2.5"
MODEL_SONNET="open_router/deepseek/deepseek-r1-0528:free"
MODEL_HAIKU="lmstudio/unsloth/GLM-4.7-Flash-GGUF"
MODEL="nvidia_nim/z-ai/glm4.7"

4. 启动代理服务器

bash

uv run uvicorn server:app --host0.0.0.0 --port8082

5. 运行 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

注意：ANTHROPIC_BASE_URL 指向代理根地址 http://localhost:8082，不要加 /v1。

三、VSCode 扩展配置

1. 启动代理服务器（同上）

2. 打开 VSCode 设置（Ctrl + ,），搜索 claude-code.environmentVariables

3. 点击 Edit in settings.json，添加：

JSON

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

1. 重新加载扩展

2. 如果弹出登录界面，点击 Anthropic Console 授权即可（不需要真的购买额度）

四、IntelliJ 扩展配置

1. 打开配置文件：

   • Windows: C:\Users\%USERNAME%\AppData\Roaming\JetBrains\acp-agents\installed.json

   • Linux/macOS: ~/.jetbrains/acp.json

2. 在 acp.registry.claude-acp 中添加：

JSON

"env":{
"ANTHROPIC_AUTH_TOKEN":"freecc",
"ANTHROPIC_BASE_URL":"http://localhost:8082"
}

1. 启动代理服务器，重启 IDE

五、模型选择器（claude-pick）

不想每次改 .env 切换模型？可以用交互式模型选择器：

1. 安装 fzf：brew install fzf

2. 在 ~/.zshrc 或 ~/.bashrc 添加：

bash

alias claude-pick="/绝对路径/to/free-claude-code/claude-pick"

1. 运行 claude-pick，每次启动时交互选择模型

或者直接用固定模型别名：

bash

alias claude-kimi='ANTHROPIC_BASE_URL="http://localhost:8082" ANTHROPIC_AUTH_TOKEN="freecc:moonshotai/kimi-k2.5" claude'

六、Discord/Telegram Bot（远程控制）

可以通过 Discord 或 Telegram 远程给 Claude Code 下发任务、查看实时进度。

Discord 配置

1. 去 Discord Developer Portal 创建 Bot，复制 Token，开启 Message Content Intent

2. 在 .env 中配置：

env

MESSAGING_PLATFORM="discord"
DISCORD_BOT_TOKEN="你的Discord Bot Token"
ALLOWED_DISCORD_CHANNELS="频道ID1,频道ID2"
CLAUDE_WORKSPACE="./agent_workspace"
ALLOWED_DIR="C:/Users/你的名字/projects"

1. 启动代理服务器即可

2. 用 OAuth2 URL Generator 邀请 Bot 进服务器（权限：读取消息、发送消息、管理消息、读取历史消息）

Telegram 配置

env

MESSAGING_PLATFORM="telegram"
TELEGRAM_BOT_TOKEN="123456789:ABC..."
ALLOWED_TELEGRAM_USER_ID="你的Telegram用户ID"

七、语音消息支持

Discord/Telegram 中可以发送语音消息，系统会自动转录：

• 本地 Whisper（默认，免费离线）：uv sync --extra voice_local

• NVIDIA NIM：uv sync --extra voice

配置：

env

VOICE_NOTE_ENABLED=true
WHISPER_DEVICE=cpu    # 或 cuda / nvidia_nim
WHISPER_MODEL=base    # tiny/base/small/medium/large-v2/large-v3

八、安装为系统工具（无需克隆）

bash

uv tool install git+https://github.com/Alishahryar1/free-claude-code.git
fcc-init        # 创建 ~/.config/free-claude-code/.env
# 编辑 .env 填入 API Key 和模型
free-claude-code    # 启动服务器

更新：uv tool upgrade free-claude-code

---

九、重要注意事项

1. Python 版本：项目要求 Python 3.14

2. BASE_URL 格式：ANTHROPIC_BASE_URL="http://localhost:8082"，不要加 /v1

3. 模型前缀格式：provider_prefix/model/name，如 nvidia_nim/z-ai/glm4.7

4. NVIDIA NIM 免费额度：40 请求/分钟，足够日常编码使用

5. 本地模型：Ollama 和 LM Studio 完全免费，但需要足够的本地算力（GPU）

6. 安全性：可以设置 ANTHROPIC_AUTH_TOKEN 限制代理访问，防止公开网络被滥用

总结

这个项目本质上是一个" Claude Code 免费化中间件"，通过本地代理把 Anthropic 的付费 API 请求转发到支持的其他厂商API下或本地模型上。配置简单，只需改 .env 文件、启动代理、设置两个环境变量即可使用。还额外提供了 Discord/Telegram 远程控制和语音输入等高级功能。

对于想免费用 Claude Code 做 AI 编程助手的开发者来说非常实用。

有任何问题都可以留言讨论！

GitHub仓库链接:Alishahryar1/free-claude-code: Use claude-code for free in the terminal, VSCode extension or via discord like openclaw

文件压缩包网盘自取：https://pan.quark.cn/s/f78fc667d47d