Testes de QA com o Codex e o Playwright

O que o Codex 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 Codex para testes de QA

Como configurar o Codex para testes de QA

1. Conecte as ferramentas

   Adicione o servidor MCP do Playwright com um comando, ou a mesma tabela no config.toml. Se os testes precisarem acessar um site de staging, ligue o acesso à rede para o sandbox.

   # Um navegador de verdade para checagens exploratórias
   codex mcp add playwright npx "@playwright/mcp@latest"
   
   # Ou no ~/.codex/config.toml
   [mcp_servers.playwright]
   command = "npx"
   args = ["@playwright/mcp@latest"]

2. Escreva as regras no AGENTS.md

   O Codex lê o AGENTS.md antes de qualquer trabalho: ~/.codex/AGENTS.md e depois os arquivos da raiz do repositório até a pasta em que está trabalhando. Coloque ali as regras do trabalho, ou em uma skill em .agents/skills/ se forem longas. Veja o guia do AGENTS.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

   codex exec roda uma tarefa e encerra. O progresso vai para o stderr e a mensagem final para o stdout; -o também a grava em um arquivo e --json transmite os eventos. O sandbox é somente leitura, a menos que você passe --sandbox workspace-write.

   # Entregue ao Codex a saída dos testes que falham
   npm test 2>&1 | codex exec "resuma os testes que falham e proponha a menor correção provável"

4. Coloque em um agendamento

   Crie uma tarefa agendada no app desktop do ChatGPT ou na web (a CLI não as gerencia), ou rode codex exec pelo cron. Veja como deixar o Codex proativo.

Fonte: documentação do Codex

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.
• O Codex roda os comandos em sandbox por padrão: as escritas ficam no workspace e a rede fica desligada. Deixe danger-full-access para um runner ou contêiner isolado.

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 Claude Code.

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 Codex 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