Google Gemini CLI：把 AI 装进你的终端

如果你每天都在终端里工作，那么 Google 最新开源的 Gemini CLI 绝对值得你关注。这款工具将 Gemini AI 直接集成到命令行中，让你无需离开终端就能完成代码编写、调试、文档查询等各种任务。

什么是 Gemini CLI？

Gemini CLI 是 Google 官方开源的命令行 AI 助手，它让开发者可以直接在终端中与 Gemini 模型交互。相比传统的网页版 AI 助手，Gemini CLI 提供了更加流畅的开发体验：

• 终端优先设计：专为命令行工作者打造，无需切换窗口
• 免费使用：个人 Google 账号即可享受每天 1000 次请求
• 强大模型：支持 Gemini 3 系列模型，1M token 上下文窗口
• 内置工具：Google Search 实时搜索、文件操作、Shell 命令执行
• 开源免费：Apache 2.0 许可证，完全开源

快速安装

方式一：使用 npx（无需安装）

npx @google/gemini-cli

这是最快的体验方式，无需全局安装即可立即使用。

方式二：全局安装（推荐）

npm install -g @google/gemini-cli

方式三：使用 Homebrew（macOS）

brew install gemini-cli

方式四：使用 Conda 环境

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

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

认证配置

Gemini CLI 提供三种认证方式，你可以根据需求选择：

方式一：Google 账号登录（推荐个人开发者）

gemini

首次运行会提示你登录 Google 账号。

优势： - 免费额度：60 次/分钟，1000 次/天 - 自动获取最新模型 - 无需管理 API Key

方式二：API Key（需要特定模型控制）

# 从 https://aistudio.google.com/apikey 获取密钥
export GEMINI_API_KEY="YOUR_API_KEY"
gemini

优势： - 可选择特定 Gemini 模型 - 按使用量计费，可升级更高额度

方式三：Google Cloud 项目（企业用户）

export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"
export GOOGLE_API_KEY="YOUR_CLOUD_API_KEY"
gemini

核心功能

1. 代码查询与编辑

Gemini CLI 可以理解整个代码库的上下文，帮助你：

# 询问代码库结构
gemini> 解释这个项目的架构

# 查找特定功能
gemini> 找到所有处理用户认证的文件

# 生成代码
gemini> 创建一个 Python 函数来解析 JSON 配置文件

2. 调试与问题排查

遇到 bug 时，可以直接让 Gemini 帮你分析：

# 粘贴错误信息
gemini> 这个错误是什么意思？
TypeError: Cannot read property 'map' of undefined

# 请求修复建议
gemini> 帮我修复这个异步函数的问题

3. 自动化任务

Gemini CLI 可以执行各种自动化操作：

# 查询 Git 状态
gemini> 查看当前分支的未提交更改

# 处理复杂 Git 操作
gemini> 帮我 rebase 到 main 分支并解决冲突

# 批量文件操作
gemini> 将所有 .jpg 文件转换为 .webp 格式

4. 实时搜索（Google Search Grounding）

Gemini CLI 内置 Google Search，可以获取最新信息：

# 查询最新技术动态
gemini> 2026 年最新的 Node.js 版本有什么新特性？

# 查找文档
gemini> 查找 React Server Components 的官方文档

5. 多模态支持

Gemini CLI 支持从图片、PDF 生成代码：

# 从设计图生成代码
gemini> 根据这个 UI 截图生成 HTML/CSS 代码

# 从 PDF 文档提取信息
gemini> 分析这个技术文档并总结要点

高级用法

会话检查点

Gemini CLI 支持保存和恢复复杂会话：

# 保存当前会话
gemini> /save my-debug-session

# 恢复会话
gemini> /load my-debug-session

自定义上下文文件

在项目根目录创建 GEMINI.md 文件，定制 AI 行为：

# GEMINI.md

## 项目规范
- 使用 TypeScript
- 遵循 ESLint Airbnb 配置
- 测试框架：Jest

## 常用命令
- 构建：npm run build
- 测试：npm test
- 部署：npm run deploy

MCP 扩展支持

通过 Model Context Protocol (MCP) 连接自定义服务：

# 连接媒体生成服务
gemini> 使用 Imagen 生成一张科技风格插图

版本更新

Gemini CLI 采用快速迭代策略：

版本类型	发布时间	说明
Preview	每周二 UTC 23:59	预览版，可能包含未验证功能
Latest	每周二 UTC 20:00	稳定版，推荐使用
Nightly	每天 UTC 00:00	每日构建，包含最新改动

安装特定版本：

# 预览版
npm install -g @google/gemini-cli@preview

# 稳定版
npm install -g @google/gemini-cli@latest

# 每日构建
npm install -g @google/gemini-cli@nightly

GitHub 集成

Gemini CLI 还提供 GitHub Action，可以集成到 CI/CD 流程中：

# .github/workflows/gemini-review.yml
name: Gemini Code Review
on: [pull_request]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: google-github-actions/run-gemini-cli@v1
        with:
          api-key: ${{ secrets.GEMINI_API_KEY }}

支持的功能包括： - 自动代码审查 - Issue 自动分类和标签 - 在 PR 中提及 @gemini-cli 获取帮助

与其他工具对比

特性	Gemini CLI	GitHub Copilot CLI	Claude Code
免费额度	1000 次/天	需订阅	有限免费
上下文窗口	1M tokens	较小	200K tokens
实时搜索	✅ 内置	❌	⚠️ 需配置
开源	✅ Apache 2.0	❌	❌
多模态	✅	❌	✅

总结

Gemini CLI 是 2026 年最值得关注的开发者工具之一。它将强大的 AI 能力无缝集成到终端工作流中，无论是日常编码、问题调试还是自动化任务，都能显著提升效率。

推荐理由： - 🎯 完全免费，额度充足 - 🚀 终端原生体验，无需切换上下文 - 🔧 功能全面，从代码到搜索一站式解决 - 📦 开源透明，社区驱动发展

如果你还没有在终端中使用 AI 助手，Gemini CLI 是最佳起点。

---

相关链接：

• GitHub 仓库
• 官方文档
• Google 官方博客
• Gemini API Key 获取
• GitHub Action