官方教程中文版入門

Gemini CLI 入門

Gemini CLI 入門目錄：定位、安裝、認證、Quickstart、Cloud Shell、釋出通道、配額費用和術語表。

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

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

1. 推薦路徑

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. 目錄

Gemini CLI 定位

先理解它和 Gemini Code Assist、Cloud Shell、VS Code agent mode、MCP 的關係。

安裝 Gemini CLI

在 npm、npx、Homebrew、sandbox 和原始碼執行之間選正確路徑。

認證方式

區分 Google OAuth、API key、Vertex AI、Cloud Project 和 headless 場景。

Quickstart

用只讀分析、限定寫入和 diff 檢查跑通第一條安全閉環。

Cloud Shell 入口

免本機安裝快速驗證，但要確認 project、IAM 和資源邊界。

釋出通道

判斷 stable、preview、nightly 的適用場景和團隊預設選擇。

配額與費用

理解認證方式、quota、pricing、隱私條款和成本控制的關係。

術語表

快速區分 ReAct、MCP、GEMINI.md、checkpoint、headless、Vertex AI 等術語。

3. 推薦起步順序

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

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

4. 進入下一組前的驗收

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

官方來源

5. 接下來去哪

CLI 工作流

入門閉環跑通後，繼續學習命令、快捷鍵、shell、history、plan 和 checkpoint。

工具與 MCP

準備讓 Gemini CLI 讀寫檔案、跑命令或接外部工具前，先看工具邊界。

Gemini CLI 官方教程中文版

基於 Google 官方文件和 google-gemini/gemini-cli 官方儲存庫重寫的中文查詢手冊，覆蓋安裝、認證、CLI、工具、MCP、配置、模型、安全、企業和自動化。

Gemini CLI 定位

解釋 Gemini CLI 是什麼、它和 Gemini Code Assist / Google Cloud / IDE agent mode 的關係，以及為什麼它不只是命令列聊天框。

本頁目錄

1. 推薦路徑 2. 目錄 3. 推薦起步順序 4. 進入下一組前的驗收官方來源 5. 接下來去哪