gemini-cli - 💡(How to fix) Fix Link in /auth instructions is broken [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
google-gemini/gemini-cli#26140Fetched 2026-04-29 06:35:29
View on GitHub
Comments
0
Participants
1
Timeline
1
Reactions
0
Participants
Timeline (top)
labeled ×1

Error Message

I run /auth and authenticate successfully with my google account however CLI throws this error

Code Example

This account requires setting the GOOGLE_CLOUD_PROJECT or GOOGLE_CLOUD_PROJECT_ID env var. See│   https://goo.gle/gemini-cli-auth-docs#workspace-gca

---

> /about
# paste output here
RAW_BUFFERClick to expand / collapse

What happened?

I run /auth and authenticate successfully with my google account however CLI throws this error

│   This account requires setting the GOOGLE_CLOUD_PROJECT or GOOGLE_CLOUD_PROJECT_ID env var. See   │
│   https://goo.gle/gemini-cli-auth-docs#workspace-gca

But https://goo.gle/gemini-cli-auth-docs#workspace-gca redirects to a 404 https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/authentication.md#workspace-gca

<img width="721" height="351" alt="Image" src="https://github.com/user-attachments/assets/f2209d08-f758-4ecc-a1e7-563e439c12f7" />

What did you expect to happen?

The link resolves

Client information

<details> <summary>Client Information</summary>

Run gemini to enter the interactive CLI, then run the /about command.

> /about
# paste output here
</details>

Login information

No response

Anything else we need to know?

No response

extent analysis

TL;DR

Set the GOOGLE_CLOUD_PROJECT or GOOGLE_CLOUD_PROJECT_ID environment variable to resolve the authentication issue.

Guidance

  • The error message indicates that the GOOGLE_CLOUD_PROJECT or GOOGLE_CLOUD_PROJECT_ID environment variable is required for authentication.
  • Check the documentation at https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/authentication.md#workspace-gca for instructions on setting the environment variable.
  • Verify that the environment variable is set correctly by running echo $GOOGLE_CLOUD_PROJECT or echo $GOOGLE_CLOUD_PROJECT_ID in your terminal.
  • If the issue persists, try updating the Gemini CLI to the latest version.

Notes

The provided link https://goo.gle/gemini-cli-auth-docs#workspace-gca redirects to a 404 page, but the correct documentation can be found at https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/authentication.md#workspace-gca.

Recommendation

Apply workaround: Set the GOOGLE_CLOUD_PROJECT or GOOGLE_CLOUD_PROJECT_ID environment variable as instructed in the documentation.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING