Casos de uso · Claude Code

Pruebas de QA con Claude Code y Playwright

Claude Code puede probar tu app de dos formas: escribiendo y ejecutando tests de Playwright en tu repositorio, y manejando un navegador real con el servidor MCP de Playwright para comprobar un cambio como lo haría una persona. Esta página cubre la configuración de ambas, las reglas de QA que lo mantienen honesto con los fallos y cómo ejecutar la suite sin ti.

Qué hace Claude Code para pruebas de QA

  • Escribe tests end-to-end para los flujos que importan: registro, pago, las pantallas principales.
  • Ejecuta la suite, lee los fallos y arregla el test o el código, diciendo cuál.
  • Maneja un navegador real para comprobar un cambio a mano, y registra bugs con pasos y capturas de pantalla.
  • Encuentra los tests inestables y los pone en cuarentena con una issue, en lugar de reintentarlos hasta que pasen.

Funciones de Claude Code para pruebas de QA

FunciónQué haceCómo empezar
Servidor MCP de PlaywrightManeja un navegador real: hace clic, escribe, lee la página y hace capturas de pantallaclaude mcp add playwright npx @playwright/mcp@latest
Tests de PlaywrightEscribe y arregla tests en tu repositorio y los ejecuta como cualquier comandonpx playwright test
claude -pEjecuta la suite y arregla los fallos sin la interfaz interactiva--allowedTools "Bash,Read,Edit"
SubagentesPrueban flujos distintos en paralelo e informanDefine un tester en .claude/agents/

Cómo configurar Claude Code para pruebas de QA

  1. Conecta las herramientas

    Añade el servidor MCP de Playwright para que Claude Code pueda abrir tu app en un navegador. Para una suite de tests en el repositorio, instala Playwright como lo harías normalmente; Claude la ejecuta como cualquier otro comando.

    # Un navegador real para comprobaciones exploratorias
    claude mcp add playwright npx @playwright/mcp@latest
    
    # Una suite de tests, si todavía no tienes una
    npm init playwright@latest
  2. Escribe las reglas en CLAUDE.md

    Claude Code lee CLAUDE.md al empezar cada sesión, también en las ejecuciones con claude -p. Pon ahí las reglas del trabajo, o en una skill dentro de .claude/skills/ si son largas. Consulta la guía de CLAUDE.md.

    ## Reglas de QA
    - Prueba contra la app local o de staging, nunca contra producción.
    - Usa las cuentas de prueba de .env.example, nunca cuentas reales.
    - Un test que falla es un hallazgo: di si el que está mal es el test
      o el código antes de cambiar cualquiera de los dos.
    - Cada informe de bug: pasos, resultado esperado, resultado real,
      una captura de pantalla y el commit que probaste.
    - No borres ni te saltes un test para que la suite pase.
  3. Ejecútalo sin la interfaz interactiva

    claude -p ejecuta una tarea y termina, así que puede lanzarlo cron, la CI u otra herramienta. Decide qué puede hacer sin preguntar con --allowedTools o --permission-mode; --output-format json devuelve el resultado junto con su coste.

    # Ejecuta la suite y arregla los fallos, desde la CI o cron
    claude -p "Ejecuta npx playwright test y arregla los fallos siguiendo CLAUDE.md" \
      --allowedTools "Bash,Read,Edit"
  4. Ponlo en un horario

    Conviértelo en una tarea programada en la nube con /schedule (Pro, Max, Ultra, Team y Enterprise) o en una tarea programada de escritorio, o usa /loop mientras la sesión siga abierta. Consulta cómo hacer que Claude Code sea proactivo.

Fuente: documentación de Claude Code

Límites y seguridad

  • Prueba lo que tiene a su alcance: una app local o de staging con datos de prueba, no producción.
  • Una suite que pasa solo cubre los flujos para los que alguien escribió tests. Pídele que enumere lo que no está cubierto.
  • Las ejecuciones en el navegador son lentas y consumen más de tu plan. Ejecuta la suite completa según un horario y un smoke test en cada cambio.
  • Desde Claude Code v2.1.302, claude -p arranca en modo Manual: se deniega cualquier acción que necesite aprobación salvo que una regla la permita. Permite solo las herramientas que el trabajo necesita.

¿Claude Code o Codex para pruebas de QA?

Las reglas sirven para los dos. Escríbelas una vez en AGENTS.md y pon @AGENTS.md en CLAUDE.md, y los dos agentes leerán el mismo archivo.

Paso a paso con el otro agente: pruebas de QA con Codex.

Claude CodeCodex
Archivo de reglasCLAUDE.mdAGENTS.md
Conectar herramientasclaude mcp addcodex mcp add o config.toml
Ejecutar sin ticlaude -pcodex exec
Horario/schedule, tareas programadas de escritorio, /loopTareas programadas en la app de ChatGPT, cron
Integrado para pruebas de QAMCP de Playwright, subagentesMCP de Playwright, stdin a codex exec
Con Crewmark

Dale a alguien el trabajo de pruebas de QA

Los comandos se ejecutan cuando alguien se acuerda de ejecutarlos. Crewmark convierte tu propio Claude Code en un empleado de IA con un rol, un objetivo en cifras, horario laboral y un heartbeat, para que el trabajo se haga según un horario y aparezca en un tablero.

  1. Empieza por el rol

    El ingeniero de software de IA, con estas reglas en su brief.

  2. Lleva el trabajo a su tablero

    Añade el trabajo como issue recurrente. El empleado se despierta con su heartbeat, lo hace e informa en un comentario.

  3. Relacionado

    Issues de GitHub cubre qué pasa con los bugs que registra.

Preguntas frecuentes

¿Puede Claude Code usar Playwright?

Sí. Añade el servidor MCP de Playwright con claude mcp add playwright npx @playwright/mcp@latest para que maneje un navegador; también puede escribir y ejecutar tests de Playwright en tu repositorio.

¿Debería Claude Code arreglar los tests que fallan?

Solo después de decir por qué fallan. Pon la regla en CLAUDE.md: un fallo es un hallazgo, y antes de cambiar nada dice si el que está mal es el test o el código.

¿Puede Claude Code hacer QA según un horario?

Sí. Ejecuta la suite con claude -p desde la CI o cron, usa una tarea programada o dásela a un empleado de Crewmark como issue recurrente.

Comprobado con la documentación de Claude Code y la de Codex de OpenAI el 13 de noviembre de 2026.

Delega el trabajo de pruebas de QA en un empleado de IA con Claude Code.

Crewmark convierte sesiones de Claude Code y Codex en empleados de IA con roles, objetivos, horario laboral y un heartbeat.