Dá para usar o Claude Code para achar falhas de segurança no seu código?

comando de revisão de segurança do Claude Code analisando código em busca de falhas
Resposta rápida

Claude Code segurança é uma pergunta prática: o agente acha falha de verdade ou só faz barulho? A revisão automatizada do Claude Code roda com /security-review dentro do projeto e procura classes conhecidas, como injeção de SQL, XSS, falhas de autenticação e autorização, tratamento inseguro de dados e dependências vulneráveis. Serve bem como primeira passada em diff pequeno, antes do pull request. Não serve como prova de que o código está seguro: uma avaliação da Semgrep mediu 14% de verdadeiro positivo (86% de falso positivo), e a própria Anthropic posiciona isso como complemento da revisão manual, nunca substituto

Mandar o próprio agente varrer teu código atrás de falha é uma daquelas promessas boas demais pra não testar

A pergunta real não é se dá pra fazer, é o que sai do outro lado: achado de verdade ou uma pilha de alerta genérico que te faz perder a tarde triando? Neste post eu separo o que a varredura do Claude Code declara cobrir, o que ela pega na prática, o que os testes independentes mostraram de limite e o que ela definitivamente NÃO substitui

Bora com o veredito honesto no fim, sem fórmula mágica 🙂

O que a varredura do Claude Code procura no seu código

Antes do como, o porquê: a revisão automatizada não é um scanner mágico que entende teu negócio, é um agente lendo código procurando padrões de classe conhecida de vulnerabilidade

As classes que a revisão automatizada do Claude Code procura são estas:

  • injeção de SQL
  • cross-site scripting (XSS)
  • falhas de autenticação e autorização
  • tratamento inseguro de dados
  • vulnerabilidades em dependências

Repara que segredo exposto e dependência abandonada caem justamente em tratamento inseguro de dados e em dependências vulneráveis, ou seja, são classes que a varredura declara cobrir

Declarar cobertura não é garantia de achado, beleza? Uma coisa é o escopo do que ele procura, outra é o que ele encontra no teu repositório específico

E o plugin que revisa o que o próprio Claude escreve?

Existe um caminho diferente, que é a orientação de segurança rodando enquanto o agente trabalha

A Anthropic mantém o plugin security-guidance, que revisa as próprias alterações de código do Claude sem você precisar invocar comando nenhum depois de instalado

O alvo dele são tipos como falhas de injeção, desserialização insegura e APIs de DOM inseguras, entre outras classes comuns de vulnerabilidade web

A diferença de escopo importa muito: um caminho olha o código, o outro olha a MUDANÇA que acabou de ser escrita

Domine o Claude Code do básico ao avançado
Pré-inscrição Formação Claude Code

Domine o Claude Code do básico ao avançado

Você vai aprender a criar sistemas completos com Claude Code, sem precisar ser programador. Inscreva-se para ter acesso a um desconto de lançamento e bônus especiais!

Como rodar a revisão de segurança no seu projeto

São caminhos diferentes com exigências diferentes, então escolhe pelo cenário e não por qual parece mais completo

Antes de começar, um aviso pra você não confundir produto: os quatro caminhos desta seção rodam no teu Claude Code e não dependem de plano Enterprise nem de ativação feita pelo dono da organização. O Claude Security é OUTRA ferramenta da Anthropic, com regra de acesso própria, e eu trato dele numa seção separada lá embaixo

  1. Rode o comando de revisão sob demanda

Dentro do diretório do projeto, na sessão do Claude Code:

/security-review

Ele roda no terminal e aponta os problemas com explicação de cada achado, o que já ajuda demais na hora de julgar se aquilo é real

Repara no que ele entrega: explicação do achado. Sugestão de patch pronto não faz parte do que está documentado pra esse comando

O erro comum deste passo: rodar de qualquer lugar do sistema. O comando é pra ser executado dentro do diretório do projeto, senão você está pedindo revisão de um contexto que não é o teu

  1. Customize o comportamento padrão do comando

Se a revisão padrão não bate com o que teu projeto precisa olhar, dá pra editar o prompt dela

O caminho é copiar o arquivo security-review.md do repositório claude-code-security-review para a pasta .claude/commands/ do projeto e editar

O erro comum deste passo: editar achando que muda pra todo mundo. A customização vive na pasta de comandos DO PROJETO, então é por projeto

  1. Instale a orientação contínua

Numa sessão de terminal do Claude Code:

/plugin install security-guidance@claude-plugins-official

Depois de instalado ele roda automaticamente, sem comando pra invocar

