SuperAPI AI 工具集

claude-permissions

智能体与模型

查看项目

更新于 10-16 03:13

技能介绍

用途:指导在 Claude Code 中配置权限、沙箱与工具访问,平衡功能与安全。

主要能力:权限分三层——只读操作(FileReadTool、LSTool、GrepTool、GlobTool、NotebookReadTool)自动允许;BashTool 执行需批准;文件修改(FileEditTool、FileWriteTool、NotebookEditTool)需会话级批准。工具集还包括 AgentTool。

使用方式:四种方法。一、/permissions 交互界面,设 Allow、Ask、Deny。二、在 .claude/settings.json 或 ~/.claude.json 配置持久权限,如 allow 含 "Bash(git status)"、deny 含 "Read(.env*)"、ask 含 "Bash(git push --force:)"。三、/allowed-tools 命令增删,如 /allowed-tools +Edit、/allowed-tools -Bash、/allowed-tools +Bash(git commit:)。四、--allowedTools 会话标志,不持久。

模式:支持简单工具名、具体命令、命令通配(Bash(git commit:))、文件与目录模式(Read(./secrets/)),通配符 * 匹配任意字符串、 递归匹配目录,且大小写敏感。技能与斜杠命令可用 SlashCommand()、Skill(typescript-coding)、Skill(plugin-name:);Skill() 可能不适用于插件作用域技能。

沙箱:在 settings.json 的 sandbox 中配置,enabled 默认 false,autoAllowBashIfSandboxed 默认 true,excludedCommands 列出沙箱外运行命令,network.allowUnixSockets 与 network.allowLocalBinding(仅 macOS,默认 false)。可提供文件系统与网络隔离、减少提示、降低数据外泄风险。

技能与智能体:技能可通过 frontmatter 中 allowed-tools 限制工具;子智能体权限在 ~/.claude/agents/ 或 .claude/agents/ 的 YAML frontmatter 中定义。

适用场景:团队权限统一、保护敏感文件、预批准常用 git/npm 命令。

限制与排错:权限被拒时检查 deny 规则、模式匹配与两级设置文件;提示过多可启用沙箱或加入 allow;沙箱不生效需确认 sandbox.enabled 为 true 并检查排除命令与网络限制。资料未提供收费或价格信息。