官方教程中文版入门

Gemini CLI 入门

Gemini CLI 入门目录：定位、安装、认证、Quickstart、Cloud Shell、发布通道、配额费用和术语表。

Gemini CLI 入门不是安装一个 npm 包就结束。第一天要完成四件事：理解它在 Google 生态里的位置，选对安装方式，选对认证路径，用一个低风险项目跑通只读分析和限定写入。

推荐顺序：定位 → 安装 → 认证 → Quickstart。Cloud Shell、发布通道、配额费用和术语表按需查，不要在没跑通第一条任务前先纠结所有高级配置。

1. 推荐路径

flowchart LR
    Position["定位"] --> Install["安装"]
    Install --> Auth["认证"]
    Auth --> Quick["Quickstart"]
    Quick --> Workflow["CLI 工作流"]
    Auth --> Quota["配额与费用"]
    Install --> Cloud["Cloud Shell"]

    style Quick fill:#dcfce7,stroke:#22c55e
    style Quota fill:#fef3c7,stroke:#f59e0b

第一天只追求一个可复现状态：gemini 能启动，认证方式清楚，第一轮只读分析没有越界，第二轮限定写入可用 git diff 审查。

2. 目录

Gemini CLI 定位

先理解它和 Gemini Code Assist、Cloud Shell、VS Code agent mode、MCP 的关系。

安装 Gemini CLI

在 npm、npx、Homebrew、sandbox 和源码运行之间选正确路径。

认证方式

区分 Google OAuth、API key、Vertex AI、Cloud Project 和 headless 场景。

Quickstart

用只读分析、限定写入和 diff 检查跑通第一条安全闭环。

Cloud Shell 入口

免本机安装快速验证，但要确认 project、IAM 和资源边界。

发布通道

判断 stable、preview、nightly 的适用场景和团队默认选择。

配额与费用

理解认证方式、quota、pricing、隐私条款和成本控制的关系。

术语表

快速区分 ReAct、MCP、GEMINI.md、checkpoint、headless、Vertex AI 等术语。

3. 推荐起步顺序

本地先确认 Node.js 版本和系统要求。
个人用户优先用 Google 账号登录。
企业、Workspace、Vertex AI 用户先确认 Google Cloud project。
第一次任务只做只读解释，不让它直接改真实项目。
需要自动化或 CI 时，再考虑 API key、Vertex AI、headless mode。

不要把入门顺序倒过来：MCP、extensions、subagents、policy、headless 和 GitHub Action 都应该在第一条安全闭环之后学。基础认证和权限没搞清，工具越多越容易出问题。

4. 进入下一组前的验收

gemini --version 能运行。
你知道当前使用的是 Google OAuth、API key 还是 Vertex AI。
你知道当前 quota 和隐私条款要去哪一个官方页面核验。
你完成过一次“只读分析项目”的提示词。
你完成过一次“只改单文件”的低风险任务，并用 git diff 检查。

官方来源

5. 接下来去哪

CLI 工作流

入门闭环跑通后，继续学习命令、快捷键、shell、history、plan 和 checkpoint。

工具与 MCP

准备让 Gemini CLI 读写文件、跑命令或接外部工具前，先看工具边界。

Gemini CLI 官方教程中文版

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

Gemini CLI 定位

解释 Gemini CLI 是什么、它和 Gemini Code Assist / Google Cloud / IDE agent mode 的关系，以及为什么它不只是命令行聊天框。

本页目录

1. 推荐路径 2. 目录 3. 推荐起步顺序 4. 进入下一组前的验收官方来源 5. 接下来去哪