Claude Code 命令被攔不知道哪條規則生效怎麼辦:/permissions 查看規則來源與沙箱網絡白名單排錯

在 settings.json 寫了 allow 卻還是被拒或一直彈確認?本文按官方文檔講清用 /permissions 反查規則來自哪層設定文件、複合命令通配符失配原因,以及區分操作系統沙箱網絡白名單(allowedDomains)與鉤子攔截。

NNathaniel bigo··原創首發·AI 輔助撰寫
11 分鐘讀完
資料核對於 2026-11-18 · 依據官方文檔與公開資料整理 Plus 帳號

結論先說

  1. 查「誰攔了我」第一步永遠是敲 /permissions:面板會把合併後的生效規則按 Allow、Ask、Deny 分類列出,並在每條規則旁標明它來自哪一層配置文件。
  2. deny 跨所有層級一票否決:判定順序永遠是 deny → ask → allow。哪怕你在本地 .claude/settings.local.json 寫了 allow,只要用戶全局 ~/.claude/settings.json 或企業託管配置裏有一條匹配的 deny,照樣會被攔死。
  3. 帶 && 或管道的複合命令要求「每一段」都被放行:只寫了 Bash(npm test *) 時,如果模型拼出 cd frontend && npm test,因為 cd 沒在白名單裏,整條命令仍會退回彈窗詢問。
  4. 報只讀文件系統或裝包聯網超時,多半是 /sandbox 沙箱攔的:應用層 /permissions 不管子進程底層聯網,Shell 里拉包被拒要去 sandbox.network.allowedDomains 加域名白名單。
  5. Claude Code 訂閱與高配額開通入口:國內無境外卡可通過本站 iOS 免上號自助卡密開通 Claude Pro 會員 或 5 倍以上額度的 Claude Max 會員,完整檔位選型見 Claude Code 訂閱說明頁。

命令或聯網被攔:四層攔截源定位

圖:本站根據 Claude Code 官方文檔:Configure permissions 與《Sandboxing》整理的示意圖

本文根據 Claude Code 官方文檔《Configure permissions》《Configure the sandboxed Bash tool》《Settings》整理,資料核對於 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 Anthropic 官方網站。

適用於誰

  • 搜「claude code permissions 排查」「claude code 命令被攔截」,明明在項目配置裏加了放行規則,命令卻還是被直接拒絕或反覆彈窗的人;
  • 拉下團隊倉庫後發現某些目錄讀不了、連不上私有 npm 源,分不清到底是哪份 settings.json、系統沙箱還是鉤子在攔路的開發者;
  • 在 Windows 上配了一條 Bash 拒絕規則後,突然發現 PowerShell 工具消失不見的人。

如果你還沒了解過六種基礎模式或想減少日常確認彈窗,可先看 Claude Code 權限模式詳解 與 別讓 Claude Code 一直問你能不能執行,本文專注解決規則衝突與被攔溯源。

一、第一步:用 /permissions 反查規則來自哪份文件

Claude Code 啟動時會同時合併五處配置的權限數組(文件具體路徑見 Claude Code settings.json 配置詳解)。自己手改單個 JSON 很容易漏看別的層:

五層設定文件與規則優先級對照

圖:本站根據 Claude Code 官方文檔:Settings 整理的示意圖

在交互會話裏輸入 /permissions 打開管理面板:

  1. 按方向鍵切到 Deny(拒絕) 或 Ask(詢問) 標籤頁;
  2. 找到疑似攔住當前工具的條目,看右側括號裏的來源標識——顯示 (local) 代表在 .claude/settings.local.json(通常是以前彈窗誤點過儲存留下的),顯示 (project) 代表在團隊提交的 .claude/settings.json,顯示 (user) 代表在 ~/.claude/settings.json,顯示 (managed) 則是由公司 IT 統一下發鎖定、個人無法刪除;
  3. 對個人誤加的 (local) 或 (user) 規則,直接在面板裏選中按提示刪除即可當場生效。

