| 模型 | 免费额度 | 状态 |
| Gemini 3 Flash | ✅ 免费 | 15 RPM,1000 次/天 |
| Gemini 3 Flash Lite | ✅ 免费 | 30 RPM,1500 次/天 |
| Gemini 3.1 Pro | ❌ 已收费 | 4 月起取消免费 |
| Gemini 2.5 Pro | ❌ 已收费 | 4 月起取消免费 |
重点:Pro 系列全部收费了,但 Flash 系列不受影响。Flash 的代码能力对日常开发完全够用。
第一步:拿到 Gemini API Key
1. 打开 Google AI Studio
2. 用个人 Gmail 登录(为什么不能用公司账号,后面说)
3. 左侧菜单 → Get API Key → Create API Key
4. 复制保存,格式是 AIzaSy... 开头
整个过程 30 秒,不需要信用卡,不需要绑定支付方式。
方法一:Claude Code Router(推荐)
CCR 是目前最成熟的方案,一条命令搞定。
安装
npm install -g claude-code-router
配置
ccr init --provider gemini --api-key YOUR_GEMINI_API_KEY
这条命令自动创建 ~/.claude-code-router/config.json,把 Gemini 3 Flash 设为默认模型。
启动
ccr start --daemon
加 --daemon 让它在后台运行,不占终端。
使用
正常启动 Claude Code 就行:
claude
所有请求自动路由到 Gemini,你感知不到区别。
配置文件长这样
{
"providers": {
"gemini": {
"apiKey": "AIzaSy_YOUR_KEY",
"baseUrl": "https://generativelanguage.googleapis.com/v1beta",
"models": ["gemini-3-flash"]
}
},
"routing": {
"default": "gemini",
"rules": [
{
"pattern": "",
"provider": "gemini",
"model": "gemini-3-flash"
}
]
}
}
方法二:环境变量直连(更轻量)
不想装额外工具?Claude Code 支持环境变量切换:
export ANTHROPIC_BASE_URL="https://generativelanguage.googleapis.com/v1beta"
export ANTHROPIC_API_KEY="YOUR_GEMINI_API_KEY"
claude --model gemini-3-flash
想永久生效,写进 shell 配置:
# zsh 用户
echo 'export ANTHROPIC_BASE_URL="https://generativelanguage.googleapis.com/v1beta"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="YOUR_GEMINI_API_KEY"' >> ~/.zshrc
source ~/.zshrc
bash 用户
echo 'export ANTHROPIC_BASE_URL="https://generativelanguage.googleapis.com/v1beta"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="YOUR_GEMINI_API_KEY"' >> ~/.bashrc
source ~/.bashrc
fish 用户
set -Ux ANTHROPIC_BASE_URL "https://generativelanguage.googleapis.com/v1beta"
set -Ux ANTHROPIC_API_KEY "YOUR_GEMINI_API_KEY"
方法三:多 Key 轮换(进阶,突破限速)
免费额度是 15 RPM。如果你写代码比较猛,偶尔会触发限速。
解决方案:申请多个 API Key,做轮换。
用不同的 Gmail 账号各申请一个 Key,然后在 CCR 配置里:
{
"providers": {
"gemini": {
"apiKeys": [
"AIzaSy_KEY_1",
"AIzaSy_KEY_2",
"AIzaSy_KEY_3"
],
"strategy": "round-robin"
}
}
}
3 个 Key = 45 RPM,基本不会触发限速。
三个踩坑提示
坑 1:公司 Google Workspace 账号用不了
很多人第一反应是用公司邮箱登录 AI Studio,结果发现根本打不开或者没有 Create API Key 按钮。
原因:部分 Google Workspace 管理员禁用了 AI Studio 访问权限。
解决:用个人 Gmail 账号。30 秒注册一个新的也行。
坑 2:ccr start 占用终端
第一次用 CCR 的人经常犯这个错:开了一个终端窗口跑 ccr start,然后发现这个窗口被占了,没法干别的。
解决:
# 方法 A:后台模式
ccr start --daemon
方法 B:nohup
nohup ccr start > /dev/null 2>&1 &
方法 C:写成 LaunchAgent(macOS)
开机自启,永远在后台
坑 3:Gemini 偶尔返回格式不兼容
Gemini 的 API 响应格式和 Claude 不完全一致。CCR 会自动做转换,但偶尔会遇到边界情况(比如超长代码块被截断)。
解决:如果遇到奇怪的输出,在 config.json 里加一行:
{
"transforms": {
"response": {
"maxTokens": 8192,
"truncateStrategy": "end"
}
}
}
免费额度用完了怎么办?
如果某天你用量特别大,免费额度耗尽:
1. 降级到 Flash Lite — 更小的模型,免费额度更大(30 RPM,1500 次/天),简单任务够用
2. 切到国内免费 API — 硅基流动注册送 14 元额度,DeepSeek 注册也送额度
3. 切回 Claude — 在 config 里加 fallback 规则,Gemini 挂了自动切 Claude
{
"routing": {
"fallback": [
{"provider": "gemini", "model": "gemini-3-flash-lite"},
{"provider": "siliconflow", "model": "deepseek-v3"},
{"provider": "anthropic", "model": "claude-sonnet-4.5"}
]
}
}
实测对比:Gemini Flash vs Claude Sonnet
同一个任务(写一个 Express.js CRUD API + 单元测试),两个模型跑一遍:
| 维度 | Claude Sonnet 4.5 | Gemini 3 Flash |
| 代码质量 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| 响应速度 | 2.3 秒 | 1.1 秒 |
| 上下文理解 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| 中文注释 | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| 月费用 | $50-200 | $0 |
结论:日常写函数、改 bug、生成模板,Gemini Flash 完全够用。只有复杂架构设计、大规模重构时才需要切回 Claude。
我的实际使用策略
跑了两周后,我摸索出一套混合策略:
- 80% 的时间用 Gemini Flash — 日常编码、写测试、改样式、生成模板
- 15% 的时间用 Flash Lite — 简单问答、文档查询、格式转换
- 5% 的时间切回 Claude Opus — 复杂架构决策、多文件重构、安全审计
这样算下来,每月 AI 编程费用从 $150+ 降到了不到 $10。省了 93%。
总结
| 方法 | 难度 | 耗时 | 推荐度 |
| CCR 一键配置 | ⭐ | 5 分钟 | ⭐⭐⭐⭐⭐ |
| 环境变量直连 | ⭐ | 2 分钟 | ⭐⭐⭐⭐ |
| 多 Key 轮换 | ⭐⭐ | 10 分钟 | ⭐⭐⭐⭐⭐ |