记录日期：2026 年 10 月 3 日｜主要环境：Windows PowerShell｜账号：已订阅 Google AI Pro 的个人 Google 账号。
开通 Google AI Pro 后，我想把它用于实际开发：不仅是在聊天框里问代码，还要让工具读取项目、修改文件，并在确认后执行命令。本次尝试先遇到了 Gemini CLI 个人账号登录失败，随后转向 Antigravity CLI。
本文记录这次从报错处理、安装、浏览器授权，到主题设置、数据使用偏好和工作区信任确认的过程，并附上后续查看额度和开始编程的方法。终端内容做了排版与必要删节，真实授权码和带参数的登录链接不予公开。
时效说明：客户端界面、账号资格和额度规则可能调整，请结合实际界面与文中链接的官方文档使用；本文不把首次配置完成等同于项目已开发或测试成功。
一、先分清：会员编程工具和 Gemini API
Antigravity CLI 是终端中的 AI 编程工具，可以在权限允许的范围内理解代码库、修改文件和执行命令，而不只是输出供人复制的代码。参见官方项目介绍。
本文采用Google 账号登录，使用账号对应的 Antigravity 权益，不需要为了这一登录方式先创建 API Key。登录时应选择已经订阅 Google AI Pro 的账号。官方安装与认证文档分别介绍了账号登录和 API Key 模式。
通过 Gemini API Key 接入程序，则适用 API 项目的额度与计费规则。让编程工具帮我开发网站，与网站上线后调用 Gemini API，是两件事。不能因为已有 Pro 会员，就把第三方程序的 API 调用理解为会员免费调用。参见Gemini API 计费说明。
二、最初遇到的问题：Gemini CLI 个人登录失败
最初使用的是 npm 包 @google/gemini-cli，启动命令为 gemini。选择 Google 账号登录后，出现了以下提示。下面保留关键内容，省略界面边框：
How would you like to authenticate for this project?
1. Sign in with Google
2. Use Gemini API Key
3. Vertex AI
Failed to sign in. Message:
This client is no longer supported for Gemini Code Assist for individuals.
To continue using Gemini, please migrate to the Antigravity suite of products:
https://antigravity.google这条错误明确表示：当前客户端不再支持这里使用的个人账号登录方式，并要求迁移到 Antigravity 产品。因此，这次改用 Antigravity CLI，而不是反复重试同一个登录入口。
需要注意，这条报错不能直接推导出“Gemini CLI 的所有用途都已停用”。本文只记录此次个人会员登录遇到的问题及迁移路径；官方也提供了从 Gemini CLI 迁移的说明。
三、卸载原来的 npm 版本（可选）
没有安装过 Gemini CLI，可以跳过本节。已经通过 npm 全局安装、且不再需要保留旧客户端时，先退出程序，再在当时安装它的同一环境中执行：
npm uninstall -g @google/gemini-cli这是Gemini CLI 官方卸载文档给出的 npm 全局安装版卸载方式。接着可以检查当前 npm 环境：
npm list -g @google/gemini-cli如果结果显示 (empty)，说明当前 npm 全局环境中已没有这个包。Windows 与 WSL 是不同的安装环境，不要在其中一个环境卸载后，就认为另一个环境中的安装也被移除了。
只卸载软件包即可，不要顺手删除整个 .gemini 目录，也不需要卸载 Node.js 或 npm。Antigravity CLI 的官方迁移流程可以检测并选择迁移旧配置，因此保留配置通常更稳妥。
四、在 Windows 安装 Antigravity CLI
打开 PowerShell，执行官方提供的 Windows 安装命令。以下命令不是 Linux 或 WSL 命令：
irm https://antigravity.google/cli/install.ps1 | iex命令来源：Antigravity CLI 官方项目的安装说明。这条命令会下载并执行安装脚本，执行前应核对域名和脚本来源，不要替换成不明第三方地址。
安装结束后，关闭并重新打开 PowerShell。可以先检查当前终端是否能找到程序：
Get-Command agy随后进入需要开发的项目目录。本次使用的目录为 F:\project\谷歌测试；读者应将下面的路径替换为自己的测试目录：
New-Item -ItemType Directory -Force -Path "F:\project\谷歌测试" | Out-Null
Set-Location "F:\project\谷歌测试"
agy后续启动使用 agy，不是 gemini。建议从单独的测试目录或项目副本开始，不要直接把整个磁盘或生产服务器配置目录作为首次工作区。
五、完成 Google 账号授权
没有可复用的登录会话时，程序会引导浏览器登录。此次界面还提供了手动粘贴授权码的入口。下面是删去动态链接后的终端内容：
Your browser should open automatically. If not:
[本次登录生成的授权链接，已省略]
Copy and paste the URL or click on the link below:
→ Click here to authenticate
If you aren't automatically redirected,
paste the authorization code below:
authorization code...打开自己终端本次生成的链接，登录订阅 Pro 的 Google 账号，并核对授权对象。不要使用他人提供的授权链接，也不要把登录信息填写到不明页面。
浏览器完成授权后，如果出现下面的提示，就需要把授权码复制回正在等待输入的终端：
Paste this code into your application to complete authentication:
[新的授权码，仅粘贴到本机对应的登录输入框]
Copy to Clipboard点击 Copy to Clipboard，回到 authorization code... 输入框，粘贴并按 Enter。只粘贴授权码，不要复制整个网页，也不要把授权码当作 PowerShell 命令执行。官方文档同样说明了手动授权码流程，尤其适用于 SSH 环境。
安全提醒：授权码、访问令牌、Cookie 和私钥不应发布到博客或截图中。完整登录链接也建议省略，只保留操作说明。若不慎公开了本次授权信息，建议中止这次流程并重新发起登录，不再继续使用已公开的授权码。
六、首次启动时的三个确认界面
1. 选择配色：Choose your color scheme
这一步只是在选择界面主题。整理后的终端示意如下，省略了右侧的配色预览：
▄▀▀▄
▀▀▀▀▀▀
▀▀▀▀▀▀▀▀
▄▀▀ ▀▀▄
▄▀▀ ▀▀▄
Welcome to Antigravity CLI!
Choose your color scheme:
terminal
light
solarized light
colorblind-friendly light
> dark
solarized dark
colorblind-friendly dark
tokyo night使用 ↑ / ↓ 选择主题，按 Enter 确认。本次界面选中的是 dark，直接回车即可继续。
右侧预览中的示例代码、compilation failed 和 warning 用来展示不同内容的颜色，不表示此时项目真的发生了编译失败。
2. 设置数据使用偏好：Terms of Service & Data Use
接下来会显示服务条款、安全风险提示和交互数据使用选项。下面仅摘录勾选项的开头，不代替完整条款：
Terms of Service & Data Use
> [x] Yes, I agree to help improve Antigravity CLI by allowing
Google to collect and use my Interactions data,
...
[Previous] [Done]
↑/↓ Navigate · enter Toggle[x] 表示已勾选，即允许将交互数据用于改进产品。不希望参与时，在该项上按一次 Enter，使其变为 [ ]；阅读条款后，将焦点移动到 Done 并确认。
取消的是用于产品改进的数据使用选项，不是把工具变成离线模式，也不是保证所有数据都不再记录。官方条款对数据记录、存储和用于改进分别作了说明。因此仍应避免让工具接触无关的真实凭据与敏感资料。
3. 确认工作区信任：Do you trust this project?
随后出现工作区确认。本次界面内容如下：
Accessing workspace:
F:\project\谷歌测试
Do you trust the contents of this project?
Antigravity CLI requires permission to read, edit, and execute files here.
> Yes, I trust this folder
No, exit
↑/↓ Navigate · enter Confirm如果这是自己创建、内容可信的测试目录，选择 Yes, I trust this folder，按 Enter 继续。对来源不明、尚未检查的代码，应先选择 No, exit。
这里不是普通的“允许聊天”，而是涉及项目文件读取、修改和执行。信任目录不等于所有命令都安全，也不等于程序被严格限制在该目录中。建议保留命令确认机制，并通过权限设置控制实际访问范围；仅在提示词中写“不要读取密钥”，不能代替权限与隔离措施。
七、查看 Pro 编程额度，检查超额积分设置
完成首次配置、进入正常对话界面后，在 agy 的对话输入框中输入：
/usage也可以使用 /quota。根据官方用量命令说明，该命令会刷新后端状态并打开额度面板，显示支持的模型及剩余额度。它不是在 PowerShell 提示符下运行的系统命令。
截至本文整理时，官方套餐说明对 Google AI Pro 的规则是：基础额度每 5 小时刷新，同时受每周上限约束。达到周上限后，不能仅靠下一次五小时刷新继续使用基础额度。
消耗与代理实际完成的工作量有关；复杂任务可能比简单问答消耗更多。官方没有在该方案页公布统一的“每天固定多少个完整任务”。因此，不要把旧工具的每日请求次数直接套用到 Antigravity，也不要把五小时刷新理解成保证连续运行五小时。
不希望基础额度耗尽后自动使用额外 AI 积分，可以打开设置：
/settings检查 AI Credit Overages，将其设置为 Never。按官方套餐说明，这会阻止基础额度用完后自动消耗 AI 积分；Always 则允许使用可用积分继续运行。设置入口及名称以实际版本为准，官方使用说明列出了 /settings 和 /config 两个设置入口。
八、开始编程：先读项目，再确认修改
首次使用不必立即交给它一个大项目。可以先发送下面的指令，了解它准备怎样访问当前工作区：
请使用中文回复。
先查看当前目录结构，判断是否已有项目。
如果有项目，只阅读理解架构所必需的普通源码和说明文档，
说明主要技术栈、目录用途和建议的下一步。
暂时不要修改文件、安装依赖或运行项目。
不要读取 .env、密码、API Key、SSH 私钥或其他敏感文件。
涉及执行命令时，请先说明目的并等待确认。下面是一个可供后续尝试的小任务示例，并非本次已完成的开发成果：
在当前测试目录中制作一个简单的个人导航页面。
使用原生 HTML、CSS 和 JavaScript，不引入外部依赖。
页面包含标题、搜索框和几个示例导航卡片。
请先给出文件规划，列明准备创建或修改的文件，
等我确认后再动手，不要覆盖已有文件。
完成后说明如何本地查看、修改了什么，以及哪些内容尚未验证。
不要部署到公网，不要使用真实密钥。操作时建议遵循“先看计划，再批准修改，最后检查结果”的顺序。生成文件不等于测试通过；安装依赖、执行脚本和部署前，都应检查具体命令。官方入门教程也包含审查文件和确认执行的步骤。
需要退出时，可在对话输入框中使用：
/exit之后再次使用，在 PowerShell 中进入同一项目目录，再运行 agy 即可。
九、Linux / WSL 安装方式补充
这一节是官方安装方式的补充，不是前面 Windows PowerShell 流程必须执行的步骤。使用 Linux 或 WSL 时，在对应的 Linux 终端中执行：
curl -fsSL https://antigravity.google/cli/install.sh | bash官方安装路径为 ~/.local/bin/agy。安装后若当前终端找不到命令，可以先让该目录在当前会话中生效：
export PATH="$HOME/.local/bin:$PATH"然后创建独立的测试目录并启动：
mkdir -p "$HOME/projects/agy-demo"
cd "$HOME/projects/agy-demo"
agy以上安装方式和路径见官方安装文档。不要在 PowerShell 中照搬 Linux 路径与命令，也不要把 Windows 和 WSL 的安装位置、配置目录混为一谈。
总结
这次配置的核心是：遇到个人账号登录不受支持的提示后，改用 Antigravity CLI，以 agy 启动，再完成 Google 授权、首次设置和工作区确认。会员编程工具与 Gemini API 需要分开理解；使用过程中，应持续关注额度、数据使用偏好和文件执行权限。
Comments | NOTHING