Gemini CLI 账号怎么开通：OAuth、API Key 与组织许可

我家大橘技术创作者 2026-11-01 13 阅读

Gemini CLI 是终端里的 AI 编程代理，可通过 Google 账号、API Key 或组织许可连接模型。

2026 年 6 月 18 日起，个人免费登录及 Google AI Pro、Ultra 的 Gemini CLI 权益已迁往 Antigravity CLI；截至 2026 年 10 月 29 日的官方 README，原版 gemini 命令主要面向 Gemini Code Assist Standard、Enterprise、GitHub 版 Code Assist，以及旧版付费 API 或 Vertex AI 凭据。现在开通前先分清 CLI 工具、订阅账号和 API 计费，才能避免浏览器登录成功后仍被拒绝。

开通前先选对工具

官方仓库目前同时列出三种容易混淆的命令：

要做的事情	应选工具	适合用户
在终端里进行多代理编程	Antigravity CLI（`agy`）	使用 Gemini 4 Argon+，或持有免费、Google AI Pro、Ultra、Google Cloud 账号的个人用户
在脚本或 CI 中直接调用模型	Gemini API CLI（`gemini-api`）	需要无状态 API、媒体处理、文件分析或托管代理的用户
使用企业 Code Assist 工作流	Gemini CLI（`gemini`）	Gemini Code Assist Standard、Enterprise、GitHub 版 Code Assist，以及旧版付费 API 或 Vertex AI 凭据用户

Gemini API CLI 是无状态命令行接口，不是完整的编程代理；原版 Gemini CLI 才是开源终端代理，但当前定位已收窄到企业 Code Assist 工作流。若只是想用 Google AI Pro 或 Ultra 打开交互式编程终端，继续照旧安装 gemini，可能走错账号体系。

三种账号路径怎么选

1. 先用 Google 账号登录

Google 账号 OAuth 登录是最省配置的路径：终端弹出浏览器，登录后返回 CLI。适合已经拥有组织 Gemini Code Assist 许可的用户。

组织账号通常还要绑定 Google Cloud 项目。官方 README 给出的配置是：

# Set your Google Cloud Project
export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"
gemini

把 YOUR_PROJECT_ID 换成组织分配的 Google Cloud 项目 ID，再执行 gemini。这一步只写入当前终端会话；如果需要长期使用，应把同一环境变量写入 shell 启动配置。

若浏览器登录后终端仍拒绝访问，重点检查两件事：当前 Google 账号是否为组织许可中的具名用户，以及 GOOGLE_CLOUD_PROJECT 是否指向正确项目。官方仓库说明，Code Assist Standard 与 Enterprise 许可需要对应的组织身份，访问权不会因拥有普通 Google 账号而自动获得。

2. 用 AI Studio API Key

个人用户或需要按用量付费的开发者，可以改用 Gemini API Key。API Key 与 Google AI Pro/Ultra 订阅不是一回事：前者连接 AI Studio 的按量计费体系，后者是 Google One 权益。

先打开 AI Studio 的 API Key 页面创建密钥：

https://aistudio.google.com/apikey

再设置环境变量并启动 CLI：

export GEMINI_API_KEY="YOUR_API_KEY"
gemini

API Key 路径的优点是可以选择具体 Gemini 模型，并按用量升级额度。官方套餐页同时提醒，Free tier 的数据可能用于改进产品；如果处理的是代码、客户资料或内部信息，应先核对数据使用条款，不要把试用额度直接当成企业数据隔离方案。

3. 用 Vertex AI 身份

Vertex AI 适合已有 Google Cloud 项目、合规要求或区域数据驻留要求的团队。认证应使用 Google Cloud 凭据或 Vertex AI API Key，调用同时受 Google Cloud 服务条款约束。

对个人用户来说，这通常不是最短路径：先要有 Google Cloud 项目、启用对应服务并完成权限配置，成本和操作量都高于 AI Studio API Key。组织若已有 Code Assist Standard 或 Enterprise，直接使用其许可与项目配置，通常更省事。

安装命令怎么选

先确认终端里有 Node.js 和 npm，然后运行 node -v 与 npm -v；两条命令都能输出版本号再继续。临时试用可以直接执行：

npx @google/gemini-cli

长期使用则全局安装：

npm install -g @google/gemini-cli

macOS 或 Linux 使用 Homebrew 时执行：

brew install gemini-cli

受限环境需要 Conda 时，官方 README 给出的完整顺序是：

conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env
npm install -g @google/gemini-cli

