Escribir pruebas automáticas de una web con Playwright y Claude Code

A quién le sirve. Desarrolladores y equipos pequeños que quieren pruebas automáticas de su web sin escribirlas a mano.

Qué hicieron

El servidor Playwright MCP se registra en Claude Code y se carga con una sesión ya iniciada, guardada mediante el estado de almacenamiento. Una instrucción en tres partes lleva los datos del entorno, un escenario en lenguaje normal y unas reglas permanentes. El agente explora la aplicación en funcionamiento a través del árbol de accesibilidad (la estructura que ven los lectores de pantalla), escribe la prueba, la ejecuta y corrige él mismo los fallos. Una persona revisa el código y el sentido del escenario.

Cómo salió

El agente produjo una prueba ejecutable con selectores leídos de la página real y corrigió por su cuenta un error de selector en modo estricto. Le cuestan los procesos largos, los datos que cambian, los condicionales profundos y OAuth (el inicio de sesión con cuentas externas). La fuente no da tiempos.

Conviene saber

Añade .auth/ a .gitignore antes de guardar cambios, porque este montaje guarda la sesión fuera de la ruta que Playwright ignora por defecto, y ejecuta la prueba con --repeat-each 5 para comprobar que no falla de forma intermitente.

Qué necesitas

• Claude Code instalado, con un plan de pago de Claude
• Node y Playwright, la herramienta que maneja el navegador para probar webs
• Tu web en marcha, en un entorno de pruebas, con datos de ejemplo
• Un proyecto con control de versiones (git)

Cómo hacerlo tú, paso a paso

1. Registra el servidor Playwright MCP en Claude Code, siguiendo la guía de la fuente.
2. Inicia sesión una vez en tu web de pruebas y guarda esa sesión en una carpeta .auth/. Añade esa carpeta al archivo .gitignore antes de guardar cambios en git.
3. Escribe la instrucción en tres partes: los datos del entorno, un escenario en lenguaje normal y unas reglas permanentes.
4. Pega el prompt de la ficha con la dirección de tu web y el escenario que quieres comprobar.
5. Deja que el agente explore la web real, escriba la prueba, la ejecute y corrija los fallos.
6. Revisa el código de la prueba y comprueba que el escenario tiene sentido para tu negocio.
7. Ejecútala varias veces seguidas, con la opción --repeat-each 5, para comprobar que no falla de forma intermitente.

Quiero una prueba automática de mi web [dirección] que compruebe este escenario: [escenario en lenguaje normal, por ejemplo iniciar sesión, añadir un producto al carrito y llegar al pago]. Explora la página real, escribe la prueba con Playwright y ejecútala. Si falla, corrígela y vuelve a probar. Habrás terminado cuando la prueba pase [número] veces seguidas. No uses datos reales de clientes ni guardes contraseñas en el código.

Consejos

• Empieza con escenarios cortos y estables. Los procesos largos, los datos que cambian y el inicio de sesión con cuentas externas le cuestan.
• No uses datos reales de clientes ni guardes contraseñas en el código de las pruebas.
• Si una prueba falla a veces, no la dejes así. Una prueba que no es fiable acaba ignorándose.

Preguntas frecuentes

Fuentes

• @jakobnorlin en DEV ↗

En el directorio desde el 6 de octubre de 2026.