O erro comum deste passo: esperar que o plugin audite o repositório inteiro. O alvo dele são as alterações de código, não um retrato completo do que já estava lá

  1. Coloque a checagem no pull request

Existe uma GitHub Action oficial da Anthropic que usa o Claude pra analisar mudanças de código em busca de vulnerabilidades em pull requests, no mesmo repositório anthropics/claude-code-security-review

O erro comum deste passo é de outra natureza e é sério: agente dentro do CI/CD amplia superfície de ataque. Volto nisso na seção dos limites, porque em junho de 2026 isso deu problema real

Vale lembrar que rodar agente com acesso ao teu código é um assunto por si só, e eu já escrevi sobre permissões, sandbox e boas práticas pra quem quer apertar isso antes

O que eu vi rodando isso na prática

Aqui eu falo do que eu mesmo testei, e o meu teste foi com um plugin que traz a revisão do Codex pra dentro do Claude Code

A instalação foram 3 comandos: adicionar o marketplace, instalar o plugin e rodar o setup

Não foi liso na primeira: bati num erro porque uma pasta estava atrapalhando, precisei excluir ela, refazer e recarregar os plugins. Aí foi

O plugin tem 3 comandos principais que eu mostrei: revisão, revisão adversarial e resgate

A revisão simples eu rodei na última funcionalidade que eu tinha adicionado no projeto, um diff de 4 arquivos e 13 inserções. Ele ainda pergunta se você quer rodar em segundo plano e seguir trabalhando ou esperar o resultado na tela, e eu esperei

E olha o que voltou: uma regressão funcional que eu tinha deixado passar. Uma alteração no cadastro tirou o único caminho pra criar contas de coach, e a interface continuava oferecendo o fluxo, deixando esses usuários bloqueados sem aviso nenhum 😅

Depois rodei a revisão adversarial com um pedido específico, questionando a abordagem de autenticação e pedindo pra procurar problema no sistema de like e comentário

O veredito foi "precisa de atenção", com recomendação de não subir pra produção. Entre os achados: endpoints que deixavam quem NÃO participava do desafio ler e interagir com conteúdo de outros usuários, curtir e descurtir reflexões arbitrárias, e uma página vazando reflexões pra não participantes

Melhor que a lista foi a saída: severidade classificada e próximos passos concretos, tipo documentar um fluxo confiável, restringir a visibilidade das reflexões e retestar com uma conta de não participante

O comando de resgate eu usei pra pedir a correção de um problema específico, e a alteração veio feita pelo modelo do Codex, não pelo modelo padrão. As reflexões passaram a ser consultadas e renderizadas só pra quem já participa do desafio, as rotas de like passaram a validar se a reflexão existe e se o usuário participa daquele desafio antes de permitir a mutação, e o lado do cliente ganhou o desfazer do like otimista quando a chamada volta com erro

E nem assim acabou: a ferramenta pediu teste manual e deixou avisos em aberto, então eu não considerei o trabalho encerrado ali

A escala confortável ficou clara pra mim: diff pequeno e recente. Não é "varre meu monorepo inteiro e me diz se tá seguro"

Minha leitura depois disso: juntar duas IAs tende a elevar a qualidade, porque modelos treinados e configurados de forma diferente respondem diferente, e um acaba pegando o erro do outro

Na prática, o Codex encontrou problema real que o modelo padrão tinha deixado passar, e ainda corrigiu quando pedi. Meu combinado hoje é revisão simples antes de abrir PR (principalmente em mudança grande) e revisão adversarial antes de ir pra produção

Varredura com IA x revisão manual x teste de penetração

Essa é a comparação que resolve a discussão, porque quase todo mundo trata a varredura como se fosse concorrente das outras duas

Abordagem O que pega O que NÃO pega Custo Quando usar
Varredura com o agente Classes conhecidas no código: injeção de SQL, XSS, autenticação e autorização, tratamento inseguro de dados, dependências vulneráveis Comportamento em execução e o que está fora do repositório; em teste independente acertou 22% em IDOR, 16% em XSS e 5% em SQL Injection Barata em tokens, cara em triagem humana (14% de verdadeiro positivo no teste da Semgrep) Primeira passada em diff pequeno, antes de abrir o PR
Revisão manual de código Contexto de negócio, regra de autorização, intenção por trás da mudança, complexidade moderada que a IA perde Escala: ninguém lê repositório inteiro toda semana Caro em tempo de gente sênior Sempre que a mudança toca permissão, dado sensível ou dinheiro
Teste de penetração e revisão de infraestrutura Comportamento em execução, configuração, superfície fora do repositório Detalhe de implementação linha a linha no código-fonte Mais caro e pontual Antes de expor sistema, e em ciclos definidos

