Claude Code 安全配置清單:deny 拒絕規則、保護 .env 敏感文件與沙箱兜底

搜「claude code 安全 配置」怕它誤讀 .env 密鑰或亂跑危險命令?按官方文檔整理四層縱深配置:permissions.deny 護住文件工具、/sandbox 與 credentials 管住 Shell 子進程、目錄外寫鎖與 PreToolUse 鉤子攔截。

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

結論先說

  1. 單寫一條 Read(./.env) 不夠安全:它只能攔住內置的 Read 工具,如果你放開了未進沙箱的 Bash 命令,子進程跑一句 cat .env 照樣能讀到內容。
  2. 完整的本地安全基線要疊四層:permissions.deny/ask 管內置工具與顯式命令 → blockWritesOutsideWorkingDirectories 鎖死寫範圍 → /sandbox + credentials 隔離 Shell 子進程 → PreToolUse 鉤子做複雜命令硬校驗。
  3. deny 規則在所有設定層裏優先級最高:哪怕項目或自動模式寫了 allow,只要命中任何一層的 deny 就一律拒絕。
  4. 開了沙箱還要關掉「無沙箱重試」:把 sandbox.allowUnsandboxedCommands 設為 false,防止命令在沙箱碰壁後請求脫離沙箱重跑。
  5. 原生 Windows 不支持系統級命令沙箱,重度關注命令隔離的 Windows 用戶官方建議在 WSL2 裏運行 Claude Code。

Claude Code 四層安全防護對照表

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

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

適用於誰

  • 搜「claude code 安全 配置」,不想讓本地 .env、~/.ssh、雲廠商密鑰被模型讀進上下文發往外部的人;
  • 只在 settings.json 寫了 Read(./.env) 就以為高枕無憂,不知道 Bash 命令還能繞過去讀文件的人;
  • 想在少彈煩人確認框的同時,守住「不刪庫、不跨目錄亂寫、不強推主分支」底線的開發者與團隊。

一、第一層:配好 permissions.deny、ask 與目錄外寫鎖

內置的 Read、Edit、Write、WebFetch 工具受 settings.json 裏的權限數組直接管轄(完整權限模式見 Claude Code 權限模式詳解,目錄外寫鎖細節見 禁止寫工作目錄之外的文件)。

建議在全局 ~/.claude/settings.json 或團隊倉庫 .claude/settings.json 中放入以下安全底線模板:

json
{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "blockWritesOutsideWorkingDirectories": true,
  "permissions": {
    "ask": [
      "Bash(git push *)",
      "Bash(git reset --hard *)",
      "Bash(docker rm *)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Edit(./.env)",
      "Edit(./.env.*)",
      "Write(./.env)",
      "Write(./.env.*)",
      "Read(./secrets/**)",
      "Read(**/*.pem)",
      "Read(**/*.key)",
      "Bash(rm -rf /)",
      "Bash(rm -rf ~*)",
      "Bash(curl * | sh)",
      "Bash(curl * | bash)"
    ]
  }
}

這裏用的文件路徑遵循 gitignore 風格的通配語法:把 .env、.env.、.pem、*.key 同時掛上 Read、Edit、Write 拒絕後,Claude 自己調用文件讀寫工具碰這些文件就會當場被拒;把 git push 放進 ask 則保證就算你平時開了自動編輯模式,真正往遠端推代碼前也必須經過你點頭。

二、第二層:開啟 /sandbox 沙箱與 credentials 憑據剝離

常見敏感風險該配哪一項安全規則

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

前面說過,permissions 裏的字符串匹配攔不住千變萬化的 Shell 寫法(比如官方舉例 Bash(git push *) 就匹配不到 git -C . push)。要真正管住 Shell 子進程不偷讀家目錄密鑰、不偷偷往陌生外網傳數據,必須在 macOS、Linux 或 WSL2 下啟用操作系統沙箱(完整原理見 Claude Code 沙箱是什麼、怎麼開):

json
{
  "sandbox": {
    "enabled": true,
    "failIfUnavailable": true,
    "allowUnsandboxedCommands": false,
    "credentials": {
      "files": [
        { "path": "~/.ssh", "mode": "deny" },
        { "path": "~/.aws/credentials", "mode": "deny" },
        { "path": "~/.npmrc", "mode": "deny" }
      ],
      "envVars": [
        { "name": "GITHUB_TOKEN", "mode": "deny" },
        { "name": "NPM_TOKEN", "mode": "deny" },
        { "name": "AWS_SECRET_ACCESS_KEY", "mode": "deny" }
      ]
    }
  }
}

