Agent 创收指南免费公开资源
中文 EN العربية

返回目录 / Agent 安全

区分工具白名单与工具可用性

验证 allowed_tools 只会预先批准列出的工具,并用 disallowed_tools 禁用明确禁止项。

目标

配置工具权限时避免把“自动批准”误当作“只开放这些工具”。

步骤

  1. 在 ClaudeAgentOptions 设置 allowed_tools=[...],只放入可自动批准的必要工具。 [readme]
  2. 对必须完全阻止的工具使用 disallowed_tools=[...];其他未列出工具仍可能按 permission_mode 或 can_use_tool 决策。 [readme]
  3. 在隔离测试目录用只读探测验证批准/拒绝行为,再逐项开放写入工具。 [readme]

验证方式

确认禁止工具明确列入 disallowed_tools,未批准工具触发预期权限路径。

故障处理

如果某工具仍能被调用,检查它是否只被省略于 allowed_tools;省略不等同于禁用。

权限边界

前置条件

权限边界

限制

工具权限还受 CLI 配置和 permission_mode 影响;该列表本身不是文件系统或网络沙箱。

固定上游来源

https://github.com/anthropics/claude-agent-sdk-python/blob/b6e9d12fe1cc98dde988ab7b7713c1feeee50c6c/README.md

仓库
anthropics/claude-agent-sdk-python
文件路径
README.md
固定提交
b6e9d12fe1cc98dde988ab7b7713c1feeee50c6c
来源检查
2026-10-14 · 已按固定上游来源核对

仓库指标

以下数字属于上游仓库整体,不代表单个 Skill 或指南的点赞/热度。

Stars
未取得
Forks
未取得
观测时间
未取得

尚未取得指标快照。

许可证: MIT

主主题

让 Agent 更安全且易于核验

相关资源