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 和實際使用模型怎麼排查。