Gemini CLI 不能用了怎么办，第一步不是卸载，也不是清空缓存，而是判断你使用的账号类型。Google 已确认，从 2026 年 6 月 18 日起，个人免费、Google AI Pro 和 Google AI Ultra 账号不再通过 Gemini CLI 提供请求服务，个人用户也不能继续使用原来的 Google 登录方式。(Google 官方迁移说明)

这意味着：如果你属于个人用户，反复安装同一个旧工具，通常不能恢复服务。你应先迁移到 Antigravity CLI，再检查项目和权限。

企业授权并不等于所有账号都自动可用。Google 的说明把 Standard、Enterprise 和部分 API 密钥路径单独列出，因此学校账号、公司账号或云项目用户不能只凭“我有付费服务”下结论。(Google 官方账号说明)

登录后不能使用，通常应该先查哪一项？

先看登录账号属于个人账号、组织授权还是 API 密钥认证。若你只是个人用户，并且错误表现为无法继续请求模型，迁移优先级高于重装。若你属于学校或企业组织，则应让管理员确认授权类型，不要自行删除旧配置。

Gemini CLI 和你的代码项目不是同一个东西。更换命令行工具，不会自动删除项目目录；但未提交的修改、工具自己的配置和会话记录，不能混在一起判断。

可以把它想成换助教：助教变了，不代表你的作业本消失；但旧助教写在自己笔记里的批注，也不一定会自动带到新助教那里。

迁移前按下面顺序检查：

1. 打开项目所在目录，确认 Python、前端或 Xcode 文件仍然存在。
2. 如果项目使用 Git，查看当前状态，确认哪些文件已经修改但还没有提交。
3. 单独复制重要的配置文件，例如本地环境变量模板、项目说明和课程要求。
4. 检查是否有未保存的编辑器标签页，不要只看终端输出。
5. 将项目复制到一个可恢复的位置，再开始退出旧工具或安装新工具。

迁移到 Antigravity CLI 后，原来的项目文件会消失吗？

正常情况下，迁移工具本身不会删除你的代码目录。真正需要防范的是未保存修改、未提交文件、被忽略的配置文件，以及旧工具保存的会话信息。建议先运行 Git 状态检查，再把练习项目复制一份，用副本完成第一次迁移。

新工具能否继续使用原来的代码目录？

可以。官方 Codelab 的基本流程也是先创建或进入项目目录，再从该目录启动 Antigravity CLI。它可以读取、编辑和执行该工作区中的文件，但首次进入目录时会要求你确认是否信任工作区。(Antigravity CLI 官方 Codelab)

首次测试不要直接使用正式作业。优先创建一个能删除的练习目录，例如：

mkdir -p ~/agy-practice
cd ~/agy-practice

然后放入一个简单的 Python 文件或静态网页。这样即使 AI 修改方向不对，也不会影响课程项目。

Antigravity CLI 应安装在实际保存和运行代码的电脑上。项目在哪里，工具就优先装在哪里。

如果你的 Xcode 项目在远程 Mac 上，那么 Antigravity CLI 应在远程 Mac 的终端里安装和启动。Windows 可以用来连接远程 Mac、编辑说明或查看结果，但不能因为本地 Windows 已经安装工具，就认为远程 Mac 也能直接使用同一套命令。

官方 Codelab 当前给出的 macOS 和 Linux 安装路线是：

curl -fsSL https://antigravity.google/cli/install.sh | bash
agy --version
agy

Windows 的 PowerShell 和命令提示符有不同安装方式，不能把 macOS 命令原样复制过去。安装脚本、命令路径和登录流程应以官方 Antigravity CLI Codelab及官方迁移说明为准。

安装后至少检查 3 项：

• 安装结果：agy --version 能返回版本信息。
• 命令路径：终端能够找到 agy，而不是提示“command not found”。
• 登录入口：启动 agy 后，能看到个人 Google OAuth 或 Google Cloud 项目等认证选项。

如果学校电脑没有管理员权限，不要尝试绕过设备管理。更稳妥的做法是使用你有控制权的个人电脑、合规的远程 Mac，或者先在浏览器中的官方学习环境完成练习。官方资料也展示了在 Cloud Shell 环境中运行 Antigravity CLI 的学习路径，但那与本地 Mac 的文件访问能力并不完全相同。(Google 官方 Cloud Shell 学习示例)

