Claude Code 安全扫描工具 - 使用 AgentShield 审计配置，发现并修复安全问题

security-scan by affaan-m/everything-claude-code

1,500 周安装量

110,400 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/affaan-m/everything-claude-code --skill security-scan

开发开发运维安全

🇨🇳中文介绍

安全扫描技能

使用 AgentShield 审计您的 Claude Code 配置以发现安全问题。

何时激活

设置新的 Claude Code 项目时
修改 .claude/settings.json、CLAUDE.md 或 MCP 配置后
提交配置更改前
加入具有现有 Claude Code 配置的新代码库时
定期进行安全卫生检查

扫描内容

文件	检查项
`CLAUDE.md`	硬编码的密钥、自动运行指令、提示词注入模式
`settings.json`	过于宽松的允许列表、缺失的拒绝列表、危险的绕过标志
`mcp.json`

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

find-skills 技能搜索工具 - Vercel Labs 开源智能体技能包管理器

733,500 周安装

Vercel React 最佳实践指南 | 58条Next.js性能优化规则与代码重构

252,100 周安装

Vercel Web界面规范检查工具 - 自动检测代码是否符合Web设计指南

202,600 周安装

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

133,200 周安装

必须安装 AgentShield。检查并安装（如果需要）：

# 检查是否已安装
npx ecc-agentshield --version

# 全局安装（推荐）
npm install -g ecc-agentshield

# 或通过 npx 直接运行（无需安装）
npx ecc-agentshield scan .

针对当前项目的 .claude/ 目录运行：

# 扫描当前项目
npx ecc-agentshield scan

# 扫描特定路径
npx ecc-agentshield scan --path /path/to/.claude

# 使用最低严重性过滤器扫描
npx ecc-agentshield scan --min-severity medium

# 终端输出（默认）- 带评级的彩色报告
npx ecc-agentshield scan

# JSON - 用于 CI/CD 集成
npx ecc-agentshield scan --format json

# Markdown - 用于文档
npx ecc-agentshield scan --format markdown

# HTML - 自包含的深色主题报告
npx ecc-agentshield scan --format html > security-report.html

自动应用安全修复（仅修复标记为可自动修复的问题）：

npx ecc-agentshield scan --fix

将硬编码的密钥替换为环境变量引用
将通配符权限收紧为范围限定的替代方案
绝不修改仅限手动处理的建议

Opus 4.6 深度分析

运行对抗性三智能体流程进行更深入的分析：

# 需要 ANTHROPIC_API_KEY
export ANTHROPIC_API_KEY=your-key
npx ecc-agentshield scan --opus --stream

攻击者（红队） - 寻找攻击向量
防御者（蓝队） - 推荐加固措施
审计员（最终裁决） - 综合双方观点

初始化安全配置

从头开始搭建一个新的安全 .claude/ 配置：

npx ecc-agentshield init

具有范围限定权限和拒绝列表的 settings.json
包含安全最佳实践的 CLAUDE.md
mcp.json 占位符

添加到您的 CI 流水线中：

- uses: affaan-m/agentshield@v1
  with:
    path: '.'
    min-severity: 'medium'
    fail-on-findings: true

等级	分数	含义
A	90-100	安全配置
B	75-89	轻微问题
C	60-74	需要注意
D	40-59	显著风险
F	0-39	严重漏洞

关键发现（立即修复）

配置文件中的硬编码 API 密钥或令牌
允许列表中的 Bash(*)（无限制的 shell 访问）
钩子中通过 ${file} 插值导致的命令注入
运行 shell 的 MCP 服务器

高优先级发现（生产前修复）

CLAUDE.md 中的自动运行指令（提示词注入向量）
权限中缺失拒绝列表
具有不必要 Bash 访问权限的智能体

中优先级发现（建议修复）

钩子中的静默错误抑制（2>/dev/null、|| true）
缺失 PreToolUse 安全钩子
MCP 服务器配置中的 npx -y 自动安装

信息性发现（了解情况）

MCP 服务器上缺失描述
正确标记为良好实践的禁止性指令

🇺🇸English

Security Scan Skill

Audit your Claude Code configuration for security issues using AgentShield.

When to Activate

Setting up a new Claude Code project
After modifying .claude/settings.json, CLAUDE.md, or MCP configs
Before committing configuration changes
When onboarding to a new repository with existing Claude Code configs
Periodic security hygiene checks

