Security

2026 Claude Code 配置會被 Agent 改寫嗎?SBPL 防篡改

2026 Claude Code 配置會被 Agent 改寫嗎?SBPL 防篡改

Claude Code 配置防篡改的獲勝方案是:受監督的個人工作可用 denyWrite 加上失敗關閉;團隊或無人值守任務應把核心規則移到 managed settings,必要時再以 SBPL 包住整個 Claude Code 進程,高風險工作則改用獨立 Mac 環境。不要把 Agent 可寫的專案設定當成最後一道安全邊界。

最後更新於 2026 年 9 月 15 日;字段、優先級與沙箱行為已對照Claude Code 權限文件、設定文件、沙箱文件及 Anthropic 的 Sandbox Runtime 儲存庫核實。

這篇適合三類讀者:把 .claude/settings.json 放在專案倉庫、並允許 Claude Code 自動編輯檔案的開發者;需要防止團隊規則被專案設定削弱的 DevSecOps 工程師;以及準備在遠端 Mac 長期執行終端 Agent 的平台負責人。

先看邊界:定義權限的檔案也能被 Agent 寫入

最危險的失效模型不是「Agent 不懂某個指令」,而是 Agent 與定義其權限的檔案位於同一個可寫目錄。假設工作區允許修改 .claude/,Agent 便可能嘗試調整設定、Hooks、Skills 或其他會影響後續會話的檔案。這只是威脅模型,不代表目前版本必然存在可利用漏洞;開發者 Issue 應只視為個案線索,仍要按實際版本與平台重現。

Claude Code 的 Edit、Write 和 Bash 並不是同一層控制:

  • Edit、Write 直接涉及檔案修改,受權限規則與工作區邊界影響。
  • Bash 會啟動命令及其子進程;官方 Bash Sandbox 主要約束這條執行路徑。
  • Claude Code 本體、設定載入流程和 Agent 會話,不會因為某個 Bash 命令受限,就自動等於整個進程已被鎖定。
  • Sandbox Runtime、Seatbelt、sandbox-exec 和手寫 SBPL 是不同層次,不能用「已開啟沙箱」四個字概括。

因此,專案設定可以承載業務偏好,但不適合承載「不可繞過的安全底線」。

專案設定方便協作,managed settings 才適合承載底線

.claude/settings.json 和本地設定很適合保存團隊工作流、測試中的 Hook 或專案特有的允許路徑。問題在於:它們通常與程式碼同處一個工作區,也可能受到 Agent 寫入權限影響。

Claude Code 配置優先級中,官方文件確認 managed settings 位於最高層級。這對策略自保的意義是:安全規則不應只放在 Agent 能編輯的專案檔案內。denyWrite、failIfUnavailable 和 allowUnsandboxedCommands 等控制項,應由平台或管理流程下發,再以實際版本文件核對字段名稱及預設行為。

Claude Code 能修改自己的 settings.json 嗎?

若該檔案所在位置對目前進程可寫,不能只因它叫 settings.json 就假設不可修改。真正要檢查的是工作區寫入規則是否涵蓋:

  1. .claude/settings.json;
  2. .claude/ 內的 Hooks 與 Skills;
  3. 使用者層或本地層設定檔;
  4. 會在下一次會話重新載入的指令或腳本。

較穩妥的分工是:業務設定留在專案;禁止取消沙箱、禁止忽略失敗、禁止擴大寫入範圍等規則,移至 Agent 無法寫入的 managed settings 或進程外控制層。

設定合併不是單一 JSON 覆蓋:先查生效來源

多層設定的風險不只在優先級,還在合併方式。managed、使用者、專案與本地設定可能共同影響最後結果;某些陣列型規則也不能簡化理解為「後載入的檔案完全覆蓋前一個檔案」。尤其是 allowWrite 一類範圍,若只打開一個 JSON 檔案閱讀,可能漏掉另一層帶來的有效路徑。

官方除配置文件外,也提供除錯設定的指引。在交付前,應按以下順序核對:

  • 用 /status 確認目前會話、權限與沙箱狀態;
  • 用 /permissions 查看實際允許、拒絕及詢問規則;
  • 用 /doctor 找出設定格式、載入或環境問題;
  • 分別修改一個測試規則,再觀察生效結果,而不是只比較檔案文字;
  • 將檢查結果保存到交付紀錄,避免下一次更新後無法判斷是哪一層改變。

managed settings 和專案設定哪個更安全?

對抗 Agent 自身修改時,managed settings 更安全,因為它的目的就是把管理者政策與專案工作流分開。專案設定仍有價值,但應被視為可協作、可審查、可變更的層,而不是防篡改層。

這裡不需要把所有 allowWrite 教學重做一次。重點只有一個:先確定哪一層能寫入、哪一層最終生效,再決定規則應該放在哪裡。

提醒:「設定優先級最高」不等於「設定檔不能被修改」。優先級回答衝突時採用哪條規則;檔案權限才回答誰能改寫規則本身。

沙箱不可用時停止,不能默認回退到普通權限

防篡改方案常見三種失效情況:

  1. 沙箱初始化失敗,任務直接中止;
  2. 沙箱初始化失敗,流程回退到沒有同等隔離的普通命令路徑;
  3. 操作者或自動流程明確使用非沙箱執行入口。

第二、第三種尤其容易被忽略。策略檔案可能完全沒有被改動,但任務已經在不受隔離的狀態下執行,因此原本的安全假設仍然失效。

