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

登入 後參與評論

還沒有評論,來搶沙發~