715 字
4 分鐘
Claude Code 2.1.326 升級後 Bash 被擋?核對權限、Hook 與 Sandbox
本文目錄
升到 Claude Code 2.1.326 後,原本能跑的 Bash 命令如果開始詢問核准,先記下命令有沒有真的啟動,以及第一筆拒絕出現在哪裡。2.1.326 同時改了核准、hook 與沙箱寫入。這三處發生的拒絕,都可能讓同一個建置任務停在 Bash。Anthropic 2.1.326 更新日誌
命令開始前就停下
- 看到核准提示時,記下目前 permission mode、待核准的命令,以及這份設定來自專案、使用者還是組織政策。新版在 macOS 會對部分原先可執行的 Bash 命令詢問或拒絕,部分工具呼叫即使原本使用 bypass permissions 也可能要求核准。無人值守的腳本要用原來的執行入口驗收,因為互動環境出現提示時仍有操作者可以回應。
- 看到 hook 的阻擋理由時,找出觸發事件及生效的 hook 來源。新版會在更多情況採用 hook 回傳的
"decision": "block"。如果 hook 原本對每個輸入都輸出 block,先用一個允許案例和一個應攔下的測試案例確認條件是否寫太寬。 - 啟動時看到規則格式警告時,先查腳本實際傳入的
--allowedTools、--disallowedTools或--tools。2.1.326 會在遇到看起來不完整的項目時警告。把警告與該次目標命令的核准結果分開記錄。
權限模式與無人值守入口的設定可對照Claude Code 自動化權限檢查表。如果問題是 hook 回傳格式,再對照 PreToolUse 攔截範例。
命令已啟動,寫檔時才失敗
先從錯誤訊息找出第一個寫不進去的路徑。建置工具的輸出可能在儲存庫裡,快取或狀態卻寫在家目錄。用 /sandbox 確認隔離有啟用,再看 Config 裡的 Denied within allowed。2.1.326 在 macOS、Linux 和 WSL 收緊了部分家目錄的預設寫入範圍。發行說明未逐項列出受影響的資料夾,應以當前環境的設定和拒絕訊息核對。Anthropic 沙箱文件
如果工具支援指定快取路徑,先讓它寫入工作目錄或使用者的暫存目錄,再用同一條命令確認。確實需要寫到外部資料夾時,由管理該環境的人依文件檢查 user 或 managed settings 的 sandbox.filesystem.allowWrite,只涵蓋工作需要的路徑。沙箱的內建受保護路徑仍有自己的限制。
驗收時保留兩個結果。第一個是原本的無害工作能順利完成,第二個是同一套 hook 或沙箱仍能攔下預期應被拒絕的測試操作。本文依 2.1.326 發行說明與沙箱文件整理診斷順序,未執行新版 Bash 寫入或套用權限設定。
參考資料:
Claude Code 2.1.326 升級後 Bash 被擋?核對權限、Hook 與 Sandbox
https://laplusda.com/posts/claude-code-2-1-326-bash-permission-diagnosis/