Gemini CLI

Google 的开源终端 AI Agent

Google Gemini /v1beta/models 协议 macOSLinuxWindows

Gemini CLI 是 Google 的开源终端 AI Agent，内置搜索、文件与 Shell 工具，支持大上下文窗口。适合想用 Gemini 模型、又需要命令行自动化与脚本化的工程师。它使用 Gemini /v1beta/models 协议，可通过 GOOGLE_GEMINI_BASE_URL 指向代理。

网关 base_url（国内站）https://api.shinloo.com/v1填到各工具的 base_url / OPENAI_BASE_URL / apiBase 之类设置里。OpenAI 线路填 /v1；Anthropic / Gemini 线路填网关根 https://api.shinloo.com。

OpenAI 兼容调用路径https://api.shinloo.com/v1/chat/completionsOpenAI 线路的客户端用这个地址（GET /v1/models 可查你的 Key 可用模型）。

Gemini 兼容调用路径（本工具直连）https://api.shinloo.com/v1beta/models国内站网关原生 Gemini /v1beta 兼容口，Gemini CLI 直接用，无需协议转换；GOOGLE_GEMINI_BASE_URL 填网关根。GET /v1/models 可查你的 Key 可用模型。

推荐模型（国内站已开通）deepseek-v4.1-flashdeepseek-v4-proqwen3.8-max以上为本站公示的模型名，实际可用清单以你的 Key 调 GET /v1/models 返回为准。

省事版 — 一键接入

脚本从 Gemini CLI 的官方来源安装，把网关配置写进工具自己的配置文件（写之前先备份原文件），再发一次真请求验证。会提示你粘贴网关 Key（也可用 --key 传入）； --uninstall 只还原它写进去的内容。

shell

curl -fsSL https://api.shinloo.com/agents/gemini-cli/setup | bash

1 · 安装

从 Gemini CLI 自己的官方来源安装。

安装

npm install -g @google/gemini-cli
# 或 Homebrew：
brew install gemini-cli
# 或不安装、直接用 npx：
npx @google/gemini-cli

2 · 配置 — 指向国内站网关

网关 base URL https://api.shinloo.com/v1；Key 在控制台创建。

配置

网关 base_url 用 https://api.shinloo.com，国内站原生提供 Gemini 兼容口（/v1beta/models），可直接接入，无需协议转换：
1) 用 Gemini API Key 认证。在 ~/.gemini/settings.json 写入：
   { "security": { "auth": { "selectedType": "gemini-api-key" } } }
2) 设置环境变量（写入 ~/.gemini/.env 亦会被自动加载）：
   export GEMINI_API_KEY=<你的网关密钥>
   export GOOGLE_GEMINI_BASE_URL=https://api.shinloo.com
   export GEMINI_MODEL=deepseek-v4.1-flash
3) 运行 gemini。
注意：GOOGLE_GEMINI_BASE_URL 仅在 gemini-api-key 认证方式下生效，且必须为 HTTPS；base_url 指向网关根，末尾不要加 /v1beta。

3 · 验证

发一次请求，能返回就说明走的是国内站网关。

验证

gemini -p "say hi"
# 能返回一句回答即接入成功；也可运行 gemini 后在交互界面里发一句 prompt。

4 · 常见坑

无头/脚本环境必须有信任标记：交互终端首次会问「是否信任该目录」，脚本里请加 --skip-trust 或环境变量 GEMINI_CLI_TRUST_WORKSPACE=true，否则报 not running in a trusted directory。
若你机器上已设 GOOGLE_API_KEY，Gemini CLI 会优先用它（提示 Using GOOGLE_API_KEY），会绕开本脚本写入的 GEMINI_API_KEY —— 请 unset GOOGLE_API_KEY 再用。
模型名以网关 /v1beta/models 返回的为准；本工具走本站 Gemini 兼容口，无需协议转换。

工具侧步骤的官方来源： github.com/google-gemini/gemini-cli github.com/google-gemini/gemini-cli/blob/main/docs/reference github.com/google-gemini/gemini-cli/blob/main/docs/get-start