跳转至

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 是最佳起点。


相关链接: