---
title: "Gemini CLI 中文教程"
description: "基於 Google 官方文件、Google Cloud 文件和 google-gemini/gemini-cli 官方儲存庫重寫的 Gemini CLI 中文教程。"
verifiedAt: "2026-05-09"
---

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

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

## 兩條互補路徑

```mermaid
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
```

<Cards>
  <Card title="📚 官方教程中文版" description="按 Google 官方能力域重組，適合查安裝、認證、配置、工具、MCP、模型、企業和故障排查。" href="/zh-Hant/docs/gemini-cli/official" />
  <Card title="從原理到實戰" description="12 篇中文講解，理解 Gemini CLI 的定位、任務迴圈、上下文、許可權、擴充套件和真實專案用法。" href="/zh-Hant/docs/gemini-cli/understanding" />
</Cards>

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

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

- [Google Developers 中文頁](https://developers.google.com/gemini-code-assist/docs/gemini-cli?hl=zh-cn)
- [Google Cloud 中文頁](https://docs.cloud.google.com/gemini/docs/codeassist/gemini-cli?hl=zh-cn)

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

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

## 怎麼選擇閱讀路徑

| 你的狀態 | 先讀什麼 | 目標 |
| --- | --- | --- |
| 還沒安裝 | [官方教程中文版](/zh-Hant/docs/gemini-cli/official) | 查安裝方式、認證方式和第一次啟動 |
| 能啟動，但不知道怎麼安全用 | [從原理到實戰](/zh-Hant/docs/gemini-cli/understanding) | 理解它如何讀專案、選工具和執行任務 |
| 想接 MCP、Skills、Hooks | [工具與 MCP](/zh-Hant/docs/gemini-cli/official/03-tools-mcp) | 查官方配置與能力邊界 |
| 想比較 Codex / Claude Code / OpenCode | [工具對比篇](/zh-Hant/docs/gemini-cli/understanding/11-gemini-cli-vs-codex-claude-opencode) | 判斷什麼時候優先選 Gemini CLI |
| 準備團隊使用 | [安全與企業](/zh-Hant/docs/gemini-cli/official/06-security-enterprise) | 查 sandbox、policy、企業控制、遙測和隱私邊界 |

> [!IMPORTANT]
> **不要只看免費額度和大上下文**。Gemini CLI 真正值得學的地方，是 Google 把終端、本地工具、MCP、Code Assist、GitHub Action 和 Cloud 生態串成了一條 agent 工作流。當前上下文視窗與免費配額請以官方 [Quota and pricing](https://github.com/google-gemini/gemini-cli/blob/main/docs/resources/quota-and-pricing.md) 為準。

## 官方資料

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

## 使用前的安全提醒

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

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

## 引流出口

- Aaron工作流主站：[xiangyugongzuoliu.com](https://xiangyugongzuoliu.com)
- AI 程式設計實操課：[課程頁](https://flowus.cn/xiangyugongzuoliu/share/d392dcad-b537-44ee-a3e2-56ff5af02bce)
