Appearance
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+):
- 运行
/model - 选择 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 Standard 或 Gemini Code Assist Enterprise 使用 Gemini CLI,启用 Gemini 3 Pro 需要管理员和用户侧分别操作。
管理员操作
需要 Google Cloud Settings Admin 权限:
- 进入 Google Cloud 项目(与 Gemini CLI Code Assist 绑定的项目)
- 导航到 Admin for Gemini > Settings
- 在 Release channels for Gemini Code Assist in local IDEs 中选择 Preview
- 点击 Save changes
详见 Configure Gemini Code Assist release channels。
用户操作
管理员启用 Preview 后等待 2-3 分钟,然后:
- 打开 Gemini CLI
- 使用
/settings命令 - 将 Preview Features 设为
true - 重启 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 留下反馈。