qimoqqimoq
登录
返回文档首页

Gemini CLI 接入

Gemini CLI 需要使用 Gemini 兼容 Endpoint。配置时重点确认 Base URL 末尾包含 /v1beta，并使用支持 Gemini 模型的访问凭证。

前置条件

项目要求
Gemini CLI本机已安装并可运行
API Key使用支持 Gemini 模型的 qimoq 访问凭证
Base URL站点根地址 + /v1beta
模型 ID从「模型广场」复制 Gemini 模型调用名称

先运行版本命令确认 CLI 存在：

gemini --version

用 CC Switch 一键导入

  1. 在「模型广场」复制 Gemini 模型 ID。
  2. 在「访问凭证」页面选择支持 Gemini 的凭证。
  3. 点击导入配置，目标客户端选择 Gemini CLI。
  4. 确认 Endpoint 类似 https://你的 qimoq 站点域名/v1beta。
  5. 保存配置并重启终端。
  6. 发起一次简单请求验证。

Gemini CLI 的 Base URL 和 OpenAI Compatible 客户端不同，少写 /v1beta 通常会导致请求失败。

手动字段

字段填写
GEMINI_API_KEYqimoq 访问凭证
GOOGLE_GEMINI_BASE_URL 或客户端等价字段https://你的 qimoq 站点域名/v1beta
Model例如 gemini-2.5-pro，以「模型广场」显示为准

不同版本 Gemini CLI 的配置字段可能会变化，以客户端当前版本支持的字段名为准。只要语义对应 API Key、Base URL、Model 即可。

排查

现象处理
401 Unauthorized检查凭证是否完整，以及凭证是否支持 Gemini 分组
404 或路径错误确认 Endpoint 末尾包含 /v1beta
模型不可用重新从「模型广场」复制 Gemini 模型 ID
日志没有记录请求没有到达 qimoq，先检查 CLI 是否读取了当前配置