Gemini CLI 是 Google 的终端开发工具。它可以通过 Gemini 原生协议访问 AIMax 的文本模型；本文不把某个 CLI 版本或某个模型版本作为使用前提。
支持状态：已完成 AIMax Gemini 原生格式最小文本验证。工具调用、浏览器能力、扩展、MCP 和多回合 Agent 工作流需要在目标模型上分别验证。

​
准备工作

  1. 按 Gemini CLI 官方安装说明 安装 gemini 命令。
  2. 获取 AIMax API Key。
  3. 在平台记录该 Key 当前可见的完整 Gemini 模型名称。
把选择的模型保存为环境变量：

​
环境变量配置

Gemini CLI 使用以下环境变量：
GOOGLE_GEMINI_BASE_URL 填服务根地址，例如 https://api.aimaxa.cn。不要在这里追加 /v1beta，Gemini CLI 会自行拼接：
如果当前 Shell 已经存在 Google 官方的 GEMINI_API_KEY，请先确认它没有覆盖 AIMax Key：

​
最小验证

用只读、单轮文本任务验证：
成功时应能在 JSON 中看到模型返回的 OK。如果需要换模型，只修改 AIMAX_MODEL，不需要重写 Base URL 或认证配置。

​
常见问题

​
返回无效 URL

确认 GOOGLE_GEMINI_BASE_URL 是服务根地址，不要写成：
否则 CLI 自动拼接路径后可能形成重复路径。

​
返回认证失败

  1. 确认 Gemini CLI 使用的是 GEMINI_API_KEY。
  2. 确认 Key 没有前后空格或换行。
  3. 确认没有被其他 Shell 配置或项目 .env 覆盖。

​
模型不可用

  1. 回到平台确认该 Key 当前可见模型。
  2. 原样填写完整模型名称，不要自行改写。
  3. 确认目标模型支持 Gemini 原生 generateContent 入口。

​
工具调用失败

先用纯文本任务确认认证、路径和模型都正常，再单独验证工具调用、MCP、浏览器或扩展能力。文本响应成功不等于这些能力已经可用。

​
协议参考