如何在 Gemini CLI 中接入 CCAPI

本指南帮助你将 Google Gemini CLI 连接到 CCAPI，以更低的价格使用 Gemini 系列模型。

Gemini CLI 是 Google 推出的开源 AI 编程 CLI 工具，支持代码生成、调试、文件操作、多模态输入等。

前提条件

已安装 Gemini CLI — npm install -g @anthropic-ai/gemini-cli 或参考 GitHub 仓库

CCAPI 账号 — 访问 ccapi.ai 注册

CCAPI 令牌 — 在控制台 > 令牌创建

访问 ccapi.ai 注册或登录

点击 新建令牌，复制密钥（只显示一次）

设置以下环境变量，将 Gemini CLI 指向 CCAPI：

添加到 ~/.bashrc 或 ~/.zshrc 后重启终端。

注意：Base URL 不要加 /v1 或其他路径后缀，Gemini CLI 会自动拼接。

CCAPI 支持以下 Gemini 模型，通过 CCAPI 使用最低可至官方 2 折：

等等其他更多模型

Gemini CLI 默认使用 gemini-2.5-flash。如果需要切换模型，可以在启动时指定：

完整模型列表和实时价格请查看模型广场。

输入一个简单问题测试：

你好，请介绍一下自己

如果正常回复，说明配置成功。可以在控制台 > 日志查看调用记录。

问题	解决方案
连接失败	确认 `GOOGLE_GEMINI_BASE_URL` 设为 `https://api.ccapi.ai`（不加路径后缀）
令牌无效	去控制台检查令牌状态
余额不足	去控制台 > 充值充值
模型不存在	检查模型名拼写，在模型广场确认可用模型

Base URL：https://api.ccapi.ai（不加路径后缀）

认证环境变量：GEMINI_API_KEY

Base URL 环境变量：GOOGLE_GEMINI_BASE_URL

模型广场：ccapi.ai/pricing