Agent Skills
返回列表
🔒

用 AgentShield 扫描 Claude Code 配置风险

IT 运维与安全 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/scan-claude-code-configs-for-secrets-permission-drift-and-unsafe-mcp-hookups-with-agentshield

技能介绍

Claude Code 配置会悄悄积累风险

一个 Claude Code 项目通常不只有主配置。.claude 目录、MCP 注册文件、hooks 脚本和子代理配置可能分散在不同路径。时间一长，容易出现三类问题：硬编码的 API key 或 token 留在示例和脚本里；allow、deny 规则因临时需要越开越宽，形成权限漂移；MCP server 配置指向不可信端点，或启动命令携带过宽的文件与网络权限。

AgentShield 如何检查

这个技能把 AgentShield 用作审计入口，而不是代替完整的人工安全审查。它可以在接手已有 Claude Code 配置前快速定位：

  • 硬编码密钥：扫描配置、脚本和示例中的疑似 API key、token 或私钥。
  • 权限漂移：标记范围过大的 allow、deny 规则，提醒收敛最小权限。
  • 危险 hooks：检查 hook 命令是否执行不受控脚本、写入敏感路径或扩大工具权限。
  • MCP 配置风险：审阅 MCP server 声明，指出来源不明、权限过宽或可疑连接方式。

典型流程是：提供 Claude Code 配置目录，运行 AgentShield CLI 或 npx 路径，把结果按风险点归类，再决定是否需要移除密钥、收紧规则或替换 MCP server。

适用边界

该技能只负责发现配置层面的风险，不会自动证明某个 MCP server 完全可信，也不能替代依赖审计或运行时监控。上游项目没有提供可自动提取的安装与使用说明，因此在敏感流程、生产环境或包含真实密钥的配置上运行前，应先阅读 https://github.com/1991513ccie-png/skills 的上游说明并人工复核扫描结果。

使用场景

  • 接手同事维护的 Claude Code 项目，需要快速摸清 `.claude` 目录、MCP 配置和 hooks 脚本是否存在硬编码 token 或过宽权限。
  • 接入新的 MCP server 前，希望先审查配置中的连接目标、启动命令和文件读写范围，避免引入不可信权限。
  • 团队要求本地开发环境的 Claude Code 配置提交前做安全自查，定位 allow/deny 规则漂移和可疑 hook 脚本。

适合人员

  • 负责维护内部 AI 开发工具链的 DevOps 工程师，需要在新增或变更 Claude Code 配置时排查安全风险。
  • 把多个 MCP server 接入团队开发环境的后端开发者，想确认注册配置没有引入过宽的文件与网络权限。
  • 正在接手陌生 Claude Code 项目的工程师，需要在跑第一条命令前确认配置里没有遗留密钥或危险 hook。