---
title: "Gemini CLI 入门"
description: "Gemini CLI 入门目录：定位、安装、认证、Quickstart、Cloud Shell、发布通道、配额费用和术语表。"
verifiedAt: "2026-05-09"
---

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

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

## 1. 推荐路径

```mermaid
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. 目录

<Cards>
  <Card title="Gemini CLI 定位" description="先理解它和 Gemini Code Assist、Cloud Shell、VS Code agent mode、MCP 的关系。" href="/docs/gemini-cli/official/00-getting-started/00-positioning" />
  <Card title="安装 Gemini CLI" description="在 npm、npx、Homebrew、sandbox 和源码运行之间选正确路径。" href="/docs/gemini-cli/official/00-getting-started/01-installation" />
  <Card title="认证方式" description="区分 Google OAuth、API key、Vertex AI、Cloud Project 和 headless 场景。" href="/docs/gemini-cli/official/00-getting-started/02-authentication" />
  <Card title="Quickstart" description="用只读分析、限定写入和 diff 检查跑通第一条安全闭环。" href="/docs/gemini-cli/official/00-getting-started/03-quickstart" />
  <Card title="Cloud Shell 入口" description="免本机安装快速验证，但要确认 project、IAM 和资源边界。" href="/docs/gemini-cli/official/00-getting-started/04-cloud-shell" />
  <Card title="发布通道" description="判断 stable、preview、nightly 的适用场景和团队默认选择。" href="/docs/gemini-cli/official/00-getting-started/05-release-channels" />
  <Card title="配额与费用" description="理解认证方式、quota、pricing、隐私条款和成本控制的关系。" href="/docs/gemini-cli/official/00-getting-started/06-quota-and-pricing" />
  <Card title="术语表" description="快速区分 ReAct、MCP、GEMINI.md、checkpoint、headless、Vertex AI 等术语。" href="/docs/gemini-cli/official/00-getting-started/glossary" />
</Cards>

## 3. 推荐起步顺序

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

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

## 4. 进入下一组前的验收

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

## 官方来源

- [Gemini CLI · Google Developers](https://developers.google.com/gemini-code-assist/docs/gemini-cli)
- [Gemini CLI Documentation](https://google-gemini.github.io/gemini-cli/docs/)
- [Gemini CLI Get Started](https://google-gemini.github.io/gemini-cli/docs/get-started/)
- [Gemini CLI Quotas and Pricing](https://google-gemini.github.io/gemini-cli/docs/quota-and-pricing.html)

## 5. 接下来去哪

<Cards>
  <Card title="CLI 工作流" description="入门闭环跑通后，继续学习命令、快捷键、shell、history、plan 和 checkpoint。" href="/docs/gemini-cli/official/01-cli-workflow" />
  <Card title="工具与 MCP" description="准备让 Gemini CLI 读写文件、跑命令或接外部工具前，先看工具边界。" href="/docs/gemini-cli/official/03-tools-mcp" />
</Cards>
