Como usar o Claude Code para automação de QA

O que o Claude Code pode fazer em um fluxo de trabalho de QA

Gerar testes unitários para um módulo, seguindo o estilo e o framework existentes no projeto.
Transformar um relato de bug em um teste de regressão que falha e, depois, corrigir o código até que ele passe.
Adicionar casos extremos ausentes a uma suíte existente (entrada vazia, Unicode, tempos limite, concorrência).
Escrever testes de ponta a ponta para Playwright ou Cypress e, com um servidor MCP de navegador, executá-los em uma aplicação em funcionamento.
Investigar uma execução de CI com falha: ler o log, encontrar a causa, propor ou aplicar a correção.
Revisar um pull request em busca de caminhos não testados e publicar os resultados.

O que ele não consegue fazer é decidir o que importa. Ele chegará sem hesitar a 100% de cobertura de linhas com testes que não verificam nada útil. A qualidade do resultado acompanha a qualidade da instrução, e é por isso que a configuração abaixo começa pelo arquivo de memória, e não pelo prompt.

Configuração: explique como os testes são executados

# CLAUDE.md
## Testing
- Unit tests: `npm test` (vitest). Files live next to the source as `*.test.ts`.
- E2E: `npx playwright test`, specs in `e2e/`. Needs the dev server: `npm run dev`.
- Always run the relevant test file after editing it. Do not mark a test `.skip` to make the suite pass.
- Prefer table-driven tests; one behaviour per `it()`; no snapshot tests for logic.

Esse bloco é a diferença entre um agente que tenta adivinhar e um que se comporta como um colega que leu o guia de contribuição. Adicione o estilo de asserções que você deseja e as coisas que nunca quer que ele faça (simular o banco de dados, pular testes, editar fixtures para corresponder a uma saída incorreta).

Gerar testes a partir de uma especificação ou de um relato de bug

> Read src/billing/prorate.ts. Write vitest tests covering the documented behaviour in
  docs/billing.md, including month boundaries, leap years and a zero-day period.
  Run them; if any fail, tell me whether the code or the doc is wrong before changing code.

> Bug #412: uploading a 0-byte file returns 500 instead of 400. Write a failing test that
  reproduces it, then fix the handler so the test passes. Do not touch other tests.

A última frase de cada prompt importa. "Diga se o código ou a documentação está errado" impede que ele altere silenciosamente o comportamento para corresponder a um teste que acabou de inventar; "não mexa nos outros testes" evita o modo de falha clássico em que ele edita uma asserção sem relação com a tarefa para fazer os testes passarem.

O ciclo de execução e correção

Peça que ele execute o teste depois de escrevê-lo. Ele lê a saída da falha, faz ajustes e executa novamente — geralmente em duas ou três iterações. Fique atento às solicitações de permissão: autorize Bash(npm test*) e Bash(npx playwright test*) uma vez com /permissions para que o ciclo não seja interrompido, e mantenha os comandos destrutivos sujeitos a confirmação. Se ele repetir o ciclo mais de quatro ou cinco vezes no mesmo teste, interrompa-o; o teste provavelmente está verificando a coisa errada e uma pessoa deve analisá-lo.

Execução sem interface gráfica em CI

# generate regression tests for whatever changed, non-interactively
git diff --name-only origin/main...HEAD | grep -E 'src/.*\.ts$' > changed.txt
claude -p "For each file in changed.txt, add or extend tests for the changed behaviour. Run them." \
  --allowedTools "Read,Edit,Write,Bash(npm test*),Bash(git diff*)" \
  --max-turns 25 --output-format json > claude-qa.json

O modo de impressão nunca faz perguntas, portanto tudo o que ele pode fazer precisa ser aprovado previamente com --allowedTools e --max-turns limita o ciclo. Configure ANTHROPIC_BASE_URL=https://aiprimetech.io e uma chave do gateway como segredos de CI, e a execução será cobrada do seu saldo no gateway ou do plano ilimitado. Faça commit do resultado em uma branch e deixe uma pessoa revisá-lo — não faça merge automático de testes gerados.

