🚀 解锁生产力：Google Gemini CLI 终端版安装与使用全攻略

为什么要用命令行版 Gemini？

在这个 AI 爆发的时代，我们习惯了在浏览器中打开网页与 ChatGPT 或 Gemini 对话。但对于开发者和极客来说，命令行界面 (CLI) 才是效率的终极归宿。

想象一下：

  • 无需离开终端窗口即可查询代码片段。
  • 通过管道 (Pipe) 将错误日志直接喂给 AI 分析。
  • 自动化脚本集成 AI 能力。

今天，这篇教程将手把手教你如何在终端中安装和配置 Google Gemini CLI，让你的终端变身 AI 智能助手。

🛠️ 准备工作

在开始之前，我们需要准备好以下两样东西：

  1. Google Gemini API Key：这是调用 AI 的钥匙。
  2. Node.js 环境：大多数 CLI 工具基于 Node.js 构建。

第一步：获取 API Key

Google 目前对开发者非常慷慨，提供了免费的 API 调用额度。

  1. 访问 Google AI Studio。
  2. 登录你的 Google 账号。
  3. 点击左侧的 “Get API key”。
  4. 点击 “Create API key” 按钮。
  5. 复制并保存好这个 Key（注意：不要泄露给他人）。

第二步：检查/安装 Node.js

打开你的终端（Terminal 或 CMD），输入以下命令检查是否已安装：

node -v
npm -v

如果显示版本号（例如 v18.x.x），则说明已安装。如果没有，请前往 Node.js 官网 下载并安装 LTS 版本。

📥 安装 Gemini CLI 工具

虽然市面上有多种封装，但我们将使用最流行、轻量级的开源封装工具（以 gemini-chat-cli 为例，这是目前社区维护较好的版本之一）。

在终端中执行以下命令进行全局安装：

npm install -g gemini-chat-cli   或者
npm install -g @google/gemini-cli@latest    //可使用Gemini 3 pro

注：Mac/Linux 用户如果遇到权限问题，可能需要在命令前加 sudo。

⚙️ 配置环境

安装完成后，我们需要将刚才申请的 API Key 告诉这个工具。

方法一：直接配置（推荐）

运行初始化配置命令：

gemini-chat configure

系统会提示你输入 API Key，将你在第一步获取的 Key 粘贴进去并回车即可。

方法二：环境变量（适合高阶用户）

你也可以将 Key 写入环境变量，这样更安全：

Windows (PowerShell):

$env:GEMINI_API_KEY="你的_API_KEY_粘贴在这里"

Mac/Linux:

export GEMINI_API_KEY="你的_API_KEY_粘贴在这里"

💻 开始使用

一切就绪！现在你可以直接在终端和 Gemini 聊天了。

1. 单次提问

如果你只需要问一个简单的问题，比如写一段代码：

gemini-chat "如何用 Python 写一个快速排序？"

AI 的回复将直接流式输出在你的终端里，酷炫且高效！

2. 进入交互模式（对话模式）

如果你需要上下文连续对话，只需输入：

gemini-chat

你会看到类似这样的界面：

🤖 Gemini CLI
Type 'exit' to quit.
>

现在你可以像在网页版一样与它畅聊了。

3. 极客玩法：管道操作 (Pipe)

这是 CLI 版最强大的功能。你可以将上一个命令的输出作为 AI 的输入。

场景：让 AI 解释报错日志

假设你的代码报错了，且日志保存在 error.log 中：

cat error.log | gemini-chat "请分析这段错误日志并给出修复建议"

场景：让 AI 为代码写注释

cat script.js | gemini-chat "为这段代码添加详细注释" > commented_script.js

❓ 常见问题 (FAQ)

Q: 使用需要付费吗？ A: 目前 Google AI Studio 的 Free Tier 允许每分钟 60 次请求（RPM），对于个人 CLI 使用通常是完全免费的。具体请以 Google 官方计费说明为准。

Q: 支持中文吗？ A: 完美支持。Gemini Pro 模型对中文的理解能力非常出色。

Q: 遇到 command not found 怎么办？ A: 请确保你的 npm 全局安装路径已添加到系统的 PATH 环境变量中。

📝 总结

通过配置 Gemini CLI，你成功将 AI 的能力引入了最贴近代码的地方——终端。这不仅看起来很酷，更重要的是它能极大地减少你在“编辑器-浏览器-终端”之间切换的上下文损耗。

快去试试吧！如果你觉得这篇文章有用，欢迎评论分享！👇

本文最后更新于 2025年