Gemini CLI 中文教程

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 為準。

官方資料

Google Developers：https://developers.google.com/gemini-code-assist/docs/gemini-cli
Google Cloud：https://docs.cloud.google.com/gemini/docs/codeassist/gemini-cli
官方儲存庫：https://github.com/google-gemini/gemini-cli
官方專案文件：https://geminicli.com/docs/
Google Codelab：https://codelabs.developers.google.com/gemini-cli-hands-on

使用前的安全提醒

Gemini CLI 可以讀檔案、寫檔案、執行 Shell、聯網、接 MCP、進入 GitHub 自動化。進入真實專案時，先按低風險順序推進：

第一輪任務只讀：讓它解釋專案結構。
第一次寫操作限定單檔案。
大範圍修改先用計劃模式或先要求它列計劃。
涉及金鑰、賬號、賬單、部署、刪除資料時必須人工確認。
團隊環境優先查企業配置、policy engine、sandbox 和 telemetry。

延伸學習

翔宇工作流主站：xiangyugongzuoliu.com
翔宇 AI 程式設計實操課：檢視課程介紹與學習路徑