谷歌正式重磅推出了 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。
Windows 用户：
- 访问 Node.js 官网
- 下载 LTS 版本（推荐）
- 运行安装程序，按照提示完成安装
- 重启终端并再次运行 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 账号认证步骤说明：
- CLI 会显示一个 URL 或自动打开浏览器
- 在浏览器中登录您的个人 Google 账号
- 授权 Gemini CLI 访问必要的权限
- 复制显示的授权码
- 返回终端，粘贴授权码并按 Enter
重要提示：
- 使用个人 Google 账号可获得每分钟 60 次请求和每天 1,000 次请求的配额
- 认证信息会安全地存储在本地
- 如需切换账号，可以重新运行认证流程
使用 API 密钥（可选）
如果您需要更高的请求限制或使用特定模型，可以配置 API 密钥：
1. 获取 API 密钥#
- 访问 Google AI Studio
- 登录您的 Google 账号
- 点击 "Create API Key" 或 "创建 API 密钥"
- 复制生成的密钥（请妥善保管，不要分享给他人）
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：搜索 "环境变量" 打开系统设置点击 "新建" 添加用户变量变量名：GEMINI_API_KEY变量值：您的 API 密钥确定保存并重启终端
其他认证方式
对于 Google Workspace 账号或其他高级认证需求，请参考官方认证指南。
常见问题解决
- "command not found" 错误
- 问题原因：Node.js 或 npm 未正确安装或未添加到系统 PATH。
- 解决方案：重新安装 Node.js重启终端检查系统 PATH 设置
- 网络连接错误
- 问题原因：防火墙或代理设置阻止了连接。
- 解决方案：检查网络连接配置代理（如果使用）：
- npm config set proxy http://proxy.example.com:8080 npm config set https-proxy http://proxy.example.com:8080
- 权限错误
- 问题原因：没有足够的权限进行全局安装。
- 解决方案：使用管理员权限运行或者使用 npx 方式运行，无需全局安装
- 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