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. 目录
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检查。
官方来源
- Gemini CLI · Google Developers
- Gemini CLI Documentation
- Gemini CLI Get Started
- Gemini CLI Quotas and Pricing