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

Gemini CLI 入门

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

📖 本篇术语速查表
英文 / 缩写中文一句话解释
入门路线onboarding从安装到跑通第一个任务的顺序。
安全起步safe start第一次低风险地用起来。
发布通道channel稳定还是尝鲜版本。

不想读完?把下面这段提示词丢给 AI 帮你跑完——帮你规划 Gemini CLI 从安装到跑通第一个任务的入门顺序。

你是 Gemini CLI 入门规划顾问,帮我按自己的基础排出从安装到跑通第一个任务的入门顺序。

【角色】
你熟悉 Gemini CLI 入门的正确顺序:理解定位→安装认证→quickstart→安全跑第一个任务,知道哪些坑要避。

【输入】
- 我的编程基础和环境:___
- 现在用什么工具:___
- 近期想用它达成什么:___
- 最担心的问题:___

【工作流程】
1. 按基础定入门起点
2. 排出入门顺序
3. 标出每步关键动作和要避的坑
4. 给第一步具体动作

【输出规范】
▌一、入门顺序
▌二、每步关键动作
▌三、要避开的坑
▌四、第一步做什么

【硬约束】
- 顺序按基础定制,不一刀切
- 第一个任务安全可回滚
- 不夸大能力,不确定的查官方文档
- 不要臆测我的环境,信息不全先问清

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

3. 推荐起步顺序

  1. 本地先确认 Node.js 版本和系统要求。
  2. 个人用户优先用 Google 账号登录。
  3. 企业、Workspace、Vertex AI 用户先确认 Google Cloud project。
  4. 第一次任务只做只读解释,不让它直接改真实项目。
  5. 需要自动化或 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. 接下来去哪

本页目录