Pular para o conteúdo
ReviewRamble

A newsletter semanal

IA, analisada, na sua caixa de entrada.

  • Novas análises de ferramentas, modelos, servidores MCP e repositórios, com o veredicto logo no início
  • Preços e notas reconferidos quando algo muda
  • Novos artigos de análise assim que são publicados

Modelos, agentes, servidores MCP e as ferramentas que realmente valem seu tempo.

Um e-mail por semana. Cancele pelo link em qualquer edição. Como usamos seu e-mail

AgentShield

Um scanner que dá nota a uma configuração do Claude Code por chaves vazadas, permissões amplas demais, hooks arriscados e servidores MCP inseguros.

Análise de ReviewRamble editors · Atualizado

Ver no GitHub Código aberto

Compartilhe esta página:XLinkedInFacebookRedditWhatsAppE-mail

Nossa nota

3.8/5

AgentShield é o jeito mais rápido de descobrir quanto a sua configuração do Claude Code confia por acidente, e os achados dele são uma lista para resolver, não um veredito para emoldurar.

O que é AgentShield?

AgentShield lê a configuração de um agente de programação, sobretudo o diretório ~/.claude e as pastas .claude dos projetos, e aponta o que pode dar errado: chaves de API coladas no CLAUDE.md, regras de permissão como Bash(*), hooks que inserem nomes de arquivo em comandos de shell, servidores MCP iniciados com npx -y e instruções que mandam o agente baixar e executar código remoto. Ele mostra uma nota de A a F com uma pontuação de 0 a 100 e consegue corrigir sozinho os problemas mais seguros.

Ele roda com npx ecc-agentshield scan, como GitHub Action que gera SARIF para o code scanning, ou dentro da GitHub App ECC Tools. Um modo opcional --opus envia a configuração ao Claude para uma revisão com três agentes: time vermelho, time azul e auditor. Affaan Mustafa o criou no hackathon de Claude Code da Cerebral Valley com a Anthropic, em fevereiro de 2026, como parte do projeto Everything Claude Code.

A CLI tem licença MIT e é gratuita; o ECC Tools Pro, uma GitHub App para análise em toda a organização, custa US$ 19 por usuário por mês.

AgentShield vale a pena?

AgentShield merece seu lugar porque lê os arquivos que importam na configuração de um agente de programação, que os scanners de segredos genéricos não entendem. Suas 268 regras em 15 módulos cobrem listas de permissões, 40 padrões de hooks que vão de reverse shells a exfiltração pela área de transferência, 49 verificações de servidores MCP e 41 regras para instruções de agentes e do CLAUDE.md. A pontuação começa em 100 por categoria e só os achados descontam, 25 por um crítico e 15 por um alto, então adicionar regras de negação decorativas não aumenta a nota.

A adoção é real, ainda que modesta: cerca de 1.413 estrelas no GitHub, 66.299 downloads do ecc-agentshield no npm nos 30 dias até 15 de novembro de 2026, e a v1.6.0 lançada em 10 de setembro de 2026. A GitHub Action, a saída SARIF, as linhas de base que só apontam achados novos e a exportação de pacotes de evidências o tornam utilizável em CI, e não só no notebook.

O ruído é o custo principal. O mantenedor mantém no repositório um arquivo de auditoria de falsos positivos, achados de MCP em pastas de modelos recebem peso de 0.25x, e a documentação gasta vários parágrafos explicando quais achados são risco real em execução e quais são exemplos. Conte com triagem. O Claude Code é o alvo principal; outros ambientes como Codex, OpenCode e Zed recebem notas de evidência, não a mesma profundidade.

O modo --opus envia sua configuração à Anthropic, ou à OrcaRouter com --provider orcarouter, e o README desaconselha usar esta última em configurações com segredos não ocultados. Rode primeiro a varredura local e corrija o que ela encontrar antes de mandar qualquer coisa para fora. Em comparação com o scanner de agentes da Snyk ou o SkillSpector da NVIDIA, focados em skills e no envenenamento de ferramentas MCP, o AgentShield cobre mais do próprio ambiente e é menos maduro em precisão.

