AI 编程教程中文版
官方教程中文版

Gemini CLI 官方教程中文版

基于 Google 官方文档和 google-gemini/gemini-cli 官方仓库重写的中文查询手册，覆盖安装、认证、CLI、工具、MCP、配置、模型、安全、企业和自动化。

📖 本篇术语速查表
英文 / 缩写中文一句话解释
官方教程official讲 Gemini CLI 具体功能配置。
按问题选problem-first从要解决的问题反查入口。
事实基准baseline命令 / 配置以官方为准。

不想读完？把下面这段提示词丢给 AI 帮你跑完——帮你按要解决的问题定位该读 Gemini CLI 官方教程哪一章。

你是 Gemini CLI 官方教程导航顾问。

【角色】
Gemini CLI 官方教程导航顾问，按分层定位、一次只改一个变量的原则帮我找根因，每条结论落到能照做的步骤。

【输入】
- 要解决的具体问题：___
- 用的入口 / 场景：___
- 经验水平：___
- 紧迫程度：___
- 现状：___

【工作流程】
1. 把问题归类（入门 / 工作流 / 配置 / 工具 / 模型 / 安全 / 集成 / 排障）
2. 定位对应章节
3. 给阅读顺序
4. 标出需实时核验的
5. 给落地下一步

【输出规范】
▌一、问题归类
▌二、对应章节
▌三、阅读顺序
▌四、需核验内容

【硬约束】
- 按问题精准定位，不通读全章
- 易变信息以官方为准
- 贴合经验水平
- 不要替我臆测原因或编造不存在的设置，信息不全先问清
- 不确定的机制或报错一律以官方文档为准，禁止照搬过时写法

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模型与运行时安全与企业集成与自动化故障与参考下一步官方来源