A própria Anthropic afirma que a revisão automatizada complementa e não substitui as práticas de segurança existentes nem a revisão manual de código

Ou seja: quem vender isso como "agora não preciso mais de pentest" está vendendo o que o fabricante nem promete

Os limites que os testes independentes expuseram

Aqui é onde a conversa fica honesta, porque os números públicos não contam a mesma história

A Semgrep avaliou o Claude Code procurando vulnerabilidade em 11 aplicações web Python open source de grande porte, com Claude Code v1.0.32 e Sonnet 4. Resultado: 46 vulnerabilidades reais encontradas, com 14% de taxa de verdadeiro positivo, o que dá 86% de falso positivo

Por classe: 22% de acerto em IDOR, 16% em XSS e 5% em SQL Injection

A conclusão deles é a frase que eu adotaria como resumo do assunto: agentes de IA procurando vulnerabilidade são úteis hoje porque encontram vulnerabilidades reais, mas são MUITO ruidosos

Do outro lado tem o resultado do Frontier Red Team da própria Anthropic, usando o Claude Opus 4.6, que encontrou e validou mais de 500 vulnerabilidades de alta severidade em software open source de produção, em projetos como Ghostscript, OpenSC e CGIF

Os dois podem ser verdade ao mesmo tempo, se liga: modelo diferente, alvo diferente e, principalmente, gente especializada fazendo a triagem do outro lado. O número alto não cai no colo de quem roda um comando no terminal

E tem o limite mais desconfortável de todos. A Checkmarx testou enganar o revisor de segurança de IA e observou duas coisas: ele perde vulnerabilidade de complexidade moderada e pode ser induzido ao erro por desvios no próprio código, chegando a descartar vulnerabilidade REAL como falso positivo

Pensa no tamanho disso: o risco não é só o alarme falso, é o silêncio falso

E pra fechar o pacote, o risco de colocar o agente no pipeline: uma falha na GitHub Action do Claude Code permitiu que uma única issue maliciosa comprometesse repositórios, via prompt injection no fluxo de CI/CD. A vulnerabilidade foi divulgada em junho de 2026 e analisada pela Microsoft Security e pela Cloud Security Alliance

Tome cuidado com isso: automação de segurança dentro do CI é ela mesma uma superfície de ataque

Claude Code Security: outro produto, não é o /security-review

Agora muda o assunto, presta atenção pra não misturar as duas coisas: tudo que veio até aqui é o comando /security-review e o plugin de orientação, que rodam na tua sessão do Claude Code sem plano especial. O que vem agora é uma capacidade separada da Anthropic, com acesso e ativação próprios

Sobre o nome, pra você não se perder na hora de pesquisar: a Anthropic usa Claude Code Security no anúncio de lançamento e Claude Security na documentação de uso

Em 20 de fevereiro de 2026 a Anthropic lançou o Claude Code Security, uma capacidade de varredura de código com sugestão de patches pra revisão humana, inicialmente como research preview limitado

Repara no detalhe que muda tudo: patch SUGERIDO, pra revisão humana. Continua tendo gente no meio. E repara também na diferença pro comando lá de cima, que aponta o problema com explicação e não é documentado como gerador de patch

Hoje o Claude Security está em beta público pra organizações no plano Enterprise, e a ativação é feita pelo dono da organização em Organization settings > Claude Security, ligando o toggle da organização

Ou seja: esse caminho não é "roda um comando e pronto", diferente do /security-review

Sobre custo, o que está publicado é que as varreduras cobram apenas o custo direto de tokens, sem taxa de plataforma adicional

E tem também o plugin claude-security pro Claude Code, em beta, que roda uma varredura multi-agente do repositório dentro da própria sessão e transforma os achados escolhidos em patches pro dev revisar e aplicar:

/plugin install claude-security@claude-plugins-official

Esse é o caminho mais parecido com "varre o repositório" que existe hoje, e ainda assim ele para no patch proposto

Vale o tempo? O veredito honesto

Vale, com escopo apertado

Vale como primeira passada barata em diff pequeno e como rede antes de abrir o pull request. A leitura da Semgrep sustenta exatamente isso: útil hoje porque encontra vulnerabilidade real, mas muito ruidoso

No meu teste, o achado que mais me serviu foi de autorização, coisa que passa despercebida quando você está com a cabeça na feature e não no abuso do endpoint

