資安

2026 Claude Code 哪些任務不能只靠 macOS Sandbox?

Apple 的 sandbox-exec 手冊已標示為 Deprecated,但目前 macOS 仍可使用這項 Seatbelt 入口;這個現況不代表它適合承擔所有 Claude Code 任務的長期安全責任。Apple 的 sandbox-exec 手冊頁可作為狀態核對依據。

因此,Claude Code macOS Sandbox 的獲勝條件是「受監督、可信任程式碼、只需工作區內修改」;只要任務包含 MCP、Hooks、無人值守執行或陌生程式碼,就不應只限制 Bash,而應升級至 Sandbox Runtime、開發容器或獨立虛擬化 Mac。手寫 SBPL 可以用於實驗和局部補強,但不宜成為團隊唯一的長期基線。

這篇文章適合:

  • 個人開發者:需要判斷日常 Claude Code 任務是否值得遷出主力 Mac。
  • DevSecOps 工程師:需要找出內置 Bash 沙箱未覆蓋的程序與憑證風險。
  • 研發平台負責人:需要替不同團隊訂立本機執行與獨立環境的分流標準。

最後更新於 2026 年 9 月 9 日;Claude Code 的沙箱行為核對自 官方 CLI 文件,Apple 平台狀態核對自 Apple Virtualization 文件 與 Apple Developer 資料。

先按任務風險分流,而不是按工具名稱選擇

Claude Code 內置 Bash Sandbox 的作用,是利用 macOS Seatbelt 類型的作業系統限制,約束 Bash 命令及其子程序對檔案和網路的存取。它解決的是「這次命令能否碰到某個路徑或網路資源」,不是自動把整個 Claude Code 會話、MCP 伺服器、Hooks 和所有外掛程序包成同一個隔離邊界。

權限提示與作業系統沙箱是兩層控制。使用者批准某個命令,只表示該命令通過互動式授權流程;它不等於命令可以突破作業系統規則,也不等於其他獨立程序會自動繼承相同限制。對日常建置與測試而言,這種分層已可能足夠;對自動化代理而言,則必須檢查整棵程序樹。

任務情境 本機 Claude Code macOS Sandbox 更合適的隔離選擇 主要判斷理由
可信任儲存庫、有人即時審閱 可作為起點 通常不必立即遷移 修改集中於工作區,操作者能即時拒絕異常命令
使用 MCP 或 Hooks 不宜只靠 Bash 限制 評估 Sandbox Runtime 或外層隔離 擴充程序可能接觸憑證、網路及外部服務
長時間或無人值守執行 不足以作為唯一防線 Sandbox Runtime、容器或虛擬機 沒有人在提示出現時判斷批准與否
陌生倉庫、安裝腳本、第三方依賴 不建議放在主力 Mac 可重置虛擬機或獨立 Mac 程式碼來源、安裝鏈及提示注入風險均較難預先界定

第一步:把受監督的日常開發留在本機

若程式碼來自團隊已審核的儲存庫,開發者全程在線,工作內容主要是編譯、測試、重構和工作區內檔案修改,本機沙箱通常是成本最低且足夠清楚的起點。這裡的「足夠」有明確條件:可寫目錄已限於專案,敏感憑證未直接放在工作區,網路存取需求也在團隊預期內。

Claude Code 內置沙箱能限制 MCP 和 Hooks 嗎?
不能把 Bash 沙箱的規則直接推定為 MCP 與 Hooks 的完整隔離。這些擴充可能由獨立程序啟動,實際能否繼承限制要看啟動方式、程序環境和 Claude Code 當前支援範圍;因此,涉及第三方 MCP 伺服器、檔案索引、瀏覽器自動化或外部 API 時,應以官方文件描述為準,不要只檢查 Bash 命令是否被攔截。Claude Code CLI 的沙箱與權限說明是較穩妥的核對入口。

在本機開始前,可先完成以下檢查:

  • [ ] 工作區不是主力 Mac 的根目錄、家目錄或系統設定目錄。
  • [ ] 測試用憑證是虛構值,正式 API Key 沒有以明文放在專案檔案中。
  • [ ] 開發者會即時閱讀檔案刪除、Git 重設、權限變更和網路連線提示。
  • [ ] 建置工具的快取、輸出目錄和暫存資料不會反向覆蓋其他專案。
  • [ ] 一旦需要 MCP、Hooks 或背景執行,會重新進行隔離層級判斷,而不是沿用原設定。

