Gemini CLI

Gemini CLI 是 Google 官方的编程 CLI，走 Gemini API 协议。ModeXFlow 保留了 Gemini 原生路径 /v1beta/models/*:generateContent，配置指到 ModeXFlow 即可直接用。

支持状态

Gemini 系模型渠道当前按需开通。默认注册用户可能看不到 Gemini 相关分组。如果你需要 Gemini，联系管理员开一下。

前置

• Node.js 20+
• ModeXFlow 令牌，分组为 gemini（如果已开通）

安装

npm install -g @google/gemini-cli

配置

环境变量

# Gemini CLI 用 GEMINI_API_KEY，不是 GOOGLE_API_KEY
export GEMINI_API_KEY="sk-你的-token"
# 覆盖默认的 generativelanguage.googleapis.com
export GEMINI_API_BASE_URL="https://api.modexflow.cc"

~/.gemini/settings.json

{
  "endpoint": "https://api.modexflow.cc",
  "apiKey": "sk-你的-token",
  "model": "gemini-2.5-pro"
}

用起来

gemini "解释一下这段代码是干嘛的"
gemini --file src/auth.py "找出这段代码的安全隐患"

与 OpenAI 兼容协议一起用

Gemini CLI 只支持 Gemini 原生路径。要从 OpenAI SDK 调 Gemini 模型：

from openai import OpenAI
client = OpenAI(
    base_url="https://api.modexflow.cc/v1",
    api_key="sk-你的-token",
)
# ModeXFlow 会内部转换协议
r = client.chat.completions.create(
    model="gemini-2.5-pro",
    messages=[{"role": "user", "content": "hi"}],
)

常见问题

Q: 无可用渠道?
Gemini 渠道未开通。找管理员。

Q: 报错 unsupported model?
你 Key 的分组不支持 Gemini。切分组。