连接 Gemini CLI

使用 API 密钥，将 Gemini CLI 接入 AnyInt 的 Gemini 兼容网关。

Gemini CLI 在 API key 认证模式下支持自定义 Gemini API 域名。AnyInt 在 /gemini 网关根地址提供 Gemini Developer API。

开始前准备

  1. 从 Gemini CLI 官方仓库安装或更新客户端。
  2. 创建 AnyInt API 密钥。
  3. 从模型目录选择 Gemini 兼容模型 ID。

配置网关

Gemini CLI 使用 GEMINI_API_KEY 进行 API key 认证，并通过下方命令中的基础 URL 变量读取 API 域名。

bash
export ANYINT_API_KEY="your_api_key"
export GEMINI_API_KEY="$ANYINT_API_KEY"
export GOOGLE_GEMINI_\
BASE_URL="https://api.anyint.ai/gemini"
export GEMINI_MODEL="YOUR_MODEL_ID"

启动 CLI，并在提示时选择 Use Gemini API key：

bash
gemini

验证与排查

  • 收到 401 表示未提交 AnyInt 密钥，或密钥已失效。
  • 收到模型错误，表示 GEMINI_MODEL 不是当前密钥可用的 Gemini 兼容模型。
  • 单独排查 API key 配置时，请移除可能冲突的 Google Cloud 认证环境变量。
  • 不要提交包含密钥的 .env 文件。Gemini CLI 也支持用户级 .gemini/.env 文件保存本地配置。

当前变量行为以 Gemini CLI 官方配置和认证文档为准。