---
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="/docs/gemini-cli/official" />
  <Card title="从原理到实战" description="12 篇中文讲解，理解 Gemini CLI 的定位、任务循环、上下文、权限、扩展和真实项目用法。" href="/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. 按中文开发者的真实使用顺序重写成“能学、能查、能上手”的结构。

## 怎么选择阅读路径

| 你的状态 | 先读什么 | 目标 |
| --- | --- | --- |
| 还没安装 | [官方教程中文版](/docs/gemini-cli/official) | 查安装方式、认证方式和第一次启动 |
| 能启动，但不知道怎么安全用 | [从原理到实战](/docs/gemini-cli/understanding) | 理解它如何读项目、选工具和执行任务 |
| 想接 MCP、Skills、Hooks | [工具与 MCP](/docs/gemini-cli/official/03-tools-mcp) | 查官方配置与能力边界 |
| 想比较 Codex / Claude Code / OpenCode | [工具对比篇](/docs/gemini-cli/understanding/11-gemini-cli-vs-codex-claude-opencode) | 判断什么时候优先选 Gemini CLI |
| 准备团队使用 | [安全与企业](/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)
