[求助] Gemini CLI 使用 Gmail 登录仍提示需要设置 GOOGLE_CLOUD_PROJECT

[EasonIndie]

[求助] 使用 Gemini CLI 登录时报错：This account requires setting the GOOGLE_CLOUD_PROJECT env var

大家好，

我在使用 Gemini CLI 的过程中遇到一个问题，想请教一下有没有人遇到类似情况，或者知道怎么解决。

🧩 背景

• 我使用的是一个普通的个人 Google 账号（@gmail.com 结尾），不是 Workspace 企业账号。
• 我的目的是通过 Gemini CLI 使用免费的 Gemini 模型（按文档说应该每天有 1000 次请求额度）。
• 尝试登录时，报如下错误 Failed to login. Message: This account requires setting the GOOGLE_CLOUD_PROJECT env var. See https://goo.gle/gemini-cli-auth-docs#workspace-gca

❓我的疑问

1. 明明我是使用 Gmail 账号登录的，为什么仍然提示要设置 GOOGLE_CLOUD_PROJECT？
2. 官方文档中写的「使用个人 Google 账号每天可请求 1000 次」是不是只在某些命令中有效？比如 gemini chat？
3. 是否目前 Gemini CLI 默认总是走 Google Cloud Auth 模式（即使是 Gmail 账号）？
4. 如果我真的需要配置 GCP 项目，那在不绑定信用卡的前提下，是否仍能享受免费额度？有没有被误收费的风险？

🙏 希望得到帮助

我想确认：对于个人用户，是否必须设置 Google Cloud 项目才能使用 Gemini CLI ？
如果可以只靠 Gmail 登录就享受免费额度，具体应该怎么操作？

---

感谢各位大佬！

谢谢各位大佬的解答，目前已经解决了。 大概步骤如下：

要解决您在使用个人Google账号（@gmail.com）登录Gemini CLI时遇到的 GOOGLE_CLOUD_PROJECT 环境变量错误，请按以下步骤操作：

根本原因

即使您是个人账号，Gemini CLI在某些情况下要求指定一个Google Cloud项目来管理API请求（免费额度也需通过项目统计）。错误提示表明您的账号未关联有效项目。

解决方案

1. 创建Google Cloud项目

• 访问 Google Cloud Console
• 登录您的 @gmail.com 账号
• 点击顶部导航栏的 项目选择下拉框 → 新建项目
• 输入项目名称（如 My-Gemini-Project），点击 创建

2. 启用Gemini API

• 在Cloud Console中进入刚创建的项目
• 侧边栏选择 "API和服务" > "库"
• 搜索 Generative Language API → 点击进入 → 启用

3. 设置环境变量

• 获取项目ID：
  • 在Cloud Console首页 → 项目信息卡片中复制 项目ID（格式如 my-project-12345）
• 设置环境变量：
  • Linux/macOS（终端执行）：

    export GOOGLE_CLOUD_PROJECT="你的项目ID"
    

  • Windows（命令提示符/PowerShell）：

    set GOOGLE_CLOUD_PROJECT=你的项目ID  # CMD
    
    

补充说明

• 免费额度：通过该项目调用Gemini API时，系统自动使用每日1000次的免费限额（无需绑定银行卡）。
• 项目位置：项目创建在Google Cloud的免费层级，不会产生费用。
• 若仍失败，检查项目ID是否拼写错误，或重启终端使环境变量生效。

完成上述步骤后，您的个人账号即可正常使用Gemini CLI。此操作不会将账号升级为Workspace，仅关联必要的云资源。

[threeBoy]

Gemini CLI 是走 api 额度的，你要有 Cloud 才能创建你的 api 。 都是免费的，点两下就行

[threeBoy]

@threeBoy https://www.v2ex.com/t/1144487 我看着这篇文章操作完的,体验下来还可以，里面还挂了个中文界面的 Gemini CLI 项目链接

[EasonIndie]

