Dá para confiar na revisão de segurança do Claude Code? O que ele pega e o que passa batido

revisão de segurança do Claude Code com /security-review e GitHub Action
Resposta rápida

A revisão de segurança do Claude Code existe em três formas: o comando /security-review na sessão do terminal, a GitHub Action oficial da Anthropic que comenta os achados no diff do pull request, e o plugin security-guidance, que roda por hooks durante a escrita. Ela vai bem no que mora no próprio código: injeção, autenticação e autorização, exposição de dados, cripto, XSS e dependências. E deixa passar o que foi excluído de propósito no prompt (DoS, rate limiting, consumo de recursos), o que ficou abaixo do limite de confiança e tudo que só aparece com a aplicação rodando. A própria doc diz: é assistiva, não substitui revisão humana

Terceirizar a revisão de segurança pro agente é uma tentação grande demais pra ignorar

Você acabou de fechar uma feature, o diff tá gordo, ninguém do time tem contexto pra revisar hoje, e tem um modelo ali do lado que lê código melhor que muita gente

A Anthropic foi no ponto: em 6 de agosto de 2025 anunciou a revisão automatizada de segurança no Claude Code, com o comando /security-review no terminal e uma action pra analisar pull requests

Depois, em 27 de maio de 2026, soltou um plugin que revisa enquanto o código está sendo escrito, o security-guidance

Ou seja, a pergunta não é mais "existe?"

A pergunta é: do que dá pra confiar, e onde o humano continua obrigatório? Bora destrinchar 🙂

Formação Claude Code
Formação Recomendada

Formação Claude Code

Domine Claude Code do absoluto zero até o avançado

  • 120 aulas
  • 4 projetos
  • 9h 45min

O que existe hoje: o comando, a action do GitHub e o plugin

São três coisas diferentes e vale não misturar, porque cada uma roda num momento distinto

1) O comando /security-review

Rodado dentro da sessão do Claude Code no terminal, ele revisa as mudanças pendentes

É o "dá uma olhada nisso aqui antes de eu commitar"

2) A GitHub Action oficial

Mantida pela Anthropic e hospedada no repositório anthropics/claude-code-security-review

Ela lê o diff do pull request e publica os achados como comentários de review nas linhas afetadas

Mesma ideia do comando, só que no fluxo do PR, onde o time já olha

3) O plugin security-guidance

Esse é de outra natureza: não é sob demanda, é contínuo

Vem do marketplace oficial anthropics/claude-plugins-official, é gratuito e está disponível em todos os planos do Claude Code

A instalação é um comando dentro da sessão:

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

Se você conhece um linter que roda no save, a analogia funciona bem: o plugin fica no caminho enquanto o código nasce, o comando e a action olham o resultado depois

Comando de revisão x plugin em tempo real: qual usar em cada momento

/security-review (+ action no PR) Plugin security-guidance
Quando roda Sob demanda, nas mudanças pendentes da sessão, ou automaticamente no pull request Por hooks, durante a escrita do código
Método Leitura semântica do código pelo modelo Três níveis: checagem por padrão na edição do arquivo (sem chamada de modelo), revisão do diff ao fim do turno em background, e revisão mais profunda no commit
Profundidade máxima Análise do diff e do código relacionado No commit, lê arquivos ao redor e rastreia fluxo de dados entre arquivos
Cobertura determinística Não se aplica (é leitura do modelo) Cerca de 25 construções conhecidas de risco, por casamento de padrão
Bloqueia? Não, é revisão Não, a revisão é assistiva e não bloqueia as edições
Onde o resultado aparece Na sessão do terminal, ou como comentários de review nas linhas do PR Achados de alta severidade do turno voltam pro próprio Claude pra correção

Repara numa coisa importante da coluna do plugin: os achados de alta severidade do fim do turno são devolvidos ao Claude pra ele corrigir

Isso é MUITO diferente de um relatório que ninguém lê

O que ele pega bem: os problemas que moram no próprio código

