Gemini CLI 调用 Gemini 3 Pro 完整教程：从安装到实战

一、前置准备：权限与环境要求

1. 确认 Gemini 3 Pro 访问权限

Gemini 3 Pro 目前仅对特定用户开放，需满足以下任一条件：

• Google AI Ultra 订阅用户（自动获取权限）

• 持有付费 Gemini API Key 且已开通 Gemini 3 权限的用户

• 持有 Vertex API Key 且已开通 Gemini 3 权限的用户

• 其他用户（免费版、Google AI Pro 等）需先 加入候补名单（用登录 CLI 的 Google 邮箱申请，获批后会收到邮件通知）

• 国内用户推荐：使用 YibuAPI 镜像服务（无需 Google 账号、无需梯子，直接开通 Gemini 3 Pro 调用权限）

2. 安装必要运行环境

Gemini CLI 依赖 Node.js 环境，要求版本 ≥ 18（推荐 20+，LTS 长期支持版最佳）：

• 检查现有 Node.js 版本：打开终端（Windows 用 CMD，Mac/Linux 用 Terminal），输入命令：

node -v

若显示 v18.0.0 及以上版本，可直接跳过安装；若提示 “不是内部或外部命令”，需继续下一步。

• 安装 / 升级 Node.js：

  • 官网下载：访问 Node.js 官网，下载 LTS 版本，一路点击 “下一步” 完成安装（Windows 需勾选 “Add to PATH”）。

  • 一键管理（推荐）：使用 ServBay 工具，在左侧 “软件包” 中找到 Node.js，可一键安装并切换多版本。

• 安装完成后，重新打开终端，输入 node -v 确认版本生效。

二、安装与更新 Gemini CLI

Gemini CLI 提供多种安装方式，推荐全局安装（长期使用），临时体验可选择 NPX 方式。

1. 安装方式选择

• 全局安装（推荐）：终端输入以下命令，全局部署 CLI 工具：

npm install -g @google/gemini-cli

• 临时体验（无需安装）：无需全局部署，直接运行最新版本：

npx @google/gemini-cli

\# 或从 GitHub 主分支运行开发版

npx https://github.com/google-gemini/gemini-cli

• 验证安装成功：输入以下命令，显示版本号（如 0.16.0+）即成功：

gemini --version

2. 升级到最新版本（关键步骤）

Gemini 3 Pro 仅支持 CLI 0.16.x 及以上版本，需确保工具为最新版：

• 手动升级命令：

npm install -g @google/gemini-cli@latest

\# 或使用升级指令

npm upgrade -g @google/gemini-cli

• 自动升级：运行 gemini 命令进入 CLI 后，若有更新提示，按提示等待自动完成即可。

三、首次启动与身份认证

1. 启动 Gemini CLI

终端输入以下命令，启动 CLI 工具：

gemini

首次启动会提示选择主题（用上下方向键选择，回车确认），后续可通过 /theme 命令重新设置。

2. 身份认证（三选一，新增 YibuAPI 方案）

认证后才能调用 Gemini 模型，国内用户优先选择 YibuAPI（无需梯子、配置最简单）：

方式一：YibuAPI 认证（国内用户首选，方便 + 便宜）

YibuAPI 是 Gemini 官方授权的国内镜像服务，支持直接调用 Gemini 3 Pro，核心优势：无需 Google 账号、无需科学上网、价格仅为官方 1/5，适合个人开发者和中小企业批量调用。

1. 获取 YibuAPI Key（30 秒完成）：

• 访问 YibuAPI 官网 https://yibuapi.com（国内直连，秒开），用手机号注册并登录（支持微信快捷登录）。

• 登录后进入 “控制台 → API 密钥”，点击 “生成密钥”，直接复制生成的 YIBU_API_KEY（无需审核，即时生效）。

1. CLI 中配置 YibuAPI：

• 在 Gemini CLI 交互界面（显示 > 符号）输入命令，切换 API 源：

/api-setting

• 选择 “自定义 API 源”，按提示输入以下信息：

  • API 基础地址：https://api.yibuapi.com/gemini/v1beta

  • API Key：粘贴刚才复制的 YIBU_API_KEY

• 输入完成后，CLI 会提示 “API 配置成功”，无需额外设置，直接可用。

方式二：Google 账号登录（推荐海外用户）

选择 “使用 Google 登录”，会自动打开浏览器，登录你的 Google 账号并授权，授权完成后终端会显示 > 符号，代表认证成功。

方式三：官方 API Key 认证（无 Google 账号可用）

1. 访问 Google MakerSuite，登录 Google 账号后点击 “创建 API 密钥”，复制生成的密钥。

2. 回到终端，选择 “Gemini API Key”，粘贴复制的密钥，回车即可完成认证。

四、启用 Gemini 3 Pro 模型

认证成功后，需手动启用预览功能才能切换到 Gemini 3 Pro，步骤如下：

1. 在 CLI 交互界面（显示 > 符号）输入以下命令，打开设置面板：

/settings

1. 找到 “Preview features” 选项，将其设置为 true（用方向键切换，回车确认）。

2. 输入以下命令，选择模型：

/model

1. 在模型列表中选择 Auto 或 Pro：

• Auto 模式：智能调度，简单任务用 Gemini 2.5 Flash（省配额），复杂任务自动切换到 Gemini 3 Pro（YibuAPI 用户默认开通权限，无需额外申请）。

