Skip to main content
Gemini CLI 是 Google 官方的 AI 编程工具。配置环境变量后，Gemini CLI 可以通过 AIOHub 调用模型。

​
前置条件

  • 已安装 Gemini CLI（建议 Node.js 20+）
  • 已 创建 AIOHub API 令牌
  • 账户有充足余额
  • API 令牌的分组包含 gemini
可以先检查本地版本：

​
配置方法

设置环境变量后启动 Gemini CLI：

​
写入 Shell 配置文件

Gemini CLI 会在 Base URL 后拼接 API 版本路径。不要把 GOOGLE_GEMINI_BASE_URL 设置成带 /v1beta 的地址，否则可能请求到重复路径。

​
验证配置

建议显式指定当前 API 令牌的分组可用的模型：
正常回复即表示配置成功。

​
常见问题

重新启动会话，并确认 API 令牌的分组包含 gemini。
清空或重开会话后重试，确认模型名称存在于 /v1beta/models 返回结果中。
检查当前目录是否有 .env 或 Gemini CLI 配置文件覆盖了 API Key、模型或 Base URL。删除冲突配置后重新打开终端。