Gemini CLI 中文教程

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 为准。

官方资料

Google Developers：https://developers.google.com/gemini-code-assist/docs/gemini-cli
Google Cloud：https://docs.cloud.google.com/gemini/docs/codeassist/gemini-cli
官方仓库：https://github.com/google-gemini/gemini-cli
官方项目文档：https://geminicli.com/docs/
Google Codelab：https://codelabs.developers.google.com/gemini-cli-hands-on

使用前的安全提醒

Gemini CLI 可以读文件、写文件、执行 Shell、联网、接 MCP、进入 GitHub 自动化。进入真实项目时，先按低风险顺序推进：

第一轮任务只读：让它解释项目结构。
第一次写操作限定单文件。
大范围修改先用计划模式或先要求它列计划。
涉及密钥、账号、账单、部署、删除数据时必须人工确认。
团队环境优先查企业配置、policy engine、sandbox 和 telemetry。

延伸学习

翔宇工作流主站：xiangyugongzuoliu.com
翔宇 AI 编程实操课：查看课程介绍与学习路径