AIAI 工具图鉴
← 返回全部文章
·约 14 分钟PPT

🔥 【今日推荐 free-claude-code】：不花一分钱免费用上 Claude Code！今日 GitHub 热榜第一，2638 Stars 疯涨！

编程开发
下载 PPT下载视频

配套媒体

本页对应的 PPT 与演示视频

free-claude-code-recommend.mp4
PPT
free-claude-code-recommend.pptx浏览器不能直接打开 PPT，下载后用 PowerPoint / WPS / Keynote 查看
下载没反应？点这里复制直链

侧边栏预览窗口（Electron webview）会拦截下载，把下面的链接复制到 Chrome / Edge 地址栏打开即可保存。

PPT../../free-claude-code-recommend.pptx
视频../../free-claude-code-recommend.mp4
本文目录
  1. 🚀 什么是 free-claude-code？
  2. ✨ 核心功能一览
  3. 🛠️ 快速上手：5 分钟配置完毕
  4. Step 1：安装 Claude Code CLI
  5. Step 2：获取免费 API Key
  6. Step 3：克隆并配置
  7. Step 4：编辑 .env 文件（选择 NVIDIA NIM 后端）
  8. Step 5：启动代理并配置 Claude Code
  9. 🏗️ 工作原理深度解析
  10. 智能模型映射
  11. 💡 适用场景
  12. 三种使用模式
  13. 场景一：终端 CLI 模式
  14. 场景二：VSCode 扩展模式
  15. 场景三：Discord 机器人模式
  16. 用户群体总结
  17. 📊 与其他方案对比
  18. 🔧 支持的后端详细配置
  19. NVIDIA NIM（推荐新手）
  20. OpenRouter（模型选择最多）
  21. LM Studio（完全本地，保护隐私）
  22. 💰 成本对比
  23. 🎯 总结

🔥 【今日推荐 free-claude-code】：不花一分钱免费用上 Claude Code！今日 GitHub 热榜第一，2638 Stars 疯涨！

封面图

Claude Code 太贵？这个开源项目帮你绕过 Anthropic 官方 API，把 Claude Code 的请求路由到 NVIDIA NIM 等免费平台。只需 2 个环境变量，5 分钟配置完毕，零成本体验顶级 AI 编程助手。

GitHub stars GitHub forks

🚀 什么是 free-claude-code？

free-claude-code 是 GitHub 用户 Alishahryar1 开发的开源 Python 代理工具。它的核心思路非常优雅：在本地启动一个轻量级代理服务器，拦截 Claude Code 发往 Anthropic 官方 API 的请求，把它们转发到 NVIDIA NIM、OpenRouter、DeepSeek、LM Studio 或 llama.cpp 等免费或低成本的 AI 平台。

Claude Code CLI 和 VSCode 扩展完全感觉不到区别——它们只知道在和"Anthropic API"通信，实际上背后是完全免费的服务。

核心价值：用 2 个环境变量，把 $20+/月的 Claude Code 订阅费变成 $0。

项目今日登上 GitHub 全站热榜第 1 名，当日新增 +2,638 Stars，总 Stars 已突破 9,062，Fork 数达到 1,334。

✨ 核心功能一览

功能特性表

六大核心特性一览：

  • 🔑 零 API 密钥：NVIDIA NIM 提供每分钟 40 次免费请求，完全无需付费
  • ⚡ 即插即用：只需设置 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY 两个环境变量
  • 🔄 多后端支持：NVIDIA NIM、OpenRouter、DeepSeek、LM Studio、llama.cpp 五选一
  • 🧠 思维令牌：支持解析 <thinking> 标签，让思维链过程完全可见
  • 🛡️ 智能限流：滚动窗口算法 + 指数退避重试，绝不超出免费额度
  • 🤖 远程控制：Discord / Telegram 机器人，随时随地调用 AI 编程能力

🛠️ 快速上手：5 分钟配置完毕

Step 1：安装 Claude Code CLI

# 需要 Node.js 18+
npm install -g @anthropic-ai/claude-code

Step 2：获取免费 API Key

前往 NVIDIA NIM 注册并获取免费 API Key（无需信用卡，注册即有 40 次/分钟免费额度）。

Step 3：克隆并配置

# 克隆仓库
git clone https://github.com/Alishahryar1/free-claude-code.git
cd free-claude-code

# 安装依赖
pip install uv
uv sync

# 复制配置模板
cp .env.example .env

Step 4：编辑 .env 文件（选择 NVIDIA NIM 后端）

# .env 配置文件（NVIDIA NIM 推荐配置）
NVIDIA_NIM_API_KEY="nvapi-你的密钥"
MODEL_OPUS="nvidia_nim/moonshotai/kimi-k2-thinking"
MODEL_SONNET="nvidia_nim/z-ai/glm4-7b"
MODEL_HAIKU="nvidia_nim/stepfun-ai/step-3.5-flash"
ENABLE_THINKING=true

Step 5：启动代理并配置 Claude Code

# 启动代理服务器（在 localhost:8080 监听）
uv run python proxy.py

# 新开一个终端，设置环境变量（Windows PowerShell）
$env:ANTHROPIC_BASE_URL = "http://localhost:8080/v1"
$env:ANTHROPIC_API_KEY = "anything"  # 任意值即可

# Linux/macOS
export ANTHROPIC_BASE_URL="http://localhost:8080/v1"
export ANTHROPIC_API_KEY="anything"

# 启动 Claude Code，与平时完全相同！
claude

注意：代理服务器必须在后台保持运行，否则 Claude Code 连不上。建议用 tmux 或 Windows Terminal 的新标签页保持运行。

