保姆级教程！谷歌Gemini CLI 详细安装全攻略

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 用户：#

访问 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：
1. 搜索 "环境变量" 打开系统设置
2. 点击 "新建" 添加用户变量
3. 变量名：GEMINI_API_KEY
4. 变量值：您的 API 密钥
5. 确定保存并重启终端

其他认证方式#

对于 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

下一步#

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

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