Em cada pull request: a GitHub Action

A GitHub Action do Claude Code executa o mesmo ciclo quando alguém comenta @claude em um pull request ou automaticamente ao abri-lo. Uma instrução voltada a QA no fluxo de trabalho — "revise este PR em busca de ramificações não testadas e adicione testes para elas" — dá a cada PR uma primeira revisão antes de um revisor analisá-lo. O guia do GitHub aborda a instalação do App, o arquivo do fluxo de trabalho e os custos.

Testes de ponta a ponta com Playwright

Dois níveis. Sem um navegador, ele escreve especificações de teste do Playwright com base na estrutura da página e na sua descrição, e você as executa. Com um servidor MCP do Playwright conectado (/mcp), ele pode abrir o aplicativo, percorrer o fluxo com cliques, ler o DOM e escrever um teste que corresponda ao que viu — seletores muito mais confiáveis, ao custo de uma sessão mais longa. Limite cada sessão de navegador a um único fluxo e /clear entre elas; capturas de tela e dumps do DOM são grandes e são reenviados a cada turno.

Como manter baixo o custo das execuções de QA

Use o nível Sonnet; a geração de testes raramente precisa do Opus. O nível Haiku é suficiente para a triagem de logs.
Direcione-o a um módulo ou um bug de cada vez. "Adicione testes para todo o repositório" é o prompt mais caro que existe.
/compact após a inclusão de cada arquivo de teste; os logs de falha que ele leu já não são úteis.
No CI, estabeleça um limite com --max-turns e execute apenas nos arquivos alterados.
Para uma equipe que executa isso diariamente, um plano ilimitado de preço fixo elimina completamente a preocupação com o custo por token.

Plano	Duração	Preço
Ilimitado por 1 hora	1 hora	$1
Ilimitado por 24 horas	24 horas	$10
Ilimitado por 1 semana	1 semana	$49
Ilimitado por 15 dias	15 dias	$89

Todos os planos ilimitados →

Experimente gratuitamente primeiro

Novas contas recebem $5 em crédito gratuito para a API com o código CLAUDECODE — suficiente para uma noite de Claude Code com Sonnet — e depois créditos com 7.69231× o valor nominal.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Crie uma conta com o código CLAUDECODE

Perguntas frequentes

O Claude Code pode escrever testes unitários?

Sim — no framework e no estilo já usados pelo projeto, se CLAUDE.md especificar quais são. Peça que os execute depois para corrigir os próprios erros.

O Claude Code pode executar testes do Playwright?

Sim. Ele pode escrever especificações de teste por conta própria e, com um servidor MCP do Playwright, pode controlar um navegador real para criá-las e verificá-las.

O Claude Code é bom para automação de QA?

Para gerar testes, fechar o ciclo de escrever, executar e corrigir, e fazer a triagem de falhas de CI, é muito bom. Ele não substitui a decisão sobre o que precisa ser testado, e os testes gerados ainda precisam de revisão humana antes do merge.

Como executo o Claude Code no CI para testes?

Use claude -p com --allowedTools e --max-turns, credenciais do gateway ou da Anthropic como segredos, e faça commit da saída em uma branch para revisão. A GitHub Action encapsula o mesmo processo para pull requests.

Execute o Claude Code no gateway

Os mesmos modelos, duas variáveis de ambiente, créditos com 7.69231× o valor nominal — ou um plano ilimitado com preço fixo. Novas contas: $5 em crédito gratuito para a API com o código CLAUDECODE.

Obter uma chave de API Ver planos ilimitados

A AI Prime Tech é um gateway de API independente e não é afiliada, endossada nem patrocinada pela Anthropic. “Claude” e “Claude Code” são marcas comerciais da Anthropic. Os recursos do Claude Code descritos aqui seguem a documentação pública da Anthropic no momento da redação e mudam com frequência; os preços e as listas de modelos nesta página são obtidos das configurações atuais deste gateway.

TLDR