Gemini 3
Gemini CLI 中 Gemini 3 支持的定位、上下文、推理能力和使用注意事项。
官方 README 把 Gemini CLI 的卖点之一写成 Gemini 3 models、改进推理和 1M token context window。具体可用模型、别名和预览状态会随官方发布变化。
模型事实容易变化：写教程和排错时，以当前 gemini --help、官方 model 文档和 changelog 为准。
该关注什么
- 当前默认模型。
- 是否启用 preview features。
- 上下文窗口。
- 配额是否支持当前模型。
- 免费层和付费层差异。
- 任务是否真的需要最强模型。
启用路径
官方 Gemini 3 页面给出的上手路径是先升级 CLI：
npm install -g @google/gemini-cli@latest升级到当前版本（按官方 Gemini 3 on Gemini CLI 给出的最低版本，例如 0.21.1 之后的版本）后，进入 Gemini CLI 运行 /model，选择 Auto (Gemini 3)。如果你有 Gemini 3.1 Pro Preview 权限，可以在 /model 的 Manual 列表里看到 gemini-3.1-pro-preview，也可以用 -m 直接指定。
gemini -m gemini-3.1-pro-previewGemini Code Assist Standard / Enterprise 用户还涉及 release channel：管理员需要在 Google Cloud 项目的 Gemini 管理设置里启用 Preview，用户再在 /settings 中开启 Preview Features，重启 CLI 后生效。
Auto 与 fallback
Gemini 3 不只是“手动选一个模型”。官方文档说明，Auto routing 会按任务复杂度决定路由：简单任务可走 Flash，复杂任务在启用 Gemini 3 时优先 Gemini 3 Pro，否则回落到 Gemini 2.5 Pro。
达到 Gemini 3 Pro 日限额时，CLI 会提示切换到 Gemini 2.5 Pro、升级配额或停止，并显示何时重置。Gemini 2.5 Pro 达到限制时，也会提示回落到 Gemini 2.5 Flash。容量过载时，CLI 会让你选择继续等待或 fallback，并用 exponential backoff 重试。
Firecrawl 抓到的官方 GitHub 文档还提到，Gemini 3.1 Pro Preview 属于 rollout 状态，可见性和账号权限强相关。教程里出现 gemini-3.1-pro-preview 时，要写成“如果你的账号可见”，不能写成所有用户的默认选项，也要写测试日期、账号类型和来源。
使用建议
复杂架构、跨文件重构、长上下文理解优先用 Auto (Gemini 3) 或 Pro；简单解释、格式整理、短任务可以用 Flash。课程里不要把 Gemini 3 写成固定必选项，因为模型可用性、预览状态、账户权限和配额都会变化。
| 场景 | 推荐写法 |
|---|---|
| 教程默认建议 | 选 Auto，让 CLI 按任务路由 |
| 复杂任务演示 | 标注测试时使用的模型和日期 |
| 账号权限不同 | 提醒用 /model 看实际可见列表 |
| 预览模型 | 说明可能需要 release channel / preview features |
| 配额限制 | 说明 CLI 会提示 fallback 或等待 |
不要把“我账号里能看到的模型”写成所有读者都能看到的事实。更稳的写法是告诉读者如何验证自己的可用模型。
同一条教程在个人 Google 登录、Gemini API key、Vertex AI、Code Assist Standard / Enterprise 下，模型入口和配额表现可能不同。发布前要注明你的认证方式。
验收方式
先用 /model 确认当前账号实际可见的模型，再用 /stats model 看当前会话模型使用情况。教程截图或录屏必须标注测试日期；否则模型名和 UI 选项变化后容易误导读者。
接下来去哪
模型选择
继续看 /model、--model、Auto、Pro、Flash 和 Manual 的使用边界。
Quota and pricing
模型可用性和配额强相关，回看 quota 和 fallback 提示。
模型路由
继续看 Auto routing、fallback 和实际使用模型怎么排查。