Skip to main content

One HTML document for Search, AI answers, and browser agents.

Switch to Simplified Chinese

# Gemini CLI OAuth 与 Google 账号授权

Source: https://www.5173z.com/case-studies/gemini-cli-oauth-google?hl=en

Gemini CLI 默认走 Google 账号 OAuth：命令行打印授权 URL，浏览器登录后把一次性码送回本机监听端口，CLI 再换成可刷新的本地凭证。这和 AI Studio 的 API Key 是两条路。个人试验可先 OAuth；脚本、CI 和无头环境应改用服务账号或 API Key，不要在流水线里点浏览器。授权失败先查端口占用、重定向 URI 和账号是否被组织策略拦住。

- Google OAuth — 登录
- 本机可刷新 — 凭证
- 改用 Key / 服务账号 — CI

子问题通常是：要不要开 Cloud 项目、能授权几个账号、凭证存在哪。本页按登录路径回答，不把每个报错做成独立栏目。

## flow 授权怎么走完

- 安装官方 Gemini CLI 后执行登录命令。
- 浏览器打开 Google 同意屏，选要用于 Gemini 的账号。
- 回环地址把授权码交回 CLI；成功后本机记下 refresh token。

## scope 授权范围别扩太大

只勾选 CLI 文档列出的 Gemini / Generative Language 范围。企业账号可能被管理员关掉“未审核应用”。不要把个人 Gmail 授权给公用机器。

## fail 打不开浏览器或卡在 localhost

先确认 CLI 打印的端口没被别的开发服务占用，关代理对 localhost 的劫持，再用无痕窗口重试。无图形界面的机器不要硬走 OAuth，改 API Key。

## takeaway 要点

- OAuth 给交互终端，Key 给脚本。
- 凭证只留本机，不进 git。
- 端口占用是第一排查项。

Gemini CLI OAuth 与 Google 账号授权

高森模型产品
齐岚开发者体验

Published September 22, 2026

Gemini CLI 默认走 Google 账号 OAuth：命令行打印授权 URL，浏览器登录后把一次性码送回本机监听端口，CLI 再换成可刷新的本地凭证。这和 AI Studio 的 API Key 是两条路。个人试验可先 OAuth；脚本、CI 和无头环境应改用服务账号或 API Key，不要在流水线里点浏览器。授权失败先查端口占用、重定向 URI 和账号是否被组织策略拦住。

Google OAuth 登录
本机可刷新 凭证
改用 Key / 服务账号 CI

子问题通常是：要不要开 Cloud 项目、能授权几个账号、凭证存在哪。本页按登录路径回答，不把每个报错做成独立栏目。

授权怎么走完#

安装官方 Gemini CLI 后执行登录命令。
浏览器打开 Google 同意屏，选要用于 Gemini 的账号。
回环地址把授权码交回 CLI；成功后本机记下 refresh token。

授权范围别扩太大#

只勾选 CLI 文档列出的 Gemini / Generative Language 范围。企业账号可能被管理员关掉“未审核应用”。不要把个人 Gmail 授权给公用机器。

打不开浏览器或卡在 localhost#

先确认 CLI 打印的端口没被别的开发服务占用，关代理对 localhost 的劫持，再用无痕窗口重试。无图形界面的机器不要硬走 OAuth，改 API Key。

要点#

OAuth 给交互终端，Key 给脚本。
凭证只留本机，不进 git。
端口占用是第一排查项。

Was this helpful?

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. Figures are original to this site.

Last updated 2026-09-22.