Skip to content

Gemini 3 Pro 是 Gemini CLI 目前最强模型。升级到 0.21.1+ 版本后,在 /model 中选择 Auto (Gemini 3) 即可启用。日用量耗尽会自动降级到 Gemini 2.5 Pro,容量过载时可选择重试或手动降级。本页说明模型路由逻辑和企业环境的管理员配置步骤。

在 Gemini CLI 中使用 Gemini 3 Pro 和 Flash

最新动态:Gemini 3.1 Pro Preview 正在逐步推出。使用 /model 命令选择 Manual,如果你有访问权限,会在列表中看到 gemini-3.1-pro-preview。有权限后,可直接用 -m 标志启动:

gemini -m gemini-3.1-pro-preview

详见 模型切换模型路由


启用 Gemini 3

第一步:将 Gemini CLI 升级到最新版本:

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

第二步(版本 0.21.1+):

  1. 运行 /model
  2. 选择 Auto (Gemini 3)

更多模型选择信息参见 模型切换(/model)


用量限制与降级策略

日用量限制

Gemini 3 Pro 有每日用量上限。当你到达上限时,CLI 会提示你选择:

  • 切换到 Gemini 2.5 Pro 继续使用
  • 升级获取更高配额
  • 停止使用

CLI 还会告知你用量上限的重置时间。

需要更高用量上限?前往 Plans 页面 比较订阅选项,找到适合你的配额方案。

类似地,当你的 Gemini 2.5 Pro 日用量也耗尽时,CLI 会提示降级到 Gemini 2.5 Flash。

容量错误

Gemini 3 Pro 有时可能过载。此时 CLI 会询问你:

  • 继续重试:使用指数退避策略(每次重试之间等待时间递增),系统繁忙时适用
  • 降级到 Gemini 2.5 Pro:立即切换到较低版本继续工作

选择"继续重试"后,如果不立即响应,等待几分钟让系统处理请求。


模型路由类型

在使用 Gemini CLI 时,可以控制请求如何在不同模型间路由。默认使用 Auto 路由。

使用 Gemini 3 Pro 时,有两种主要路由策略:

路由模式说明适用场景
Auto自动判断复杂度:简单 Prompt → Gemini 2.5 Flash;复杂 Prompt → Gemini 3 Pro(已启用时)或 Gemini 2.5 Pro一般日常使用,省配额
Pro优先调用最强模型(含 Gemini 3 Pro)需要最高质量输出的任务

切换方法:运行 /model,在菜单中选择对应路由模式。

详细路由逻辑参见 模型路由与故障转移


企业用户:Gemini Code Assist 启用步骤

如果你通过 Gemini Code Assist StandardGemini Code Assist Enterprise 使用 Gemini CLI,启用 Gemini 3 Pro 需要管理员和用户侧分别操作。

管理员操作

需要 Google Cloud Settings Admin 权限:

  1. 进入 Google Cloud 项目(与 Gemini CLI Code Assist 绑定的项目)
  2. 导航到 Admin for Gemini > Settings
  3. Release channels for Gemini Code Assist in local IDEs 中选择 Preview
  4. 点击 Save changes

详见 Configure Gemini Code Assist release channels

用户操作

管理员启用 Preview等待 2-3 分钟,然后:

  1. 打开 Gemini CLI
  2. 使用 /settings 命令
  3. Preview Features 设为 true
  4. 重启 Gemini CLI

重启后应可使用 Gemini 3。


常见问题

Q: 怎么判断我是否已经在用 Gemini 3 Pro?

A: 在 /model 菜单中查看当前选择的路由模式。如果选了 Auto (Gemini 3) 或 Pro,且你有 Gemini 3 的访问权限,复杂任务就会走 Gemini 3 Pro。每次响应顶部的模型标识也会显示实际使用的模型。

Q: Gemini 3.1 和 Gemini 3 有什么区别?

A: Gemini 3.1 Pro Preview 是 Gemini 3 系列的更新版本,能力更强。两者的使用方式相同,区别在于 3.1 目前还在 Preview 阶段,访问权限正在逐步开放。你可以通过 /model → Manual 检查是否有访问权限。

Q: 遇到问题如何获得帮助?

A: 在 GitHub Issues 搜索已知问题。如果找不到,可以创建新 Issue 或在 GitHub Discussions 留下反馈。