這段配置一次性堵死了三個高頻口子:

  1. credentials.files 與 envVars:沙箱預設可讀磁盤大部分目錄並繼承終端環境變量,加上這兩段後,子進程既讀不到 ~/.ssh 私鑰,也拿不到終端裏導出的高危令牌;
  2. allowUnsandboxedCommands: false:徹底禁止模型在沙箱報錯時帶 dangerouslyDisableSandbox 參數申請裸奔重試;
  3. failIfUnavailable: true:萬一 Linux 缺了 bubblewrap 等依賴導致沙箱沒起來,直接報錯退出,絕不靜默降級成無沙箱運行。

三、第三層:用鉤子(Hooks)與受信任習慣補齊最後一塊拼圖

  • 用 PreToolUse 鉤子做正則審查:對於無法用簡單前綴概括的高危操作(如禁止直連生產庫地址、提交前強制跑單測),掛一個 PreToolUse 腳本檢查入參 JSON,發現違規返回退出碼 2 即可硬性阻斷執行(實戰示例見 Hooks 實戰:提交前自動跑測試)。
  • 克隆陌生開源倉庫先看 .claude/ 與 .mcp.json:打開不熟悉的第三方倉庫時,不要盲目閉眼點信任文件夾;先掃一眼裏面有沒有夾帶惡意的項目鉤子或可疑 MCP 服務。數據庫類 MCP 永遠只給只讀帳號連接。

安全配穩之後,日常放心跑複雜重構任務如需補充會話額度,可查看本站 Claude Code 訂閱充值說明。

常見問題

問:為什麼改了 settings.json 裏的 deny 規則,怎麼確認它真的生效了?

答:Claude Code 會實時監聽 permissions 變更,通常儲存即生效。你可以在會話裏輸入 /permissions 查看當前合併後的允許與拒絕列表,或直接讓它嘗試讀一次 .env 驗證是否被攔截。

問:--dangerously-skip-permissions 參數什麼時候能用?

答:這個參數會跳過所有權限彈窗,官方明確警告只應該在沒有互聯網訪問、無任何敏感憑據的一次性隔離容器或虛擬機裏使用,絕不要在裝有個人密鑰的主力開發機上日常開啟。

問:自己用 ! 前綴在輸入框敲的本地命令,受上面的 deny 規則限制嗎?

答:你在交互介面手動敲 ! cat .env 代表你本人主動執行,通常不走面向模型的權限詢問與預設沙箱測試路徑,因此測試沙箱和拒絕規則時要發自然語言讓 Claude 自己去調工具。

相關教學

參考資料

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

