Antigravity 终端沙箱(Sandbox)与权限策略:四种执行策略、文件网络边界与放行清单

既不想每次跑 npm test 都手动点确认,又怕 AI 误删本机目录或读取 ~/.ssh 密钥?本文按 Google Antigravity 官方文档详解系统级终端沙箱原理、四档权限预设、Deny > Ask > Allow 判定顺序与项目级覆盖配置。

NNathaniel bigo··原创首发·AI 辅助撰写
11 分钟读完
资料核对于 2026-11-18 · 依据官方文档与公开资料整理 免费账号 账号

结论先说

  1. 日常开发最稳妥的组合是开启终端沙箱(Default / proceed-in-sandbox):智能体在当前项目目录内编译、跑测试全程自动执行不打扰你,一旦试图读写工作区外文件或访问未授权网络就会自动拦下询问。
  2. 沙箱不是简单的字符串黑名单,而是操作系统内核级隔离:在 Linux 基于内核命名空间(Namespaces)、macOS 基于 sandbox-exec、Windows 基于系统容器机制隔离进程,默认封锁 ~/.ssh 等高敏路径。
  3. 白名单和黑名单撞车时,永远按 Deny > Ask > Allow 顺序裁决:只要某条命令或路径命中了拒绝(deny)列表,哪怕你在别处配了允许也会被立即阻断。
  4. 别为了省事把全局切成 Turbo(无沙箱全放行):个别特殊仓库需要跨目录读写时,用 项目级设置(Project-Level Settings) 单独覆盖当前仓库即可,不影响电脑上的其他项目。
  5. 谷歌账号准备与主力编程订阅入口:使用 Antigravity 全系列客户端需登录符合开放地区与年龄条件的个人谷歌账号,缺号可查看本站 谷歌账号购买说明(含带 2FA 自动发卡的 谷歌邮箱成品号);多工具主力开发订阅总览见 AI 会员充值中心。

Antigravity 四档权限与沙箱预设

图:本站根据 Antigravity 权限官方文档 整理的示意图

本文根据 Google Antigravity 官方沙箱与权限文档(antigravity.google/docs/sandbox、antigravity.google/docs/permissions)整理,资料核对于 2026-11-18。配图为本站整理的示意图,不是软件界面截图。本站(bigolab.com)不是 Google 官方网站。

适用于谁

  • 嫌智能体每跑一条 git status 或单测命令都要弹框等点确认,想安全提速的开发者;
  • 担心自主智能体误碰工作区外的私人目录、~/.ssh 私钥或乱发外网请求的人;
  • 在沙箱开启状态下遇到 git commit 锁文件拒绝访问、npm install 网络被拦不知道怎么放行的人。

一、四档权限预设与工具执行策略怎么选

打开左侧「设置(Settings)」,你会看到围绕 终端沙箱(Terminal Sandbox) 与 工具执行策略(Tool Execution Policy) 组合而成的四档常用模式:

预设档位 / 策略名沙箱开关文件与终端执行表现推荐使用场景
Request Review(request-review / strict)关闭或严管每执行一条终端命令前都暂停等待人工点批准存放线上基础设施脚本、Terraform 或核心账务配置的高敏仓库
Default(proceed-in-sandbox)开启沙箱内读写当前项目与临时缓存免确认;越界动作弹框审批绝大多数前后端日常业务开发(官方默认推荐)
Auto(Preview 预览档)开启沙箱内自动跑;沙箱外请求由引擎评估可逆性,低风险操作自动放行频繁需要跨子模块构建、希望进一步减少弹窗打断的熟手
Turbo(always-proceed)关闭完全不设沙箱、不弹确认,智能体拥有与当前登录用户同等的终端权限仅限用完即毁的纯隔离云主机、Docker 开发容器或空实验靶场

首次安装完客户端还没检查过默认策略的读者,可对照 Google Antigravity 下载与初始化设置指南 先做一遍核查;若需要准备独立开发使用的个人谷歌账号,可参考 谷歌账号购买说明 或前往自动发货的 谷歌邮箱成品号商品页(质保政策以商品页为准)。

二、细粒度权限控制:文件、网络与 action(target) 语法