As categorias que a revisão busca são estas:

  • Ataques de injeção, inclusive SQL injection
  • Falhas de autenticação e autorização
  • Exposição de dados
  • Problemas criptográficos
  • Tratamento inseguro de dados
  • XSS
  • Vulnerabilidades em dependências

E por que essa classe de problema sai bem numa revisão feita por modelo?

Porque a abordagem não é casamento de regra

A própria Anthropic descreve o método como leitura semântica: o Claude lê o código "como um pesquisador de segurança humano faria: entendendo como os componentes interagem, rastreando como os dados se movem pela aplicação e capturando vulnerabilidades complexas que ferramentas baseadas em regras não pegam"

Na prática, é o tipo de coisa que está escrita ali, no arquivo, esperando alguém ler com atenção

Do lado determinístico, a camada de padrão do plugin sinaliza construções que todo mundo já conhece de nome mas continua deixando escapar no cansaço:

  • eval() e new Function()
  • child_process.exec() e os.system()
  • desserialização com pickle e yaml.load
  • vetores de XSS no DOM, tipo dangerouslySetInnerHTML e innerHTML
  • segredos escritos direto no código
  • injeção de comando em workflows do GitHub Actions

Essa camada nem chama modelo, é checagem por padrão na hora da edição do arquivo

É o óbvio sendo pego cedo, que é justamente onde custa barato consertar

O que passa batido: exclusões explícitas, filtro de confiança e o que só aparece rodando

Agora a parte honesta

Tem coisa que não passa batido por acidente, passa batido por projeto

1. Categorias excluídas de propósito

O prompt que conduz a revisão é aberto, publicado no repositório anthropics/claude-code-security-review, no arquivo .claude/commands/security-review.md

E ele descarta categorias inteiras de achado de propósito:

  • negação de serviço (DoS) e exaustão de recursos
  • preocupações de rate limiting e sobrecarga de serviço
  • consumo de memória ou CPU
  • segredos e credenciais em disco quando já protegidos por outro meio

Ou seja: se o seu medo é o endpoint que derruba a aplicação com uma enxurrada de requisições, essa revisão não foi feita pra isso

Não é falha, é escopo… mas você precisa saber, senão o relatório limpo vira falsa sensação de segurança

2. O filtro de confiança corta o "talvez"

Pra segurar a enxurrada de falso positivo, existe um limite de confiança: achado que não atinge esse limite é descartado antes de chegar em você

Faz sentido pra usabilidade, mas o efeito colateral é direto: achado incerto e real pode simplesmente sumir do relatório

O que você vê é a parte de cima da peneira, não tudo que o modelo levantou

3. O método lê código, não vê a aplicação rodando

O comando e a action fazem análise estática assistida por modelo: leem código e diff

O plugin é misto, lembra? Tem a camada de padrão na edição, que é casamento determinístico e nem chama modelo, e as camadas de modelo que leem o diff do turno e o código ao redor no commit

Mas o ponto em comum é o que importa aqui: nenhuma delas executa a aplicação

Então falha que só aparece no comportamento em execução (combinação de estado, ordem de chamada, dado real trafegando) fica fora do alcance por construção

Aqui vale a mesma desconfiança saudável que a gente aplica quando o agente mexe nos testes pra fazer passar: verde na tela não é prova de comportamento correto

Veredito: onde a revisão humana continua obrigatória

O ganho é real e tem número: segundo dados internos da Anthropic, houve queda de 30% a 40% nos comentários relacionados a segurança em pull requests abertos com o plugin ativo

Isso é bastante coisa, principalmente pra time pequeno que hoje não tem revisão nenhuma

Mas a documentação oficial não deixa margem pra interpretação criativa: é uma ferramenta assistiva e de melhor esforço, sem garantia

Os achados são sugestões, não veredito

E mais: o revisor pode deixar passar vulnerabilidade, gerar falso positivo e se comportar de forma diferente entre bases de código, linguagens e versões de modelo

A doc é explícita também em dizer que isso não substitui revisão humana de código, SAST/DAST, varredura de dependências ou teste de intrusão