對無人值守任務,較合理的判斷是:

  • 沙箱不可用時直接失敗,不把「繼續完成任務」放在「維持隔離」之前;
  • 不開放 allowUnsandboxedCommands 作為方便的逃生口,除非該例外有明確範圍、審批和記錄;
  • 不為了讓某個命令通過,就隨意擴大排除清單;
  • 先按當前官方文件核對字段、預設行為與版本差異,再部署到自動化工作。

這裡不能自行假定某個字段的預設值。Claude Code 更新沙箱機制後,必須重新查閱官方沙箱說明。

SBPL 保護整個進程,但不要把已棄用介面當長期承諾

SBPL 能否限制整個 Claude Code 進程的寫權限?

可以把 Claude Code 作為被 sandbox-exec 啟動的進程,讓手寫 SBPL 從進程外約束 Claude Code 本體及其子進程可寫入的位置。這和官方 Bash Sandbox 的層級不同:後者主要限制 Bash 及子進程;前者嘗試把整個啟動樹放入 Seatbelt 政策。

不過,Apple 的 sandbox-exec 已被標記為 Deprecated。它在目前 macOS 環境仍可能被呼叫,並不代表 Apple 對其提供長期支援或未來相容性承諾。Xcode man page 的說明與Sandbox 機制文件都應列入版本升級檢查。Anthropic Sandbox Runtime 公開儲存庫亦確認其 macOS 實作涉及 sandbox-exec 與自訂政策,但不能因此推論該介面永遠不會改變。

以下示例只用臨時目錄和虛構檔案驗證寫入邊界,不接觸真實密鑰、系統設定或生產倉庫:

(version 1)

(deny default)

(allow process-fork)
(allow process-exec)
(allow signal)
(allow sysctl-read)

(allow file-read*
    (subpath "/tmp/sbpl-demo"))

(allow file-write*
    (subpath "/tmp/sbpl-demo"))

第一步,建立測試目錄及虛構策略檔案:

mkdir -p /tmp/sbpl-demo
printf 'demo-policy\n' > /tmp/sbpl-demo/policy.txt

第二步,把內容保存為只供測試的 /tmp/sbpl-demo/profile.sb。第三步,先用簡單命令驗證:在沙箱內寫入 /tmp/sbpl-demo/result.txt,再嘗試寫入另一個臨時路徑。第四步,確認被拒絕時流程確實返回失敗,而不是繼續以普通權限執行。第五步,才把同一思路包到 Claude Code 的啟動 Alias;若 Claude Code 因啟動所需的執行檔、函式庫或 IPC 權限而失敗,應調整測試政策或停用方案,不應直接加入一個過寬的全域允許規則。

可撤銷的 Alias 思路如下:

alias claude-sbpl='sandbox-exec -f /tmp/sbpl-demo/profile.sb claude'

這個 Alias 不是正式生產設定,也不是對 Claude Code 全功能相容性的保證。它只展示「進程外包裹」的方向。長期方案應評估現代 Virtualization 或獨立 Mac,而不是把 Deprecated 工具當作永久平台承諾。

第一個落地方案:用風險結果決定隔離層

先不要問「哪種沙箱最強」,先問任務出了問題時,策略檔案要如何恢復、誰能修正、環境是否與其他工作獨占。以下表格可作為交付前分流工具:

執行方案 策略檔案落點 防篡改能力 失敗後恢復 適用情況
專案設定 + 受監督執行 專案 .claude/ 低至中;依賴工作區寫入限制 可由開發者檢查 Git 變更 個人、互動式、可即時批准
managed settings + 失敗關閉 管理層,與專案分離 中至高;核心政策不由專案控制 可集中審計及重新下發 團隊共用任務、持續整合
SBPL 包住整個進程 進程外設定檔 高於單純 Bash 限制,但受 Deprecated 介面影響 啟動失敗時需保留診斷流程 需要鎖定工作區外路徑的驗證
獨立 Mac 環境 專用環境及管理層 取決於管理、登入和重建流程 可重建、回收或隔離整個環境 無人值守、高敏感資料、長期 Agent

受監督、團隊與無人值守的取捨

受監督開發可以讓專案策略繼續存在,但要把 .claude/、Hooks 和 Skills 列入變更審查。這種方案的優點是調試快;缺點是人員必須在場,不能把審批假設延伸到夜間任務。

團隊共享任務更適合使用 managed settings,並把失敗關閉設定納入版本化交付。優點是規則可集中維護;缺點是設定更新需要平台流程,不能只提交一個專案檔案。

無人值守 Agent 若同時接觸私密金鑰、外部網路和真實程式碼,應增加全進程隔離,或移到獨立 Mac。獨立環境的價值不在宣稱更快,而在於可分離登入狀態、策略檔案、恢復流程與其他開發者的工作區。若團隊需要先驗證這種落點,可先查看 ProxyMac 的使用說明,再按任務是否無人值守、允許寫入哪些目錄和失敗後如何重建來評估 香港方案。

目前的本機方案若只靠專案設定,缺點是 Agent 可能與策略檔案同處可寫邊界;若只靠 Bash Sandbox,缺點是它不必然代表整個 Claude Code 進程已被包住;若把 sandbox-exec 當成永久基礎設施,缺點則是忽略 Deprecated 狀態和未來相容性。需要長期運行 Claude Code 的團隊,先整理策略檔案位置、任務是否無人值守,以及可寫目錄,再考慮以 ProxyMac 的獨立 Mac 租用環境完成隔離驗證,通常比直接把一套未驗證的規則推進生產更穩妥。

為 Agent 工作配置獨立的遠端 Mac 環境

使用 ProxyMac 遠端 Mac,將自動化開發與日常工作環境清晰分離,降低設定互相影響的風險。
透過獨立 Mac 執行開發、測試與檔案操作,讓專案權限管理更容易規劃。