Configuración de la extensión de Chrome Claude Code para la automatización del navegador
Claude Code puede controlar tu navegador Chrome. Navega por páginas, haz clic en botones, rellena formularios, lee contenido, toma capturas de pantalla. Es útil para probar aplicaciones web, depurar con registros de consola o automatizar tareas repetitivas del navegador sin salir de la terminal.
He probado otros MCP de navegador (Playwright MCP, Puppeteer, etc.) y la extensión de Chrome es notablemente más rápida. Se conecta a tu sesión de navegador real, por lo que comparte tu estado de inicio de sesión. Sin iniciar navegadores *headless*, sin flujos de autenticación separados. Si has iniciado sesión en Gmail, Notion o tu entorno de *staging*, Claude Code puede interactuar con esas páginas inmediatamente.
La documentación oficial cubre todo en detalle. Esta publicación es la versión corta.
Lo que necesitas
- Google Chrome o Microsoft Edge
- La extensión Claude in Chrome (v1.0.36+) de Chrome Web Store
- Claude Code v2.0.73 o superior
- Un plan directo de Anthropic (Pro, Max, Teams o Enterprise). Esto no funciona a través de Bedrock o Vertex
Configuración
Instala la extensión desde Chrome Web Store. Ese es el paso principal. Claude Code se encarga del resto.
Luego inicia Claude Code con la *flag* --chrome.
claude --chromeSi ya estás en una sesión, escribe /chrome para conectarte sin reiniciar.
La primera vez que lo hagas, Claude Code instala un archivo de configuración de host de mensajería nativa que Chrome lee al iniciarse. Si la extensión no se detecta en tu primer intento, reinicia Chrome e inténtalo de nuevo.
Si quieres que Chrome esté habilitado por defecto para no tener que pasar --chrome cada vez, ejecuta /chrome y selecciona "Habilitado por defecto". Sin embargo, hay algo a tener en cuenta. Habilitarlo por defecto aumenta el uso de contexto ya que las herramientas del navegador siempre están cargadas. Yo solo uso la *flag* cuando la necesito.
Uso
Una vez conectado, solo dile a Claude qué hacer en el navegador. Abre nuevas pestañas para las tareas del navegador y puedes ver todo suceder en tiempo real.
Abre localhost:3000, intenta enviar el formulario con datos no válidos,
y comprueba si los mensajes de error aparecen correctamente.También puede leer la salida de la consola, lo cual es genial para la depuración.
Abre el panel de control y comprueba la consola en busca de errores al cargar la página.Para sesiones autónomas donde Claude Code se ejecuta sin supervisión, combínalo con --dangerously-skip-permissions para que las acciones del navegador no requieran aprobación manual.
claude --chrome --dangerously-skip-permissionsSi algo falla
La conexión puede caerse durante sesiones largas cuando el *service worker* de la extensión de Chrome entra en estado de inactividad. Ejecuta /chrome y selecciona "Volver a conectar extensión" para solucionarlo.
Si aparece un diálogo de alerta o confirmación de JavaScript en la página, bloquea todos los eventos del navegador. Claude Code no puede descartarlo. Tienes que cerrarlo manualmente y luego indicarle a Claude que continúe.
Para la guía completa de solución de problemas, consulta la documentación oficial.