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

登录 后参与评论

还没有评论,来抢沙发~