首页 >> 综合 > 快讯 >

Antigravity 保姆级上手教程,覆盖安装、基础设置、远程 Agent 完整操作

2026-11-18 10:28:24 来源:网易 编辑:詹菊浩 

Antigravity 是谷歌推出的以 Agent 智能体为核心的 AI 开发平台,支持桌面 IDE、CLI 命令行、网页端三种使用方式,很多新手不知道怎么下载安装、完成账号鉴权,也搞不懂本地 Agent 和远程 Agent 的区别,这份教程从环境准备开始一步步讲清楚,远程 Agent 就算本地电脑休眠、断网,任务也能继续跑,还可以跨设备接着查看结果,适合做长期复杂代码任务。安装前先确认系统门槛,Windows 需要 Win10 64 位以上,macOS 最低 12 Monterey,Linux 要求 glibc 版本达标,同时准备好谷歌账号,企业场景可以用 Gemini Enterprise 凭证。安装分三种渠道,桌面端直接官网下载安装包,CLI 用对应系统脚本一键安装,VS Code、JetBrains 等 IDE 也可以装插件;装好之后登录账号、配置密钥、新建项目绑定本地代码文件夹,先跑本地 Agent 熟悉基础操作,再开启远程 Agent 会话,远程 Agent 运行在独立沙箱环境,不会自动读取本机文件,需要手动上传仓库或者文件给它使用。操作的时候注意权限管控,工具调用会有审批弹窗,敏感操作建议手动确认,任务跑完之后可以查看自动生成的产物,包括代码 diff、执行报告、截图记录。

安装方式清单

  • 桌面 IDE:访问 antigravity.google/download,选择对应系统安装包,安装完成后打开直接登录谷歌账号
  • CLI 命令行:macOS/Linux 执行 curl 一键脚本;Windows 用 PowerShell 脚本,安装后命令是 agy,安装完成用 agy update 升级
  • IDE 插件:VS Code、JetBrains 系列 IDE,在插件市场搜索 Antigravity 安装,在 AI 设置页面完成鉴权

基础设置步骤清单

  1. 登录鉴权:个人账号直接谷歌账号登录;开发场景配置 GEMINI_API_KEY,企业用户配置 Vertex AI 环境变量
  2. 新建项目:选择 New Project,绑定本地代码文件夹或者 Git 仓库,每个项目独立隔离配置、安全策略
  3. Agent 面板快捷键:Ctrl+L 打开 Agent 侧边栏,Ctrl+Shift+L 开启新对话
  4. 权限设置:在设置里调整 Agent 自动审批等级,默认重要操作需要手动确认

远程 Agent 操作清单

  1. 版本检查:CLI 版本≥1.4.12,版本不够先执行 agy update
  2. 启动会话:终端输入 agy --remote-agent,开启远程 Agent 模式
  3. 分配项目:首次启动选择远程项目空间
  4. 提交任务:输入需求指令,Agent 在云端沙箱执行,电脑休眠、断网不中断
  5. 续看任务:桌面端、网页端、CLI 都可以打开同一个远程会话继续查看

本地 Agent 与远程 Agent 对比表

项目本地 Agent远程 Agent
运行环境本机环境云端独立 Linux 沙箱
断网 / 休眠任务中断持续执行
文件访问可直接读取绑定项目文件夹不会自动读取本机文件,需要手动上传
适合场景快速调试、小功能开发长时间任务、批量测试、复杂架构开发
跨设备接续不支持支持多端查看会话

【相关 FAQ】

问题 1:Antigravity 远程 Agent 断网之后任务会停止吗?

回答 1:Antigravity 远程 Agent 运行在云端沙箱环境,本地断网、电脑休眠,任务依旧持续执行,之后可以在任意终端、网页、IDE 打开会话继续查看。

问题 2:Antigravity 安装 CLI 之后,输入 agy 命令提示找不到怎么办?

回答 2:Antigravity CLI 安装完成后需要确认环境变量,macOS/Linux 检查~/.local/bin 是否加入 PATH,Windows 重启终端,或者直接使用完整路径执行 agy。

问题 3:Antigravity 远程 Agent 能不能直接读取我电脑上本地代码?

回答 3:Antigravity 远程 Agent 默认不能直接读取本机文件,需要手动把代码仓库、文件附加到远程项目,它才可以访问这些资源。

问题 4:Antigravity 本地 Agent 和远程 Agent 怎么切换使用?

回答 4:Antigravity 桌面 IDE 默认是本地 Agent,CLI 加 --remote-agent 参数启动远程会话;桌面端可以新建远程项目,在项目设置里切换 Agent 运行模式。

【参考资料】

[2026-11-11](Google Antigravity 远程 Agent 使用指南)Google Antigravity 官方文档

[2026-11-05](Antigravity 保姆级入门教程,安装配置 + 远程 Agent 实操)AIcodingTools

[2026-10-20](Antigravity CLI 快速安装与鉴权配置)Google Antigravity 官方文档

[2026-09-28](Antigravity IDE 插件适配 JetBrains、VS Code 说明)Subvolts

【免责声明】

本资讯仅为 Antigravity 工具操作科普,平台功能、权限、可用地区、账号套餐规则以 Google Antigravity 官方最新文档为准,使用该工具请遵守谷歌服务条款,不构成开发指导。

 
最新文章