Gemini CLI 全平台终端极速安装与配置实战 (macOS / Linux / Windows)

#!/usr/bin/env bash
set -e

echo "==> 正在检测操作系统与架构环境..."
OS="$(uname -s)"
ARCH="$(uname -m)"

case "$OS" in
  Darwin)
    echo "==> 检测到 macOS，优先使用 Homebrew 安装..."
    if command -v brew >/dev/null 2>&1; then
      brew install gemini-cli
    else
      npm install -g @google/gemini-cli
    fi
    ;;
  Linux)
    echo "==> 检测到 Linux，正在使用 npm 全局安装..."
    npm install -g @google/gemini-cli
    ;;
  *)
    echo "==> 未知系统，请参考文档通过 Node.js npm 安装: npm install -g @google/gemini-cli"
    exit 1
    ;;
esac

echo "==> 安装完成！运行 'gemini --version' 验证安装结果。"

为什么需要在终端中使用 Gemini CLI？

通过命令行终端（Terminal）直接与 Gemini 3 进行交互，是现代 AI 工程师提升生产力的利器。借助 CLI，你可以：

1. 管道数据流式处理：通过 cat error.log | gemini "解析堆栈报错根因" 实现秒级诊断；
2. 免切屏代码生成：直接在终端生成复杂脚本或正则，并通过标准输出重定向写入目标文件；
3. 结合自动化 CI/CD：在持续集成构建过程中无缝注入多模态审查或自动化文档生成。

---

全平台安装指南

1. macOS (推荐 Homebrew 或 npm)

macOS 用户推荐使用官方 Homebrew 存储库：

# 使用 Homebrew 安装（保持自动更新）
brew install gemini-cli

# 或者使用 Node.js 全局安装
npm install -g @google/gemini-cli

2. Linux (Ubuntu / Debian / CentOS / Arch)

在 Linux 服务器或开发机上，确保已具备 Node.js 18+ 环境：

# Ubuntu / Debian 前置准备
sudo apt update && sudo apt install -y nodejs npm curl

# 全局安装 Gemini CLI
sudo npm install -g @google/gemini-cli

# 验证安装版本
gemini --version

3. Windows 11 / 10 (Winget 或 PowerShell)

对于 Windows 开发者，推荐使用 Windows Terminal 搭配 Winget：

# 使用 Windows 软件包管理器 Winget 安装
winget install Google.GeminiCLI

# 或者使用 PowerShell 运行 npm 全局安装
npm install -g @google/gemini-cli

---

环境变量与 API 密钥持久化配置

安装完成后，你必须为 CLI 配置来自 Google AI Studio 的 API 密钥。

macOS / Linux (zsh 或 bash)

编辑你的 shell 配置文件（~/.zshrc 或 ~/.bashrc）：

# 追加环境变量到 shell 配置中
echo 'export GEMINI_API_KEY="AIzaSyYourGeneratedSecretKey"' >> ~/.zshrc

# 立即刷新当前终端环境
source ~/.zshrc

Windows (PowerShell)

# 永久设置当前用户环境变量
[System.Environment]::SetEnvironmentVariable('GEMINI_API_KEY', 'AIzaSyYourGeneratedSecretKey', 'User')

---

常用单行命令测试

成功配置后，立即在终端执行以下指令感受极速体验：

# 1. 基础问答与交互
gemini "用 3 句话解释量子纠缠的核心原理"

# 2. 结合管道读取日志排查
git log -n 5 --oneline | gemini "根据这 5 次提交记录撰写一份精简的 Release Note"

# 3. 指定最新 Gemini 3 模型
gemini --model gemini-3-pro "编写一个用 Rust 实现的异步 TCP 端口扫描器"