Onde ele se destaca

  • Um desenvolvedor solo com um ano de hooks e servidores MCP do Claude Code acumulados

    Descobrir se alguma parte da minha configuração vaza chaves ou deixa o agente executar qualquer coisa

    Rode npx ecc-agentshield scan sem instalar nada, leia primeiro os achados críticos e altos e aplique --fix aos segredos fixos no código. Não custa nada e termina localmente, sem enviar arquivos para lugar nenhum.

  • Uma equipe de plataforma que distribui um diretório .claude compartilhado para 40 engenheiros

    Impedir que permissões ou hooks arriscados entrem na configuração da equipe

    Adicione a GitHub Action affaan-m/agentshield@v1 com uma linha de base para que pull requests só falhem com achados críticos ou altos novos, e envie o SARIF ao code scanning. A Action é gratuita; o ECC Tools Pro a US$ 19/usuário/mês acrescenta análise em toda a organização.

  • Uma engenheira de segurança que prepara evidências para uma auditoria SOC 2

    Mostrar aos auditores como as configurações de agentes são controladas

    Rode a varredura com --compliance e --evidence-pack para mapear os achados a IDs de controle e exportar um pacote portátil, e anexe o relatório HTML à auditoria.

Antes de decidir

Configuração
npx ecc-agentshield scan encontra ~/.claude automaticamente e mostra um relatório com nota em um único comando; agentshield init grava uma configuração base mais rígida.
Integrações
GitHub Action com SARIF e resumos de job; saída em JSON, Markdown e HTML; GitHub App ECC Tools; pacotes de regras externos; API da Anthropic ou OrcaRouter para --opus; consultas ao registro npm com --supply-chain-online.
Dados e privacidade
A varredura padrão roda localmente e as verificações de cadeia de suprimentos funcionam offline. O --opus envia o conteúdo da configuração à Anthropic, ou à OrcaRouter se escolhida, então oculte os segredos antes.
Custo em escala
Gratuito para a CLI e a Action. O --opus usa o Claude Opus às tarifas da sua API da Anthropic; o ECC Tools Pro custa US$ 19 por usuário por mês.
Limites
Falsos positivos são comuns o bastante para o mantenedor documentar um processo de triagem; achados de MCP em modelos recebem peso de 0.25x; a cobertura é mais profunda para o Claude Code.

O que é bom

  • Entende configurações, hooks e MCP do Claude Code
  • A pontuação não pode ser inflada com defesas extras
  • GitHub Action com SARIF e desvio em relação à linha de base
  • A correção automática move segredos fixos para variáveis de ambiente

O que não é

  • Muitos achados exigem triagem manual
  • Perde profundidade fora do Claude Code
  • O modo --opus envia sua configuração a uma API de terceiros
  • Nenhuma versão desde 10 de setembro de 2026

Ideal para

Desenvolvedores e equipes de plataforma que usam o Claude Code com hooks e servidores MCP e querem uma auditoria repetível dessa configuração em CI.

Alternativas ao AgentShield

AgentShield: perguntas frequentes

AgentShield vale a pena?
AgentShield é o jeito mais rápido de descobrir quanto a sua configuração do Claude Code confia por acidente, e os achados dele são uma lista para resolver, não um veredito para emoldurar. Damos nota 3.8 de 5.
Quanto custa AgentShield?
CLI e GitHub Action gratuitas sob MIT. A análise --opus é cobrada na sua chave de API da Anthropic. GitHub App ECC Tools Pro: US$ 19/usuário/mês.
Quais são as desvantagens de AgentShield?
Muitos achados exigem triagem manual; perde profundidade fora do Claude Code; o modo --opus envia sua configuração a uma API de terceiros; nenhuma versão desde 10 de setembro de 2026.
Para quem AgentShield é indicado?
Desenvolvedores e equipes de plataforma que usam o Claude Code com hooks e servidores MCP e querem uma auditoria repetível dessa configuração em CI.
Quanto custa AgentShield para uma equipe ou em produção?
Gratuito para a CLI e a Action. O --opus usa o Claude Opus às tarifas da sua API da Anthropic; o ECC Tools Pro custa US$ 19 por usuário por mês.
AgentShield é seguro para dados da empresa?
A varredura padrão roda localmente e as verificações de cadeia de suprimentos funcionam offline. O --opus envia o conteúdo da configuração à Anthropic, ou à OrcaRouter se escolhida, então oculte os segredos antes.
Quais são as melhores alternativas ao AgentShield?
As alternativas mais próximas que analisamos são Snyk Agent Scan, SkillSpector, Cisco Skill Scanner e Everything Claude Code (ECC).

Respostas verificadas em 16 de nov. de 2026.