文档接入指南Gemini CLI

Gemini CLI

Google 官方终端 Agent。改两个环境变量即可走站内 Gemini 兼容端点。

前置
已登录并充值 · 已创建密钥并选对分组（创建密钥）· 模型 ID 来自 推荐模型表 或 /v1/models

下载与安装

需要 Node.js 20+：npm install -g @google/gemini-cli，安装后运行 gemini。

配置步骤

  1. 1
    创建密钥时选包含 Gemini 系模型的分组（见 创建密钥）。
  2. 2
    设置环境变量：GEMINI_API_KEY 填 sk-xxxx，GOOGLE_GEMINI_BASE_URL 填 https://api.daoxe.com（站点根，不带 /v1 或 /v1beta）。
  3. 3
    新开终端运行 gemini，认证方式选「使用 Gemini API 密钥」；用 -m 模型ID 指定站内 Gemini 模型。
bash
# ~/.zshrc / ~/.bashrc
export GEMINI_API_KEY="sk-xxxx"
export GOOGLE_GEMINI_BASE_URL="https://api.daoxe.com"

gemini -m 你的Gemini模型ID
bash
# 先用 curl 验证 Gemini 兼容端点 / smoke-test the Gemini endpoint first
curl "https://api.daoxe.com/v1beta/models/你的Gemini模型ID:generateContent?key=sk-xxxx" \
-H "Content-Type: application/json" \
-d '{"contents":[{"parts":[{"text":"ping"}]}]}'

模型选择

只有 Gemini 系模型走 /v1beta 端点；模型 ID 从 推荐模型表 复制（如 gemini-* 系列）。

常见坑

  • Base 填站点根 https://api.daoxe.com：CLI 自己拼 /v1beta/...，多写 /v1 会 404。
  • 环境变量只对新终端生效；改完后要重开终端再运行 gemini。
  • 也可以在支持 OpenAI 协议的工具里用 Gemini 模型（Base 用 https://api.daoxe.com/v1），见 双协议清单。

配置界面参考

Gemini CLI · 认证方式选择 · 点击图片可放大

相关

上一页 · 接入指南
Codex CLI
下一页 · 接入指南
Cline