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 条评论

登录 后参与评论

还没有评论,来抢沙发~