---
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="/zh-Hant/docs/gemini-cli/official/05-models-runtime/51-model-selection" />
  <Card title="Quota and pricing" description="模型可用性和配額強相關，回看 quota 和 fallback 提示。" href="/zh-Hant/docs/gemini-cli/official/00-getting-started/06-quota-and-pricing" />
  <Card title="模型路由" description="繼續看 Auto routing、fallback 和實際使用模型怎麼排查。" href="/zh-Hant/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)
