配額與費用
Gemini CLI 配額與費用：Google 賬號、Google AI Pro/Ultra、Gemini API Key、Vertex AI、Workspace 和 Code Assist 版本怎麼理解。
Gemini CLI 的配額、費用和隱私條款都跟認證方式繫結。最容易出錯的不是“不知道多少錢”，而是把 Google 賬號、Gemini API key、Vertex AI、Code Assist subscription 和 Workspace plan 混在一起比較。
不要硬背額度數字：Google 官方 quota、pricing、模型可用性和套餐邊界會變。本文只保留選擇邏輯；具體數字、價格、區域和套餐必須回官方 quota and pricing 頁面核驗。
1. 三類成本模型
| 模型 | 適合場景 | 主要風險 |
|---|---|---|
| Free usage | 體驗、輕量個人使用、課程試跑 | 額度耗盡、模型/能力受限（詳見下文 § 1a Free 層關鍵限制） |
| Fixed price paid tier | 個人或企業需要更可預測的日額度 | 套餐邊界和資格條件會變化 |
| Pay-as-you-go | 長任務、專業工作流、不中斷自動化 | 成本隨呼叫、token、模型和任務範圍增長 |
1a. Free 層關鍵限制（新手最容易踩坑）
不同 Free 入口的限制差異很大，按官方 quota-and-pricing 當前頁：
- Google 賬號登入（Code Assist for Individuals）：每使用者每天約 1,000 次模型請求，模型由 Gemini CLI 在 Gemini family 內自動選。
- Gemini API key 免費層：每使用者每天約 250 次請求，只能用 Flash 模型。要 Pro 或更高，必須切付費。
- Vertex AI Express mode：免費但 90 天后必須 enable billing，否則停止。
常見誤判：很多新手以為"用免費 API key 也能用 Pro 模型" —— 實際只能 Flash。要長期用 Pro，要麼走 Google AI Pro / Ultra 訂閱（個人）、Code Assist Standard / Enterprise（組織），要麼走 API key Pay-as-you-go。
1b. 哪些套餐不支援 Gemini CLI
按官方 quota-and-pricing 頁，下面這些計劃目前不支援 Gemini CLI（避免報錯時找不到原因）：
- Google AI Plus（個人訂閱，但官方未列入 Gemini CLI 支援矩陣）
- Google Workspace AI Standard / Plus / Expanded（這些只覆蓋 Gemini web app 等產品，不覆蓋 Gemini CLI 背後的 API）
- Gemini for Workspace 計劃：這些計劃只適用於 Google web 產品（如 Gemini web app、Flow），不適用於 Gemini CLI。Google 官方說"Supporting these plans is under active consideration for future support"。
flowchart TD
Auth["認證方式"] --> Google["Google account / Code Assist"]
Auth --> API["Gemini API key"]
Auth --> Vertex["Vertex AI"]
Google --> Fixed["免費或固定訂閱額度"]
API --> PayGo["免費 tier 或按量付費"]
Vertex --> Cloud["Express / regular mode / Cloud billing"]
Fixed --> Terms["對應隱私和 ToS"]
PayGo --> Terms
Cloud --> Terms
style Auth fill:#dbeafe,stroke:#3b82f6,stroke-width:2px
style PayGo fill:#fef3c7,stroke:#f59e0b
style Cloud fill:#fee2e2,stroke:#ef44442. 認證方式決定費用路徑
| 認證方式 | 費用/額度判斷入口 | 更適合誰 |
|---|---|---|
| Google account / Code Assist | Code Assist limits、Google AI Pro / Ultra、Standard / Enterprise | 個人本機、團隊席位、固定額度 |
| Gemini API key | Gemini API rate limits 和 pricing | headless、指令碼化、明確 API 計費 |
| Vertex AI | Vertex AI quota、dynamic shared quota、pricing、provisioned throughput | 企業、生產、IAM 和 Cloud 治理 |
| Cloud Shell | 當前 Cloud project、賬號許可和組織策略 | Cloud 學習和輕量專案任務 |
同一個人換認證方式，quota、費用和隱私條款可能都變。排障時先問“當前 CLI 到底用什麼身份在呼叫”，不要只看模型名。
3. 個人使用者怎麼選
個人開發者通常先用 Google 賬號登入。好處是：
- 不用管理 API key。
- 更適合互動式使用。
- 成本更可預測。
- 對教程復現更簡單。
如果你已經有 Google AI Pro / Ultra 或 Code Assist 權益，用對應賬號登入，再回官方 quota 頁面確認當前權益是否覆蓋 Gemini CLI。
4. API Key 和 Vertex AI 怎麼選
API Key 適合：
- headless mode。
- 指令碼化。
- 想明確使用 Gemini API。
- 不方便瀏覽器登入。
Vertex AI 適合：
- 企業。
- 生產環境。
- 需要 IAM、治理、安全、合規和 Cloud 生態。
按量付費前先收窄任務範圍：長上下文、大儲存庫掃描、反覆失敗的自動化、CI 迴圈和大規模重構都會推高呼叫成本。先用只讀計劃確認範圍，再執行。
5. 隱私條款也隨認證方式變化
官方 Terms and Privacy 頁面把認證方式拆成四類：個人 Google account、Standard/Enterprise Google account、Gemini Developer API key、Vertex AI GenAI API key。每類適用的 ToS、privacy notice 和是否用於模型改進的規則不同。
這對教程使用者很重要：個人體驗可以用個人賬號，企業程式碼和客戶資料不應該預設走個人免費路徑。團隊上線前要確認：
- 賬號型別。
- 是否 Standard / Enterprise。
- 是否透過 API key 或 Vertex AI。
- usage statistics 是否開啟。
- prompts、answers、code 是否可能被用於產品改進或模型訓練。
6. 查當前用量
官方文件推薦：
/stats model它會顯示當前 session token 使用情況，以及當前 quota/模型相關資訊。退出 session 時也會展示模型使用摘要。
7. 降低成本的基本方法
- 先問清楚再讓它執行，不要用模糊大任務來回試。
- 大範圍重構先讓它列計劃。
- 付費 API Key 場景要監控
/stats model。 - 使用 token caching 相關能力前，先理解快取對當前任務是否真的有收益。
- CI/headless 任務要設定明確範圍，不要讓它掃描不必要目錄。
8. 接下來去哪
術語表
如果 Code Assist、Vertex AI、MCP、headless、token caching 還混淆，先補術語。
模型選擇
費用和 quota 只是入口，具體任務還要按模型、上下文和速度選。
Terms and privacy
繼續看不同認證方式對應的 ToS、隱私和 usage statistics 邊界。