Gemini CLI 简介

谷歌正式推出了 Gemini CLI，将 Gemini 大模型的强大能力直接融入到开发者日常离不开的命令行界面之中。不仅如此，它还拥有业界最大的免费使用配额！登录个人谷歌账号，即可享受每分钟 60 次、每天 1000 次的模型请求机会，还能解锁 100 万 token 的超大上下文窗口。如此慷慨的配置，极大降低了开发门槛，让更多人能尽情探索 AI 辅助开发的无限可能。

Gemini CLI 到底还藏着哪些超乎想象的 “大招”？它又将如何重塑我们的开发工作流？别急，接下来就为你一一揭晓。

Gemini CLI 主要特性

• 免费使用个人 Google 账号（每分钟最多 60 次请求，每天最多 1,000 次请求）
• 支持多种认证方式
• 可自定义颜色主题
• 支持高级 API 密钥配置

系统要求

操作系统

• Windows 10 或更高版本
• macOS 10.15 或更高版本
• Linux（支持主流发行版）

软件要求

• Node.js 18.0.0 或更高版本
• npm（通常随 Node.js 一起安装）
• 稳定的网络连接

前置准备

1. 检查 Node.js 版本

首先，打开终端（Windows 用户请使用 PowerShell 或 Command Prompt）并运行以下命令检查是否已安装 Node.js：

node --version

如果显示的版本号低于 18.0.0 或显示 "command not found"，您需要安装或更新 Node.js。

2. 安装 Node.js（如果需要）

Windows 用户：

1. 访问 Node.js 官网
2. 下载 LTS 版本（推荐）
3. 运行安装程序，按照提示完成安装
4. 重启终端并再次运行 node --version 确认安装成功

macOS 用户：

使用 Homebrew 安装（推荐）：

# 如果没有 Homebrew，先安装 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Node.js
brew install node

或者从 Node.js 官网下载安装包。

Linux 用户：

使用包管理器安装：

• Ubuntu/Debian：

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

• CentOS/RHEL/Fedora：

curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo yum install nodejs

3. 验证 npm 安装

npm 通常会随 Node.js 一起安装。运行以下命令确认：

npm --version

安装步骤

方法一：直接运行（推荐初次使用）

这种方法无需全局安装，适合快速尝试：

npx https://github.com/google-gemini/gemini-cli

注意事项：

• 首次运行时会自动下载必要的文件
• 可能需要等待几秒钟
• 确保网络连接稳定

方法二：全局安装（推荐频繁使用）

如果您计划经常使用 Gemini CLI，建议全局安装：

npm install -g @google/gemini-cli

安装过程说明：

• -g 参数表示全局安装
• 安装完成后，您可以在任何目录下使用 gemini 命令
• 可能需要管理员权限（Windows 用户可能需要以管理员身份运行终端）

解决权限问题

如果遇到权限错误，尝试以下方法：

• macOS/Linux：sudo npm install -g @google/gemini-cli
• Windows：以管理员身份运行 PowerShell，然后执行安装命令。

配置与认证

1. 首次运行

安装完成后，运行 Gemini CLI：

# 如果使用 npx
npx https://github.com/google-gemini/gemini-cli

# 如果已全局安装
gemini

2. 选择颜色主题

首次运行时，系统会提示您选择颜色主题。使用方向键选择您喜欢的主题，然后按 Enter 确认。

3. Google 账号认证步骤说明：

1. CLI 会显示一个 URL 或自动打开浏览器
2. 在浏览器中登录您的个人 Google 账号
3. 授权 Gemini CLI 访问必要的权限
4. 复制显示的授权码
5. 返回终端，粘贴授权码并按 Enter

重要提示：

• 使用个人 Google 账号可获得每分钟 60 次请求和每天 1,000 次请求的配额
• 认证信息会安全地存储在本地
• 如需切换账号，可以重新运行认证流程

高级配置

使用 API 密钥（可选）

如果您需要更高的请求限制或使用特定模型，可以配置 API 密钥：

1. 获取 API 密钥

1. 访问 Google AI Studio
2. 登录您的 Google 账号
3. 点击 "Create API Key" 或 "创建 API 密钥"
4. 复制生成的密钥（请妥善保管，不要分享给他人）

2. 设置环境变量

• Windows (PowerShell)：

$env:GEMINI_API_KEY="YOUR_API_KEY"

• Windows (Command Prompt)：

set GEMINI_API_KEY=YOUR_API_KEY

• macOS/Linux：

export GEMINI_API_KEY="YOUR_API_KEY"

3. 永久设置环境变量

为了避免每次都需要设置，可以将环境变量永久添加：

• macOS/Linux：编辑 ~/.bashrc、~/.zshrc 或 ~/.profile 文件：

echo 'export GEMINI_API_KEY="YOUR_API_KEY"' >> ~/.bashrc
source ~/.bashrc

• Windows：
  1. 搜索 "环境变量" 打开系统设置
  2. 点击 "新建" 添加用户变量
  3. 变量名：GEMINI_API_KEY
  4. 变量值：您的 API 密钥
  5. 确定保存并重启终端

其他认证方式

对于 Google Workspace 账号或其他高级认证需求，请参考官方认证指南。

常见问题解决

1. "command not found" 错误

   • 问题原因：Node.js 或 npm 未正确安装或未添加到系统 PATH。
   • 解决方案：
     • 重新安装 Node.js
     • 重启终端
     • 检查系统 PATH 设置

2. 网络连接错误

   • 问题原因：防火墙或代理设置阻止了连接。
   • 解决方案：
     • 检查网络连接
     • 配置代理（如果使用）：

     npm config set proxy http://proxy.example.com:8080
     npm config set https-proxy http://proxy.example.com:8080
     

3. 权限错误

   • 问题原因：没有足够的权限进行全局安装。
   • 解决方案：
     • 使用管理员权限运行
     • 或者使用 npx 方式运行，无需全局安装

4. API 配额超限

   • 问题原因：超过了免费配额限制。
   • 解决方案：
     • 等待配额重置（每天重置）
     • 使用 API 密钥获得更高配额
     • 优化请求频率

验证安装

基本功能测试

运行以下命令测试 Gemini CLI 是否正常工作：

# 如果全局安装
gemini "Hello, can you introduce yourself?"

# 如果使用 npx
npx https://github.com/google-gemini/gemini-cli "Hello, can you introduce yourself?"

检查版本信息

gemini --version

查看帮助信息

gemini --help

下一步

恭喜！您已成功安装并配置了 Gemini CLI。现在您可以：

1. 探索基本功能：尝试不同的提示词和命令
2. 查看文档：了解更多高级功能和选项
3. 集成到工作流：将 Gemini CLI 集成到您的开发或创作流程中
4. 自定义配置：根据需求调整设置和参数