Gemini CLI 手动配置

选择分组与协议

在密钥管理创建 Gemini 密钥。当前 Gemini （特价渠道） 和 Gemini （官方直连） 均列出 gemini-3.8-flash。特价渠道描述明确提示缓存命中几乎没有，不应依赖缓存节省成本。官方直连组的模型集并非完全相同。费用以实时价格为准。

Gemini CLI 使用 Gemini 原生 API；本站已有 /v1beta/ 路由。不要把 OpenAI 的 /v1 base 套到原生客户端。

Windows、macOS、Linux 安装

完成 Node.js，在 Windows PowerShell、macOS / Linux 终端执行：

macOS 已使用 Homebrew 时，也可选择 brew install gemini-cli，两种方式选其一。Windows 若版本要求 WSL，就在 WSL 内配置；Linux 使用用户拥有的 npm 安装位置，不默认添加 sudo。

Windows

powershell
npm install -g @google/gemini-cli
gemini --version

macOS

bash
npm install -g @google/gemini-cli
gemini --version

Linux

bash
npm install -g @google/gemini-cli
gemini --version

当前会话配置

当前 Gemini CLI 支持 GOOGLE_GEMINI_BASE_URL、GEMINI_API_KEY 与 GEMINI_MODEL。自定义 base 使用网关 / 自定义地址的 API key 认证；旧版本界面可能称为 API key 模式，也可能不支持自定义 base。Windows PowerShell：

powershell
$env:GOOGLE_GEMINI_BASE_URL = "https://monkeytheme.com"
$env:GEMINI_API_KEY = "YOUR_API_KEY"
$env:GEMINI_MODEL = "gemini-3.8-flash"
gemini

macOS / Linux：

bash
export GOOGLE_GEMINI_BASE_URL="https://monkeytheme.com"
export GEMINI_API_KEY="YOUR_API_KEY"
export GEMINI_MODEL="gemini-3.8-flash"
gemini

Windows CMD 对应使用 set NAME=value。启动时若出现认证选择，选择 API key 方式；Google 账户 OAuth 或 Vertex 项目认证不应被当作本站密钥认证。若版本不识别变量或仍连接官方服务，暂停请求并查该版本帮助，不猜测替代 JSON 字段，也不要把密钥填进网址。

持久化与日常使用

Windows 可在用户环境变量界面保存同名变量；macOS zsh 编辑 ~/.zshrc，Linux bash 编辑 ~/.bashrc 添加 export。保护含密钥文件，勿提交到 Git，重开终端后再启动。仅临时试用时无需永久保存。在项目目录运行 gemini；非交互示例为：

text
gemini -p "用一句话解释这个项目的用途"

先确认将发送的文件和提示词适合交给服务处理。

验证与排错

用户运行后可能计费。401 检查密钥和认证模式；404 检查是否重复添加 /v1beta 或错用 /v1；model_not_found 检查组中是否存在该 ID。环境变量修改后要重启客户端。成功安装、成功登录 Google 账户与成功通过 MonkeyAI 调用是三件不同的事。其他接入方式见 TRAE SOLO。