Antigravity CLI 沙箱与工具审批模式怎么设:自动执行风险控制与 .geminiignore 忽略敏感文件

在终端运行 Antigravity CLI(原 Gemini CLI)怕误删目录或泄露 .env 密钥?本文按官方文档讲清 --sandbox 沙箱隔离、--approval-mode 四种审批模式及 .geminiignore 忽略敏感文件配置。

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

结论先说

  1. 审批模式决定「问不问你」,沙箱决定「能碰哪里」:两者各管一摊,想减少人工确认弹窗时,务必先把沙箱隔离打开。
  2. 四种常见审批档位按风险递增:plan(只读规划)、default(读写与命令均确认)、auto_edit(改文件免确认、跑命令仍确认)、yolo(跳过全部确认)。切忌在无沙箱的宿主机直接跑 --yolo。
  3. 开启沙箱有三种入口:单次启动加 -s / --sandbox,环境变量设 GEMINI_SANDBOX=true,或在 settings.json 里常驻开启;越界读写或联网会触发动态扩展审批。
  4. 防读取敏感文件靠 .geminiignore:在仓库根目录建 .geminiignore 写入 .env、.pem 等匹配规则,并确认配置项 respectGeminiIgnore 为开启状态。
  5. 谷歌账号准备与多工具订阅入口:使用 Gemini、Google AI Studio 与 Antigravity 需具备符合地区与年龄要求的个人谷歌账号,缺号可查看本站 谷歌账号购买说明(含带 2FA 的 谷歌邮箱成品号),跨平台付费订阅总览见 AI 会员充值中心。

CLI 工具审批模式与沙箱风险对比

图:本站根据 Gemini CLI 命令速查页 与 Antigravity 权限文档 整理的示意图

本文根据 Google Antigravity CLI 与 Gemini CLI 官方文档整理,资料核对于 2026-11-18。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 Google 官方网站。

适用于谁

  • 嫌终端智能体每次改文件、跑单测都要停下来等按回车确认,想安全提速的开发者;
  • 需要开启自动执行(如 auto_edit 或 yolo),但担心脚本误改工作区外目录或乱连外网的人;
  • 项目根目录有 .env、证书私钥、本地数据库文件,不想被 CLI 扫描塞进上下文的人。

一、工具审批模式(Approval Mode)怎么选、怎么配

默认情况下,无论是 Antigravity CLI(agy)还是仍面向企业与付费 API Key 提供的 gemini 命令行(两代工具过渡背景见 Gemini CLI 与 Antigravity CLI 说明),在修改本地文件或执行终端命令前都会暂停等待人工确认。按官方文档,审批策略主要分四档:

模式名称启动参数写法文件修改行为终端命令行为适用场景
默认模式--approval-mode=default每次询问每次询问初次接手陌生仓库、操作线上配置脚本
只读规划--approval-mode=plan禁止直接写盘仅做只读检索分析大型重构前先让智能体出方案,审完再动手
自动改稿--approval-mode=auto_edit自动放行修改执行命令前仍询问高频写业务代码,既省点确认又能拦住危险命令
全自动(YOLO)--approval-mode=yolo 或 --yolo自动放行修改自动执行全部命令仅限开启了系统沙箱或运行在一次性隔离容器内

在 Antigravity 统一权限设置中,这些档位也对应 request-review(逐条审批)、proceed-in-sandbox(沙箱内自动放行)和 always-proceed(无沙箱全放行)。如果想把常用档位固定下来,可在配置文件(Antigravity CLI 为 ~/.gemini/antigravity-cli/settings.json,原 Gemini CLI 为 ~/.gemini/settings.json)中设置默认审批项,启动 agy --help 可核对当前版本支持的完整标志名。

二、终端沙箱(Sandbox)的三种开启方式与越界审批

开启自动执行前,必须给终端命令套上沙箱。按官方沙箱文档,底层隔离并非简单的字符串过滤,而是优先调用操作系统原生隔离机制(macOS 使用 sandbox-exec Seatbelt,Linux 使用内核命名空间 Namespaces,Windows 使用系统容器边界),也支持指定 Docker 或 Podman 容器作为沙箱后端。

常用的三种开启方式如下:

  1. 命令行临时开启:启动时附带 -s 或 --sandbox,例如在非交互自动化脚本中执行:
