Gemini CLI

Gemini CLI 使用 Google Gemini 协议。Amux 同时兼容 v1 与 v1beta 两个版本段；官方文档中两种写法都会出现，客户端使用任一版本均可接入。

推荐：用 CC Switch 配#

CC Switch 支持 Gemini CLI，添加一个供应商（Base URL 填 https://gateway.amux.ai）即可。切换之后重开终端。

下面是手动配置的写法。

一、安装#

npm install -g @google/gemini-cli
# 或
pnpm install -g @google/gemini-cli

gemini --version

二、创建 Amux 密钥#

在控制台的密钥页创建一把。创建后仍可在该页面再次查看，无需重新生成。

三、配置#

环境变量#

mkdir -p ~/.gemini

写进 ~/.gemini/.env：

.env

GOOGLE_GEMINI_BASE_URL=https://gateway.amux.ai
GEMINI_API_KEY=你的 Amux 密钥
GEMINI_MODEL=google/gemini-3-pro

或者走 shell：

Terminal

export GOOGLE_GEMINI_BASE_URL=https://gateway.amux.ai
export GEMINI_API_KEY=你的 Amux 密钥
export GEMINI_MODEL=google/gemini-3-pro

PowerShell

$env:GOOGLE_GEMINI_BASE_URL = "https://gateway.amux.ai"
$env:GEMINI_API_KEY = "你的 Amux 密钥"
$env:GEMINI_MODEL = "google/gemini-3-pro"

地址不带 /v1：Gemini 客户端会自己拼 /v1beta/models/{model}:generateContent。

关掉 Google 登录#

编辑 ~/.gemini/settings.json，把鉴权方式显式设成 API Key：

{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

不设的话它会走 Google 账号登录流程，根本不看你填的密钥。

四、验证#

source ~/.zshrc   # 或重开终端
gemini -p "只回复 OK。" --output-format json

返回里应当能看到 "response": "OK"。再试一次带文件的：

cd my-project
gemini -p "@README.md 用一句话概括这个文件。" --output-format json

选模型#

改 GEMINI_MODEL，或者用命令行参数：

gemini --model anthropic/claude-opus-5

模型名用规范 ID，不限于 Google 的模型——前提是那个模型的上游能承接 Gemini 协议，模型详情页会标出来。

锁定供应商 / 指定路由策略#

在模型名后加冒号锁定某一家（google/gemini-3-pro:google），或用 @ 后缀指定排序（:@price、:@latency）。完整说明见 API 参考。

常见问题#

弹出 Google 登录#

settings.json 里没设 selectedType。确认一下：

cat ~/.gemini/settings.json

鉴权失败#

密钥是否复制完整（首尾空格与换行最常见），控制台里这把密钥是否还启用，工作区余额是否充足。

.env 没生效#

shell 里的变量会盖掉 .env 文件里的。先看当前进程里到底是什么：

env | grep -E "GEMINI_|GOOGLE_"

另外目录内的 .env 优先级高于 ~/.gemini/.env——在项目里放过 .env 的话，那一份会赢。

连不上#

curl https://gateway.amux.ai/v1beta/models -H "x-goog-api-key: $GEMINI_API_KEY"

能返回模型列表说明网络与密钥都没问题。也确认地址是 https://gateway.amux.ai，没有多带 /v1。

模型不可用#

模型 ID 要带厂商前缀（google/gemini-3-pro，不是 gemini-3-pro）。不是每个模型都支持每种协议——Gemini CLI 说 Gemini，得挑上游能承接 Gemini 的那些。

超时#

长上下文加强推理模型首字本来就慢。缩短提示词或减少附带文件，换一档更快的模型，或者用 :@latency 后缀让路由优先挑延迟低的供应商。