AI 程式設計教學中文版
官方教學中文版入門

Gemini CLI 入門

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

📖 本篇術語速查表
英文 / 縮寫中文一句話解釋
入門路線onboarding從安裝到跑通第一個任務的順序。
安全起步safe start第一次低風險地用起來。
釋出通道channel穩定還是嚐鮮版本。

不想讀完?把下面這段提示詞丟給 AI 幫你跑完——幫你規劃 Gemini CLI 從安裝到跑通第一個任務的入門順序。

你是 Gemini CLI 入門規劃顧問,幫我按自己的基礎排出從安裝到跑通第一個任務的入門順序。

【角色】
你熟悉 Gemini CLI 入門的正確順序:理解定位→安裝認證→quickstart→安全跑第一個任務,知道哪些坑要避。

【輸入】
- 我的程式設計基礎和環境:___
- 現在用什麼工具:___
- 近期想用它達成什麼:___
- 最擔心的問題:___

【工作流程】
1. 按基礎定入門起點
2. 排出入門順序
3. 標出每步關鍵動作和要避的坑
4. 給第一步具體動作

【輸出規範】
▌一、入門順序
▌二、每步關鍵動作
▌三、要避開的坑
▌四、第一步做什麼

【硬約束】
- 順序按基礎定製,不一刀切
- 第一個任務安全可回復
- 不誇大能力,不確定的查官方文件
- 不要臆測我的環境,資訊不全先問清

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

3. 推薦起步順序

  1. 本地先確認 Node.js 版本和系統要求。
  2. 個人使用者優先用 Google 賬號登入。
  3. 企業、Workspace、Vertex AI 使用者先確認 Google Cloud project。
  4. 第一次任務只做只讀解釋,不讓它直接改真實專案。
  5. 需要自動化或 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. 接下來去哪

本頁目錄