📑简介

Gemini CLI 是一个开源的 AI 代理，将 Gemini 的力量直接带入您的终端。它提供了轻量级的 Gemini 访问，让用户从提示到模型的最直接路径。

🚀 为什么选择 Gemini CLI？

🎯 免费套餐：使用个人 Google 账户，每分钟 60 次请求和每天 1,000 次请求。
🧠 强大的 Gemini 2.5 Pro：访问 1M 令牌的上下文窗口
🔧 内置工具：谷歌搜索定位、文件操作、shell 命令、网页抓取
🔌 可扩展：支持 MCP（模型上下文协议）以实现自定义集成
💻 终端优先：专为习惯使用命令行的开发者设计

🛡️ 开源：Apache 2.0 许可协议

📦 安装

安装 Node

下载地址：https://nodejs.org/en

Node.js 版本要求 20 或更高

Quick Install 快速安装

使用 npx 立即运行

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

使用 npm 全局安装

npm install -g @google/gemini-cli

使用 Homebrew 全局安装（macOS/Linux）

brew install gemini-cli

Release Cadence and Tags 发布节奏和标签

Preview 预览

每周将在周二发布新的预览版本。这些版本可能尚未经过全面审查，可能包含回归或其他未解决的问题。请帮助我们使用 preview 标签进行测试和安装。

npm install -g @google/gemini-cli@preview

Stable 稳定

每周将在周二发布新的稳定版本，这将是上周 preview 发布的全面推广加上任何错误修复和验证。使用 latest 标签。

npm install -g @google/gemini-cli@latest

Nightly 夜间

每周将在 UTC 0000 时发布新版本，这将是发布时主分支的所有更改。应假定存在待验证的问题。使用 nightly 标签。

npm install -g @google/gemini-cli@nightly

Reference

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

---

🔐登录

gemini 的登录方法分为一下三种：

Login with Goole

✨ 适合对象：个人开发者以及拥有 Gemini Code Assist 许可证的人。（有关配额限制和条款服务的详细信息，请参阅）

特点：

• 免费层：每分钟 60 请求和每天 1,000 请求
• Gemini 2.5 Pro 带有 1M 令牌上下文窗口
• 无需管理 API 密钥 - 只需使用您的 Google 账户登录
• 自动更新到最新模型

启动 Gemini CLI，然后根据提示选择 OAuth 并遵循浏览器身份验证流程

推荐 window 使用 powershell。

gemini

如果您正在使用来自组织的付费 Code Assist 许可证，请记住设置 Google Cloud 项目

# 同一个powershell窗口
set GOOGLE_CLOUD_PROJECT="ID"
gemini

但是这样每次通过登录时，都需要设置GOOGLE_CLOUD_PROJECT，为了方便使用，通常讲GOOGLE_CLOUD_PROJECT保存到本地的环境变量，gemini 启动时就会自动检测环境变量实现快速登录。

$env:GOOGLE_CLOUD_PROJECT="ID"

Gemini API 密钥

✨ 适合对象：需要特定模型控制或付费层访问的开发者

Benefits: 优势：

• 免费版：每天 100 次请求，使用 Gemini 2.5 Pro
• 模型选择：选择特定的 Gemini 模型
• 按使用量计费：需要时升级以获得更高的限制

set GEMINI_API_KEY="YOUR_API_KEY"

你同样也可以设置本地环境变量实现快速登录。

$env:GEMINI_API_KEY="YOUR_API_KEY"

Vertex AI

✨ 适用于：企业团队和生产工作负载

特点：

• 企业功能：高级安全和合规性
• 可扩展：更高的速率限制与计费账户
• 集成：与现有的 Google Cloud 基础设施兼容

# Get your key from Google Cloud Console
set GOOGLE_API_KEY="YOUR_API_KEY"
set GOOGLE_GENAI_USE_VERTEXAI=true
gemini

有关 Google Workspace 账户和其他认证方法，请参阅认证指南。

---

🎯常见问题

卡在登录页面，无法登录问题

1. 首先打开 cmd，设置代理

set http_proxy=http://127.0.0.1:[vpn的端口地址]

This account requires setting the GOOGLE_CLOUD_PROJECT env var

这个错误，说明你没有在 google cloud 中创建 project。

1. 首先打开google cloud
2. 创建项目，然后复制 project id.

3. 将项目ID设置到环境变量中，命名为 GOOGLE_CLOUD_PROJECT，执行命令如下。

-- Windows (CMD)
set GOOGLE_CLOUD_PROJECT=frank-web-470005

-- Windows (PowerShell)
$env:GOOGLE_CLOUD_PROJECT="frank-web-470005"

4. 搜索 Gemini for Google Cloud 这个服务并启用。然后回到命令行工具，就可以使用了。如果你是Windows用户，建议使用 Powershell。