gemini-cli 怎么配置第三方 API

Gemini CLI 默认连接 Google 的 Gemini API，认证用 GEMINI_API_KEY。它并不直接支持 OpenAI 兼容接口，这是接入第三方网关时最容易踩的坑。

第一步：确认网关类型

问清楚服务商提供的是哪一种端点：

• Gemini 原生格式：generateContent 接口，可以尝试通过网关地址接入。
• 仅 OpenAI 兼容：Gemini CLI 不能直接用，需要换客户端或让网关提供 Gemini 兼容层。

第二步：配置 key

export GEMINI_API_KEY="your-key"

如果网关提供自定义端点，按网关文档设置对应的 base URL 环境变量；不同版本字段名可能不同，以 gemini --help 为准。

第三步：验证

gemini -p "reply with OK"

常见报错

• API key not valid：key 与端点不匹配，例如把 OpenAI 兼容 key 用到了 Gemini 端点。
• 404 not found：端点路径不对，确认是否需要 /v1beta 前缀。
• 429：免费额度或限流，退避重试。
• model not found：模型名要用 Gemini 的 ID，不是 GPT 或 Claude 的名字。

建议

如果你的网关只有 OpenAI 兼容接口，直接用支持该格式的客户端（如 Cline、Cherry Studio、Open WebUI）更省事，不必强改 Gemini CLI。