🏗️ 工作原理深度解析

工作原理图

整个流程只有 4 步：

  1. Claude Code 发起请求 → 向 localhost:8080/v1 发送 Anthropic 格式的 API 请求
  2. 代理拦截 & 路由 → free-claude-code proxy 接收请求，根据 .env 配置选择目标后端
  3. 后端执行推理 → NVIDIA NIM / OpenRouter 等平台执行实际的 AI 推理
  4. 响应格式转换 → 代理把后端响应转换回 Claude Code 期望的 Anthropic 格式，返回给客户端

智能模型映射

free-claude-code 会把 Claude Code 请求的模型名称（opus/sonnet/haiku）映射到对应后端的等效模型：

# 模型映射示例（内部实现）
MODEL_MAP = {
    "claude-opus-4-5": os.getenv("MODEL_OPUS"),      # 最强 → 最强后端模型
    "claude-sonnet-4-5": os.getenv("MODEL_SONNET"),  # 均衡 → 均衡后端模型
    "claude-haiku-4-5": os.getenv("MODEL_HAIKU"),    # 快速 → 快速后端模型
}

💡 适用场景

三种使用模式

使用场景图

场景一：终端 CLI 模式

功能说明：在命令行终端中使用完整的 Claude Code 功能，包括文件读写、命令执行、多轮对话、代码生成。对于使用 Linux 服务器或 WSL 的开发者，这是最流畅的方案。

输入要求：只需配置好环境变量，像平时一样运行 claude 命令。

输出效果：完整的 Claude Code 对话体验，支持代码生成、调试、解释、重构等所有功能。

适用场景：个人开发项目、服务器端编程、脚本开发、算法实现。

场景二：VSCode 扩展模式

功能说明：在 VSCode 中安装 Claude Code 官方扩展，但把 API 请求路由到免费代理。可以在编辑器内直接调用 AI 能力，包括代码补全建议、文件间导航分析、PR Review 等。

输入要求：安装 VSCode 扩展后，在设置中把 Base URL 改为 http://localhost:8080/v1。

输出效果：与官方付费版完全相同的 VSCode 集成体验，实时代码辅助。

适用场景：日常编程工作、代码审查、技术文档编写、学习新框架时的即时帮助。

场景三：Discord 机器人模式

功能说明：把 Claude Code 能力接入 Discord 机器人，团队成员可以在频道里直接@机器人请求代码帮助。适合开发团队的协作场景，也适合不在电脑旁时用手机触发编程任务。

输入要求：额外配置 Discord Bot Token，参考仓库的 Discord bot 配置文档。

输出效果：团队频道内的 AI 编程助手，支持代码块响应。

适用场景：开发团队协作、远程办公、学习社区、开源项目维护。

用户群体总结

  • ✅ 学生/初学者：体验顶级 AI 编程工具，零成本学习
  • ✅ 独立开发者：削减 SaaS 订阅费，用免费方案替代
  • ✅ 开源贡献者：低成本维护多个项目，按需使用
  • ✅ AI 研究者：对比不同后端模型在编程任务上的表现
  • ❌ 不适合：企业生产级需求（建议使用官方 API，稳定性有保障）

📊 与其他方案对比

竞品对比表

free-claude-code 最大的优势在于零成本+多后端选择，配置极简。与直连 OpenRouter 相比，它额外提供了对 Claude Code 客户端的原生兼容，无需修改任何客户端配置。

🔧 支持的后端详细配置

NVIDIA NIM（推荐新手）

NVIDIA_NIM_API_KEY="nvapi-xxxx"
MODEL_OPUS="nvidia_nim/moonshotai/kimi-k2-thinking"
MODEL_SONNET="nvidia_nim/z-ai/glm4-7b"
MODEL_HAIKU="nvidia_nim/stepfun-ai/step-3.5-flash"
ENABLE_THINKING=true

免费额度：40 req/min，注册地址：build.nvidia.com/settings/api-keys

OpenRouter（模型选择最多）

OPENROUTER_API_KEY="sk-or-xxxx"
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（完全本地，保护隐私）

LM_STUDIO_BASE_URL="http://localhost:1234/v1"
# 无需 API Key，使用本地加载的模型

💰 成本对比

方案 月费用 请求限制 模型质量
官方 Claude Code $20/月起 无硬性限制 最佳
free-claude-code + NVIDIA NIM $0 40次/分钟 良好
free-claude-code + OpenRouter 免费模型 $0 视模型而定 良好
free-claude-code + LM Studio（本地） $0 无限制 依赖本地硬件

开源协议：MIT License

💡 NVIDIA NIM 推荐理由：免费额度对个人开发者完全够用，GLM4-7B 和 Kimi K2 的编程能力均达到 GPT-4 级别，Claude Code 的工具调用能正常工作。

🎯 总结

free-claude-code 是今年最"实用"的开源项目之一。它不是什么复杂的技术创新，而是一个精准解决痛点的轻量工具：Claude Code 好用但太贵，NVIDIA NIM 免费但用不上——它把两者完美连接在一起。

9,000+ Stars、1,300+ Fork、今日 GitHub 全站第一，说明这个需求是真实而普遍的。5 分钟配置完毕，立刻省下每月 $20 的订阅费，任何人都值得试一次。

推荐指数： ⭐⭐⭐⭐⭐（满分5星）

适合人群：所有想用 Claude Code 但不想付费的开发者

GitHub 仓库：Alishahryar1/free-claude-code

数据截至 2026 年 4 月 25 日，最新信息请以官网为准。NVIDIA NIM 免费额度政策可能调整，使用前请确认最新条款。