Então o veredito é esse, sem cavalo de pau: serve como primeira peneira antes do humano, não como o humano

Regra de bolso de quando a revisão humana é inegociável:

  • Lógica de autorização e regra de negócio: quem pode ver o quê é uma decisão do seu produto, não uma propriedade do arquivo
  • Tudo que depende de comportamento em execução: se só aparece com a coisa rodando, nenhuma das duas abordagens vai ver
  • As categorias excluídas do prompt: DoS, rate limiting e consumo de recursos não estão sendo olhados, ponto
  • Mudança destrutiva e irreversível: o custo do erro é alto demais pra confiar em sugestão de ferramenta assistiva

Conclusão

A revisão de segurança do Claude Code não é a bala de prata, e a graça é que a própria Anthropic não vende ela assim

O melhor uso é empilhar as camadas:

  1. Plugin durante a escrita, pra pegar o óbvio cedo (o eval(), o segredo hardcoded, o innerHTML esquecido)
  2. Comando ou action antes de mandar o PR, pra ler o diff com calma
  3. Revisão humana e as ferramentas dedicadas por cima: SAST/DAST, varredura de dependências, teste de intrusão

Cada camada pega o que a anterior não pega, e nenhuma delas é substituta da outra

Próximo passo concreto, bem simples: instala o plugin com /plugin install security-guidance@claude-plugins-official numa sessão do Claude Code e roda /security-review nas mudanças pendentes do seu próximo commit

Lê os achados como sugestão, não como laudo, e vê o que aparece

E me conta nos comentários: o que a revisão pegou no teu projeto? E o que ela deixou passar e só um humano viu? Esse segundo caso é o mais interessante de todos =)

Até o próximo post!

Perguntas frequentes

O /security-review do Claude Code detecta ataques de negação de serviço (DoS)?

Não. O prompt que conduz a revisão exclui de propósito DoS e exaustão de recursos, preocupações de rate limiting e sobrecarga de serviço, além de consumo de memória ou CPU. É escopo definido, não falha da ferramenta, mas se o seu medo é esse tipo de ataque, essa revisão não cobre.

Preciso pagar para usar o plugin security-guidance no Claude Code?

Não, o plugin security-guidance é gratuito e está disponível em todos os planos do Claude Code. Ele foi anunciado em 27 de maio de 2026 e é instalado pelo comando /plugin install security-guidance@claude-plugins-official.

O plugin de segurança do Claude Code impede que o código com falha seja commitado?

Não, a revisão do security-guidance é assistiva e não bloqueia as edições. Mesmo quando encontra um padrão de risco na camada de checagem por padrão, o arquivo continua sendo escrito normalmente.

Quando a Anthropic lançou a revisão de segurança automatizada no Claude Code?

O anúncio foi em 6 de agosto de 2025, trazendo o comando /security-review no terminal e uma GitHub Action para analisar pull requests. O plugin security-guidance, que revisa em tempo real durante a escrita do código, veio depois, em 27 de maio de 2026.

A revisão de segurança do Claude Code consegue achar vulnerabilidade em uma aplicação rodando em produção?

Não. As duas abordagens analisam código e diff: o comando faz leitura semântica pelo modelo e o plugin combina checagem por padrão na edição com revisão do diff pelo modelo. Nenhuma delas executa a aplicação, então falhas que só aparecem no comportamento em execução ficam fora do alcance dessas revisões.

Onde fica o prompt que a Anthropic usa na revisão de segurança do Claude Code?

O prompt é aberto e está publicado no repositório anthropics/claude-code-security-review, no arquivo .claude/commands/security-review.md. É ali que estão as regras de exclusão de categorias e os critérios que guiam o que a revisão busca.



Escrito por | Matheus Battisti

Matheus Battisti
Fundador da Hora de Codar

Programador apaixonado pelo mundo das tecnologias, sempre buscando em aprender e se aprofundar em linguagens, frameworks e o que mais for necessário para executar um bom trabalho. Agora tem uma nova missão que é de passar seu conhecimento adiante para formar novos programadores e especializar mais os que já são.

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