---
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/)

## 先按问题选入口

| 你现在要做什么 | 进入哪组 | 先看哪一页 |
| --- | --- | --- |
| 第一次安装和登录 | 入门 | [入门](/docs/gemini-cli/official/00-getting-started) |
| 查 `gemini` 命令和 slash commands | CLI 工作流 | [CLI 工作流](/docs/gemini-cli/official/01-cli-workflow) |
| 配 `GEMINI.md`、settings、忽略文件 | 上下文与配置 | [上下文与配置](/docs/gemini-cli/official/02-context-config) |
| 接 MCP、Web、Shell、文件系统工具 | 工具与 MCP | [工具与 MCP](/docs/gemini-cli/official/03-tools-mcp) |
| 使用 Skills、Subagents、Remote agents | Agents & Skills | [Agents & Skills](/docs/gemini-cli/official/04-agents-skills) |
| 选择模型、看配额和缓存 | 模型与运行时 | [模型与运行时](/docs/gemini-cli/official/05-models-runtime) |
| 控制权限、沙箱、企业策略 | 安全与企业 | [安全与企业](/docs/gemini-cli/official/06-security-enterprise) |
| 接 IDE、Hooks、GitHub Action、自动化 | 集成与自动化 | [集成与自动化](/docs/gemini-cli/official/07-integrations-automation) |
| 排错、卸载、查版本 | 故障与参考 | [故障与参考](/docs/gemini-cli/official/08-troubleshooting-reference) |

<Cards>
  <Card title="从入门开始" description="安装、认证、Quickstart、Cloud Shell、发布通道和配额费用。" href="/docs/gemini-cli/official/00-getting-started" />
  <Card title="进入日常工作流" description="CLI commands、文件、Shell、Web、计划、checkpoint 和 Plan mode。" href="/docs/gemini-cli/official/01-cli-workflow" />
  <Card title="配置真实项目" description="GEMINI.md、settings、memory、ignore、custom commands 和 trusted folders。" href="/docs/gemini-cli/official/02-context-config" />
  <Card title="扩展工具能力" description="内置工具、MCP、resources、server 和 extensions。" href="/docs/gemini-cli/official/03-tools-mcp" />
  <Card title="补齐安全边界" description="sandbox、policy、enterprise controls、telemetry 和 privacy。" href="/docs/gemini-cli/official/06-security-enterprise" />
  <Card title="排查和版本参考" description="FAQ、troubleshooting、uninstall、release notes 和 NPM package。" href="/docs/gemini-cli/official/08-troubleshooting-reference" />
</Cards>

## 推荐阅读顺序

第一次学习按这个顺序走，不要直接跳到 MCP、Hooks 或 GitHub Action：

1. [入门](/docs/gemini-cli/official/00-getting-started)：先确认它是什么、怎么装、怎么认证、怎么启动。
2. [CLI 工作流](/docs/gemini-cli/official/01-cli-workflow)：掌握命令、文件、Shell、Web、会话、计划和 checkpoint。
3. [上下文与配置](/docs/gemini-cli/official/02-context-config)：把一次性提示沉淀成 `GEMINI.md`、settings 和自定义命令。
4. [工具与 MCP](/docs/gemini-cli/official/03-tools-mcp)：先掌握内置工具，再接外部系统。
5. [Agents & Skills](/docs/gemini-cli/official/04-agents-skills)：把专门能力、角色和远程 agent 分层。
6. [安全与企业](/docs/gemini-cli/official/06-security-enterprise)：进入真实项目和团队前必须补读。

> [!IMPORTANT]
> **不要只查怎么开功能**：凡是涉及文件写入、Shell、MCP 写操作、GitHub 自动化、企业项目和 Cloud 账单，都要同时查安全、policy、sandbox 和权限边界。

## 完整目录

### 入门

- [入门](/docs/gemini-cli/official/00-getting-started)
- Gemini CLI 定位
- 安装方式
- 认证方式
- Quickstart
- Cloud Shell
- 发布通道
- 配额与费用
- 术语表

入门阶段只验证三件事：命令能启动、认证能通过、Gemini CLI 能在一个低风险目录里完成只读解释。先不要让它大范围改代码。

### CLI 工作流

- [CLI 工作流](/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 的交互动作和任务控制方式串起来。

### 上下文与配置

- [上下文与配置](/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](/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](/docs/gemini-cli/official/04-agents-skills)
- Agent Skills
- create skills
- skills best practices
- activate skill
- subagents
- remote agents

这一组适合已经能稳定跑普通任务的人。目标不是“多装能力”，而是把专门任务变成可复用能力。

### 模型与运行时

- [模型与运行时](/docs/gemini-cli/official/05-models-runtime)
- Gemini 3
- model selection
- model routing
- local model routing
- token caching
- ACP mode

模型选择不是越强越好。要结合任务复杂度、上下文长度、配额、成本和失败回退策略一起看。

### 安全与企业

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

这一组不是附录。真实项目、团队项目、企业项目、Cloud 项目都必须先定义边界再扩大使用。

### 集成与自动化

- [集成与自动化](/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 自动化一次性全接上。

### 故障与参考

- [故障与参考](/docs/gemini-cli/official/08-troubleshooting-reference)
- FAQ
- troubleshooting
- uninstall
- release notes
- NPM package

故障排查按症状查；版本和发布通道按当前官方 changelog 查。

## 下一步

- 想理解这些功能为什么这样分层，继续读：[Gemini CLI 从原理到实战](/docs/gemini-cli/understanding)。
- 已经准备动手，先读：[安装、认证和第一次启动](/docs/gemini-cli/understanding/02-install-auth-first-run)。
- 准备和 Codex、Claude Code、OpenCode 做选择，读：[Gemini CLI vs Codex CLI vs Claude Code vs OpenCode](/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)
