Gemini CLI

Gemini CLI 是 Google 推出的开源终端 agent。设置两个环境变量把它指向 Synthorai，它就会用你的 Synthorai 密钥调用网关的 Gemini 原生端点。

开始之前

在控制台的 API 密钥页面创建一把密钥，并立即复制：它只显示一次。

第 1 步 — 设置环境变量

export GOOGLE_GEMINI_BASE_URL="https://synthorai.io"
export GEMINI_API_KEY="sk-..."
gemini -m gemini-3-pro

Gemini CLI 询问认证方式时，选择 Use Gemini API key。密钥会放在 x-goog-api-key 请求头里发送，网关在 Gemini 原生端点上接受这个请求头：/v1beta/models/{model}:generateContent 和 :streamGenerateContent。

第 2 步 — 选择模型

用 -m 指定一个你的密钥能调用的 Gemini 模型，可选模型见模型页面。

这条路径只提供 generateContent 和 streamGenerateContent。其他方法（如 countTokens、embedContent）会返回 404，且不计费。

把设置写进文件

不想在每个 shell 里都 export 一遍，可以把这两个变量写进 ~/.gemini/.env：

# ~/.gemini/.env
GOOGLE_GEMINI_BASE_URL="https://synthorai.io"
GEMINI_API_KEY="sk-..."

故障排查

401 密钥不对，或者运行 gemini 的那个 shell 里没有设置它。

某个模型返回 404 这个模型没有对你的密钥开放，换一个密钥能调用的模型。

URL 里出现 /v1/v1beta 把 GOOGLE_GEMINI_BASE_URL 里的 /v1 去掉。

想比较各 Gemini 模型的价格，见模型价格对比。