正文
如果你用的是个人 Google 账号、Google AI Pro、Google AI Ultra，或免费的 Gemini Code Assist for individuals，先确认当前账号是否已经进入 Antigravity CLI 迁移路径。
Google 官方公告写明，2026-06-18 起，这些个人路径下的 Gemini CLI 和 Gemini Code Assist IDE extensions 会停止服务请求。企业许可和 Google Cloud 路径不一样，不要把所有账号都当成同一种情况。
随着开发工具不断升级与整合，很多开发者希望将现有的 Gemini CLI 个人账号迁移到新的 Antigravity CLI，以享受更强大的功能、统一的账号体系和更高效的工作流。本文将详细介绍迁移步骤、注意事项以及常见问题，确保整个过程顺利完成。
一、迁移前准备
在开始迁移之前，需要做一些基础准备工作，以防数据丢失或操作错误。
迁移前不要先删 ~/.gemini，也不要先卸载 Gemini CLI。先把新 CLI 跑通，再决定旧 CLI 是否保留。这样出问题时还能对照旧配置。
- 确认账号状态：确保 Gemini CLI 的个人账号正常登录且数据完整，并确认 Antigravity CLI 已注册或可注册新账号。
- 备份重要数据：导出 Gemini CLI 配置文件，例如
~/.gemini/config.json；备份关键项目文件、API Keys、token、历史日志等。 - 更新 CLI 到最新版本：确保本地 Gemini CLI 和 Antigravity CLI 均为最新版，以避免兼容性问题。
- 记录环境变量：记下 Gemini CLI 的环境变量、路径和相关依赖，以便在 Antigravity CLI 中复用。
二、安装 Antigravity CLI
如果尚未安装 Antigravity CLI，可以按照以下步骤进行安装。安装完成后，重新打开一个终端窗口，让新的命令路径生效。
确认命令能正常输出版本号后，再进入账号迁移步骤。不要在命令路径还没生效时反复重装。
# Mac / Linux
curl -fsSL https://antigravity.dev/cli/install.sh | bash
# Windows PowerShell
iwr https://antigravity.dev/cli/install.ps1 -UseBasicParsing | iex
# 验证版本
antigravity --version三、配置账号与认证
Antigravity CLI 支持多种登录方式，包括邮箱密码、OAuth、以及 API Key。迁移时建议使用官方推荐的账号绑定方式。
通过已有 Gemini 账号迁移时，Antigravity CLI 提供迁移命令，可直接将 Gemini CLI 账号关联到 Antigravity 账号。命令执行后，CLI 会提示输入 Gemini CLI 的用户名或邮箱、token 或密码，并选择是否同步配置文件。
如果自动迁移失败，可以手动将 Gemini 配置文件迁移，再登录 Antigravity CLI 并检查当前账号。
确认账号绑定成功后，再迁移项目、API Keys 和插件。不要在账号状态不明确时继续导入资源。
# 自动迁移
antigravity migrate --from gemini
# 手动复制配置
cp ~/.gemini/config.json ~/.antigravity/config.json
# 登录并检查账号
antigravity login
antigravity whoami四、迁移项目和资源
Gemini CLI 账号中可能存在多个项目、API Keys 或插件，需要同步到 Antigravity CLI。
先导出项目列表，再在 Antigravity CLI 中导入。API Keys 和插件也要逐项检查，不要假设所有内容都会自动同步。
如果某个插件或扩展没有同步成功，先检查路径和权限，再看 Antigravity CLI 是否支持同类插件格式。不要直接把旧目录全量覆盖到新目录。
# 导出项目列表
gemini list-projects --json > projects.json
# 在 Antigravity CLI 中导入
antigravity import-projects projects.json
# 查看 Gemini CLI 中的 Keys
gemini keys list
# 在 Antigravity CLI 中创建或导入 Keys
antigravity keys import keyfile.json
# 迁移自定义插件或模板
cp -r ~/.gemini/plugins/* ~/.antigravity/plugins/五、验证迁移结果
迁移完成后，需要进行全面验证，确保数据、配置、项目和 API 正常运行。
验证时至少检查四件事：账号是否正确、配置是否完整、关键项目能否运行、API Key 和权限是否可用。建议选取一个关键项目进行本地运行或部署测试，确认迁移没有破坏配置。
如果你的项目依赖特定环境变量或路径，也要逐项对照旧 Gemini CLI 配置。迁移成功不等于所有本地工作流都已经恢复。
# 检查账号信息
antigravity whoami
# 检查配置和环境变量
antigravity config list六、常见问题与解决方案
七、迁移小技巧
为了降低迁移风险，建议按步骤推进，不要一次性搬完所有内容。
- 分步迁移：先迁移账号和配置，再迁移项目和 API Keys，避免一次性操作引发不可预期错误。
- 保持 Gemini CLI 可用：迁移期间不要卸载 Gemini CLI，确保可以回退或参考旧配置。
- 使用官方迁移工具：Antigravity CLI 提供官方迁移命令时，优先使用，减少错误。
- 备份关键数据：包括 token、配置文件、插件、项目 JSON 文件等。
结论
将 Gemini CLI 个人账号迁移到 Antigravity CLI 并不复杂，但需要做好准备、配置、迁移、验证四个环节。
核心要点总结：
通过以上步骤，可以确保迁移平稳、安全、高效，享受 Antigravity CLI 带来的更高效工作流和统一账号管理体验。
- 迁移前备份数据和配置。
- 安装最新 Antigravity CLI 并选择自动或手动迁移方式。
- 同步项目、API Keys 和插件。
- 验证账号、项目、配置和 API 是否正常。
- 遇到问题参考官方文档或手动调整配置。