跳转到主要内容
Gemini CLI 是 Google 官方的 AI 编程工具。配置环境变量后，Gemini CLI 可以通过 AIOHub 调用模型。

​
前置条件

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

​
配置方法

设置环境变量后启动 Gemini CLI： 
export GEMINI_API_KEY="sk-你的API令牌"
export GOOGLE_GEMINI_BASE_URL="https://api.aiohub.org"
gemini

​
写入 Shell 配置文件

echo 'export GEMINI_API_KEY="sk-你的API令牌"' >> ~/.zshrc
echo 'export GOOGLE_GEMINI_BASE_URL="https://api.aiohub.org"' >> ~/.zshrc
source ~/.zshrc
Gemini CLI 会在 Base URL 后拼接 API 版本路径。不要把 GOOGLE_GEMINI_BASE_URL 设置成带 /v1beta 的地址，否则可能请求到重复路径。

​
验证配置

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

​
常见问题

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