项目在远程 Mac 上时，工具应该部署在哪台设备？

如果代码目录、Xcode、编译器和模拟器都在远程 Mac 上，就在远程 Mac 的终端安装。不要只在本地 Windows 安装后，再期待远程会话自动共享命令、配置和权限。

这也是使用远程 Mac 部署 AI 编程工具的首次验收指南时最容易漏掉的一项：连接设备和运行项目的设备，必须是同一台，或者你要明确通过 SSH、版本控制和文件同步完成交接。

首次登录主要涉及 3 个不同概念：

• 账号验证：确认你是谁，以及账号是否有使用资格。
• 工作区信任：确认工具可以读取、编辑和执行哪个文件夹。
• 命令执行权限：确认 AI 是否能运行终端命令、写文件或调用外部服务。

官方 Codelab 说明，Antigravity CLI 首次进入新目录时，会询问你是否信任该工作区；工具权限还可以在设置中选择需要复核、沙盒执行、完全自动执行或严格模式。(Antigravity CLI 权限说明)

对学生来说，建议从低风险模式开始：

1. 只信任临时练习目录，不要直接信任整个用户目录。
2. 第一次请求只让工具读取并解释文件，不要立即要求批量修改。
3. 要求它先列出准备修改的文件。
4. 查看差异后，再允许写入。
5. 运行测试、构建或删除命令时逐项确认。

⚠️ 不要把 API 密钥、证书、学校账号密码或 .env 文件直接交给 AI。不要使用共享账号。也不要在没有人工复核的情况下启用完全自动执行权限。

工具权限会影响文件读写、终端命令和外部服务调用；减少确认步骤的自动执行设置，也会扩大误操作范围。首次迁移时，安全性应优先于操作速度。

如果你需要更细的验收顺序，可以参考AI Agent 修改代码后的权限、差异与构建检查清单。对于 Xcode 项目，还应结合 Xcode 项目的独立构建检查，确认 AI 显示“已完成”之后，项目确实能构建或运行。

完成迁移后，不要只看 Antigravity CLI 是否能启动。学生真正关心的是：课程作业还能不能继续。

按 5 项指标验收：

1. 账号可用：能完成登录，并能提交一次简单请求。
2. 项目完整：原代码、资源文件和必要配置仍在。
3. 工具可启动：agy --version 有输出，进入项目目录后能启动。
4. 权限可控：工具修改前会展示文件或命令，危险操作不会静默执行。
5. 课程可完成：Python 能运行，前端能启动，Xcode 项目能构建或进入模拟器测试。

iOS 学习者尤其不能只看 AI 是否回复“任务完成”。你还要打开 Xcode，执行一次构建；如果项目需要模拟器，再确认目标设备、签名、依赖和运行结果。AI 能修改代码，不代表 Xcode 一定接受这份代码。

可以按下面的条件分支做决定：

• 若你是个人免费、Google AI Pro 或 Ultra 用户，且 Gemini CLI 已不能请求：迁移到 Antigravity CLI。
• 若你是企业授权或 API 密钥用户，且旧工具仍能稳定完成课程：先核对官方资格，可暂时保留。
• 若你正处于关键作业周期，但还没有验证新工具：先用可删除副本双轨测试，不要直接替换正式项目。
• 若项目位于远程 Mac：在远程 Mac 安装、登录、信任目录并运行测试。
• 若五项验收中有一项失败：不要把迁移标记为完成，先处理失败指标。

截至目前，官方资料已经给出迁移方向，但具体版本、账号资格、命令选项和功能边界仍可能变化。发布前应再次核对官方 Antigravity 产品文档、官方迁移页面和官方发布公告。官方 Codelab 还展示了认证、工作区信任和配置文件位置等操作细节；不同版本的界面可能不完全相同。

如果你当前方案只是继续重装 Gemini CLI，它的真实缺点是：不能解决个人账号资格变化；容易覆盖或打乱旧配置；会让你在正式作业期间反复试错。相比之下，先在远程 Mac 的可删除练习目录中完成 Antigravity CLI 迁移和 Xcode 验收，能把账号、项目、权限和 macOS 环境一次分开检查。

若你暂时没有本地 Mac，可以先查看 KVMNODE 的远程 Mac 方案，租用一台可控的远程 Mac 做完整验证；确认课程路线适合你之后，再决定是否长期购买设备或继续使用本地环境。