Nathaniel 的更多內容

  1. 01

    LangGraph 流式輸出(Streaming)詳解:逐字 Token 流、節點進度與自定義事件寫法

    多步智能體如果等全部節點跑完才返回,網頁前端就會白屏乾等十幾秒。本文按 LangGraph 官方文檔講清 updates、messages、custom 與 values 四種 stream_mode 的區別,以及組合訂閱逐字打字機輸出加工具內部實時進度的完整代碼。

    其他 AI 工具0
  2. 02

    LangGraph 持久化與長期記憶怎麼配:Checkpointer、Store 與 PostgreSQL 實戰

    在生產環境跑 LangGraph,單靠 InMemorySaver 一重啟就會丟失全部對話。本文按官方文檔講清線程內短期檢查點(Checkpointer)與跨線程長期記憶(Store)的分工,以及用 langgraph-checkpoint-postgres 對接 PostgreSQL 的完整步驟。

    其他 AI 工具0
  3. 03

    LangGraph 多智能體怎麼寫:Supervisor 主管包與 Subgraph 隔離子圖實戰

    在 LangGraph 裏把單個圖擴展成多智能體協作有兩條官方路線:快速原型用預置包 langgraph-supervisor,大型生產系統用原生子圖(Subgraph)嵌套。本文講清兩種寫法的完整代碼、私有狀態隔離防 Token 膨脹技巧以及檢查點傳播規則。

    其他 AI 工具0
  4. 04

    LangGraph 人工介入審批怎麼寫:interrupt 暫停圖運行與 Command 恢復實戰

    企業之所以選 LangGraph,很大程度看中它能安全掛起等待人工審批(Human-in-the-Loop)。本文按官方最新規範講清 interrupt() 動態暫停、Checkpointer 必備條件、Command(resume=...) 恢復執行,以及防止副作用重複運行的重入規則。

    其他 AI 工具0
  5. 05

    多 Agent 協作平台怎麼選:Dify、釦子(Coze)、n8n 與 LangGraph 多智能體機制對比

    搜「多agent協作平台」時,Dify、釦子、n8n 和 LangGraph 都宣稱支持多智能體,但底層的調度方式完全不同。本文跳過基礎安裝,專門從多 Agent 角色跳轉、子代理工具調用、上下文隔離與私有化部署四個維度幫你一次選準。

    其他 AI 工具0
  6. 06

    企業微信有官方 MCP 和 CLI 嗎:@wecom/cli 安裝初始化、長連接機器人與接入教學

    搜「企業 微信 有 mcp 嗎」不用再東拼西湊民間群機器人腳本了:企業微信官方已推出 @wecom/cli 命令行工具並內置 stdio 模式的 MCP Server。本文按官方開發者文檔講清安裝、智能機器人長連接初始化、業務命令與接入 Claude Code 步驟。

    Claude其他 AI 工具0

同產品的其他教學

  1. 01

    MCP 收費嗎:開源協議免費邊界、第三方 API 帳單與隱形 Token 開銷說明

    搜「mcp 收費 嗎」的人常擔心裝多了插件會被扣費。MCP(模型上下文協議)本身和官方 SDK 採用 MIT 協議完全免費;實際使用中可能產生費用的只有兩處:掛載過多工具佔用的大模型上下文 Token,以及部分外部商業數據源自帶的 API 套餐。

    Claude其他 AI 工具0
  2. 02

    MCP 協議最新版本更新了什麼:無狀態架構、OAuth 2.1、結構化輸出與異步 Tasks 詳解

    搜「mcp 重大 更新」「mcp 協議 更新」想補齊規範演進脈絡?本文對照 modelcontextprotocol.io 官方規範更新日誌,梳理從 Streamable HTTP 到無狀態優先架構、OAuth 2.1 資源伺服器、Elicitation 交互補參與異步 Tasks 擴展的核心變化。

    Claude其他 AI 工具0
  3. 03

    A2A 和 MCP 有什麼區別:工具連接協議與智能體通信協議的邊界和配合

    很多人問「有了 MCP 為什麼還要出 A2A,兩者是不是二選一的競爭關係」。兩份官方規範都明確寫明它們是上下互補關係:MCP 負責給單個智能體掛載工具與數據源,A2A 負責讓多個獨立黑盒智能體跨團隊、跨框架互相派單協作。

    Claude其他 AI 工具0
  4. 04

    LangGraph 怎麼使用 MCP:用 langchain-mcp-adapters 接入本地與遠程工具

    想讓自建的 LangGraph 狀態圖直接調用現成的 MCP 伺服器,官方標準方案是安裝 langchain-mcp-adapters 並使用 MultiServerMCPClient。本文講清 stdio 與 streamable_http 兩種配置寫法、異步圖運行及按節點分工具技巧。

    Claude其他 AI 工具0
  5. 05

    LangGraph 入門教學:Python 安裝、核心概念與跑通第一個狀態圖智能體

    面向搜「python 安裝 langgraph」和「langgraph 中文 文檔」的初學者:本文按 LangChain 官方最新 Graph API 規範,講清安裝步驟、State/Node/Edge 四大概念,並從零寫出第一個帶工具調用循環的 StateGraph。

    Claude其他 AI 工具0
  6. 06

    Claude Agent SDK 子代理怎麼寫:AgentDefinition 配置、權限收斂與 Python/TS 示例

    在 Python 或 TypeScript 裏用 Claude Agent SDK 編排多角色協作,核心是配置 ClaudeAgentOptions 的 agents 字段與 AgentDefinition。本文講清必開的 Agent 委派權限、工具收斂、模型分級與完整代碼示例。

    Claude0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~