bash
# 以沙箱隔离方式运行单次任务
agy --sandbox
# 原 Gemini CLI 非交互沙箱执行写法
gemini --sandbox -p "运行当前仓库的单元测试并汇总报错"
  1. 环境变量指定后端:在当前终端会话中设置 GEMINI_SANDBOX=true(若需强制走容器隔离,可设为 docker 或 podman)。
  2. settings.json 常驻开启:在配置文件中写入沙箱与文件过滤开关,避免每次手敲参数:
json
{
  "general": {
    "defaultApprovalMode": "auto_edit"
  },
  "tools": {
    "sandbox": true
  },
  "context": {
    "fileFiltering": {
      "respectGeminiIgnore": true
    }
  }
}

当沙箱内的命令试图修改工作区以外的本机路径(如 ~/.ssh)或发起未授权的外网请求(如 npm install 拉包)时,进程会被拦下并触发沙箱扩展请求(Sandbox Expansion Request),由你当场决定单次放行还是拒绝。如果你想对比其他主流终端工具的沙箱机制,可参考 Claude Code 沙箱安全边界说明 与 Codex 权限与沙箱设置指南。

自动执行与敏感文件保护怎么选

图:本站根据 Antigravity 沙箱文档 与 Gemini CLI 文档 整理的示意图

三、用 .geminiignore 屏蔽 .env 与敏感目录

很多开发者以为加进 .gitignore 就够了,但在未初始化 Git 的子目录或某些不想让 AI 看到、却需要留在仓库里的配置场景下,应当在项目根目录单独建一份 .geminiignore。它的语法与 .gitignore 一致:

gitignore
# 环境变量与密钥凭证
.env
.env.*
*.pem
*.key
secrets/

# 本地数据库快照与大体积构建产物
*.sqlite
dist/
coverage/

配置后务必分清两条安全边界:.geminiignore 管的是智能体内置的文件搜索、目录遍历与上下文读取工具,防止密钥在提问时被自动打包上传;而操作系统沙箱管的是终端派生的 Shell 子进程。如果既没开沙箱、又切到了 yolo 模式,一段拼接出来的 cat .env 脚本依然可能绕开忽略列表直接读盘。编辑器端同类忽略文件的写法也可对照 Cursor 隐私模式与 .cursorignore 配置。若开发测试还需要单独准备合规的个人谷歌账号,可查看 谷歌账号开通说明 或浏览 AI 会员充值总览。

常见问题

问:.geminiignore 建好了但智能体还是读到了里面的文件怎么办?

答:先检查文件是否放在启动终端的工作区根目录且文件名拼写无误(开头带英文句点),再核查 settings.json 里的 context.fileFiltering.respectGeminiIgnore 是否被设成了 false;改完配置后重开一次终端会话再验证。

问:开启 --sandbox 后执行 git commit 报锁文件或签名密钥无权限怎么办?

答:沙箱默认封锁 .git 外部配置目录及 ~/.gnupg、~/.ssh 私钥目录。建议让智能体只负责改代码和跑单测,最终的 git commit 与 git push 回到你自己的普通宿主机终端手动执行。

问:什么时候才能安全使用 --yolo 全自动模式?

答:官方与安全实践都只建议在「已开启容器级沙箱」或「用完即销毁的云端开发容器 / 空白测试虚拟机」中使用,不要在存有个人资料与生产凭证的日常本机目录直接裸跑。

问:没有可用的个人谷歌账号,或者同时想开其他主流 AI 会员怎么办?

答:本站提供即买即发的 谷歌邮箱成品号(登录方法见 谷歌账号购买页),同时支持支付宝、微信支付与 AlipayHK 自助充值 ChatGPT Plus、Claude Code 等主流服务,实时价格与质保细则以各商品页说明为准。

相关教程

参考资料

  • Antigravity 官方文档:CLI Reference — https://antigravity.google/docs/cli/reference
  • Antigravity 官方文档:Terminal Sandbox — https://antigravity.google/docs/sandbox
  • Antigravity 官方文档:Agent Permissions & Security — https://antigravity.google/docs/permissions
  • Gemini CLI 官方文档:CLI Reference — https://geminicli.com/docs/cli/cli-reference

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 条评论

登录 后参与评论

还没有评论,来抢沙发~