二、第二步:排查三條最隱蔽的通配符失配細節

如果 Deny 里根本沒東西,但你寫的 allow 規則就是匹配不上,逐條核對以下三個語法坑:

  1. 複合命令與參數前綴變形:Bash(git push *) 只匹配以 git push 開頭的簡單命令;如果模型加了全局參數寫成 git -C ./app push,前綴變成了 git -C,規則就會失效。同理,&&、; 或管道 | 連接的多段命令,必須每一段子命令都命中 allow 才能免確認直通。
  2. Read 拒絕規則會連坐封鎖 Edit 和 Write:官方明確說明,如果你為了省上下文寫了 Read(./config/**) 放進 deny,Claude 對該目錄下任何文件的修改和新建也會同步被拒。
  3. Windows 路徑格式與 PowerShell 自動停用:
  • 在權限規則裏寫 Windows 盤符路徑時,底層會先轉成 POSIX 風格再匹配,例如攔整個 D 盤下的密鑰應寫 Read(//d/**/.env) 而不是反斜槓;
  • 在裝了 Git Bash 的 Windows 電腦上,只要你在配置裏寫了哪怕一條 Bash(...) 的 deny 規則,Claude Code 為防止模型換用另一個 Shell 繞過限制,會自動悄悄關閉原生 PowerShell 工具。解決辦法是給 PowerShell 補上對等的拒絕規則(如 PowerShell(git push *)),或在環境變量裏顯式設 CLAUDE_CODE_USE_POWERSHELL_TOOL=1。

三、第三步:分清是不是 /sandbox 網絡白名單或鉤子攔的

有時 /permissions 面板乾乾淨淨,命令跑出去卻報 Operation not permitted、Read-only file system,或者 npm install、curl、gh pr list 全部連接被拒。這說明攔截髮生在操作系統沙箱層(原理見 Claude Code 沙箱(sandbox)是什麼)。

開啟沙箱後,Shell 命令及子進程沒有直接出網通道,所有請求都經過本機代理按域名白名單過濾。輸入 /sandbox 查看狀態,若確認是網絡被攔,在 .claude/settings.json 或 ~/.claude/settings.json 的 sandbox.network.allowedDomains 裏補上需要的包源和代碼託管域名:

json
{
  "sandbox": {
    "enabled": true,
    "network": {
      "allowedDomains": [
        "github.com",
        "*.githubusercontent.com",
        "registry.npmjs.org",
        "pypi.org",
        "files.pythonhosted.org"
      ]
    }
  }
}

如果既不是權限數組也不是沙箱,報錯裏帶有 Hook 字樣,輸入 /hooks 查看是否有團隊配置的 PreToolUse 腳本返回了退出碼 2 強制攔截。

相比公司電腦受企業 managed-settings.json 嚴格鎖死權限,個人在本機做獨立項目開發時擁有完整的設定文件控制權;需要為個人帳號開通或續期官方訂閱的開發者,可查看本站 Claude Code 訂閱充值頁 或 Claude Pro 方案。

常見問題

問:為什麼我在項目 .claude/settings.json 裏寫了 "defaultMode": "bypassPermissions" 卻完全不生效?

答:這是官方故意設計的安全防線。為防止惡意倉庫通過提交配置文件替打開項目的開發者靜默關掉所有安全檢查,項目級配置裏的 "bypassPermissions" 和 "auto" 預設模式都會被忽略。

問:MCP 工具在 /permissions 裏該怎麼寫整組放行或攔截?

答:寫 mcp__伺服器名 即可代表該 MCP 伺服器下的全部工具,寫 mcp__伺服器名__具體工具名 則精確控制單個工具;注意不要在後面隨便加 :* 通配符。

問:開啟了沙箱,命令寫不了上級兄弟目錄怎麼辦?

答:沙箱預設只允許寫入當前啟動目錄及臨時目錄。確需跨目錄寫入時,啟動加 --add-dir ../shared-lib 或在設定文件的 permissions.additionalDirectories 裏聲明額外工作目錄。

