Google Gemini CLI 完全指南：终端中的 AI 编程神器

前言

Google 推出的 Gemini CLI 是一款开源的命令行 AI 代理工具，它将强大的 Gemini 2.5 Pro 模型直接带入你的终端。最令人兴奋的是，它提供了慷慨的免费额度：每分钟 60 次请求、每天 1000 次请求！本文将带你全面掌握 Gemini CLI 的安装和使用。

---

一、什么是 Gemini CLI？

Gemini CLI 是 Google 开发的开源（Apache 2.0 许可）命令行 AI 代理，让开发者可以在终端中直接与 Gemini 模型交互。

核心优势

特性	说明
🎯 免费额度	60 次/分钟，1000 次/天
🧠 强大模型	Gemini 2.5 Pro，100 万 Token 上下文
🔧 内置工具	Google 搜索、文件操作、Shell 命令
🔌 可扩展	支持 MCP 协议自定义集成
💻 终端优先	为命令行开发者设计
🛡️ 开源免费	Apache 2.0 许可

---

二、核心功能

代码理解与生成

• 🔍 查询和编辑大型代码库（支持 100 万+ Token）
• 📄 从 PDF、图片、草图生成应用程序（多模态能力）
• 🐛 使用自然语言调试和排错

自动化与集成

• ⚙️ 自动化操作任务（Git 操作、PR 查询等）
• 🔗 通过 MCP 服务器连接外部工具（Imagen、Veo 等）
• 📜 支持非交互式脚本运行

高级功能

• 🌐 内置 Google 搜索实时获取信息
• 💾 对话检查点，保存和恢复复杂会话
• 📋 自定义上下文文件（GEMINI.md）

---

三、安装要求

系统要求

• 操作系统：macOS、Linux 或 Windows
• Node.js：v20 或更高版本

检查 Node.js 版本

node --version
# 输出应 >= v20.0.0

如果版本过低，请先升级：

# 使用 nvm 升级（推荐）
nvm install 20
nvm use 20

---

四、安装方法

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

npx @google/gemini-cli

方式二：npm 全局安装（推荐长期使用）

npm install -g @google/gemini-cli

方式三：Homebrew 安装（macOS/Linux）

brew install gemini-cli

选择版本

# 稳定版（推荐）
npm install -g @google/gemini-cli@latest

# 预览版（每周二发布）
npm install -g @google/gemini-cli@preview

# 每日构建版（最新功能）
npm install -g @google/gemini-cli@nightly

验证安装

gemini --version

---

五、认证配置

Gemini CLI 提供三种认证方式：

方式一：Google 账号登录（推荐）

最简单的方式，享受免费额度：

gemini
# 选择 "Login with Google"，按提示在浏览器中完成认证

免费额度：

• ✅ 60 次请求/分钟
• ✅ 1000 次请求/天
• ✅ Gemini 2.5 Pro 模型
• ✅ 100 万 Token 上下文窗口

方式二：Gemini API Key

# 1. 访问 https://aistudio.google.com/apikey 获取 API Key
# 2. 设置环境变量
export GEMINI_API_KEY="your-api-key-here"

# 3. 启动
gemini

免费额度：每天 100 次请求（Gemini 2.5 Pro）

方式三：Vertex AI（企业用户）

export GOOGLE_API_KEY="your-api-key-here"
export GOOGLE_GENAI_USE_VERTEXAI=true
gemini

适合需要企业级安全和合规性的团队。

---

六、基本使用

启动交互模式

# 在当前目录启动
gemini

# 包含多个目录
gemini --include-directories ../lib,../docs

# 使用指定模型
gemini -m gemini-2.5-flash

非交互式模式（脚本使用）

# 获取文本响应
gemini -p "解释这个代码库的架构"

# 获取 JSON 格式输出
gemini -p "解释这个代码库的架构" --output-format json

# 流式 JSON 输出（实时事件）
gemini -p "运行测试并部署" --output-format stream-json

常用斜杠命令

