---
title: "Gemini CLI 官方教程中文版"
description: "基於 Google 官方文件和 google-gemini/gemini-cli 官方儲存庫重寫的中文查詢手冊，覆蓋安裝、認證、CLI、工具、MCP、配置、模型、安全、企業和自動化。"
verifiedAt: "2026-05-09"
---

Gemini CLI 官方教程中文版是查詢入口，不是逐字翻譯。你不用從頭讀完，按自己當前卡住的問題進入對應章節：安裝認證看“入門”，日常命令看“CLI 工作流”，專案規則看“上下文與配置”，工具擴充套件看“工具與 MCP”，團隊使用看“安全與企業”。

> [!NOTE]
> **這頁解決什麼問題**：把 Google 官方文件、Google Cloud 頁面和 `google-gemini/gemini-cli` 儲存庫文件重組成中文功能地圖。讀完你應該知道“我要查的能力在哪一組”。

事實來源：

- [Google Developers · Gemini CLI](https://developers.google.com/gemini-code-assist/docs/gemini-cli)
- [Google Developers · Gemini CLI 中文頁](https://developers.google.com/gemini-code-assist/docs/gemini-cli?hl=zh-cn)
- [Google Cloud · Gemini CLI](https://docs.cloud.google.com/gemini/docs/codeassist/gemini-cli)
- [google-gemini/gemini-cli](https://github.com/google-gemini/gemini-cli)
- [Gemini CLI 官方專案文件](https://google-gemini.github.io/gemini-cli/docs/)

## 先按問題選入口

| 你現在要做什麼 | 進入哪組 | 先看哪一頁 |
| --- | --- | --- |
| 第一次安裝和登入 | 入門 | [入門](/zh-Hant/docs/gemini-cli/official/00-getting-started) |
| 查 `gemini` 命令和 slash commands | CLI 工作流 | [CLI 工作流](/zh-Hant/docs/gemini-cli/official/01-cli-workflow) |
| 配 `GEMINI.md`、settings、忽略檔案 | 上下文與配置 | [上下文與配置](/zh-Hant/docs/gemini-cli/official/02-context-config) |
| 接 MCP、Web、Shell、檔案系統工具 | 工具與 MCP | [工具與 MCP](/zh-Hant/docs/gemini-cli/official/03-tools-mcp) |
| 使用 Skills、Subagents、Remote agents | Agents & Skills | [Agents & Skills](/zh-Hant/docs/gemini-cli/official/04-agents-skills) |
| 選擇模型、看配額和快取 | 模型與執行時 | [模型與執行時](/zh-Hant/docs/gemini-cli/official/05-models-runtime) |
| 控制許可權、沙箱、企業策略 | 安全與企業 | [安全與企業](/zh-Hant/docs/gemini-cli/official/06-security-enterprise) |
| 接 IDE、Hooks、GitHub Action、自動化 | 整合與自動化 | [整合與自動化](/zh-Hant/docs/gemini-cli/official/07-integrations-automation) |
| 排錯、解除安裝、查版本 | 故障與參考 | [故障與參考](/zh-Hant/docs/gemini-cli/official/08-troubleshooting-reference) |

<Cards>
  <Card title="從入門開始" description="安裝、認證、Quickstart、Cloud Shell、釋出通道和配額費用。" href="/zh-Hant/docs/gemini-cli/official/00-getting-started" />
  <Card title="進入日常工作流" description="CLI commands、檔案、Shell、Web、計劃、checkpoint 和 Plan mode。" href="/zh-Hant/docs/gemini-cli/official/01-cli-workflow" />
  <Card title="配置真實專案" description="GEMINI.md、settings、memory、ignore、custom commands 和 trusted folders。" href="/zh-Hant/docs/gemini-cli/official/02-context-config" />
  <Card title="擴充套件工具能力" description="內建工具、MCP、resources、server 和 extensions。" href="/zh-Hant/docs/gemini-cli/official/03-tools-mcp" />
  <Card title="補齊安全邊界" description="sandbox、policy、enterprise controls、telemetry 和 privacy。" href="/zh-Hant/docs/gemini-cli/official/06-security-enterprise" />
  <Card title="排查和版本參考" description="FAQ、troubleshooting、uninstall、release notes 和 NPM package。" href="/zh-Hant/docs/gemini-cli/official/08-troubleshooting-reference" />
</Cards>

## 推薦閱讀順序

第一次學習按這個順序走，不要直接跳到 MCP、Hooks 或 GitHub Action：

1. [入門](/zh-Hant/docs/gemini-cli/official/00-getting-started)：先確認它是什麼、怎麼裝、怎麼認證、怎麼啟動。
2. [CLI 工作流](/zh-Hant/docs/gemini-cli/official/01-cli-workflow)：掌握命令、檔案、Shell、Web、會話、計劃和 checkpoint。
3. [上下文與配置](/zh-Hant/docs/gemini-cli/official/02-context-config)：把一次性提示沉澱成 `GEMINI.md`、settings 和自定義命令。
4. [工具與 MCP](/zh-Hant/docs/gemini-cli/official/03-tools-mcp)：先掌握內建工具，再接外部系統。
5. [Agents & Skills](/zh-Hant/docs/gemini-cli/official/04-agents-skills)：把專門能力、角色和遠端 agent 分層。
6. [安全與企業](/zh-Hant/docs/gemini-cli/official/06-security-enterprise)：進入真實專案和團隊前必須補讀。

> [!IMPORTANT]
> **不要只查怎麼開功能**：凡是涉及檔案寫入、Shell、MCP 寫操作、GitHub 自動化、企業專案和 Cloud 賬單，都要同時查安全、policy、sandbox 和許可權邊界。

## 完整目錄

### 入門

- [入門](/zh-Hant/docs/gemini-cli/official/00-getting-started)
- Gemini CLI 定位
- 安裝方式
- 認證方式
- Quickstart
- Cloud Shell
- 釋出通道
- 配額與費用
- 術語表

入門階段只驗證三件事：命令能啟動、認證能透過、Gemini CLI 能在一個低風險目錄裡完成只讀解釋。先不要讓它大範圍改程式碼。

### CLI 工作流

- [CLI 工作流](/zh-Hant/docs/gemini-cli/official/01-cli-workflow)
- CLI reference
- slash commands
- keyboard shortcuts
- file management
- shell commands
- web search / web fetch
- session history
- task planning
- checkpoint / rewind
- plan mode

這一組解決“每天怎麼用”。它不是配置參考，而是把 Gemini CLI 的互動動作和任務控制方式串起來。

### 上下文與配置

- [上下文與配置](/zh-Hant/docs/gemini-cli/official/02-context-config)
- settings
- `GEMINI.md`
- memory management
- `.geminiignore`
- custom commands
- generation settings
- system prompt
- themes
- trusted folders

這一組決定 Gemini CLI 是否能長期穩定遵守你的專案習慣。不要把所有東西都塞進一次性 prompt。

### 工具與 MCP

- [工具與 MCP](/zh-Hant/docs/gemini-cli/official/03-tools-mcp)
- tools overview
- file system tool
- shell tool
- web tools
- todos / planning tools
- MCP setup
- MCP server
- MCP resources
- extensions

先理解內建工具，再接 MCP。工具越多，許可權越要清楚。

### Agents & Skills

- [Agents & Skills](/zh-Hant/docs/gemini-cli/official/04-agents-skills)
- Agent Skills
- create skills
- skills best practices
- activate skill
- subagents
- remote agents

這一組適合已經能穩定跑普通任務的人。目標不是“多裝能力”，而是把專門任務變成可複用能力。

### 模型與執行時

- [模型與執行時](/zh-Hant/docs/gemini-cli/official/05-models-runtime)
- Gemini 3
- model selection
- model routing
- local model routing
- token caching
- ACP mode

模型選擇不是越強越好。要結合任務複雜度、上下文長度、配額、成本和失敗回退策略一起看。

### 安全與企業

- [安全與企業](/zh-Hant/docs/gemini-cli/official/06-security-enterprise)
- sandbox
- policy engine
- enterprise config
- enterprise controls
- telemetry
- terms and privacy
- Google Cloud security/privacy/compliance

這一組不是附錄。真實專案、團隊專案、企業專案、Cloud 專案都必須先定義邊界再擴大使用。

### 整合與自動化

- [整合與自動化](/zh-Hant/docs/gemini-cli/official/07-integrations-automation)
- IDE integration
- hooks
- headless mode
- automation
- GitHub Action
- issue and PR automation
- local development

整合適合已有工作流的人讀。個人上手階段先不要把 GitHub Action、Hooks 和 headless 自動化一次性全接上。

### 故障與參考

- [故障與參考](/zh-Hant/docs/gemini-cli/official/08-troubleshooting-reference)
- FAQ
- troubleshooting
- uninstall
- release notes
- NPM package

故障排查按症狀查；版本和釋出通道按當前官方 changelog 查。

## 下一步

- 想理解這些功能為什麼這樣分層，繼續讀：[Gemini CLI 從原理到實戰](/zh-Hant/docs/gemini-cli/understanding)。
- 已經準備動手，先讀：[安裝、認證和第一次啟動](/zh-Hant/docs/gemini-cli/understanding/02-install-auth-first-run)。
- 準備和 Codex、Claude Code、OpenCode 做選擇，讀：[Gemini CLI vs Codex CLI vs Claude Code vs OpenCode](/zh-Hant/docs/gemini-cli/understanding/11-gemini-cli-vs-codex-claude-opencode)。

## 官方來源

- [Google Developers Gemini CLI](https://developers.google.com/gemini-code-assist/docs/gemini-cli?hl=zh-cn)
- [Gemini CLI GitHub](https://github.com/google-gemini/gemini-cli)
