Gemini CLI

用 Aihubmix 为 Gemini CLI 提供强劲动力，享受稳定高效的 Gemini 模型服务。

Gemini CLI 官方说明：免费层及 Google One 用户自 2026 年 6 月 18 日起改用 Antigravity CLI。使用 API Key 并自定义 Base URL 的方式不受影响。

快速配置指引：

1️⃣ 全局安装 npm 包

终端运行：

npm install -g @google/gemini-cli

确保你的 Node.js 版本 >= 20 更多详细说明可以参考：

2️⃣ 环境变量配置

在系统环境变量中填入 Aihubmix 密钥和转发地址，密钥可以在 Aihubmix 「Keys」页面生成。比如在 ~/.zshrc 中添加：

export GOOGLE_GEMINI_BASE_URL="https://aihubmix.com/gemini"
export GEMINI_API_KEY="sk-***"

对于 Mac 用户，你可以在用户名目录通过快捷键 ⌘ + ⇧ + . 显示隐藏的 .zshrc 文件，用系统的「文本编辑」APP 打开并添加上述内容。

Windows PowerShell 用户可以执行以下命令（仅对当前窗口生效）：

$env:GEMINI_API_KEY="sk-***"
$env:GOOGLE_GEMINI_BASE_URL="https://aihubmix.com/gemini"

3️⃣ 使配置生效

添加配置之后，终端执行 source ~/.zshrc，回车即可。

4️⃣ 终端启动

终端输入

gemini

初始化配置

选择接入方式

首次启动时，Gemini CLI 会先询问是否信任当前文件夹，选择 Trust folder 后会自动重启。重启后显示 Get started 认证界面，已设置 GEMINI_API_KEY 时默认选中 Use Gemini API Key，回车确认：

  1. Sign in with Google
● 2. Use Gemini API Key
  3. Vertex AI

随后会弹出 Enter Gemini API Key 输入框，框中已预填 GEMINI_API_KEY 的值，确认无误后回车提交。

之后需要切换认证方式时，可以输入 /auth 重新打开认证界面。

跳过交互选择（可选）

在 ~/.gemini/settings.json 中加入以下配置，即可跳过启动时的交互选择：

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

启动成功

完成以上初始化即可正常使用。

祝你使用愉快！

更新时间：2026-10-27

编程助手

IDE 集成

Agent / Workflow 平台

SDK 与框架

快速配置指引：

1️⃣ 全局安装 npm 包

2️⃣ 环境变量配置

3️⃣ 使配置生效

4️⃣ 终端启动

初始化配置

选择接入方式

跳过交互选择（可选）

启动成功

祝你使用愉快！

​快速配置指引：

​1️⃣ 全局安装 npm 包

​2️⃣ 环境变量配置

​3️⃣ 使配置生效

​4️⃣ 终端启动

​初始化配置

​选择接入方式

​跳过交互选择（可选）

​启动成功

​祝你使用愉快！

快速配置指引：

1️⃣ 全局安装 npm 包

2️⃣ 环境变量配置

3️⃣ 使配置生效

4️⃣ 终端启动

初始化配置

选择接入方式

跳过交互选择（可选）

启动成功

祝你使用愉快！