命令	说明
/help	显示帮助信息
/chat	切换对话模式
/quit 或 /exit	退出 Gemini CLI
/bug	报告问题

---

七、实用示例

开始新项目

cd new-project/
gemini
> 帮我写一个 Discord 机器人，可以根据 FAQ.md 文件回答问题

分析现有代码

git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini
> 给我一个昨天所有代码更改的摘要

代码审查

gemini
> 审查最近的 PR，找出潜在的安全问题

生成文档

gemini
> 为这个项目生成 API 文档

调试帮助

gemini
> 这个函数为什么会抛出空指针异常？

---

八、配置文件

主配置文件

配置存储在 ~/.gemini/settings.json：

{
  "theme": "dark",
  "defaultModel": "gemini-2.5-pro",
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    }
  }
}

项目上下文文件（GEMINI.md）

在项目根目录创建 GEMINI.md 文件，为 Gemini 提供项目上下文：

# 项目说明

这是一个 Spring Boot 后端项目，使用 MySQL 数据库。

## 代码规范
- 使用驼峰命名法
- 所有 API 返回统一格式
- 使用 Lombok 简化代码

## 目录结构
- src/main/java - 源代码
- src/test/java - 测试代码

---

九、MCP 服务器集成

配置 MCP 服务器

在 ~/.gemini/settings.json 中配置：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    },
    "slack": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-slack"]
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"]
    }
  }
}

使用 MCP 工具

gemini
> @github 列出我的开放 PR
> @slack 发送今天的提交摘要到 #dev 频道
> @database 查询不活跃用户

---

十、GitHub Actions 集成

Gemini CLI 可以集成到 GitHub 工作流中：

# .github/workflows/gemini.yml
name: Gemini Code Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: google-github-actions/run-gemini-cli@v1
        with:
          prompt: "审查这个 PR 的代码变更"

支持的功能

• 🔍 自动代码审查
• 🏷️ Issue 自动分类
• 💬 @gemini-cli 提及响应
• ⚙️ 自定义工作流

---

十一、键盘快捷键

快捷键	功能
Ctrl + C	取消当前操作
Ctrl + D	退出
Tab	自动补全
↑ / ↓	浏览历史命令

---

十二、常见问题

Q1: 首次运行提示认证失败

解决方案：确保能访问 Google 服务，选择 “Login with Google” 完成认证

Q2: Node 版本过低

解决方案：

nvm install 20
nvm use 20

Q3: 请求频率超限

解决方案：免费版限制 60 次/分钟，稍等片刻或升级到付费版

Q4: 如何更换模型

解决方案：

gemini -m gemini-2.5-flash
# 或
gemini -m gemini-2.5-pro

Q5: 如何卸载

解决方案：

npm uninstall -g @google/gemini-cli
# 删除配置文件
rm -rf ~/.gemini

---

十三、与 Codex CLI 对比

特性	Gemini CLI	Codex CLI
开发商	Google	OpenAI
免费额度	1000次/天	需订阅 ChatGPT
上下文窗口	100万 Token	-
Node.js 要求	v20+	v22+
内置搜索	Google Search	-
开源协议	Apache 2.0	Apache 2.0

---

总结

Gemini CLI 是一个强大且免费的终端 AI 助手，它的慷慨免费额度（每天 1000 次）和 100 万 Token 的超大上下文窗口使其成为开发者的得力助手。

快速开始三步走

1. 安装：npm install -g @google/gemini-cli
2. 认证：运行 gemini，选择 Google 账号登录
3. 使用：开始与 AI 对话，提升开发效率！

---

参考资源

• Gemini CLI 官方文档
• GitHub 仓库
• Google 开发者文档
• NPM 包

---

作者简介：一名正在实习的Java开发工程师，热爱技术分享，专注于性能优化和系统架构设计。

觉得有用的话可以点点赞 (/ω＼)，支持一下。

如果愿意的话关注一下。会对你有更多的帮助。

每周都会不定时更新哦 >人< 。

版权声明：本文为原创技术文章，转载请注明出处。