Gemini CLI 接入指南

这里把 Gemini CLI 的安装过程与本站接入说明拆开写。安装命令参考 Google 官方 `google-gemini/gemini-cli` README。

1. 安装 Gemini CLI

官方 README 给出的常见安装方式如下。

Run instantly with npx
npx @google/gemini-cli
Global npm install
npm install -g @google/gemini-cli
Homebrew
brew install gemini-cli

2. 官方原生启动方式

Google 官方主路径是直接运行 gemini,然后使用 Google 登录、Gemini API Key 或 Vertex AI 认证。

Start
gemini
Gemini API key example
export GEMINI_API_KEY="YOUR_API_KEY"
gemini

3. 接词元神网关的兼容方式

这一段不是 Google 官方文档里的主认证路径,而是给支持 OpenAI 兼容模式的 Gemini CLI 分支、封装或兼容客户端准备的配置写法。

Compatibility env
注意如果你使用的是 Google 官方原版 Gemini CLI,它主要走 Google 登录 / GEMINI_API_KEY / Vertex AI 三种方式。上面这组 OPENAI_BASE_URL 变量并不等于“官方承诺支持第三方 OpenAI 网关”。

4. 最小验证

Prompt mode
gemini -p "请只回复一句接入成功"