← 返回文档首页

快速接入 Agent

Gemini CLI

配置步骤

  1. 确认账户与 API Key 有权使用公开的 Gemini 模型；管理员还需要完成模型定价，并将模型映射到 Gemini 渠道。
  2. 在运行 Gemini CLI 的终端中设置以下环境变量：
$env:GEMINI_API_KEY = "YOUR_API_KEY"
$env:GOOGLE_GEMINI_BASE_URL = "https://www.zltokens.com"
$env:GEMINI_MODEL = "PUBLIC_GEMINI_MODEL"
gemini
  1. GOOGLE_GEMINI_BASE_URL 只填写服务器根地址。Gemini CLI 会请求 /v1beta/models/...，不要在这个变量中追加 /v1。
  2. 先发送短请求，再在使用日志中核对模型名、Gemini 路由、token 和扣费。

不适用时

  • Gemini CLI 不是通用的 OpenAI Compatible 客户端。
  • 当前版本不支持 GOOGLE_GEMINI_BASE_URL、请求没有出现在平台日志中，或返回 Gemini 官方认证错误时，请改用 Cline、Cherry Studio 或 Codex 的 OpenAI Compatible 配置。

验证与边界

  • 仅在 gemini-api-key 认证模式下使用 GEMINI_API_KEY 和自定义 GOOGLE_GEMINI_BASE_URL；不要用于 Google 登录、Code Assist 或 Vertex AI。
  • 地址必须是 HTTPS 根地址且不带 /v1。成功后使用日志应显示 /v1beta/models；否则改用已验证的 OpenAI Compatible 客户端。

官方版本参考

  • 客户端配置会随版本变化；部署、排障或改配置前，请核对 [Gemini CLI configuration reference](https://github.com/google-gemini/gemini-cli/blob/main/docs/reference/configuration.md).