这三条必须按顺序执行；创建环境后如果直接运行 npm 全局安装，依赖可能仍装到系统 Node.js，而不是刚创建的 gemini_env。安装后运行 gemini --version，能显示版本号才说明可执行文件已经进入当前环境。

免费、Pro、Ultra 与 API 额度要分清

Gemini CLI 套餐页仍列出 Free、Google AI Pro、Google AI Ultra、Google Developer Program、AI Studio 和 Vertex AI，但同一时期的官方仓库 README 已明确说明：免费个人访问以及 Google AI Pro、Ultra 的原版 Gemini CLI 权益已迁往 Antigravity CLI。两份官方材料存在入口迁移上的时间差，这也是现在最值得注意的变化。

账号或计费方式	官方页面描述的权益	当前操作建议
Free	Google 账号快速认证，用于入门探索	原版 Gemini CLI 已迁往 Antigravity CLI；需要使用原版 `gemini` 时改走 AI Studio API Key
Google AI Pro	包含 Free，并提高 Gemini CLI 等工具的使用限额，附带 Gmail、Docs、Vids 和 Cloud Storage	按官方仓库当前说明，Gemini CLI 相关权益转到 Antigravity CLI
Google AI Ultra	包含 Pro，并提供最高使用限额、Deep Think	同样先确认是否应使用 Antigravity CLI
Google Developer Program	可访问 Gemini Code Assist、较高使用限额及 Cloud 与 GenAI 月度积分	适合团队和 Workspace 企业账号
AI Studio	使用 API Key 登录，可按用量付费并获得隐私、较高限额及付费模型	个人需要继续使用原版 `gemini` 时的直接路径
Vertex AI	Google Cloud 凭据、更高限额、SLA 与区域数据驻留	企业生产工作负载优先

页面没有给出统一的请求次数或每日配额，因此不能把某个固定数字当作所有账号的共同上限。实际限制还取决于认证方式、模型、账号资格和计费项目。

卡住时按报错类型处理

旧版个人 OAuth 登录常见提示是：This client is no longer supported for Gemini Code Assist for individuals. 它的含义不是 CLI 仓库停止维护，而是当前客户端已不再接受个人 Code Assist 登录。此时不要反复重开浏览器授权，改用 AI Studio API Key，或按仓库指引迁往 Antigravity CLI。

组织账号常见提示是：You must be a named user on your organization's Gemini Code Assist Standard edition subscription。遇到这条时，联系 Workspace 或 Gemini Code Assist 管理员确认邮箱是否已加入订阅，并按上一节设置正确的 GOOGLE_CLOUD_PROJECT。仅重新登录同一账号不会增加许可名额。

使用 Free Tier API Key 时若出现：Quota exceeded for metric: generativelanguage.googleapis.com/generate_content_free_tier_requests, limit: 0，说明该密钥当前没有可用的免费请求额度。处理方式是进入 AI Studio API Key 页面检查项目是否已启用计费，然后重新获取或更新密钥；不要把本地删除 GEMINI_API_KEY 当作解决额度问题的方法，因为删除后只会变成找不到凭据。

付费账号若遇到 429，先查看对应请求模型在 AI Studio 或 Google Cloud 控制台中的配额与结算状态，再选择提高配额、切换账号或等待限流窗口结束。免费 OAuth、免费 API Key、付费 API Key 属于不同配额体系，不能拿其中一处的结果推断另一处。

怎么确认已经开通成功

完成认证后运行：

gemini

成功标志不是浏览器显示“登录成功”，而是终端进入 Gemini CLI 的交互界面，并能用当前认证身份发送一条简单测试请求。组织许可路径还应同时确认：

gemini --version 能输出安装版本；
GOOGLE_CLOUD_PROJECT 已指向获授权项目；
登录后的账号属于组织许可中的具名用户。

API Key 路径则检查 echo $GEMINI_API_KEY 是否返回密钥内容，以及测试请求是否从 AI Studio 计费项目正常返回。终端若仍提示旧客户端不受支持，就继续完成迁移，而不是反复执行 OAuth。

官方入口与延伸阅读

Gemini CLI 官方仓库与 README：安装命令、账号迁移说明及 OAuth、API Key、Vertex AI 认证方式。
Gemini CLI 套餐页：Free、Pro、Ultra、AI Studio、Vertex AI 等账号与计费路径。
固定版本 README（2026-10-29）：核对特定时期的安装与认证说明。
AI Studio API Key 页面：创建密钥、查看或更新项目凭据。

参考来源

Gemini CLI 免费配额缩减后的 6 种有效应对方案（2026）

# AI # 知识

评论区

0 条评论

登录后可评论。