Auditoria de Segurança com a Skill da Cloudflare no Claude Code
Instale a skill security-audit da Cloudflare no Claude Code e audite um app seu em ambiente isolado. Comandos, prompts, custos e limites.
O que é
Auditoria de Segurança com a Skill da Cloudflare no Claude Code
A security-audit é uma skill de código aberto da Cloudflare (licença MIT) que transforma o seu agente em um auditor de segurança. Ela mapeia o app, distribui agentes caçadores por áreas do código, passa cada candidato por um verificador que tenta desmentir o achado e gera um relatório com o que foi confirmado e o que ainda precisa de validação.
Este tutorial mostra como instalar, o que pedir ao Claude Code, como ler os três vereditos do relatório e como repetir a auditoria. É para quem constrói apps com IA e quer uma camada extra de verificação antes de lançar.
As ressalvas principais: use só em sistemas seus ou autorizados e em ambiente isolado, porque a skill exige um sandbox do sistema operacional para executar o alvo. A execução usa muitos agentes e tokens, e o resultado não garante que o app esteja seguro.
Instalação em um comando
npx skills add com --skill security-audit, no projeto ou com --global.
Caçadores e verificadores
Agentes isolados caçam falhas e outro agente tenta desmentir cada achado.
Três vereditos
confirmed, needs_validation e rejected, em relatórios separados.
Prompt injection incluso
Há um guia próprio para apps com LLM: injeção de prompt, agentes e tratamento de saída.
Sandbox obrigatório para executar
Sem isolamento do sistema operacional, a skill não executa o código do alvo.
Nível: avançado · Tempo estimado: ~40 min para instalar e rodar a primeira auditoria, sem contar a preparação do ambiente isolado nem o tempo de execução dos agentes, que varia com o tamanho do código. README lido em 20/10/2026.
Use somente em sistemas que você possui ou para os quais tem autorização expressa por escrito, e sempre em ambiente isolado. Não rode contra produção, serviços de terceiros ou dados de clientes. A própria skill orienta a não sondar endpoints públicos, serviços externos, produção nem identidades reais, e a usar segredos e contas fictícios. Esta página não é aconselhamento jurídico.
Sem sandbox do sistema operacional, a skill não executa o código do alvo. O README exige um sandbox que bloqueie rede externa, use ambiente sanitizado, limite recursos e permita escrita só em pastas de trabalho. Sem isso, os achados dependentes de execução ficam como needs_validation, sem severidade e sem correção. O README não ensina a montar esse sandbox no macOS, e este tutorial não testou nenhum método: não improvise rodando o app alvo fora de isolamento.
Segurança não é garantia. A skill reduz risco, mas não prova que um app é seguro: pode deixar falhas passarem. O README informa que, nos testes da Cloudflare, uma única execução encontrou cerca de metade do que execuções repetidas encontraram. Trate o relatório como uma camada, junto com revisão humana e testes.
Custo: a auditoria orquestra vários agentes em paralelo e consome muitos tokens. Tempo e custo não foram medidos neste tutorial e o README não informa um valor. Comece por um app pequeno e acompanhe o consumo no seu plano. O modelo precisa suportar uso de ferramentas e sub-agentes paralelos.
Não testado neste tutorial: a execução da skill em um app de teste e a presença de correção sugerida em cada achado. Pela documentação, o campo de correção existe nos achados confirmados (confirmed), e não nos que dependem de validação.
Pré-requisitos
- Claude Code com um modelo que suporte uso de ferramentas e sub-agentes paralelos (requisito do README)
- Node.js, usado pelos validadores da skill
- Um app de teste seu, sem dados reais, com segredos fictícios
- Um ambiente isolado do sistema operacional para executar o app alvo (máquina virtual, contêiner ou outro mecanismo que atenda ao README)
- Orçamento de tokens para uma execução multiagente
Conceitos-chave
- 01
Skill × harness
A security-audit é uma skill de agente de código. O README a descreve como o ponto de partida de onde nasceu o sistema interno de descoberta de vulnerabilidades da Cloudflare, descrito no blog oficial. A skill não é esse sistema.
- 02
Caçadores e verificadores
Agentes isolados caçam falhas por áreas do código. Cada candidato passa por um verificador novo que tenta desmentir o achado: quem confere nunca é quem achou.
- 03
confirmed, needs_validation, rejected
Três vereditos. confirmed tem trilha completa no código e resultado observado. needs_validation tem um fato pendente e não tem severidade. rejected é um candidato refutado.
- 04
Fases
Reconhecimento, caça guiada por cobertura, validação de candidatos, saída estruturada, verificação independente e relatório.
Passo a passo
- 01
Escolha o alvo certo
Use um app de teste seu, de preferência pequeno, com segredos fictícios. Nunca um app de cliente nem um serviço em produção.
- 02
Prepare o ambiente isolado
Confirme que o sandbox atende aos requisitos do README antes de pedir a auditoria. Sem ele, espere resultados needs_validation.
- 03
Instale a skill
Rode no terminal. Para instalar no nível do usuário, acrescente --global ao final.
npx skills add https://github.com/cloudflare/security-audit-skill --skill security-audit - 04
Abra o Claude Code na pasta do app
Entre na pasta do app de teste e inicie o Claude Code.
cd ~/meu-app-de-teste claude - 05
Peça a auditoria
A skill ativa sozinha quando o pedido combina com o gatilho. Use um dos pedidos do README.
security audit this codebase - 06
Acompanhe as fases
O agente mapeia o app, distribui caçadores, valida candidatos e verifica os registros. Acompanhe o consumo de tokens enquanto roda.
- 07
Leia a pasta de saída
Por padrão, a saída vai para a pasta abaixo, fora do repositório. A skill só escreve no repositório se você escolher uma pasta ignorada pelo git. Abra o REPORT.md, o FINDINGS-DETAIL.md e o NEEDS-VALIDATION.md.
~/security-audit-skill/<repo>/run-<N> - 08
Corrija e rode de novo
Corrija os achados confirmados em uma branch e rode outra auditoria. Execuções no mesmo repositório são aditivas: a skill reaproveita ledgers e achados anteriores para cobrir lacunas e revalidar o que mudou.
Prompts prontos
Os três primeiros são os pedidos de exemplo do README, em inglês, porque são os que a skill documenta como gatilho. Troque [NOME-DO-PROJETO] pelo nome da sua pasta de saída. Os demais ajudam a interpretar o relatório e a repetir a auditoria. [CAMINHO-DO-RELATÓRIO] é a pasta run-N gerada na saída.
Prompt: auditoria completa do código
security audit this codebase
Prompt: auditoria de uma pasta
find security vulnerabilities in ./src
Prompt: auditoria com pasta de saída
do a security review, output to ~/audits/[NOME-DO-PROJETO]
Prompt: explicar o relatório
Leia o relatório em [CAMINHO-DO-RELATÓRIO]. Explique em linguagem simples cada achado confirmado, ordenado por severidade, com o trecho de código envolvido e a correção mínima sugerida. Liste à parte os itens needs_validation e o fato que falta para validar cada um. Não altere nenhum arquivo antes do meu ok.
Prompt: nova rodada depois das correções
Faça uma nova auditoria de segurança deste código, usando os resultados anteriores em [CAMINHO-DO-RELATÓRIO] para focar nas lacunas e revalidar o que mudou. Ao final, compare com o relatório anterior e diga o que foi resolvido, o que continua e o que é novo.
Erros comuns
- Todos os achados saem como needs_validation → não há sandbox que atenda ao README, então a skill não executa o alvo → configure o ambiente isolado ou aceite que a validação dinâmica não será feita
- A skill não é acionada → o pedido não combina com o gatilho → use um pedido como security audit this codebase ou find security vulnerabilities in ./src
- A auditoria demora e consome muitos tokens → execução multiagente em código grande → comece por uma pasta menor, como ./src, e acompanhe o consumo
- O relatório não traz correção para um item → o item é needs_validation, que não tem severidade nem remediação → resolva o fato pendente ou investigue manualmente
- O modelo ignora os sub-agentes → o modelo ou o plano não suporta uso de ferramentas e sub-agentes paralelos → use um modelo que atenda ao requisito do README
- A auditoria encontrou menos do que o esperado → uma única execução cobre parte do problema → rode mais vezes: as execuções são aditivas
Checklist final
- O alvo é um app seu, de teste, com segredos fictícios
- O ambiente isolado atende aos requisitos de rede, ambiente e escrita do README
- A skill foi instalada e o pedido de auditoria ativou o fluxo
- Você leu o REPORT.md e separou confirmed de needs_validation
- Nenhuma chave real apareceu em tela, log ou relatório
- As correções entraram por revisão humana, e uma nova auditoria foi feita depois
Os números de falhas do blog da Cloudflare valem para esta skill?
Não. O blog oficial (18/06/2026) descreve um sistema interno construído a partir da skill, em um experimento isolado. Esses números não são o resultado esperado da skill no seu app.
Ela garante que o app fica seguro?
Não. Ela procura e valida falhas, mas não prova ausência de vulnerabilidades. Use junto com revisão humana e testes.
Dá para rodar sem sandbox?
Dá para rodar, mas a skill não executa o código do alvo. Os achados que dependem de execução ficam como needs_validation.
Custa quanto?
A skill é MIT e gratuita. O custo está nos tokens dos agentes. O README não informa um valor, e este tutorial não mediu.
Fontes oficiais
- Repositório da skill security-audit (MIT)github.com/cloudflare/security-audit-skill (abre em nova aba)
- SKILL.md da skillgithub.com/cloudflare/security-audit-skill/blob/main/skills/security-audit/SKILL.md (abre em nova aba)
- Validação e relatóriogithub.com/cloudflare/security-audit-skill/blob/main/skills/security-audit/VALIDATION-AND-REPORTING.md (abre em nova aba)
- Blog da Cloudflare sobre o harnessblog.cloudflare.com/build-your-own-vulnerability-harness (abre em nova aba)
- Skills CLIskills.sh (abre em nova aba)
Próximos passos
Comece agora
Pronto para colocar Auditoria de Segurança com a Skill da Cloudflare no Claude Code para rodar?
Ver a security-audit no GitHubPróximo passo
Veja os outros recursos do catálogo
Dezenas de recursos entre squads, skills, apps e integrações — todos usados em produção pelo João.
Voltar ao catálogo