@threeBoy #1 请问，我需要创建 GOOGLE_CLOUD_PROJECT 吗？如果走 api 也是每天可以 1000 次的免费吗？我从 chatgpt 询问获得的回复是：某些命令（比如 gemini run 、gemini file upload 等）会触发 GCP 项目要求，而 GCP 项目有免费试用额度

[b19g3r]

没注意看文档吧

[neteroster]

@threeBoy 错误的，Gemini 个人号有免费 1000 次额度每天，这个是和 GCP 那边完全独立的。

---

这个错误有多种可能的原因，可能不是 workspace 的关系，具体请参阅：

https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/authentication.md

[lneoi]

昨天刚问过这个问题, AI 是说两个是独立的, 并且配置这个是免费使用的基础. 所以我也配过去了.
但不用绑定信用卡什么的, 他报错里会给一个链接, 访问链接开启一下服务就行.

[gamblor]

我开始配置也遇到相同问题了，求助 DeepSeek 就解决了，记得要打开联网+深度思考模式。用了一段时间了，谷歌伟大！

[cnhongwei]

申请 API 的时候，要先在 google cloud 的控制台中新建一个 Project 或使用现存的 project 。

[imdong123]

我在使用的时候发现，在用 gmail 登陆时 会跳转到本地 Gemini CLI 监听的服务， 在本地服务中 Gemini CLI 会调用 google api 所以你的终端也需要设置代理 不然 Gemini CLI 调用 google api 时会超时。不知道你的情况和我的是不是一样

[kaffka]

@imdong123 正确的。需要设置 $https_proxy ，而且不支持 socks 协议要用 http

[threeBoy]

@neteroster 他不是要用 Gemini CLI ？ Gemini CLI 得走 api 啊

[threeBoy]

@threeBoy #11 明白了,你说的对。

[korzhao9595]

- 去谷歌云创建个项目
- 给 gemini api 开通下权限
- 本地环境变量设置下 GOOGLE_CLOUD_PROJECT

谷歌有专门的 wiki ，跟着走一会就配好了

[my101du]

同样的问题， 我用 Gmail 登陆后，还提示需要设置 PROJECT

然后去 Cloud Dashboard 设置一个 project 并 enable API （ Gemini ） 后，能使用了

结果过了几天邮件发来产生了 0.03 美元的费用？？

我确定并没有使用超过 1000 次，因为就简单体验了不到半小时而已。

[halov]

https://www.cnblogs.com/maplepie/p/18949291 参考这个 拉到最下面 看看自己有没有项目 id 还需要开通 api 权限 我可以正常使用了

[EchoWhale]

我甚至申请了一个新的账号想避免设置 GOOGLE_CLOUD_PROJECT ，都没成功。


同问：GOOGLE_CLOUD_PROJECT 和单纯的 gmail 账号在额度和收费方面有什么区别？

[crysislinux]

个人账号也可以用 Google Cloud Platform, 现在 Google 正在把老服务迁移到 GCP ，迁移后各种服务都要 project id ，没用过 gemini ，不过想来应该不会再走老路单独给你一套 secret 了。

[xzyDeathGun]

为什么不用 API KEY 登录呢？这个不是可以使用 100 次免费的 gemini-pro

[my101du]

没人遇到过很简单的几次调用，过几天仍然会产生账单吗？

按这个步骤走的

1. Google 个人账号认证
2. 使用之前的 Project 并添加 project id 到环境变量
3. enable gemini api
4. 环境变量设置代理

[EasonIndie]

@my101du #19 我点击项目控制台的 billing ，提示：没关联账户。也就不存在付费吧。gemini cli 目前正常使用。
Billing
This project has no billing account
This project is not linked to a billing account

[alvinzheng]

我是注册新号使用的时候碰到的这个问题，要求我必须绑定信用卡。我用老号，本地没有设置 GOOGLE_CLOUD_PROJECT 也不会报此错误。感觉并不是真正的根源。

[YiPeng0505]

感谢