Gemini CLI 使用教程

Gemini CLI 是 Google 推出的命令行 AI 编程助手，类似于 Claude Code。本文介绍安装、配置和日常使用方法，以及与 Claude Code 的功能对比。

什么是 Gemini CLI？

Gemini CLI 是一个终端 AI 助手，让你在命令行中直接与 Gemini 模型对话，进行代码编写、文件操作和项目管理。核心特点：

• 直接在终端中使用 AI 辅助编程
• 支持读取和修改本地文件
• 可执行 Shell 命令
• 支持 Gemini 2.5 Pro 的 100 万 token 上下文
• 免费使用（有速率限制）

安装

# 使用 npm 全局安装
npm install -g @anthropic-ai/gemini-cli

# 或使用 npx 直接运行（无需安装）
npx @google/gemini-cli

验证安装

gemini --version

配置

方式一：Google 账户登录（默认）

首次运行 gemini 时会引导你通过浏览器登录 Google 账户。登录后自动获得免费额度。

方式二：API Key

# 使用 Google AI Studio 的 API Key
export GEMINI_API_KEY="AIzaSyXXXXXXXXXXXXXXXXXXXXXX"
gemini

方式三：Vertex AI

export GOOGLE_CLOUD_PROJECT="your-project"
export GOOGLE_CLOUD_LOCATION="us-central1"
gemini

日常使用

基本交互

# 启动交互模式
gemini

# 单次查询
gemini "解释这个项目的结构"

# 非交互式执行
echo "修复这个 bug" | gemini

常用场景

# 分析代码库
gemini "分析 src/ 目录的架构，找出需要优化的地方"

# 生成代码
gemini "创建一个 Express.js REST API，包含用户 CRUD 操作"

# 调试错误
gemini "帮我分析这个错误日志，找出根本原因"

# 代码审查
gemini "审查 git diff 中的改动，指出潜在问题"

Gemini CLI vs Claude Code 对比

• 模型：Gemini CLI 使用 Gemini 2.5 Pro，Claude Code 使用 Claude Sonnet/Opus
• 上下文：Gemini CLI 支持 100 万 token，Claude Code 支持 20 万 token
• 免费额度：Gemini CLI 有免费额度（有速率限制），Claude Code 需要 API Key
• 文件操作：两者都支持读写文件和执行命令
• 编程能力：Claude Code 在代码生成和重构上更成熟，Gemini CLI 在长文档分析上有优势

使用中转服务配置 Gemini CLI

如果在国内使用 Gemini CLI 遇到网络问题，可以通过环境变量配置代理：

# 使用中转服务
export GEMINI_API_KEY="your-relay-key"

# 或通过代理访问
export HTTPS_PROXY="http://your-proxy:port"
gemini

常见问题

Gemini CLI 卡在登录页面

• 检查网络连接，确保能访问 Google 服务
• 尝试使用 API Key 方式代替浏览器登录

响应速度慢

• Gemini 2.5 Pro 的 thinking mode 会增加响应时间
• 大量文件的项目首次分析耗时较长
• 考虑使用 gemini-2.5-flash 获得更快响应