Cómo usar Claude Code para automatizar QA

Qué puede hacer Claude Code en un flujo de trabajo de QA

• Generar pruebas unitarias para un módulo con el estilo y el framework existentes en el proyecto.
• Convertir un informe de error en una prueba de regresión que falle y después corregir el código hasta que pase.
• Añadir casos límite que falten en una suite existente (entradas vacías, Unicode, tiempos de espera agotados, concurrencia).
• Escribir pruebas de extremo a extremo para Playwright o Cypress y, con un servidor MCP de navegador, ejecutarlas contra una aplicación en funcionamiento.
• Diagnosticar una ejecución fallida de CI: leer el registro, encontrar la causa y proponer o aplicar la corrección.
• Revisar una solicitud de incorporación de cambios para detectar rutas de ejecución sin pruebas y publicar los hallazgos.

Lo que no puede hacer es decidir qué importa. Alcanzará sin problema una cobertura de líneas del 100% con pruebas cuyas aserciones no comprueban nada útil. La calidad del resultado depende de la calidad de las instrucciones, por eso la configuración siguiente empieza por el archivo de memoria en lugar del prompt.

Configuración: indícale cómo se ejecutan las pruebas

# 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.

Ese bloque marca la diferencia entre un agente que hace suposiciones y uno que se comporta como un compañero que ha leído la guía de contribución. Añade el estilo de aserciones que quieres y las cosas que nunca quieres que haga (simular la base de datos, omitir pruebas o editar los datos de prueba para que coincidan con resultados incorrectos).

Generar pruebas a partir de una especificación o un informe de error

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

La última frase de cada prompt importa. «Dime si el código o la documentación están mal» evita que cambie el comportamiento de forma silenciosa para ajustarlo a una prueba que acaba de inventar; «no toques otras pruebas» evita el fallo clásico de editar una aserción no relacionada para que las pruebas pasen.

El ciclo de ejecución y corrección

Pídele que ejecute la prueba después de escribirla. Lee la salida del fallo, hace ajustes y vuelve a ejecutarla, normalmente en dos o tres iteraciones. Presta atención a las solicitudes de permiso: permite Bash(npm test*) y Bash(npx playwright test*) una vez con /permissions para que el ciclo no se interrumpa, y mantén los comandos destructivos sujetos a confirmación. Si repite el ciclo más de cuatro o cinco veces con una misma prueba, detenlo; probablemente la prueba esté comprobando algo incorrecto y debería revisarla una persona.

Sin interfaz gráfica en 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

El modo de impresión nunca hace preguntas, así que todo lo que pueda hacer debe autorizarse de antemano con --allowedToolsy --max-turns limita el ciclo. Configura ANTHROPIC_BASE_URL=https://aiprimetech.io y una clave de la pasarela como secretos de CI, y la ejecución se facturará con cargo al saldo de tu pasarela o a tu plan ilimitado. Guarda el resultado en un commit en una rama y deja que una persona lo revise; no integres automáticamente las pruebas generadas.

En cada solicitud de incorporación de cambios: la acción de GitHub

La acción de GitHub de Claude Code ejecuta el mismo ciclo cuando alguien comenta @claude en una solicitud de incorporación de cambios, o automáticamente al abrirla. Una instrucción orientada a QA en el flujo de trabajo —«revisa esta solicitud para detectar ramas sin probar y añade pruebas para ellas»— proporciona una primera revisión de cada solicitud antes de que la examine un revisor. La guía de GitHub cubre la instalación de la aplicación, el archivo del flujo de trabajo y los costes.

Pruebas de extremo a extremo con Playwright

Dos niveles. Sin navegador, escribe especificaciones de Playwright a partir de la estructura de la página y tu descripción, y tú las ejecutas. Con un servidor MCP de Playwright conectado (/mcp), puede abrir la aplicación, recorrer el flujo haciendo clic, leer el DOM y escribir una prueba que coincida con lo que ha visto, con selectores mucho más fiables, a costa de una sesión más larga. Limita cada sesión del navegador a un solo flujo y /clear entre sesiones; las capturas de pantalla y los volcados del DOM son grandes y se reenvían en cada turno.

Cómo mantener bajos los costes de las ejecuciones de QA

• Usa el nivel Sonnet; la generación de pruebas rara vez necesita Opus. El nivel Haiku es adecuado para clasificar registros.
• Céntralo en un módulo o un error a la vez. «Añade pruebas para todo el repositorio» es la instrucción más cara que existe.
• /compact después de incorporar cada archivo de pruebas; los registros de fallos que ha leído ya no son útiles.
• En CI, establece un límite con --max-turns y ejecuta solo sobre los archivos modificados.
• Para un equipo que ejecuta esto a diario, un plan ilimitado de tarifa fija elimina por completo la preocupación por el coste por token.

Todos los planes ilimitados →

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

Preguntas frecuentes

AI Prime Tech es una pasarela API independiente y no está afiliada a Anthropic, ni cuenta con su respaldo o patrocinio. «Claude» y «Claude Code» son marcas comerciales de Anthropic. Las funciones de Claude Code descritas aquí se basan en la documentación pública de Anthropic en el momento de la redacción y cambian con frecuencia; los precios y las listas de modelos de esta página se obtienen de la configuración actual de esta pasarela.