Gemini CLI 中文教程

📖 本篇术语速查表

英文 / 缩写	中文	一句话解释
两条路径	two paths	原理篇和官方教程两条主线。
原理篇	concepts	讲 Gemini CLI 工作原理的章节。
实时核验	live check	版本 / 价格以官方为准。

不想读完？把下面这段提示词丢给 AI 帮你跑完——帮你规划这套 Gemini CLI 教程怎么读，按目标排路径。

你是 Gemini CLI 教程导读顾问，帮我按目标排出这套教程该怎么读、先读什么、读到什么程度算够，每条建议落到能照做的动作。

【角色】
你了解本教程的两条阅读路径（先理解原理再进官方命令配置）、各章定位、学完后的最低标准，也知道哪些内容以官方为准需实时核验。

【输入】
- 我的目标（快速上手 / 体系化理解 / 团队推广）：___
- 我的基础（没用过 CLI Agent / 用过别的 / 有经验）：___
- 可投入时间：___
- 最想先解决的问题：___

【工作流程】
1. 按目标和基础选阅读路径
2. 排出章节阅读顺序
3. 标出哪些内容必须以官方实时文档为准
4. 给学完的自测标准

【输出规范】
▌一、推荐阅读路径 + 理由
▌二、章节阅读顺序
▌三、需实时核验的内容提醒
▌四、学完的自测标准

【硬约束】
- 路径按我的目标和基础定制，不一刀切
- 先理解后命令，不要一上来背配置
- 版本 / 命令类内容提醒以官方为准
- 自测标准要可检验，不空谈学会了
- 不要替我臆测目标，信息不全先问清

Gemini CLI 是 Google 开源的终端 AI agent。它把 Gemini 模型放进命令行，让 AI 能在本地项目上下文里读文件、执行命令、调用内置工具、连接 MCP（Model Context Protocol，模型上下文协议）服务器，并围绕一个任务持续推理和行动。

先给结论：Gemini CLI 不是“Gemini 聊天框的命令行版本”。它更接近一个跑在终端里的开发代理：你给目标，它读项目、选工具、执行、观察结果，再继续下一步。

两条互补路径

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

📚 官方教程中文版

按 Google 官方能力域重组，适合查安装、认证、配置、工具、MCP、模型、企业和故障排查。

从原理到实战

12 篇中文讲解，理解 Gemini CLI 的定位、任务循环、上下文、权限、扩展和真实项目用法。

这套教程和官方中文页的关系

Google 已经提供 Gemini CLI 官方中文页面：

这些页面适合确认官方术语和产品事实，但它们不是按中文新手学习路径写的完整教程。本教程会做三件事：

用官方中文页校准术语。
用 google-gemini/gemini-cli 官方仓库文档补全细节。
按中文开发者的真实使用顺序重写成“能学、能查、能上手”的结构。

怎么选择阅读路径

你的状态	先读什么	目标
还没安装	官方教程中文版	查安装方式、认证方式和第一次启动
能启动，但不知道怎么安全用	从原理到实战	理解它如何读项目、选工具和执行任务
想接 MCP、Skills、Hooks	工具与 MCP	查官方配置与能力边界
想比较 Codex / Claude Code / OpenCode	工具对比篇	判断什么时候优先选 Gemini CLI
准备团队使用	安全与企业	查 sandbox、policy、企业控制、遥测和隐私边界

不要只看免费额度和大上下文。Gemini CLI 真正值得学的地方，是 Google 把终端、本地工具、MCP、Code Assist、GitHub Action 和 Cloud 生态串成了一条 agent 工作流。当前上下文窗口与免费配额请以官方 Quota and pricing 为准。