安装和配置Gemini CLI

---

系统要求

在开始安装之前，请确保您的系统满足以下要求：

基础环境：

• Node.js 版本 20 或更高版本
• 稳定的网络连接
• Google 账户（用于身份验证）

操作系统支持：

• Windows 10/11
• macOS 10.15+
• Linux (Ubuntu 18.04+, CentOS 7+)

快速开始

Gemini CLI 提供了两种主要的安装和使用方式：

方法一：直接运行（推荐新手）

无需安装，直接运行：

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

方法二：全局安装

如果您希望在任何地方都能使用 gemini 命令：

npm install -g @google/gemini-cli

安装完成后，您可以在任何地方运行：

gemini

初始配置

1. 选择颜色主题

首次运行 Gemini CLI 时，系统会提示您选择一个颜色主题，根据个人喜好选择即可。

2. 身份验证

Gemini CLI 提供多种身份验证方式：

方式一：Google 账户登录（推荐新手）

当您首次运行 gemini 命令时，系统会提示您登录 Google 账户：

• 按照提示在浏览器中完成登录
• 这将为您提供每分钟最多 60 次请求，每日最多 1000 次请求的免费额度
• 使用的是 Gemini 模型

方式二：使用 Gemini API 密钥

如果您需要更高的请求限制或想要使用特定模型：

1. 从 Google AI Studio 生成 API 密钥
2. 设置环境变量（将 YOUR_API_KEY 替换为您的实际密钥）：

Windows (PowerShell)：

$env:GEMINI_API_KEY = "YOUR_API_KEY"

Windows (命令提示符)：

set GEMINI_API_KEY=YOUR_API_KEY

macOS/Linux：

export GEMINI_API_KEY="YOUR_API_KEY"

3. （可选）在 API 密钥页面将您的 Gemini API 项目升级到付费计划，这将自动解锁 Tier 1 速率限制

方式三：使用 Vertex AI API 密钥

Vertex AI API 提供免费层级，支持 Gemini 2.5 Pro 的快速模式：

1. 从 Google Cloud 生成 API 密钥
2. 设置环境变量：

Windows (PowerShell)：

$env:GOOGLE_API_KEY = "YOUR_API_KEY"
$env:GOOGLE_GENAI_USE_VERTEXAI = "true"

macOS/Linux：

export GOOGLE_API_KEY="YOUR_API_KEY"
export GOOGLE_GENAI_USE_VERTEXAI=true

3. （可选）在您的项目中添加账单账户以获得更高的使用限制

验证安装

安装完成后，您可以通过以下方式验证 Gemini CLI 是否正确安装：

检查版本：

gemini --version

运行测试命令：

gemini

如果安装成功，您应该能看到 Gemini CLI 的交互界面。

首次使用

现在您已经准备好使用 Gemini CLI 了！以下是一些使用示例：

在新项目中使用：

cd new-project/
gemini
> 为我写一个使用 FAQ.md 文件回答问题的 Discord 机器人

在现有项目中使用：

git clone https://github.com/your-repo/project
cd project
gemini
> 给我一个昨天所有更改的总结

常见问题

Q: 提示"command not found: gemini" A: 请确保：

1. Node.js 版本 20 或更高已安装
2. 如果使用全局安装方式，请确保 npm 全局 bin 目录在您的 PATH 中
3. 重新启动终端窗口

Q: 无法连接到 API A: 请检查：

1. 网络连接是否正常
2. API 密钥是否正确设置
3. 如果在企业网络中，可能需要配置代理

Q: 请求被限制 A: 考虑：

1. 升级到付费 API 计划
2. 使用 Vertex AI API（具有不同的限制）
3. 减少请求频率

下一步

现在您已经成功安装并配置了 Gemini CLI，您可以：

• 查看基本使用教程学习基本命令
• 阅读高级功能了解更多功能
• 参考故障排除指南解决可能遇到的问题
• 查看官方文档获取完整信息

相关链接

• 官方 GitHub 仓库
• Google AI Studio

---

🎉 恭喜！ 您已经成功安装并配置了 Gemini CLI。现在可以开始体验 AI 助手的强大功能了！

which gemini # macOS/Linux

where gemini # Windows

手动添加到PATH

export PATH=$PATH:/usr/local/bin # macOS/Linux

**问题2：API密钥无效**
```bash
# 重新设置API密钥
gemini config set api-key YOUR_NEW_API_KEY

# 检查密钥格式
gemini config get api-key

问题3：网络连接问题

# 测试网络连接
ping ai.google.dev

# 检查代理设置
gemini config get proxy-url

问题4：权限问题

# Linux/macOS权限修复
sudo chmod +x /usr/local/bin/gemini

# Windows以管理员身份运行

下一步

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

1. ✅ 已安装Gemini CLI
2. ✅ 已配置API密钥
3. ✅ 已验证基本功能

接下来，我们将学习Gemini CLI的基本命令和用法，开始您的AI助手之旅！

💡 小贴士：建议在开始使用前，先熟悉一下help命令：gemini --help，这会显示所有可用的命令和选项。