• Pro 模式：始终优先使用 Gemini 3 Pro（YibuAPI 无权限限制，按调用量计费），无配额耗尽问题。

五、核心场景实战：Gemini 3 Pro 典型用法

Gemini 3 Pro 擅长代理编码、跨服务联动等复杂任务，以下是 2 个高频场景的实操示例（YibuAPI 与官方 API 用法完全一致，直接复用）：

场景 1：代理编码 - 一键生成 3D 应用

Gemini 3 Pro 可整合文本、代码和视觉需求，直接生成可运行的项目骨架。例如生成金门大桥 3D 模拟应用：

1. 在 CLI 中输入提示（可直接复制）：

Build a visually stunning 3D Voxel simulation of the Golden Gate Bridge using Three.js. Requirements:

\- Lighting: 0-24h slider to control sun position and sky color

\- Water: Custom GLSL shader with waves and reflections

\- Traffic: 400+ cars with headlights/taillights using InstancedMesh

\- Output: Single HTML file (golden\_gate\_bridge.html) via CDN, no build step

1. 按下回车，Gemini 3 Pro 会自动生成完整代码，输出到当前目录，直接用浏览器打开 HTML 文件即可运行。

场景 2：跨服务联动 - 排查云端故障

借助工具调用能力，联动日志监控、代码库解决复杂问题。例如排查云服务器响应缓慢：

1. 在 CLI 中输入提示：

My Google Cloud VM is responding slowly. Check logs for errors, analyze CPU/memory usage, and suggest optimization steps. Use cloud monitoring tools and code repository checks.

1. Gemini 3 Pro 会自动制定多步骤计划，调用相关工具查询日志、分析资源占用，最终输出排查报告和优化方案。

六、YibuAPI 专属优势：便宜 + 省心详解

1. 价格对比（核心优势：成本仅官方 1/5）

YibuAPI 采用 “按量计费” 模式，无最低消费、无订阅门槛，价格大幅低于官方和其他竞品：

计费项	一步 价格（人民币）	官方 Gemini API 价格（人民币）	优势比例
输入每百万 Token	1.99 元	9.13 元（缓存未命中）	省 80%
输出每百万 Token	7.99 元	73.09 元	省 90%
免费额度	新用户送 10 万 Token	无免费额度（需付费订阅）	零成本试用

注：按日常开发场景估算（每天调用 100 次，每次平均 1000 Token 输入 + 2000 Token 输出），YibuAPI 每月仅需 5-10 元，而官方需 50-100 元，长期使用可节省 80% 成本。

2. 额外省心特性（国内用户刚需）

• 无需梯子：API 服务器部署在国内，延迟低至 20-50ms，比官方跨境调用快 3-5 倍，无超时问题。

• 零配置兼容：完全兼容 Google Gen AI SDK，无需修改代码，仅替换 API 地址和 Key 即可切换。

• 无权限限制：所有 YibuAPI 用户默认开通 Gemini 3 Pro 调用权限，无需加入官方候补名单，注册即能用。

• 实时账单：控制台可查看每笔调用的 Token 消耗和费用，支持按日 / 周 / 月导出账单，花钱明明白白。

七、常见问题与注意事项

1. 模型回退（Fallback）机制

• 服务器繁忙时（显示 Capacity Error），会提示 “继续尝试” 或 “切换到 2.5 Pro”，按需求选择即可。

• YibuAPI 用户无回退问题：默认保障 Gemini 3 Pro 优先调用，服务器负载自动扩容，无繁忙超时。

2. 常用命令速览

命令	功能描述
gemini help	查看所有支持的子命令
gemini status	诊断网络与鉴权状态
/tools	列出已启用的本地工具
/memory show	查看上下文记忆（如 GEMINI.md 文件）
/theme	重新设置 CLI 主题
/api-setting	切换 API 源（官方 / YibuAPI）
/balance	查看 YibuAPI 剩余额度（仅 Yibu 用户）

3. 网络访问问题

• 官方 API 用户：若所在网络无法访问 Google 服务，需提前配置代理或镜像，否则会出现认证失败或模型调用超时。

• YibuAPI 用户：无需任何配置，国内网络直连，支持电信 / 联通 / 移动等所有运营商，无访问限制。

• 若未获得 Gemini 3 Pro 权限或达到每日配额，CLI 会自动回退到 Gemini 2.5 Pro，再耗尽则回退到 2.5 Flash。

• 服务器繁忙时（显示 Capacity Error），会提示 “继续尝试” 或 “切换到 2.5 Pro”，按需求选择即可。

• YibuAPI 用户无回退问题：默认保障 Gemini 3 Pro 优先调用，服务器负载自动扩容，无繁忙超时。

2. 常用命令速览

命令	功能描述
gemini help	查看所有支持的子命令
gemini status	诊断网络与鉴权状态
/tools	列出已启用的本地工具
/memory show	查看上下文记忆（如 GEMINI.md 文件）
/theme	重新设置 CLI 主题
/api-setting	切换 API 源（官方 / YibuAPI）
/balance	查看 YibuAPI 剩余额度（仅 Yibu 用户）

3. 网络访问问题

• 官方 API 用户：若所在网络无法访问 Google 服务，需提前配置代理或镜像，否则会出现认证失败或模型调用超时。

• YibuAPI 用户：无需任何配置，国内网络直连，支持电信 / 联通 / 移动等所有运营商，无访问限制。