Gemini CLI 中转站配置使用教程

第 1 步：安装并查看版本

按官方安装页准备支持的 Node.js 环境，然后安装 CLI。

npm install -g @google/gemini-cli
gemini --version

第 2 步：设置 Gemini 原生接口变量

macOS / Linux，在运行 CLI 的同一终端配置：

export GEMINI_API_KEY="YOUR_tokenba_API_KEY"
export GOOGLE_GEMINI_BASE_URL="https://api.apizt.com"
export GEMINI_MODEL="YOUR_AVAILABLE_GEMINI_MODEL_ID"

Windows PowerShell：

$env:GEMINI_API_KEY = "YOUR_tokenba_API_KEY"
$env:GOOGLE_GEMINI_BASE_URL = "https://api.apizt.com"
$env:GEMINI_MODEL = "YOUR_AVAILABLE_GEMINI_MODEL_ID"

模型占位符替换为 apizt 当前支持的 Gemini 原生模型 ID。CLI 使用 Gemini 协议，不能将地址改为 OpenAI 的 /v1/chat/completions。

第 3 步：选择 API key 认证

运行 gemini，按认证引导选择 Gemini API key；GOOGLE_GEMINI_BASE_URL 在该认证模式下生效。之前使用 Google 登录时，应切换认证模式并重启 CLI，不只修改地址变量。

第 4 步：先验证文本再验证工具

询问一个短问题，核对网关原生 Gemini 路由上的请求记录。随后测试读取本地项目文件。认证正常但工具失败时，分别核对模型能力与 CLI 工具权限。

API Key 认证与 OAuth 分开核对

启动后选择 Use Gemini API key。GOOGLE_GEMINI_BASE_URL 仅对 gemini-api-key 模式生效；Google 登录或 Vertex 模式不会因设置此变量就改走该地址。检查项目与用户目录的 .gemini/.env 是否覆盖配置。

export GEMINI_API_KEY="YOUR_tokenba_API_KEY"
export GOOGLE_GEMINI_BASE_URL="https://api.apizt.com"
export GEMINI_MODEL="gemini-3.8-flash"
gemini --version
gemini

Node.js 要求 20+。npm 的 latest 是公开发布版本；本机未安装 Gemini CLI，不能据此填写 CLI 实测版本。

真实调用记录与验证范围

测试日期：2026-09-28（Asia/Shanghai）；macOS 26.3。查看脱敏记录、软件版本和真实生成图片。一次文本成功仅证明本次请求，不代表其他模型、工具执行、多轮上下文或桌面版均已通过。

client: Python requests 2.33.1
POST https://api.apizt.com/v1beta/models/gemini-3.8-flash:generateContent
HTTP 200
output: tokenba_OK

原生接口真实调用已通过；Gemini CLI 的认证选择、工具和会话尚未实测。Google 登录仍出现、Base URL 未生效和 404 排查。

已额外验证 Gemini SDK 常用的 x-goog-api-key 鉴权头：同一原生路径返回 HTTP 200，算术题返回 4。这仍是接口测试，Gemini CLI 的认证界面及工具未验证。