Gemini CLI 快速上手教程（GitHub README 中文整理）

是什么

Gemini CLI 是 Google 推出的开源 AI 智能体，把 Gemini 模型的能力直接带进你的终端。它提供了轻量级的 Gemini 访问方式，让你从输入提示词到获得模型响应之间，走一条最短路径。项目采用 Apache 2.0 开源协议，代码托管在 GitHub 上。

核心亮点包括：

• 免费额度：使用个人 Google 账号即可享受每分钟 60 次请求、每天 1000 次请求的免费额度
• Gemini 3 模型：支持强大的推理能力和 100 万 token 上下文窗口
• 内置工具：Google 搜索接地（Grounding）、文件操作、Shell 命令执行、网页抓取
• 可扩展：支持 MCP（Model Context Protocol）协议，方便接入自定义集成
• 终端优先：为命令行开发者而生

能干什么

Gemini CLI 的能力覆盖多个场景：

代码理解与生成

• 查询和编辑大型代码库
• 利用多模态能力，从 PDF、图片或草图生成新应用
• 用自然语言调试问题、排查故障

自动化与集成

• 自动化运维任务，比如查询 Pull Request 或处理复杂的 rebase 操作
• 通过 MCP 服务器接入新能力，包括用 Imagen、Veo 或 Lyria 做媒体生成
• 在脚本中以非交互模式运行，实现工作流自动化

高级能力

• 内置 Google Search 接地，获取实时信息
• 对话检查点（Checkpointing）功能，可保存和恢复复杂会话
• 支持自定义上下文文件（GEMINI.md），针对不同项目定制行为

GitHub 集成
借助官方提供的 Gemini CLI GitHub Action，可以直接把 Gemini CLI 接入 GitHub 工作流：

• Pull Request 自动审查，提供上下文相关的反馈和建议
• Issue 自动分类和优先级排序
• 在 Issue 或 PR 中提及 @gemini-cli 即可获得调试、解释或任务委派帮助

怎么装

快速安装

方式一：npx 直接运行（无需安装）

npx @google/gemini-cli

方式二：npm 全局安装

npm install -g @google/gemini-cli

方式三：Homebrew（macOS/Linux）

brew install gemini-cli

方式四：MacPorts（macOS）

sudo port install gemini-cli

方式五：Anaconda（受限环境）

# 创建并激活新环境
conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env

# 在环境内全局安装
npm install -g @google/gemini-cli

发布渠道

项目提供三个更新渠道，按需选择：

• Preview（预览版）：每周二 UTC 23:59 发布，未经完整验证，可能有回归问题，适合测试

  npm install -g @google/gemini-cli@preview
  

• Stable（稳定版）：每周二 UTC 20:00 发布，是上周预览版的完整升级加上 bug 修复

  npm install -g @google/gemini-cli@latest
  

• Nightly（每日版）：每天 UTC 00:00 发布，包含 main 分支的最新改动，可能有未验证的问题

  npm install -g @google/gemini-cli@nightly
  

怎么用第一个例子

安装完成后，直接在终端里启动：

gemini

首次启动时，终端会引导你完成 Google 账号的登录认证。认证通过后，你就可以直接输入自然语言指令了。

试试这些示例：

# 让 Gemini 解释当前目录下的代码
gemini "解释一下当前目录下的项目结构"

# 让 Gemini 帮你调试
gemini "帮我看看这个报错是什么原因"

# 让 Gemini 生成代码
gemini "写一个 Python 脚本，读取 CSV 文件并生成统计报告"

如果你想在脚本中非交互式运行，可以使用 -p 参数：

gemini -p "列出当前目录下所有文件"

社区资源

• 官方文档：https://geminicli.com/docs/ 包含完整的安装指南、使用教程和 API 参考
• GitHub 仓库：https://github.com/google-gemini/gemini-cli 可以查看源码、提交 Issue 或参与贡献
• GitHub Action：https://github.com/google-github-actions/run-gemini-cli 用于 CI/CD 集成
• 更新日志：https://www.geminicli.com/docs/changelogs 查看各版本发布说明

翻译整理自 GitHub README，原文：https://github.com/google-gemini/gemini-cli