---
title: "Gemini 3"
description: "Gemini CLI 中 Gemini 3 支持的定位、上下文、推理能力和使用注意事项。"
verifiedAt: "2026-05-09"
---

官方 README 把 Gemini CLI 的卖点之一写成 Gemini 3 models、改进推理和 1M token context window。具体可用模型、别名和预览状态会随官方发布变化。

> [!WARNING]
> **模型事实容易变化**：写教程和排错时，以当前 `gemini --help`、官方 model 文档和 changelog 为准。

## 该关注什么

- 当前默认模型。
- 是否启用 preview features。
- 上下文窗口。
- 配额是否支持当前模型。
- 免费层和付费层差异。
- 任务是否真的需要最强模型。

## 启用路径

官方 Gemini 3 页面给出的上手路径是先升级 CLI：

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

升级到当前版本（按官方 [Gemini 3 on Gemini CLI](https://github.com/google-gemini/gemini-cli/blob/main/docs/get-started/gemini-3.md) 给出的最低版本，例如 `0.21.1` 之后的版本）后，进入 Gemini CLI 运行 `/model`，选择 **Auto (Gemini 3)**。如果你有 Gemini 3.1 Pro Preview 权限，可以在 `/model` 的 Manual 列表里看到 `gemini-3.1-pro-preview`，也可以用 `-m` 直接指定。

```bash
gemini -m gemini-3.1-pro-preview
```

Gemini 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 选项变化后容易误导读者。

## 接下来去哪

<Cards>
  <Card title="模型选择" description="继续看 /model、--model、Auto、Pro、Flash 和 Manual 的使用边界。" href="/docs/gemini-cli/official/05-models-runtime/51-model-selection" />
  <Card title="Quota and pricing" description="模型可用性和配额强相关，回看 quota 和 fallback 提示。" href="/docs/gemini-cli/official/00-getting-started/06-quota-and-pricing" />
  <Card title="模型路由" description="继续看 Auto routing、fallback 和实际使用模型怎么排查。" href="/docs/gemini-cli/official/05-models-runtime/52-model-routing" />
</Cards>

## 官方来源

- [Gemini 3 on Gemini CLI](https://github.com/google-gemini/gemini-cli/blob/main/docs/get-started/gemini-3.md)
- [Gemini CLI model selection](https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/model.md)
