一句话答案
Free Claude Code 是一个开源的 API 转发代理，它能让你用免费的 Google Gemini API、性价比超高的 DeepSeek、本地 Ollama 或是 NVIDIA NIM 平台提供的 API，来免费且无限制地运行 Anthropic 官方的 Claude Code 终端编程工具。
为什么你需要 Free Claude Code？
如果你是开发者，你一定被 Anthropic 官方推出的终端 AI 编程助手 Claude Code CLI 惊艳过。它强大的项目分析、代码自动编写、终端命令执行和实时 Debug 能力，能够大幅提升开发效率。
然而，官方 Claude Code 伴随着以下局限：
- 费用昂贵：频繁的项目上下文读取与多轮对话，会迅速消耗你的 Anthropic API 余额。
- 额度限制：对于高频使用或企业开发，官方额度往往很快就见顶。
- 模型单一：无法灵活切换至其他模型（如专注中文的 DeepSeek，或推理能力强的 Gemini）。
Free Claude Code 完美解决了这些痛点。它在本地启动一个轻量级的代理服务器，拦截 Claude Code 发出的所有请求，并将其智能路由、翻译成其他 API 格式。你不仅可以用上完全免费的 Gemini，还能享受本地私有大模型的绝对隐私！
核心功能亮点
- 零门槛 drop-in 代理：只需修改几个环境变量，就能让 Claude Code “误以为”自己在调用官方接口。
- 17 大后端服务商支持：包括 Google AI Studio (Gemini)、DeepSeek、NVIDIA NIM、OpenRouter、Mistral AI、Groq、Ollama、LM Studio 等。
- 智能分层路由：可针对 Opus、Sonnet 和 Haiku 分别配置不同的后端大模型，完美保留 Claude Code 原生的
/model切换体验。 - 完美兼容核心协议：支持流式响应（Streaming）、函数与工具调用（Tool Use）、甚至 DeepSeek R1 这种思维链模型的推理块输出。
- 附带丰富周边：自带美观易用的本地 Admin 控制面板（Admin UI），另外还支持 Discord/Telegram 机器人远程接入、VSCode 插件整合以及 Whisper 语音识别。
快速上手教程：只需 4 步
第一步：一键式安装
确保你的系统已安装好 git、uv 还有 Python 环境。然后运行以下命令进行安装：
macOS / Linux 系统：
curl -fsSL "https://github.com/Alishahryar1/free-claude-code/blob/main/scripts/install.sh?raw=1" | sh
Windows (PowerShell)：
irm "https://github.com/Alishahryar1/free-claude-code/blob/main/scripts/install.ps1?raw=1" | iex
提示：安装脚本会自动检查 Python 3.14 环境、全局安装
fcc-server代理端及配套的命令行快捷方式。
第二步：启动代理服务器
在终端输入以下命令启动服务：
fcc-server
启动后，你会看到如下的终端输出，它会在本地 8082 端口运行，并打印出管理后台地址：
INFO: Admin UI: http://127.0.0.1:8082/admin (local-only)
用浏览器打开这个链接，你就可以进入可视化配置界面。
第三步：在 Admin UI 中配置你的模型
以最推荐的 Google AI Studio (Gemini) 和 DeepSeek 为例：
-
配置 Google Gemini（免费额度超大）：
- 访问 Google AI Studio 获取一个免费的 API Key。
- 在 Free Claude Code 的 Admin 界面，找到
GEMINI_API_KEY，粘贴你的 Key。 - 点击下方 Validate 校验并保存。
- 将主模型
MODEL设置为gemini/gemini-2.5-flash或gemini/gemini-3.1-flash-lite。
-
配置 DeepSeek（极致性价比）：
- 访问 DeepSeek 开放平台 获取 API Key。
- 在 Admin 页面找到
DEEPSEEK_API_KEY填入。 - 将主模型
MODEL设置为deepseek/deepseek-chat即可。
第四步：启动你的 Free Claude Code！
配置完毕后，你不需要直接运行官方的 claude 命令。相反，在你的项目目录下，输入：
fcc-claude
fcc-claude 是 Free Claude Code 提供的便捷封装，它会自动读取当前代理的端口和安全 Token，在后台自动设置好以下环境变量，并启动真正的官方 Claude Code：
ANTHROPIC_BASE_URL指向本地代理。- 自动设定 190k 自动压缩窗口大小，防爆上下文。
此时，你在终端里输入的所有指令，都会被转发给你的 Gemini 或 DeepSeek 模型！快去向它提问，或者让它帮你重构、审查当前项目下的代码吧！
常用服务商推荐与配置对照
| 推荐后端服务 | 获取密钥地址 | 典型模型标识 (MODEL) | 特点 / 适用场景 |
| :--- | :--- | :--- | :--- |
| Google AI Studio | aistudio.google.com | gemini/gemini-2.5-flash | 免费额度友好，速度飞快，适合日常大部分任务。 |
| DeepSeek API | platform.deepseek.com | deepseek/deepseek-chat | 价格低廉，中文编程和逻辑表达极其顺畅。 |
| NVIDIA NIM | build.nvidia.com | nvidia_nim/nvidia/nemotron-3-super-120b-a12b | 享受 NVIDIA 提供的海量免费 NIM 模型，包含国内外多个主流大模型。 |
| OpenRouter | openrouter.ai | open_router/stepfun/step-3.5-flash:free | 聚合各大厂商 API，有丰富的免费模型库可供直接白嫖。 |
| Ollama (本地运行) | 本地 Ollama 客户端 | ollama/qwen2.5-coder:7b | 100% 本地运行，完全不用担心商业机密和代码数据泄露。 |
高级技巧：模型分层路由 (Per-model Routing)
Claude Code 会根据不同的编程任务，自动选用不同的模型档次（Opus、Sonnet 或 Haiku）。在 Free Claude Code 中，你可以利用细粒度的环境变量，对这三个档次分配不同的模型：
MODEL_OPUS = deepseek/deepseek-reasoner # 遇到复杂推理任务，自动调用 DeepSeek R1 满血版
MODEL_SONNET = gemini/gemini-2.5-flash # 核心代码编写与分析，使用速度快的 Gemini 2.5
MODEL_HAIKU = open_router/google/gemini-2-flash-thinking-exp:free # 轻量询问或 fallback，走免费的 thinking 实验模型
你只需在 Admin UI 中分别配置这几个变量，就能在节省成本的同时，将各类大模型的长处发挥到极致。
常见问题与解答 (FAQ)
1. 为什么运行时提示我 API 格式不兼容？
请确保你使用的模型支持 Tool Use（即函数调用/工具执行）。Claude Code 高度依赖智能体在终端执行命令、读写文件的能力。如果大模型不支持 Tool Use，代理将无法正常协同工作。强烈建议使用 Gemini 2.5 系列、DeepSeek 官方 API，或者经过专门微调的代码模型（如 Qwen-2.5-Coder 等）。
2. 我的代码会被泄露给第三方吗？
Free Claude Code 服务本身是完全运行在本地的。代码是否泄露取决于你配置的“后端大模型”。如果你对隐私有极高要求，建议在本地运行 Ollama 并配置 Free Claude Code 连接本地的 ollama/qwen2.5-coder 或 ollama/llama3 模型。
3. 如何在 VSCode 插件中使用？
该代理提供了标准的兼容端点。只需在 VSCode 的 AI 编程插件（如 Continue 等）中，将自定义 API 的 Base URL 设置为 http://127.0.0.1:8082/v1 即可。
结语
Free Claude Code 以极其巧妙的代理转发思路，打破了官方 Claude Code 高昂价格的壁垒。它不仅让个人开发者能免费体验到终端 Agent 编程 the 快，也为企业团队探索本地化、低成本大模型编程提供了一条绝佳的路径。赶紧去 Star 他们的 GitHub 项目仓库，开始你的免费终端 AI 编程之旅吧！
