让 Claude Code 用上 Google 最强免费模型，零成本体验 AI 编程
一、先说重点：为什么你要接入 Gemini？
用过 Claude Code 的开发者都知道，这玩意儿是真的香——用它重构代码、修 Bug、写测试，效率直接起飞。
但问题也很现实：Claude Code 虽然免费，背后调用的却是收费的 Claude API。没有 Pro/Max 订阅？抱歉，门都进不去。
一个月 20 美元，说贵不贵，说便宜也不便宜。尤其是对学生党、刚入行的开发者，或者只是想体验一下的个人用户来说，这钱花得确实有点肉疼。
有没有不花钱的办法？
还真有！Google 的 Gemini API 提供了免费层，而且这额度相当能打：
| 模型 | 每日请求次数 | 每分钟 Tokens | 推荐场景 |
|---|---|---|---|
| Gemini 2.5 Pro | 100 次 | 25 万 | 复杂推理、深度思考 |
| Gemini 2.5 Flash | 250 次 | 25 万 | 日常开发首选 |
| Gemini 2.5 Flash-Lite | 1000 次 | 25 万 | 高频调用、批处理 |
今天这篇文章，就是教你怎么零成本让 Claude Code 接入 Gemini，用上 Google 的免费算力。
二、原理讲解：Claude Code 是怎么接入第三方模型的？
在开始配置之前，先简单说说原理，不然你配置半天不知道为什么能跑通，出了问题也不知道咋回事。
Claude Code 默认连接的是 Anthropic 的 API。但实际上，它支持通过环境变量指定第三方 API 端点。只要第三方服务提供Anthropic 兼容格式的接口，就能正常使用。
核心就是这三个环境变量：
# 指定 API 服务器地址
export ANTHROPIC_BASE_URL=https://generativelanguage.googleapis.com/v1beta/models/
# API 密钥（Gemini 的 key）
export ANTHROPIC_AUTH_TOKEN=你的 Gemini 密钥
# 使用的模型
export ANTHROPIC_MODEL=gemini-2.5-pro
但问题来了——Gemini 的原生 API 格式和 Anthropic 并不完全兼容，直接这样配置会报错。所以我们需要一个中间层来做格式转换。
这个中间层，就是我们今天要安装的 Claude Code Gemini 代理服务。
三、实战操作：四步完成接入
第一步：获取 Gemini API 密钥
这是整个流程的前提，没有 API 密钥什么都做不了。
- 访问 Google AI Studio
- 使用 Google 账号登录
- 点击 “Get API Key”
- 选择 “Create API Key in new project”（或选择已有项目）
- 复制生成的密钥，保存好
⚠️ 提示：Gemini 免费 API 有地域限制，部分地区可能无法使用。如果无法访问，可以考虑使用中转服务。
第二步：安装 Claude Code Gemini 代理
这是一个开源项目，专门解决格式兼容问题。
# 克隆项目
git clone https://github.com/yuqie6/claude-code-gemini.git
# 进入目录
cd claude-code-gemini
# 安装依赖（推荐使用 uv，速度更快）
uv sync
# 或者使用 pip
pip install -r requirements.txt
第三步：配置 API 密钥
# 复制配置模板
cp .env.example .env
# 编辑配置文件
nano .env
在 .env 文件中填入你的 Gemini API 密钥：
# 必须配置
GEMINI_API_KEY=你的 Gemini 密钥
# 可选配置
# GEMINI_BASE_URL=custom_endpoint # 如需使用自定义端点
BIG_MODEL=gemini-2.5-pro # 对应 Claude sonnet/opus
SMALL_MODEL=gemini-2.5-flash # 对应 Claude haiku
PORT=8082 # 默认端口
HOST=0.0.0.0 # 监听地址
第四步：启动服务并使用
启动代理服务：
# 直接运行
python -m src.main
# 或者使用 uv
uv run claude-code-gemini
看到类似这样的输出，说明服务启动成功：
INFO: Uvicorn running on http://0.0.0.0:8082
新开一个终端，启动 Claude Code：
# Linux/macOS
export ANTHROPIC_BASE_URL=http://localhost:8082
export ANTHROPIC_API_KEY=any-key
claude
# Windows PowerShell
$env:ANTHROPIC_BASE_URL="http://localhost:8082"
$env:ANTHROPIC_API_KEY="any-key"
claude
💡 小技巧：每次都输环境变量太麻烦了，直接写到配置文件里一劳永逸：
echo 'export ANTHROPIC_BASE_URL=http://localhost:8082' >> ~/.zshrc echo 'export ANTHROPIC_API_KEY=any-key' >> ~/.zshrc source ~/.zshrc
四、验证：让你的 Claude Code 跑起来
服务启动后，来个简单的测试：
# 创建一个测试项目
mkdir claude-test && cd claude-test
# 启动 Claude Code
claude
在 Claude Code 中输入：
请创建一个简单的计算器程序，支持加减乘除四种运算。
如果程序正常生成并可以运行，说明接入成功！
五、进阶配置：榨干 Gemini 的免费额度
模型自动路由
Claude Code Gemini 支持自动选择模型。这个功能挺贴心的——简单任务自动用 Flash 省额度，复杂任务切到 Pro 保证质量。
在配置中设置不同场景使用的模型：
# 日常对话用 Flash，速度快
SMALL_MODEL=gemini-2.5-flash
# 复杂任务用 Pro，能力强
BIG_MODEL=gemini-2.5-pro
避免频繁换页
Gemini 免费版有请求限制，额度用完就只能等第二天了。所以日常使用的时候注意几点：
- 经常使用
/clear重置对话，上下文太长会增加 token 消耗 - 拆分大任务 为多个小任务，不要一股脑全丢给它
- 简单任务用 Flash 就够了，把 Pro 额度留给真正复杂的场景
监控 API 用量
Gemini API 控制台可以查看用量：
- 访问 Google AI Studio - API Key 管理
- 点击对应的 API Key
- 查看今日/本周/本月用量
六、常见问题解答
Q1：连接成功但没有响应？
检查代理服务是否正常运行，确认端口 8082 没有被占用：
# 查看端口占用
lsof -i :8082
# 如果端口被占用，修改.env 中的 PORT 值
Q2：提示 API 额度用完？
免费额度每日午夜（太平洋时间）重置。可以：
- 等待次日重置
- 切换到 Flash-Lite 模型（每天 1000 次请求）
- 考虑付费升级
Q3：工具调用不生效？
Gemini 的函数调用能力和 Claude 比起来确实有些差距。不是说 Gemini 不行，只是在极端复杂的场景下，可能会出现工具调用不生效的情况。遇到这种问题，把 prompt 简化一下通常能解决。
Q4：Windows 用户无法启动？
Windows 下 PowerShell 的环境变量设置和 Linux 不同，确保使用正确的语法：
# PowerShell
$env:ANTHROPIC_BASE_URL="http://localhost:8082"
# CMD
set ANTHROPIC_BASE_URL=http://localhost:8082
七、替代方案：还有其他免费接入方式
如果你觉得上面那套方案太复杂，或者想试试其他选择，也有几条路可以走。
方案二：Claude Code Router
如果你想同时使用多个模型（如 DeepSeek、GLM 等），可以试试 Claude Code Router。
安装：
npm install -g @musistudio/claude-code-router
ccr ui
