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 就假設不可修改。真正要檢查的是工作區寫入規則是否涵蓋:
.claude/settings.json;.claude/內的 Hooks 與 Skills;- 使用者層或本地層設定檔;
- 會在下一次會話重新載入的指令或腳本。
較穩妥的分工是:業務設定留在專案;禁止取消沙箱、禁止忽略失敗、禁止擴大寫入範圍等規則,移至 Agent 無法寫入的 managed settings 或進程外控制層。
設定合併不是單一 JSON 覆蓋:先查生效來源
多層設定的風險不只在優先級,還在合併方式。managed、使用者、專案與本地設定可能共同影響最後結果;某些陣列型規則也不能簡化理解為「後載入的檔案完全覆蓋前一個檔案」。尤其是 allowWrite 一類範圍,若只打開一個 JSON 檔案閱讀,可能漏掉另一層帶來的有效路徑。
官方除配置文件外,也提供除錯設定的指引。在交付前,應按以下順序核對:
- 用
/status確認目前會話、權限與沙箱狀態; - 用
/permissions查看實際允許、拒絕及詢問規則; - 用
/doctor找出設定格式、載入或環境問題; - 分別修改一個測試規則,再觀察生效結果,而不是只比較檔案文字;
- 將檢查結果保存到交付紀錄,避免下一次更新後無法判斷是哪一層改變。
managed settings 和專案設定哪個更安全?
對抗 Agent 自身修改時,managed settings 更安全,因為它的目的就是把管理者政策與專案工作流分開。專案設定仍有價值,但應被視為可協作、可審查、可變更的層,而不是防篡改層。
這裡不需要把所有 allowWrite 教學重做一次。重點只有一個:先確定哪一層能寫入、哪一層最終生效,再決定規則應該放在哪裡。
提醒:「設定優先級最高」不等於「設定檔不能被修改」。優先級回答衝突時採用哪條規則;檔案權限才回答誰能改寫規則本身。
沙箱不可用時停止,不能默認回退到普通權限
防篡改方案常見三種失效情況:
- 沙箱初始化失敗,任務直接中止;
- 沙箱初始化失敗,流程回退到沒有同等隔離的普通命令路徑;
- 操作者或自動流程明確使用非沙箱執行入口。
第二、第三種尤其容易被忽略。策略檔案可能完全沒有被改動,但任務已經在不受隔離的狀態下執行,因此原本的安全假設仍然失效。
對無人值守任務,較合理的判斷是:
- 沙箱不可用時直接失敗,不把「繼續完成任務」放在「維持隔離」之前;
- 不開放
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 租用環境完成隔離驗證,通常比直接把一套未驗證的規則推進生產更穩妥。