Gemini CLI ↗ 支持自定义 Google Gemini API 基址 URL。将其指向受 Cloudflare Access 保护的 AI Gateway 自定义域名。在启动 Gemini CLI 之前,使用 cloudflared 生成短期 Access 令牌。
Gemini CLI 不支持 API 密钥 helper。Access 会话过期后,你必须刷新令牌。
开始之前,你需要:
- 一个带有自定义域名的 AI Gateway。
- 已在自定义域名上启用 Cloudflare Access,并有允许你身份的策略。
- Google AI Studio 的凭据。使用 Unified Billing 积分,或使用 BYOK (Store Keys) 在 AI Gateway 中存储 Google AI Studio 密钥。
- 已安装
cloudflared。 - 已安装并更新到最新版本的 Gemini CLI ↗。
-
将 Google Gemini 基址 URL 设为你的 AI Gateway 自定义域名。将
ai.example.com替换为你的自定义域名。export GOOGLE_GEMINI_BASE_URL="https://ai.example.com/google-ai-studio" -
向 Access 进行身份验证,并将得到的令牌存储在
GEMINI_API_KEY中。export GEMINI_API_KEY="$(cloudflared access login -app https://ai.example.com)" -
启动 Gemini CLI 并发送提示。请求现在会通过 AI Gateway 路由。
gemini
Access 令牌过期后,请再次运行身份验证命令。你也可以将这些命令添加到启动 Gemini CLI 的引导脚本中。
有关这些环境变量的更多信息,请参阅 Gemini CLI 配置 ↗。
要确认流量已到达 AI Gateway,请参阅验证是否生效。