---
title: "Gemini CLI 入門"
description: "Gemini CLI 入門目錄：定位、安裝、認證、Quickstart、Cloud Shell、釋出通道、配額費用和術語表。"
verifiedAt: "2026-05-09"
---

Gemini CLI 入門不是安裝一個 npm 包就結束。第一天要完成四件事：理解它在 Google 生態裡的位置，選對安裝方式，選對認證路徑，用一個低風險專案跑通只讀分析和限定寫入。

> [!NOTE]
> **推薦順序**：定位 → 安裝 → 認證 → Quickstart。Cloud Shell、釋出通道、配額費用和術語表按需查，不要在沒跑通第一條任務前先糾結所有高階配置。

## 1. 推薦路徑

```mermaid
flowchart LR
    Position["定位"] --> Install["安裝"]
    Install --> Auth["認證"]
    Auth --> Quick["Quickstart"]
    Quick --> Workflow["CLI 工作流"]
    Auth --> Quota["配額與費用"]
    Install --> Cloud["Cloud Shell"]

    style Quick fill:#dcfce7,stroke:#22c55e
    style Quota fill:#fef3c7,stroke:#f59e0b
```

第一天只追求一個可復現狀態：`gemini` 能啟動，認證方式清楚，第一輪只讀分析沒有越界，第二輪限定寫入可用 `git diff` 審查。

## 2. 目錄

<Cards>
  <Card title="Gemini CLI 定位" description="先理解它和 Gemini Code Assist、Cloud Shell、VS Code agent mode、MCP 的關係。" href="/zh-Hant/docs/gemini-cli/official/00-getting-started/00-positioning" />
  <Card title="安裝 Gemini CLI" description="在 npm、npx、Homebrew、sandbox 和原始碼執行之間選正確路徑。" href="/zh-Hant/docs/gemini-cli/official/00-getting-started/01-installation" />
  <Card title="認證方式" description="區分 Google OAuth、API key、Vertex AI、Cloud Project 和 headless 場景。" href="/zh-Hant/docs/gemini-cli/official/00-getting-started/02-authentication" />
  <Card title="Quickstart" description="用只讀分析、限定寫入和 diff 檢查跑通第一條安全閉環。" href="/zh-Hant/docs/gemini-cli/official/00-getting-started/03-quickstart" />
  <Card title="Cloud Shell 入口" description="免本機安裝快速驗證，但要確認 project、IAM 和資源邊界。" href="/zh-Hant/docs/gemini-cli/official/00-getting-started/04-cloud-shell" />
  <Card title="釋出通道" description="判斷 stable、preview、nightly 的適用場景和團隊預設選擇。" href="/zh-Hant/docs/gemini-cli/official/00-getting-started/05-release-channels" />
  <Card title="配額與費用" description="理解認證方式、quota、pricing、隱私條款和成本控制的關係。" href="/zh-Hant/docs/gemini-cli/official/00-getting-started/06-quota-and-pricing" />
  <Card title="術語表" description="快速區分 ReAct、MCP、GEMINI.md、checkpoint、headless、Vertex AI 等術語。" href="/zh-Hant/docs/gemini-cli/official/00-getting-started/glossary" />
</Cards>

## 3. 推薦起步順序

1. 本地先確認 Node.js 版本和系統要求。
2. 個人使用者優先用 Google 賬號登入。
3. 企業、Workspace、Vertex AI 使用者先確認 Google Cloud project。
4. 第一次任務只做只讀解釋，不讓它直接改真實專案。
5. 需要自動化或 CI 時，再考慮 API key、Vertex AI、headless mode。

> [!WARNING]
> **不要把入門順序倒過來**：MCP、extensions、subagents、policy、headless 和 GitHub Action 都應該在第一條安全閉環之後學。基礎認證和許可權沒搞清，工具越多越容易出問題。

## 4. 進入下一組前的驗收

- `gemini --version` 能執行。
- 你知道當前使用的是 Google OAuth、API key 還是 Vertex AI。
- 你知道當前 quota 和隱私條款要去哪一個官方頁面核驗。
- 你完成過一次“只讀分析專案”的提示詞。
- 你完成過一次“只改單檔案”的低風險任務，並用 `git diff` 檢查。

## 官方來源

- [Gemini CLI · Google Developers](https://developers.google.com/gemini-code-assist/docs/gemini-cli)
- [Gemini CLI Documentation](https://google-gemini.github.io/gemini-cli/docs/)
- [Gemini CLI Get Started](https://google-gemini.github.io/gemini-cli/docs/get-started/)
- [Gemini CLI Quotas and Pricing](https://google-gemini.github.io/gemini-cli/docs/quota-and-pricing.html)

## 5. 接下來去哪

<Cards>
  <Card title="CLI 工作流" description="入門閉環跑通後，繼續學習命令、快捷鍵、shell、history、plan 和 checkpoint。" href="/zh-Hant/docs/gemini-cli/official/01-cli-workflow" />
  <Card title="工具與 MCP" description="準備讓 Gemini CLI 讀寫檔案、跑命令或接外部工具前，先看工具邊界。" href="/zh-Hant/docs/gemini-cli/official/03-tools-mcp" />
</Cards>
