Gemini CLI 接入

先说结论

当前服务已经支持 Gemini 兼容接口，可用于 Gemini CLI。

1. 安装前准备

Gemini CLI 官方安装命令通过 npm 全局安装，因此需要先准备好：

• Node.js 18+
• npm（安装 Node.js 后通常会一起提供）

安装方式建议直接走 Node.js 官方下载页：https://nodejs.org/en/download

• macOS / Windows：下载并安装 LTS 版本
• Linux：按该页面提供的发行版方式安装

如果你在 macOS 上已经安装了 Homebrew，也可以直接执行：

brew install node

安装完成后确认命令可用：

node -v
npm -v

2. 安装

npm install -g @google/gemini-cli

安装完成后确认：

gemini --version

3. 配置

Gemini CLI 支持通过以下三个环境变量接入自定义网关：

环境变量	说明
GOOGLE_GEMINI_BASE_URL	网关服务根地址，替换 Google 默认端点
GEMINI_API_KEY	你的 API Key
GEMINI_MODEL	默认使用的模型

配置示例：

export GOOGLE_GEMINI_BASE_URL="https://codex.openai.com"
export GEMINI_API_KEY="codex_your_api_key"
export GEMINI_MODEL="gemini-2.5-pro"

TIP

GOOGLE_GEMINI_BASE_URL 填写服务根地址，不需要带具体接口路径。Gemini CLI 会自动拼接 API 路径。

如果你只需要在当前 shell 会话中临时测试，直接 export 以上三个变量后执行 gemini 即可。

如果你希望永久生效，可以将上述 export 语句加入你的 shell 配置文件，例如 ~/.zshrc 或 ~/.bashrc，然后执行 source ~/.zshrc（或 source ~/.bashrc）使其生效。

4. 启动

gemini

5. 验证

启动后在 Gemini CLI 中发起一次对话，如果能正常收到回复，说明接入成功。

如果遇到鉴权错误，请确认 GEMINI_API_KEY 是否正确，以及 GOOGLE_GEMINI_BASE_URL 是否指向正确的服务地址。