在 AI 辅助编程领域，Anthropic 官方推出的命令行工具 Claude Code 因其极强的 Agent 代码理解与执行能力深受开发者喜爱。然而，高昂的 API 调用费用常常让个人开发者与独立创作者望而却步。
开源项目 free-claude-code 在 GitHub 上迅速跻身热门榜单，获得了 5.7 万 Star。它通过在本地搭建轻量级请求代理中转站，将 Claude Code 的 API 请求无缝映射至 60 多家服务商提供的免费/低成本模型，帮助开发者实现无限额度的 AI 编程辅助。
一、 工作原理与核心架构
free-claude-code 的核心机制非常巧秒：保留 Claude Code 的终端交互体验，替换底层的计费 API 接口。
Claude Code 命令行 ──► 本地代理中转站 (Local Proxy) ──► 60+ 服务商免费模型 API
- 本地代理拦截：在本地运行一个轻量级代理服务，模拟 Anthropic 官方 API 接口规范（
api.anthropic.com）。 - 多服务商路由：将原本发送给 Anthropic 的请求，动态重定向并路由至包括 Groq、Together AI、DeepSeek、OpenRouter 等 60 多家提供免费 Tier 或高额度 API 的服务商。
- 协议适配与响应转换：自动完成上下文格式适配与流式响应转换，让 Claude Code 以为自己依然在与官方模型对话。
二、 快速部署与配置步骤
只需简单三步即可在本地跑通这套免费替换方案：
1. 克隆项目与安装依赖
Bash
git clone https://github.com/Alishahryar1/free-claude-code.git
cd free-claude-code
npm install # 或使用 pnpm install
2. 配置免费 API 密钥
复制环境配置文件并填入支持的服务商 Key（如 Groq 或 OpenRouter 的免费 Key）：
Bash
cp .env.example .env
# 编辑 .env 文件，填入你的免费 API Key
3. 启动本地代理并运行 Claude Code
启动本地代理中转服务（默认监听本地端口）：
Bash
npm start
另开终端，配置 Claude Code 的环境变量指向本地代理：
Bash
export ANTHROPIC_BASE_URL="http://localhost:3000"
claude