AI 程式設計教程中文版
官方教程中文版

Gemini CLI 官方教程中文版

基於 Google 官方文件和 google-gemini/gemini-cli 官方儲存庫重寫的中文查詢手冊，覆蓋安裝、認證、CLI、工具、MCP、配置、模型、安全、企業和自動化。

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

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

事實來源：

先按問題選入口

你現在要做什麼進入哪組先看哪一頁
第一次安裝和登入入門入門
查 gemini 命令和 slash commandsCLI 工作流CLI 工作流
配 GEMINI.md、settings、忽略檔案上下文與配置上下文與配置
接 MCP、Web、Shell、檔案系統工具工具與 MCP工具與 MCP
使用 Skills、Subagents、Remote agentsAgents & SkillsAgents & Skills
選擇模型、看配額和快取模型與執行時模型與執行時
控制許可權、沙箱、企業策略安全與企業安全與企業
接 IDE、Hooks、GitHub Action、自動化整合與自動化整合與自動化
排錯、解除安裝、查版本故障與參考故障與參考

從入門開始

安裝、認證、Quickstart、Cloud Shell、釋出通道和配額費用。

進入日常工作流

CLI commands、檔案、Shell、Web、計劃、checkpoint 和 Plan mode。

配置真實專案

GEMINI.md、settings、memory、ignore、custom commands 和 trusted folders。

擴充套件工具能力

內建工具、MCP、resources、server 和 extensions。

補齊安全邊界

sandbox、policy、enterprise controls、telemetry 和 privacy。

排查和版本參考

FAQ、troubleshooting、uninstall、release notes 和 NPM package。

推薦閱讀順序

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

  1. 入門：先確認它是什麼、怎麼裝、怎麼認證、怎麼啟動。
  2. CLI 工作流：掌握命令、檔案、Shell、Web、會話、計劃和 checkpoint。
  3. 上下文與配置：把一次性提示沉澱成 GEMINI.md、settings 和自定義命令。
  4. 工具與 MCP：先掌握內建工具，再接外部系統。
  5. Agents & Skills：把專門能力、角色和遠端 agent 分層。
  6. 安全與企業：進入真實專案和團隊前必須補讀。

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

完整目錄

入門

  • 入門
  • Gemini CLI 定位
  • 安裝方式
  • 認證方式
  • Quickstart
  • Cloud Shell
  • 釋出通道
  • 配額與費用
  • 術語表

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

CLI 工作流

  • CLI 工作流
  • CLI reference
  • slash commands
  • keyboard shortcuts
  • file management
  • shell commands
  • web search / web fetch
  • session history
  • task planning
  • checkpoint / rewind
  • plan mode

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

上下文與配置

  • 上下文與配置
  • settings
  • GEMINI.md
  • memory management
  • .geminiignore
  • custom commands
  • generation settings
  • system prompt
  • themes
  • trusted folders

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

工具與 MCP

  • 工具與 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
  • Agent Skills
  • create skills
  • skills best practices
  • activate skill
  • subagents
  • remote agents

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

模型與執行時

  • 模型與執行時
  • Gemini 3
  • model selection
  • model routing
  • local model routing
  • token caching
  • ACP mode

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

安全與企業

  • 安全與企業
  • sandbox
  • policy engine
  • enterprise config
  • enterprise controls
  • telemetry
  • terms and privacy
  • Google Cloud security/privacy/compliance

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

整合與自動化

  • 整合與自動化
  • IDE integration
  • hooks
  • headless mode
  • automation
  • GitHub Action
  • issue and PR automation
  • local development

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

故障與參考

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

下一步

官方來源

真實專案貫穿實戰

用一個真實專案流程串起 Gemini CLI：只讀掃描、上下文沉澱、計劃、修改、驗證、checkpoint、headless 和 GitHub Action。

Gemini CLI 入門

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

本頁目錄

先按問題選入口推薦閱讀順序完整目錄入門CLI 工作流上下文與配置工具與 MCPAgents & Skills模型與執行時安全與企業整合與自動化故障與參考下一步官方來源