第二步:遇到擴充程序時,將 Bash 邊界提升為全程序邊界

MCP 與 Hooks 的風險不只在於它們能否寫入專案。它們可能讀取環境變數、使用 SSH Agent、連線外部服務,或把工具輸出交給下一個程序;即使工作區寫入權限已被限制,憑證暴露面和網路出口仍可能存在。

Anthropic 提供的 Sandbox Runtime 是另一個評估方向,其官方儲存庫把它定位為可供代理工作流程採用的沙箱執行環境。Sandbox Runtime 官方儲存庫應用於實際部署前,仍需核對當前支援的作業系統、程序、網路規則和整合方式;不能把它與 macOS sandbox-exec 或手寫 SBPL 當成同一產品層級。

隔離層 主要保護對象 不應假設它自動解決的問題 適用判斷
Claude Code Bash Sandbox Bash 命令及其受限制的檔案、網路存取 MCP、Hooks、外部程序的完整生命週期 受監督的可信任日常開發
手寫 SBPL / sandbox-exec 依規則描述的程序能力與路徑 Deprecated 狀態、規則維護、工具相容性 實驗、研究或局部補強
Sandbox Runtime 較完整的代理執行環境邊界 團隊身分治理、映像交付、所有外部依賴 MCP、Hooks 或多程序工作流程
虛擬化 Mac 獨立作業系統環境與可重置工作區 映像管理、憑證注入、網路出口仍需治理 高風險、不可信或長時間自動化任務

第三步:無人值守時,取消「審批」作為最後防線

Claude Code 無人值守執行需要虛擬機嗎?
不必把所有背景任務一律升級到虛擬機,但只要任務會長時間執行、跳過互動批准、接收外部輸入,或可自行呼叫 MCP 和 Hooks,環境邊界就必須承擔主要防護責任。這時可先比較 Sandbox Runtime、開發容器和虛擬化 Mac;不能只依靠命令白名單、手寫 SBPL,或關閉非沙箱提示。

決策條件可以這樣執行:

  1. 若有人全程審閱、程式碼可信、只修改工作區,則選 Claude Code 內置 macOS Sandbox。
  2. 若加入 MCP、Hooks 或其他會在主機獨立執行的工具,則先評估 Sandbox Runtime;若仍無法明確界定程序與憑證範圍,回退到獨立環境。
  3. 若任務需要無人值守、長時間運行或自動接受外部輸入,則不要把互動審批當成控制項,改用全程序沙箱、容器或虛擬機。
  4. 若程式碼來源未知、包含安裝腳本或需要建置第三方依賴,則移離主力 Mac,優先使用可重置的虛擬化 Mac 或一次性環境。
  5. 若團隊無法統一可寫目錄、網路出口、憑證注入和失敗後重置流程,則不要把手寫 SBPL 當成正式基線,先建立標準化環境。

第四步:陌生倉庫先隔離,再決定是否交給 Agent

陌生程式碼倉庫能否直接交給 Claude Code 修改?
技術上可以,但不應直接在主力 Mac 內執行安裝腳本、依賴下載和建置命令。風險不只來自程式碼本身,也包括套件安裝鏈、生成檔案、環境變數、提示注入內容,以及為了讓建置成功而臨時放寬的檔案和網路權限。

主機級輕量沙箱仍面對三個現實限制:

  • 專案目錄通常必須可寫,惡意或錯誤流程可能在允許範圍內破壞測試資料。
  • 建置常需要網路、編譯器、套件管理器及系統工具;限制越細,工具相容性越難維持。
  • 即使檔案存取受限,主機上的 SSH Agent、API Key、瀏覽器登入狀態或其他服務仍可能成為高價值目標。

因此,陌生倉庫較適合一次性虛擬機、可重置的獨立 Mac 或其他完整作業系統隔離。Apple 的 Virtualization framework 文件和 Hypervisor 文件可用於評估虛擬化環境的技術路線;它們不等於現成的團隊治理方案,映像、更新、網路出口和憑證清理仍需另行設計。