問:國內沒有海外銀行卡,怎麼給 Claude Code 開通 Pro 或 Max 訂閱?

答:可在 Claude Code 訂閱頁 選擇走 iOS 訂閱鏈路的 Claude Pro 自助卡密 或 Claude Max 充值,支持支付寶、微信支付與 AlipayHK,無需交出帳號密碼;若帳號彈出身份核驗也可查看 Claude KYC 認證人工協助(失敗不收費,封號不在質保範圍)。

相關教學

參考資料

  • Claude Code 官方文檔:Configure permissions — https://code.claude.com/docs/en/permissions
  • Claude Code 官方文檔:Configure the sandboxed Bash tool — https://code.claude.com/docs/en/sandboxing
  • Claude Code 官方文檔:Settings — https://code.claude.com/docs/en/settings

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

    Anthropic Contextual Retrieval(上下文增強檢索)是什麼、怎麼實現:給文檔塊自動補背景摘要結合緩存降失誤率

    長文檔切成小塊後丟了公司名、年份和主語指代導致 RAG 頻頻搜錯?本文按 Anthropic 官方技術文章詳解 Contextual Retrieval 原理、官方公開評測失誤率下降 49% 至 67% 的組合架構,以及用 Claude 提示詞緩存低成本批量生成切片背景的完整 Python 代碼。

    Claude其他 AI 工具0
  2. 02

    RAG 知識庫回答不準怎麼調優:切片大小(Chunking)、BM25 + 向量混合檢索與 Rerank 重排序三步排查法

    搭好的 RAG 企業知識庫一問具體型號、報錯碼或跨行表格就答非所問?本文按 OpenAI 與 Anthropic 官方檢索文檔,給出先隔離檢索與生成故障、再按結構化切片(Chunking)、BM25 加向量混合召回(RRF)與 Rerank 重排序逐層調優的三步法。

    Claude其他 AI 工具0
  3. 03

    Langfuse 開源本地部署(Docker Compose)與提示詞版本管理(Prompt Management)從零上手教學

    企業內網嚴禁業務日誌出境,又想免費擁有大模型調用鏈追蹤與不發版熱更新提示詞的能力?本文按 Langfuse 官方文檔整理 Docker Compose 本地一鍵啟動(含 ClickHouse 架構注意事項)、密鑰配置與 Prompt Management 標籤化版本管理全流程。

    Claude其他 AI 工具0
  4. 04

    LangSmith 入門教學:給 LangGraph 與原生 OpenAI / Claude 接口加調用鏈追蹤、Token 成本統計與免費層限額

    智能體多步調用總是找不到哪一輪提示詞跑偏、單次請求到底燒了多少 Token?本文按 LangSmith 官方文檔講清環境變量零侵入接入 LangGraph、用 wrap_openai / wrap_anthropic 與 @traceable 追蹤原生接口,以及 Developer 免費層額度與留存規則。

    Claude其他 AI 工具0
  5. 05

    Zotero 搭配 Claude / ChatGPT 高效讀英文文獻:PDF 翻譯插件、批註導出精讀與防捏造參考文獻流程

    在 Zotero 裏讀英文頂會論文怎麼無縫聯動 Claude 與 ChatGPT?本文整理 Translate for Zotero 劃詞翻譯配置、高亮批註導出精讀提示詞,以及杜絕 AI 捏造假 DOI 參考文獻的核驗閉環。

    Claude其他 AI 工具0
  6. 06

    Obsidian 接入 Claude、ChatGPT 與本地 Ollama 做個人雙鏈筆記問答:主流插件配置與私隱脫敏邊界

    想在 Obsidian 裏基於自己的雙鏈筆記庫做 AI 問答又擔心私隱外泄?本文對比 Copilot 與 Smart Connections 插件,整理接入 Claude、OpenAI 官方 API 與本地 Ollama 的步驟及敏感目錄隔離規則。

    Claude其他 AI 工具0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~