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

> Una guía para usar Playwright MCP con Claude Code y generar pruebas automáticas de una web en pocos minutos.

- **Tipo:** Caso de uso
- **Tema:** Programación
- **Herramientas:** Claude Code
- **Dificultad:** avanzada
- **Origen:** [@jakobnorlin en DEV](https://dev.to/jakobnorlin/how-to-write-playwright-tests-in-minutes-with-playwright-mcp-and-claude-code-1o0d)
- **En el directorio desde:** 6 de octubre de 2026
- **URL:** https://conqueia.com/caso/escribir-pruebas-automaticas-con-playwright-mcp-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.

## Pruébalo con Claude Code

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

### ¿Hace falta saber programar?

Para describir el escenario basta con lenguaje normal. Para revisar las pruebas sí conviene entender un poco qué comprueba cada una.

### ¿Qué es una prueba intermitente y por qué importa?

Es la que a veces pasa y a veces falla sin que nada haya cambiado. Por eso se repite varias veces: si falla alguna, no es fiable.

## Fuentes

- [@jakobnorlin en DEV](https://dev.to/jakobnorlin/how-to-write-playwright-tests-in-minutes-with-playwright-mcp-and-claude-code-1o0d)

---

Fuente: conqueia.com/caso/escribir-pruebas-automaticas-con-playwright-mcp-y-claude-code