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 條評論

登入 後參與評論

還沒有評論,來搶沙發~