---
title: "配額與費用"
description: "Gemini CLI 配額與費用：Google 賬號、Google AI Pro/Ultra、Gemini API Key、Vertex AI、Workspace 和 Code Assist 版本怎麼理解。"
verifiedAt: "2026-05-09"
---

Gemini CLI 的配額、費用和隱私條款都跟認證方式繫結。最容易出錯的不是“不知道多少錢”，而是把 Google 賬號、Gemini API key、Vertex AI、Code Assist subscription 和 Workspace plan 混在一起比較。

> [!WARNING]
> **不要硬背額度數字**：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](https://github.com/google-gemini/gemini-cli/blob/main/docs/resources/quota-and-pricing.md) 當前頁：

- **Google 賬號登入（Code Assist for Individuals）**：每使用者每天約 1,000 次模型請求，模型由 Gemini CLI 在 Gemini family 內自動選。
- **Gemini API key 免費層**：每使用者每天約 250 次請求，**只能用 Flash 模型**。要 Pro 或更高，必須切付費。
- **Vertex AI Express mode**：免費但 **90 天后必須 enable billing**，否則停止。

> [!WARNING]
> **常見誤判**：很多新手以為"用免費 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"。

```mermaid
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:#ef4444
```

## 2. 認證方式決定費用路徑

| 認證方式 | 費用/額度判斷入口 | 更適合誰 |
| --- | --- | --- |
| 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 生態。

> [!IMPORTANT]
> **按量付費前先收窄任務範圍**：長上下文、大儲存庫掃描、反覆失敗的自動化、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. 查當前用量

官方文件推薦：

```text
/stats model
```

它會顯示當前 session token 使用情況，以及當前 quota/模型相關資訊。退出 session 時也會展示模型使用摘要。

## 7. 降低成本的基本方法

- 先問清楚再讓它執行，不要用模糊大任務來回試。
- 大範圍重構先讓它列計劃。
- 付費 API Key 場景要監控 `/stats model`。
- 使用 token caching 相關能力前，先理解快取對當前任務是否真的有收益。
- CI/headless 任務要設定明確範圍，不要讓它掃描不必要目錄。

## 8. 接下來去哪

<Cards>
  <Card title="術語表" description="如果 Code Assist、Vertex AI、MCP、headless、token caching 還混淆，先補術語。" href="/zh-Hant/docs/gemini-cli/official/00-getting-started/glossary" />
  <Card title="模型選擇" description="費用和 quota 只是入口，具體任務還要按模型、上下文和速度選。" href="/zh-Hant/docs/gemini-cli/official/05-models-runtime/51-model-selection" />
  <Card title="Terms and privacy" description="繼續看不同認證方式對應的 ToS、隱私和 usage statistics 邊界。" href="/zh-Hant/docs/gemini-cli/official/06-security-enterprise/65-terms-privacy" />
</Cards>

## 官方來源

- [Gemini CLI Quotas and Pricing](https://google-gemini.github.io/gemini-cli/docs/quota-and-pricing.html)
- [Gemini CLI Terms of Service and Privacy Notice](https://google-gemini.github.io/gemini-cli/docs/tos-privacy.html)
- [Google Developers Gemini CLI](https://developers.google.com/gemini-code-assist/docs/gemini-cli?hl=zh-cn)