What It Scans

File	Checks
`CLAUDE.md`	Hardcoded secrets, auto-run instructions, prompt injection patterns
`settings.json`	Overly permissive allow lists, missing deny lists, dangerous bypass flags
`mcp.json`	Risky MCP servers, hardcoded env secrets, npx supply chain risks
`hooks/`	Command injection via interpolation, data exfiltration, silent error suppression
`agents/*.md`	Unrestricted tool access, prompt injection surface, missing model specs

Prerequisites

AgentShield must be installed. Check and install if needed:

# Check if installed
npx ecc-agentshield --version

# Install globally (recommended)
npm install -g ecc-agentshield

# Or run directly via npx (no install needed)
npx ecc-agentshield scan .

Usage

Basic Scan

Run against the current project's .claude/ directory:

# Scan current project
npx ecc-agentshield scan

# Scan a specific path
npx ecc-agentshield scan --path /path/to/.claude

# Scan with minimum severity filter
npx ecc-agentshield scan --min-severity medium

Output Formats

# Terminal output (default) — colored report with grade
npx ecc-agentshield scan

# JSON — for CI/CD integration
npx ecc-agentshield scan --format json

# Markdown — for documentation
npx ecc-agentshield scan --format markdown

# HTML — self-contained dark-theme report
npx ecc-agentshield scan --format html > security-report.html

Auto-Fix

Apply safe fixes automatically (only fixes marked as auto-fixable):

npx ecc-agentshield scan --fix

This will:

Replace hardcoded secrets with environment variable references
Tighten wildcard permissions to scoped alternatives
Never modify manual-only suggestions

Opus 4.6 Deep Analysis

Run the adversarial three-agent pipeline for deeper analysis:

# Requires ANTHROPIC_API_KEY
export ANTHROPIC_API_KEY=your-key
npx ecc-agentshield scan --opus --stream

This runs:

Attacker (Red Team) — finds attack vectors
Defender (Blue Team) — recommends hardening
Auditor (Final Verdict) — synthesizes both perspectives

Initialize Secure Config

Scaffold a new secure .claude/ configuration from scratch:

npx ecc-agentshield init

Creates:

settings.json with scoped permissions and deny list
CLAUDE.md with security best practices
mcp.json placeholder

GitHub Action

Add to your CI pipeline:

- uses: affaan-m/agentshield@v1
  with:
    path: '.'
    min-severity: 'medium'
    fail-on-findings: true

Severity Levels

Grade	Score	Meaning
A	90-100	Secure configuration
B	75-89	Minor issues
C	60-74	Needs attention
D	40-59	Significant risks
F	0-39	Critical vulnerabilities

Interpreting Results

Critical Findings (fix immediately)

Hardcoded API keys or tokens in config files
Bash(*) in the allow list (unrestricted shell access)
Command injection in hooks via ${file} interpolation
Shell-running MCP servers

High Findings (fix before production)

Auto-run instructions in CLAUDE.md (prompt injection vector)
Missing deny lists in permissions
Agents with unnecessary Bash access

Medium Findings (recommended)

Silent error suppression in hooks (2>/dev/null, || true)
Missing PreToolUse security hooks
npx -y auto-install in MCP server configs

Info Findings (awareness)

Missing descriptions on MCP servers
Prohibitive instructions correctly flagged as good practice

Claude Code 安全扫描工具 - 使用 AgentShield 审计配置，发现并修复安全问题

🇨🇳中文介绍

安全扫描技能

何时激活

扫描内容

相关 Skills

先决条件

使用方法

基本扫描

输出格式

自动修复

Opus 4.6 深度分析

初始化安全配置

GitHub Action

严重性等级

解读结果

关键发现（立即修复）

高优先级发现（生产前修复）

中优先级发现（建议修复）

信息性发现（了解情况）

链接

🇺🇸English

Security Scan Skill

When to Activate

What It Scans

Prerequisites

Usage

Basic Scan

Output Formats

Auto-Fix

Opus 4.6 Deep Analysis

Initialize Secure Config

GitHub Action

Severity Levels

Interpreting Results

Critical Findings (fix immediately)

High Findings (fix before production)

Medium Findings (recommended)

Info Findings (awareness)

Links

最新 Skills