Gemini CLI

适合谁

希望在终端使用 Gemini 能力的用户：可用 Google 官方账号 / 官方 API Key，也可统一走自己的 API 网关。

本工具通过 npm 全局安装。若还没有 Node.js / npm，先完成安装 Node.js 与 npm。

npm install -g @google/gemini-cli

（包名以官方当前文档为准；若命令有变，以 npm 包说明为准。）

方式	适合
官方 Google / Gemini 登录或官方 Key	使用 Google AI Studio / Gemini API 官方通道
自定义 API / 中转	使用兼容网关的 Base URL + Key

准备 Google 账号，并按 Gemini CLI 官方文档完成首次登录（常见为启动后走浏览器 OAuth，或以当前版本提示为准）
或从 Google AI Studio / Google Cloud 创建 官方 Gemini API Key，按官方说明写入环境变量（常见名如 GEMINI_API_KEY / GOOGLE_API_KEY，以当前版本文档为准）
不要设置会指向中转的 GOOGLE_GEMINI_BASE_URL（或同类 Base URL 变量），除非你明确要走网关
新开终端，运行 gemini（命令名以你安装的包为准），发送测试消息

CC Switch 通常会写入 ~/.gemini/.env 与相关 settings。

常见环境变量（名称可能随版本变化）：

export GEMINI_API_KEY="sk-你的密钥"
export GOOGLE_GEMINI_BASE_URL="{{API_BASE_URL}}"

具体键名以 Gemini CLI 当前版本文档为准。