Habilidade de Verificação de Segurança

Audite sua configuração do Claude Code em busca de problemas de segurança usando o AgentShield.

Quando Ativar

• Ao configurar um novo projeto Claude Code
• Após modificar as configurações .claude/settings.json, CLAUDE.md ou MCP
• Antes de confirmar alterações de configuração
• Ao integrar um novo repositório com configurações existentes do Claude Code
• Verificações periódicas de higiene de segurança

O Que Ele Verifica

Pré-requisitos

O AgentShield deve estar instalado. Verifique e instale se necessário:

# 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 .

Uso

Verificação Básica

Execute na pasta .claude/ do projeto atual:

# 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

Formatos de Saída

# 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

Correção Automática

Aplique correções seguras automaticamente (apenas correções marcadas como passíveis de correção automática):

npx ecc-agentshield scan --fix

Isso irá:

• Substituir segredos codificados diretamente por referências a variáveis de ambiente
• Apertar permissões curinga para alternativas com escopo
• Nunca modificar sugestões manuais

Análise Profunda Opus 4.6

Execute o pipeline adversarial de três agentes para uma análise mais profunda:

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

Isso executa:

1. Atacante (Equipe Vermelha) — encontra vetores de ataque
2. Defensor (Equipe Azul) — recomenda fortalecimento
3. Auditor (Veredito Final) — sintetiza ambas as perspectivas

Inicializar Configuração Segura

Crie uma nova configuração segura do .claude/ do zero:

npx ecc-agentshield init

Cria:

• settings.json com permissões com escopo e lista de negação
• CLAUDE.md com melhores práticas de segurança
• Marcador de posição mcp.json

Ação do GitHub

Adicione ao seu pipeline de CI:

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

Níveis de Gravidade

Interpretando Resultados

Descobertas Críticas (corrigir imediatamente)

• Chaves de API ou tokens codificados diretamente em arquivos de configuração
• Bash(*) na lista de permissão (acesso irrestrito ao shell)
• Injeção de comando em hooks via interpolação ${file}
• Servidores MCP que executam shell

Descobertas Altas (corrigir antes da produção)

• Instruções de execução automática em CLAUDE.md (vetor de injeção de prompt)
• Listas de negação ausentes em permissões
• Agentes com acesso Bash desnecessário

Descobertas Médias (recomendado)

• Supressão silenciosa de erros em hooks (2>/dev/null, || true)
• Hooks de segurança PreToolUse ausentes
• Instalação automática de npx -y em configurações de servidor MCP

Descobertas de Informação (conscientização)

• Descrições ausentes em servidores MCP
• Instruções proibitivas corretamente sinalizadas como boas práticas

Links

• GitHub: github.com/affaan-m/agentshield
• npm: npmjs.com/package/ecc-agentshield