除了上面的总档位,Antigravity 的统一权限引擎还把智能体的动作拆成三个独立边界开关和精确的规则清单:

  1. 非工作区文件访问(Non-Workspace File Access):可选 allow(允许)、ask(每次询问)、deny(一律拒绝)。强烈建议全局设为 ask 或 deny,防止智能体顺着相对路径 ../../ 改坏相邻仓库的代码。
  2. 网络访问策略(Internet Access Policy):同样分 allow、ask、deny 三档。在沙箱模式下,未经批准的外部域名请求会被切断;如果你发现内置网页测试工具访问受阻,还需要同步检查浏览器白名单,详见 Antigravity Browser 域名白名单配置。
  3. 命令放行与封禁清单(Command Allowlist / Denylist):权限引擎内部使用 action(target) 语法表达权限资源(例如 command(git)、read_file(/path) 或针对外部工具的 mcp(linter/*))。你可以把只读安全的 git status、pnpm test 放进全局允许清单,同时把 rm -rf、git push --force 钉死在封禁清单里。

三、常见沙箱报错与权限冲突怎么排

沙箱拦截与权限冲突排查决策

图:本站根据 Antigravity 沙箱官方文档 整理的排错示意图

开启沙箱后如果正常的构建或版本管理命令报 Permission denied,不用急着把整个沙箱关掉,按下面三步精准放行:

  1. Git 多工作树(git worktree)提交报无法创建 index.lock:当你使用 Git Worktree 开发时,.git 主目录实际位于当前文件夹外面的父级仓库目录里,沙箱默认会拦住向工作区外写锁文件的操作。此时只需在当前项目的 Project-Level Settings(项目级设置) 里针对该主仓库 .git 路径授予项目级文件权限(Permission Grants),或者在弹框询问越界写入时点击允许。
  2. 配置了允许却依然每次被拒:记住官方引擎的铁律——Deny > Ask > Allow。先检查全局设置和项目级设置里的拒绝列表(Denylist)是不是写了范围过宽的通配规则,把冲突项删掉即可恢复。
  3. 想在代码层面防止 AI 触碰特定业务表:操作系统的沙箱管的是目录与进程级安全;如果你想限制「允许改 src/,但禁止动 src/billing/ 计费核心逻辑」,可以搭配项目级规则文件与生命周期钩子双重约束,规则写法见 Antigravity Rules 规则配置指南,外部工具接入安全见 Antigravity MCP 服务器配置教程。

常见问题

问:Windows 上的终端沙箱和 macOS / Linux 隔离强度一样吗?

答:底层实现机制不同。官方文档说明 Linux 采用内核 Namespaces、macOS 采用系统级 Seatbelt(sandbox-exec),而 Windows 依赖当前系统版本对 AppContainers 等隔离特性的支持程度,建议 Windows 用户同时把高危命令写进 Denylist 双保险。

问:项目级设置(Project-Level Settings)改完会影响我打开的另一个仓库吗?

答:不会。项目级设置只对当前激活的那一个工作区生效,且优先级高于全局设置;切回其他项目时会自动恢复你严谨的全局安全策略。

问:为什么智能体发现沙箱跑不通命令时,不自己想办法绕过去?

答:官方内置了严格的智能体行为准则:严禁绕过、篡改或试探任何沙箱边界与权限校验。遇到权限不足导致阻塞时,智能体会如实向你汇报报错并停手等待授权。

问:国内没有可用的个人谷歌账号,或者重度写代码想搭配其他编程订阅怎么办?

答:可在本站即时选购带独立 2FA 的 谷歌邮箱成品号(首登顺序与 3 天首登质保细则见 谷歌账号购买页),支持支付宝、微信支付与 AlipayHK;若日常还需要高配额终端智能体互补,也可自助兑换 Claude Code 订阅 或 ChatGPT Plus。

相关教程

Nathaniel 的更多内容

  1. 01

    独立开发者用 ChatGPT + Codex 跑通产品全流程:市场验证、PRD、原型到代码上线复盘清单

    单人做独立产品最容易陷入「闭门写两个月代码上线零用户」或「AI 写到一半目录越改越崩」。本文整理「ChatGPT 负责市场验证、PRD 与复盘 + Codex 负责工程实现与测试」的五阶段双轨流程,附起手提示词与 7 项上线复盘清单。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成规范文件命名规则、整理混乱目录树与合并零散发票抬头清单脚本

    面对满桌面的「新建文件夹」「最终版2」和上百张零散电子发票,手工改名抄台账耗时又容易漏重。本文分享先脱敏取样、再用 ChatGPT 生成带预演和回滚日志的本地 Python 脚本,离线安全完成目录整理与发票抬头合并去重的实战流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外邮件营销(EDM)受众分层文案、A/B 主题行测试与防进垃圾箱自检

    做海外独立站或出海 SaaS 邮件营销(EDM),最怕千人一面群发被直接送进垃圾箱。本文结合 Gmail/Yahoo 批量发件人规范,梳理用 ChatGPT 设计受众分层文案、批量生成 A/B 主题行矩阵并开展发前垃圾词与合规自检的实战提示词。

    ChatGPT0
  4. 04

    用 ChatGPT 写 Notion Formula 2.0 公式、Obsidian Dataview 查询与 Airtable 自动化脚本

    给 Notion 数据库写多条件 Formula 2.0 公式、给 Obsidian 写 Dataview 动态看板,或在 Airtable 里写自动化脚本,经常因为一个小括号或类型不匹配报错半天。本文整理三大工具的通用上下文喂料规范与三套直接可复制的生成提示词。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 处理复杂 JSON / YAML / XML 字段映射、格式转换与校验规则编写实战

    对接第三方 API、迁移 Kubernetes 配置或解析政企 XML 报文时,手工对照几百行嵌套字段既慢又容易漏掉空值与类型边界。本文整理用 ChatGPT 完成字段映射表梳理、生成确定性转换脚本以及编写 JSON Schema / Pydantic / XSD 校验规则的实战流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 准备本科/硕士毕业论文答辩:提炼答辩 PPT 结构、模拟导师犀利追问与 3 分钟自述稿

    毕业论文写完后,要在 3–5 分钟内讲清研究价值并顶住答辩评委的连环追问并不轻松。本文整理在严格遵守高校学术规范的前提下,用 ChatGPT 提炼答辩 PPT 结构、打磨 3 分钟口语自述稿并开展模拟导师犀利追问的排练流程与提示词。

    ChatGPT0

同产品的其他教程

  1. 01

    用 ChatGPT 速读英文产品手册、开源文档与 GitHub Issue 并沉淀团队中文内训手册

    团队引入海外 SaaS 工具或开源框架时,全英文文档晦涩冗长、真正的坑全藏在几十页 GitHub Issue 讨论里。本文分享速读拆解英文手册、归类 Issue 排障库以及重构团队中文内训 SOP 的完整实战流程。

    ChatGPT其他 AI 工具0
  2. 02

    用 ChatGPT 写油猴脚本(Tampermonkey)与浏览器书签小工具解决网页繁琐重复操作实战

    每天在后台系统里重复勾选几十个复选框、手工复制网页表格或清理遮挡阅读的侧边栏,既枯燥又浪费时间。本文分享不会写 JS 也能用 F12 配合 ChatGPT 写出油猴脚本与书签小工具的完整实战流程。

    ChatGPT其他 AI 工具0
  3. 03

    用 ChatGPT 写高质量 SQL 窗口函数(RANK / LAG / SUM OVER)做留存与漏斗分析实战

    做用户留存率、复购间隔与有序转化漏斗时,多层自连接既难读又拖垮数据库,窗口函数则是高效解法。本文整理数据库方言喂数规范、CTE 分层提示词以及用内置沙盒先验证再上线的完整实战流程。

    ChatGPT其他 AI 工具0
  4. 04

    ChatGPT 连接 Canva、Figma、Linear、Jira、Dropbox 等第三方应用搜不到数据或授权失效怎么办

    在 ChatGPT 接入 Canva、Figma、Linear、Jira 或 Dropbox 后,明明显示已连接却搜不到文件工单,或老提示授权失效怎么办?本文拆解账号错绑、OAuth 范围漏选、权限继承与管理员拦截 5 步排障法。

    ChatGPT其他 AI 工具0
  5. 05

    Anthropic Contextual Retrieval(上下文增强检索)是什么、怎么实现:给文档块自动补背景摘要结合缓存降失误率

    长文档切成小块后丢了公司名、年份和主语指代导致 RAG 频频搜错?本文按 Anthropic 官方技术文章详解 Contextual Retrieval 原理、官方公开评测失误率下降 49% 至 67% 的组合架构,以及用 Claude 提示词缓存低成本批量生成切片背景的完整 Python 代码。

    Claude其他 AI 工具0
  6. 06

    RAG 知识库回答不准怎么调优:切片大小(Chunking)、BM25 + 向量混合检索与 Rerank 重排序三步排查法

    搭好的 RAG 企业知识库一问具体型号、报错码或跨行表格就答非所问?本文按 OpenAI 与 Anthropic 官方检索文档,给出先隔离检索与生成故障、再按结构化切片(Chunking)、BM25 加向量混合召回(RRF)与 Rerank 重排序逐层调优的三步法。

    Claude其他 AI 工具0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~