接入指南

接入 Gemini CLI

在 Gemini CLI 中配置 UWCode 的 Gemini 兼容通道，将命令行 AI 调用纳入企业统一管控。

接入 Gemini CLI

Gemini CLI 使用 Gemini API 或 Vertex AI API 形态。与 OpenAI-compatible 客户端不同，它需要使用 Gemini 兼容 Base URL。企业上线前应由 UWCode 管理员在控制台启用 Gemini CLI 通道，并将对应接入地址分发给员工。

适用场景

  • 研发团队已在命令行中使用 Gemini CLI。
  • 企业希望把 Gemini CLI 调用纳入 UWCode 的 Key、用量和日志管理。
  • 员工需要继续使用 Gemini CLI 的本地工作流，但不再自行维护个人模型账号。

前提条件

  1. 已安装 Gemini CLI。
  2. UWCode 已启用 Gemini API 兼容通道。
  3. 员工已获得一个可用于 Gemini CLI 的 UWCode Key。
  4. 已从 UWCode 控制台复制 Gemini CLI 专用 Base URL。

环境变量配置

Gemini CLI 官方支持通过 GOOGLE_GEMINI_BASE_URL 覆盖 Gemini API 请求地址。请注意，该地址应使用 UWCode 控制台提供的 Gemini CLI 专用地址，而不是直接套用 OpenAI-compatible Base URL。

export GEMINI_API_KEY=uwc-xxxxxxxx
export GOOGLE_GEMINI_BASE_URL=<UWCode 控制台提供的 Gemini CLI Base URL>

如果企业通过 Vertex AI 形态接入，则使用 Vertex 专用变量：

export GOOGLE_VERTEX_BASE_URL=<UWCode 控制台提供的 Vertex 兼容 Base URL>

配置步骤

  1. 在 UWCode 控制台为员工创建 Gemini CLI Key。
  2. 确认该 Key 已授权 Gemini 系列模型或企业自有 Gemini 兼容通道。
  3. 将 GEMINI_API_KEY 和 GOOGLE_GEMINI_BASE_URL 写入终端环境。
  4. 重新打开终端，执行一次 Gemini CLI 请求。
gemini --version
gemini "用一句话解释 UWCode 的统一网关能力"

验证接入

  • UWCode 控制台 调用日志 中能看到该员工 Key 的 Gemini CLI 请求。
  • 模型分布 中出现对应 Gemini 或企业映射模型。
  • 如果返回 401，优先检查 GEMINI_API_KEY 是否为 UWCode Key。
  • 如果返回连接错误，优先检查 GOOGLE_GEMINI_BASE_URL 是否为 Gemini CLI 专用地址。

上线建议

  • 不要把 OpenAI-compatible Base URL 直接配置给 Gemini CLI，除非 UWCode 控制台明确声明该地址兼容 Gemini API。
  • 通过企业终端管理工具分发环境变量，减少员工手动配置错误。
  • 对 Gemini CLI 使用单独的项目 Key，便于与 NextChat、Cline 等工具拆分统计。

官方依据