谷歌的 Gemini 模型 最近热度很高，而它的 Gemini CLI 则是一个非常实用的小工具，让你可以直接在命令行里调用大模型，就像用 grep、cat 一样顺手。

这一篇博客，我们就来聊聊 Gemini CLI：它是什么、怎么安装、能做什么，以及几个简单示例。

为什么要用 Gemini CLI？

如果你是开发者，日常大量时间都在命令行里切来切去：

• 想写个脚本？→ 打开浏览器找 AI → 再 copy 回来
• 想翻译一段日志？→ 还得切窗口

有了 Gemini CLI，这些都可以在 命令行里一次完成：

• 输入一句命令 → 输出一段解释 / 代码 / 翻译
• 无需切窗口、无需复杂 API

它就是给开发者的 轻量 AI 助手。

安装 Gemini CLI

1. 环境准备

• Node.js v20+
• npm 或 Homebrew

检查 Node.js：

node -v

2. 安装方式（三选一）

# 方式一：全局安装（推荐）
npm install -g @google/gemini-cli

# 方式二：直接运行（免安装）
npx https://github.com/google-gemini/gemini-cli

# 方式三：macOS/Linux 用 Homebrew
brew install gemini-cli

安装成功后，你会得到 gemini 命令。

登录和认证

Gemini CLI 支持三种认证方式：

1. Google 账号登录（最省事）

gemini

会弹出浏览器 → 登录 → CLI 自动完成配置。

2. 使用 AI Studio 的 API Key

export GEMINI_API_KEY="your_api_key_here"
gemini

3. 企业环境（Vertex AI）

export GOOGLE_API_KEY="your_vertex_api_key"
export GOOGLE_GENAI_USE_VERTEXAI=true
gemini

免费额度：约 60 req/min、1000 req/天，支持 Gemini 2.5 Pro 和 百万 token 上下文。

基本用法示例

1. 交互式模式

gemini

进入后直接对话，就像一个命令行版的 Gemini Chat。

2. 一次性问答

gemini -p "写一个 hello world 的 Python 程序"

输出示例：

print("Hello, world!")

3. 指定模型

gemini -m gemini-2.5-flash -p "解释一下这段代码的作用"

4. 文件处理

gemini --file README.md -p "请用要点总结这份文档"

5. 管道操作

cat error.log | gemini -p "总结报错原因"

常见问题

• 问题 1：命令找不到 gemini
  → 说明全局没安装成功，尝试用：
• npm install -g @google/gemini-cli
• 或 macOS/Linux：
• brew install gemini-cli
• 问题 2：npx 运行没创建可执行文件
  → 改用全局安装或 Homebrew 安装。
• 问题 3：认证失败
  → 检查环境变量 GEMINI_API_KEY 是否正确，或者重新 gemini login。

小练习

• 用 Gemini CLI 总结你本地项目的 README.md。
• 让它帮你生成一条 Git 提交信息：
• git diff | gemini -p "帮我写一个简洁的 commit message"

总结

这一篇我们快速了解了：

• 如何正确安装 Gemini CLI（npm/Homebrew/npx）
• 登录和认证方式（Google 账号、API Key、Vertex AI）
• 常见用法与报错解决

下一篇，我们会聊聊 如何用 Gemini CLI 提升开发效率 —— 比如自动生成 commit message、快速写测试用例、翻译日志等等。