Testes de QA com o Claude Code e o Playwright

O que o Claude Code faz em testes de QA

• Escreve testes end-to-end para os fluxos que importam: cadastro, checkout, as telas principais.
• Roda a suíte, lê as falhas e corrige o teste ou o código, dizendo qual dos dois.
• Controla um navegador de verdade para conferir uma mudança à mão e registra bugs com passos e capturas de tela.
• Encontra testes instáveis e os coloca em quarentena com uma issue, em vez de repetir até passarem.

Recursos do Claude Code para testes de QA

Como configurar o Claude Code para testes de QA

1. Conecte as ferramentas

   Adicione o servidor MCP do Playwright para o Claude Code abrir o seu app em um navegador. Para uma suíte de testes no repositório, instale o Playwright como faria normalmente; o Claude a roda como qualquer outro comando.

   # Um navegador de verdade para checagens exploratórias
   claude mcp add playwright npx @playwright/mcp@latest
   
   # Uma suíte de testes, se você ainda não tem uma
   npm init playwright@latest

2. Escreva as regras no CLAUDE.md

   O Claude Code lê o CLAUDE.md no início de toda sessão, inclusive nas execuções com claude -p. Coloque ali as regras do trabalho, ou em uma skill em .claude/skills/ se forem longas. Veja o guia do CLAUDE.md.

   ## Regras de QA
   - Teste no app local ou de staging, nunca em produção.
   - Use as contas de teste do .env.example, nunca contas reais.
   - Um teste falhando é um achado: diga se o teste ou o código
     está errado antes de mudar qualquer um dos dois.
   - Todo relato de bug: passos, esperado, obtido, uma captura de
     tela e o commit que você testou.
   - Não exclua nem pule um teste para fazer a suíte passar.

3. Rode sem a interface interativa

   claude -p roda uma tarefa e encerra, então o cron, o CI ou outra ferramenta pode iniciá-lo. Escolha o que ele pode fazer sem pedir com --allowedTools ou --permission-mode; --output-format json devolve o resultado com o custo.

   # Rode a suíte e corrija as falhas, pelo CI ou pelo cron
   claude -p "Rode npx playwright test e corrija as falhas, seguindo o CLAUDE.md" \
     --allowedTools "Bash,Read,Edit"

4. Coloque em um agendamento

   Transforme-o em uma tarefa agendada na nuvem com /schedule (Pro, Max, Ultra, Team e Enterprise) ou em uma tarefa agendada no desktop, ou use /loop enquanto uma sessão fica aberta. Veja como deixar o Claude Code proativo.

Fonte: documentação do Claude Code

Limites e segurança

• Ele testa o que consegue alcançar: um app local ou de staging com dados de teste, não a produção.
• Uma suíte que passa cobre só os fluxos para os quais alguém escreveu testes. Peça a ele para listar o que não está coberto.
• Execuções no navegador são lentas e consomem mais do seu plano. Rode a suíte completa com agendamento e um smoke test a cada mudança.
• Desde o Claude Code v2.1.302, claude -p começa no modo Manual: uma ação que precisa de aprovação é negada, a menos que uma regra a permita. Permita só as ferramentas de que o trabalho precisa.

Claude Code ou Codex para testes de QA?

As regras valem para os dois. Escreva-as uma vez no AGENTS.md e coloque @AGENTS.md no CLAUDE.md, e os dois agentes leem o mesmo arquivo.

Passo a passo para o outro agente: testes de QA com o Codex.

Coloque alguém responsável por testes de QA

Comandos rodam quando alguém lembra de rodá-los. O Crewmark transforma o seu próprio Claude Code em um funcionário de IA com um cargo, uma meta em números, horário de trabalho e um heartbeat, então o trabalho acontece no horário e aparece em um quadro.

1. Comece pelo cargo

   O engenheiro de software com IA, com estas regras no brief.

2. Leve o trabalho para o quadro dele

   Adicione o trabalho como issue recorrente. O funcionário acorda com o heartbeat, faz o trabalho e relata em um comentário.

3. Veja também

   Issues do GitHub cobre o que acontece com os bugs que ele registra.

Perguntas frequentes