Gemini CLI 中文教學

📖 本篇術語速查表

英文 / 縮寫	中文	一句話解釋
兩條路徑	two paths	原理篇和官方教學兩條主線。
原理篇	concepts	講 Gemini CLI 工作原理的章節。
即時核驗	live check	版本 / 價格以官方為準。

不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你規劃這套 Gemini CLI 教學怎麼讀，按目標排路徑。

你是 Gemini CLI 教學導讀顧問，幫我按目標排出這套教學該怎麼讀、先讀什麼、讀到什麼程度算夠，每條建議落到能照做的動作。

【角色】
你瞭解本教學的兩條閱讀路徑（先理解原理再進官方命令設定）、各章定位、學完後的最低標準，也知道哪些內容以官方為準需即時核驗。

【輸入】
- 我的目標（快速上手 / 體系化理解 / 團隊推廣）：___
- 我的基礎（沒用過 CLI Agent / 用過別的 / 有經驗）：___
- 可投入時間：___
- 最想先解決的問題：___

【工作流程】
1. 按目標和基礎選閱讀路徑
2. 排出章節閱讀順序
3. 標出哪些內容必須以官方即時文件為準
4. 給學完的自測標準

【輸出規範】
▌一、推薦閱讀路徑 + 理由
▌二、章節閱讀順序
▌三、需即時核驗的內容提醒
▌四、學完的自測標準

【硬約束】
- 路徑按我的目標和基礎定製，不一刀切
- 先理解後命令，不要一上來背設定
- 版本 / 命令類內容提醒以官方為準
- 自測標準要可檢驗，不空談學會了
- 不要替我臆測目標，資訊不全先問清

Gemini CLI 是 Google 開源的終端 AI agent。它把 Gemini 模型放進命令列，讓 AI 能在本地專案上下文裡讀檔案、執行命令、呼叫內建工具、連線 MCP（Model Context Protocol，模型上下文協議）伺服器，並圍繞一個任務持續推理和行動。

先給結論：Gemini CLI 不是“Gemini 聊天框的命令列版本”。它更接近一個跑在終端裡的開發代理：你給目標，它讀專案、選工具、執行、觀察結果，再繼續下一步。

兩條互補路徑

flowchart LR
    Start["Gemini CLI 中文教學"] --> Official["官方教學中文版"]
    Start --> Understanding["從原理到實戰"]
    Official --> Lookup["安裝 / 認證 / CLI / 工具 / MCP / 設定 / 企業"]
    Understanding --> Judgment["定位 / 工作流 / 許可權 / 對比 / 實戰"]

    style Start fill:#dbeafe,stroke:#3b82f6,stroke-width:2px
    style Official fill:#dcfce7,stroke:#22c55e
    style Understanding fill:#fef3c7,stroke:#f59e0b

📚 官方教學中文版

按 Google 官方能力域重組，適合查安裝、認證、設定、工具、MCP、模型、企業和故障排查。

從原理到實戰

12 篇中文講解，理解 Gemini CLI 的定位、任務迴圈、上下文、許可權、擴充套件和真實專案用法。

這套教學和官方中文頁的關係

Google 已經提供 Gemini CLI 官方中文頁面：

這些頁面適合確認官方術語和產品事實，但它們不是按中文新手學習路徑寫的完整教學。本教學會做三件事：

用官方中文頁校準術語。
用 google-gemini/gemini-cli 官方儲存庫文件補全細節。
按中文開發者的真實使用順序重寫成“能學、能查、能上手”的結構。

怎麼選擇閱讀路徑

你的狀態	先讀什麼	目標
還沒安裝	官方教學中文版	查安裝方式、認證方式和第一次啟動
能啟動，但不知道怎麼安全用	從原理到實戰	理解它如何讀專案、選工具和執行任務
想接 MCP、Skills、Hooks	工具與 MCP	查官方設定與能力邊界
想比較 Codex / Claude Code / OpenCode	工具對比篇	判斷什麼時候優先選 Gemini CLI
準備團隊使用	安全與企業	查 sandbox、policy、企業控制、遙測和隱私邊界

不要只看免費額度和大上下文。Gemini CLI 真正值得學的地方，是 Google 把終端、本地工具、MCP、Code Assist、GitHub Action 和 Cloud 生態串成了一條 agent 工作流。目前上下文視窗與免費配額請以官方 Quota and pricing 為準。