1. 文档
  2. 编程工具
  3. Gemini CLI

在 Gemini CLI 中使用 Airoutly

在 ~/.gemini/.env 里写三行,并用 API Key 方式登录,Gemini CLI 就会通过 Airoutly 发送请求。

Base URL
https://api.airoutly.com不带 /v1beta
Key 变量
GEMINI_API_KEY
可用模型
模型页中的 Gemini 系列

1. 安装 Gemini CLI

npm install -g @google/gemini-cli

2. 连接到 Airoutly

新建 ~/.gemini/.env:

~/.gemini/.env
GOOGLE_GEMINI_BASE_URL="https://api.airoutly.com"
GEMINI_API_KEY="sk-your-key"
GEMINI_MODEL="gemini-2.5-flash"

Gemini CLI 询问登录方式时,选择 Gemini API key。自定义 Base URL 只对 API Key 登录生效,用 Google 账号登录不会经过 Airoutly。

3. 选择模型

GEMINI_MODEL 是默认模型;单次运行可以用 gemini -m gemini-2.5-pro。

4. 验证是否生效

运行 gemini,发送 hi。几秒内,控制台的用量日志里就会出现这次请求。

常见问题

请求仍然发到了 Google

Gemini CLI 只加载找到的第一个 .env。项目目录或其上级目录里的 .env 会盖过 ~/.gemini/.env,请把这三行也写进去,或删掉那个文件。

我的 Key 存在 AIROUTLY_API_KEY 里

Gemini CLI 只读取 GEMINI_API_KEY。可以在 shell 配置里加一行 export GEMINI_API_KEY=“$AIROUTLY_API_KEY”,代替 .env 里的那一行。