sandbox-exec 和 Sandbox Runtime 有什麼區別?
sandbox-exec 是 macOS 上使用 SBPL 描述限制的舊式入口,Apple 已標示 Deprecated,且 SBPL 並非面向第三方產品承諾長期穩定的公開介面。Apple Developer Forum 的相關說明可作為支援狀態的交叉參考。Sandbox Runtime 則是代理工作流程的較高層環境方案;兩者在維護責任、程序覆蓋範圍和未來相容性上不能互換。

第五步:把個人選擇轉成團隊強制策略

個人開發者可以按任務臨時切換隔離層;團隊則需要把「誰能自行放寬規則」視為治理問題。托管設定可約束內置沙箱的使用方式,但虛擬機或標準化環境還需要裝置管理、映像版本、交付流程和回收流程配合。Apple 的 App Sandbox 文件有助於理解平台能力,但不能直接當作 Claude Code 全部擴充程序的安全承諾。

可按團隊型態採用不同起點:

  • 小型團隊:可信任儲存庫留在本機;MCP、Hooks 和陌生倉庫統一遷入可重置環境,先管理憑證與網路出口。
  • 受監管團隊:要求固定環境映像、最小權限憑證、可追蹤工作紀錄和失敗後重置,禁止以個人手寫 SBPL 取代集中政策。
  • 集中式 AI Agent 平台:把工作區、工具程序、MCP 伺服器和秘密注入拆開治理,為高風險任務提供獨立虛擬化 Mac,而不是讓所有代理共用同一台主機。

最後一步:用遷移清單決定是否離開主力 Mac

在實際遷移前,建議逐項勾選;只要任一高風險條件成立,就先搬移該類任務,而不是一次重建全部開發流程。

  • [ ] 任務是否需要 MCP、Hooks 或其他獨立程序?
  • [ ] 是否會讀取正式憑證、SSH Agent、瀏覽器登入狀態或內部 API?
  • [ ] 是否可能在無人監督下長時間執行?
  • [ ] 程式碼是否來自陌生來源,或包含安裝腳本與第三方依賴?
  • [ ] 工作區是否能在任務結束後完整重置?
  • [ ] 網路出口是否可限制並留下可追蹤紀錄?
  • [ ] 團隊是否能統一設定來源,而不是由每位開發者自行編寫 SBPL?
  • [ ] 出現相容性問題時,是否有可回退的 Sandbox Runtime、容器或獨立 Mac?

如果前四項都沒有勾選,本機 Claude Code macOS Sandbox 通常可先承擔日常建置與測試;若勾選了程序、無人值守或來源不可信其中一項,就應至少評估全程序沙箱;若同時涉及正式憑證、陌生依賴和不可即時審閱,獨立虛擬化 Mac 會是更清楚的邊界。

把所有任務留在主力 Mac,優點是檔案存取直接、工具鏈熟悉,但缺點也很具體:工作區與私人資料共存、主機憑證暴露面較大,而且每次臨時放寬規則都可能留下難以稽核的例外。相較之下,租賃 KuzCloud 的 Mac 環境可把高風險任務從日常工作機分開,讓隔離、重置和交付流程更容易按任務安排;它不會取代團隊的 SBPL、憑證和網路政策,但對需要臨時測試陌生倉庫、MCP 或無人值守流程的情況,通常比在主力 Mac 上反覆放寬限制更合適。需要查看環境入口與交付選項時,可先參考 KuzCloud 的 Mac 環境說明,再按上述清單逐項遷移最高風險任務。

若要直接建立或管理隔離用的 Mac 工作環境,可前往 KuzCloud 控制台;長期重負載、需要實體介面或必須完全掌控硬體的團隊,則仍應評估自購 Mac,而不是把租賃環境當成所有場景的唯一答案。

高風險開發任務,交由 KuzCloud 遠端 Mac 處理

當任務涉及未知程式碼、敏感資料或高權限操作,使用獨立遠端環境可降低對本機工作站的影響。

KuzCloud 提供可遠端連線的 Mac,讓您在隔離環境中執行開發、測試與自動化流程。