login Gemini CLI Workspace 报错解决指南

专为 Google Cloud / AI Studio 用户提供的精确登录步骤。

checklist_rtl登录流程详解

1. 1

   cloud_queue访问 Google Cloud 控制台

   首先，请确保您已登录正确的 Google 账户。然后，访问 Google Cloud 控制台。

   即便是普通 Google 账户也能登录。如果您从未创建过项目，系统通常会自动为您生成一个名为 “My First Project” 的默认项目。

2. 2

   pin定位并记录项目 ID

   在控制台页面左上角，您会看到当前的项目名称。点击它，会弹出一个项目列表。

   在列表中，每个项目名称下方都有一行由字母和数字组成的唯一 ID（例如 my-awesome-project-382913）。请找到您要使用的项目，并复制这串 ID。

3. 3

   terminal设置环境变量

   在启动 Gemini CLI 之前，必须在您的终端中设置 GOOGLE_CLOUD_PROJECT 环境变量，并将其值设为您刚刚复制的项目 ID。

   # 在 Linux 或 macOS 中:
   export GOOGLE_CLOUD_PROJECT="xxxxxxx"
   
   # 在 Windows (CMD) 中:
   set GOOGLE_CLOUD_PROJECT="xxxxxxx"
   
   # 在 Windows (PowerShell) 中:
   $env:GOOGLE_CLOUD_PROJECT="xxxxxxx"

   请务必将代码中的 xxxxxxx 替换为您的真实项目 ID。

4. 4

   rocket_launch手动发起身份验证

   在设置了环境变量的同一个终端中，启动 Gemini CLI：

   gemini

   启动后，CLI 不会自动弹出验证。您需要手动输入 /auth 命令并按回车，以启动登录流程。

5. 5

   manage_accounts完成登录

   浏览器将打开一个 Google 登录页面。请按以下步骤操作：

   1. 点击 “More” (更多) 选项。
   2. 选择并使用您的 Workspace 账号 进行登录。

   error

   至关重要：您在这里登录的 Google 账户，必须与您在第一步中访问 Google Cloud 控制台并获取项目 ID 时所用的账户完全一致。