Não vale como prova de que o código está seguro, e aqui eu sou chato mesmo: com 86% de falso positivo a triagem humana não some, ela só muda de lugar, e a Checkmarx mostrou que o revisor pode ser induzido a descartar falha real

Quem tem plano Enterprise ganha um caminho mais estruturado com o Claude Security. Quem não tem, fica com /security-review e o plugin de orientação, que já é bastante coisa pro custo

É o mesmo tipo de conta que eu fiz sobre o Claude Code no Obsidian: a pergunta boa nunca é "a IA consegue?", é "consegue bem o bastante pro que eu vou fazer com o resultado?"

Conclusão

A varredura do Claude Code procura classes conhecidas de vulnerabilidade e acha coisa real, principalmente em diff pequeno e recente, mas ela é ruidosa e a própria Anthropic a posiciona como complemento da revisão manual, não como substituto

Guarda a separação: /security-review e o plugin de orientação são o teu caminho na sessão, e o Claude Security é a capacidade separada, hoje em beta público no plano Enterprise

O próximo passo concreto é simples: roda /security-review no último diff do teu projeto, trata cada achado como HIPÓTESE a confirmar e não como bug fechado, e mantém revisão manual e teste de penetração exatamente onde eles já estavam

Se fizer o teste, me conta o que apareceu… aposto que vem pelo menos um achado de autorização que ninguém tinha visto

até o próximo post! 😀

Perguntas frequentes

O Claude Code substitui a revisão manual de segurança do código?

Não. A própria Anthropic posiciona a revisão automatizada como complemento, não substituto da revisão manual de código nem das práticas de segurança que o time já tem. Ela ajuda a levantar suspeita, mas quem decide o que é risco real ainda é gente.

Qual a taxa de acerto do Claude Code encontrando vulnerabilidades reais?

Numa avaliação independente da Semgrep em 11 aplicações web Python open source, o Claude Code encontrou 46 vulnerabilidades reais, mas com só 14% de taxa de verdadeiro positivo, ou seja, 86% de falso positivo. O acerto variou por classe: 22% em IDOR, 16% em XSS e 5% em SQL Injection, com Claude Code v1.0.32 e Sonnet 4.

É seguro rodar a revisão de segurança do Claude Code dentro do CI/CD?

Existe um precedente sério: em junho de 2026 foi divulgada uma falha na GitHub Action do Claude Code em que uma única issue maliciosa comprometia repositórios via prompt injection no fluxo de CI/CD, caso analisado pela Microsoft Security e pela Cloud Security Alliance. Colocar um agente dentro do pipeline amplia a superfície de ataque, então vale revisar permissões antes de automatizar.

O comando /security-review é a mesma coisa que o Claude Security?

Não são a mesma coisa. O /security-review é o comando de revisão sob demanda que você executa dentro do diretório do projeto, na sessão do Claude Code, e que aponta os problemas com explicação de cada achado, sem depender de plano específico. O Claude Security é a capacidade de varredura de código com sugestão de patches para revisão humana, hoje em beta público para organizações no plano Enterprise, com ativação feita pelo dono da organização em Organization settings > Claude Security.

Quanto custa usar o Claude Security para varrer o código?

A cobrança é só o custo direto de tokens usados na varredura, sem taxa de plataforma adicional. Lembrando que esse é o produto de varredura, hoje em beta público para organizações no plano Enterprise, e não o comando /security-review que qualquer um roda na sessão do Claude Code.

O que é o Claude Security e quando foi lançado?

É a capacidade de varredura de código com sugestão de patches para revisão humana, lançada pela Anthropic em 20 de fevereiro de 2026 como research preview limitado. O nome aparece nas duas formas nas fontes oficiais: Claude Code Security no anúncio de lançamento e Claude Security na documentação de uso. A pesquisa do Frontier Red Team da Anthropic com o Claude Opus 4.6 já encontrou e validou mais de 500 vulnerabilidades de alta severidade em projetos open source como Ghostscript, OpenSC e CGIF.

Dá para enganar a revisão de segurança de IA do Claude Code?

Segundo pesquisa da Checkmarx, sim, em dois sentidos: o revisor perde vulnerabilidades de complexidade moderada e pode ser induzido ao erro por desvios no próprio código, chegando a descartar uma vulnerabilidade real como falso positivo. É mais um motivo pra tratar o achado como ponto de partida, não veredito final.




Subscribe
Notify of
guest

0 Comentários
Oldest
Newest Most Voted

Formações

Formação Vibe Coding

Formação Vibe Coding

Do Prompt ao Produto: Crie Software Real com IA

  • 474 aulas
  • 20 projetos
  • 39h 27min

Blog | Mais populares