Usar Claude Code con Chrome
Conecta Claude Code a tu navegador Chrome para probar aplicaciones web, depurar con registros de consola, automatizar el relleno de formularios y extraer datos de páginas web.
Claude Code se integra con la extensión del navegador Claude en Chrome para brindarte capacidades de automatización del navegador desde la CLI o la extensión de VS Code. Construye tu código, luego prueba y depura en el navegador sin cambiar de contexto.
Claude abre nuevas pestañas para tareas del navegador y comparte el estado de inicio de sesión de tu navegador, por lo que puede acceder a cualquier sitio en el que ya hayas iniciado sesión. Las acciones del navegador se ejecutan en una ventana de Chrome visible en tiempo real. Cuando Claude encuentra una página de inicio de sesión o CAPTCHA, se detiene y te pide que lo manejes manualmente.
La extensión recopila las pestañas que Claude abre en un grupo de pestañas de Chrome vinculado a tu sesión. En sesiones locales, si Claude Code cierra ese grupo cuando finaliza la sesión depende de cómo finalice:
- Cuando escribes
/clear, Claude Code cierra el grupo, incluidas las páginas abiertas, a menos que el trabajo que sobrevive al clear aún se esté ejecutando - Cuando cambias de sesiones con un comando como
/resume, sales de Claude Code, o ejecutas un/clearmientras el trabajo que lo sobrevive aún se está ejecutando, Claude Code cierra el grupo solo si no contiene nada más que pestañas nuevas vacías, por lo que las páginas que aún podrías estar leyendo permanecen abiertas
La integración de Chrome funciona con Google Chrome y Microsoft Edge. Claude Code también detecta la extensión y configura la conexión en otros navegadores basados en Chromium, incluidos Brave, Arc, Vivaldi y Opera. La integración de Chrome no es compatible en Windows Subsystem for Linux (WSL).
Capacidades
Con Chrome conectado, puedes encadenar acciones del navegador con tareas de codificación en un único flujo de trabajo:
- Depuración en vivo: lee errores de consola y estado del DOM directamente, luego corrige el código que los causó
- Verificación de diseño: construye una interfaz de usuario a partir de un mock de Figma, luego ábrelo en el navegador para verificar que coincida
- Prueba de aplicaciones web: prueba la validación de formularios, verifica regresiones visuales o verifica flujos de usuario
- Aplicaciones web autenticadas: interactúa con Google Docs, Gmail, Notion o cualquier aplicación en la que hayas iniciado sesión sin conectores de API
- Extracción de datos: extrae información estructurada de páginas web y guárdala localmente
- Automatización de tareas: automatiza tareas repetitivas del navegador como entrada de datos, relleno de formularios o flujos de trabajo multisitio
- Carga de archivos: adjunta archivos de tu máquina para cargarlos en campos de carga en páginas web
- Grabación de sesión: graba interacciones del navegador como GIF para documentar o compartir lo que sucedió
Requisitos previos
Antes de usar Claude Code con Chrome, necesitas:
- Google Chrome, Microsoft Edge, u otro navegador basado en Chromium como Brave, Arc, Vivaldi u Opera
- Extensión Claude en Chrome versión 1.0.36 o superior, disponible en la Chrome Web Store
- Claude Code
- Un plan directo de Anthropic (Pro, Max, Team o Enterprise)
La integración de Chrome también requiere iniciar sesión con /login. Si te autenticas con una clave API o un token de larga duración de claude setup-token, Claude Code mantiene la integración de Chrome desactivada, incluso cuando pasas --chrome, porque la extensión del navegador no puede autenticarse con esas credenciales. Antes de v2.1.216, estas sesiones podrían habilitar la integración de Chrome, pero cada intento de conectarse a la extensión del navegador fallaba con un error 403.
La integración de Chrome no está disponible a través de proveedores de terceros como Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry. Si accedes a Claude exclusivamente a través de un proveedor de terceros, necesitas una cuenta separada de claude.ai para usar esta función.
Comenzar en la CLI
Lanzar Claude Code con Chrome
Inicia Claude Code con la bandera --chrome:
claude --chrome
La primera vez que inicia con Chrome, Claude Code muestra un diálogo único que presenta la integración y explica cómo funcionan los permisos del sitio. Presione Intro para continuar.
Para habilitar Chrome para futuras sesiones sin la bandera, consulte Habilitar Chrome de forma predeterminada.
Pídele a Claude que use el navegador
Este ejemplo navega a una página, interactúa con ella e informa lo que encuentra, todo desde su terminal o editor:
Go to code.claude.com/docs, click on the search box,
type "hooks", and tell me what results appear
Si Claude Code solicita permiso antes de una acción del navegador, apruébalo. El diálogo comienza con Claude in Chrome wants to y ofrece una opción para permitir todas las acciones en ese sitio durante la sesión. Claude abre una nueva pestaña e inicia la tarea.
Ejecuta /chrome en cualquier momento para verificar el estado de la conexión, administrar permisos, reconectar la extensión o elegir qué navegador conectado usar. La integración funciona cuando el panel de estado muestra "Status: Enabled" y "Extension: Installed".
Si más de un navegador está conectado, usted elige cuál usa Claude. Cuando una acción del navegador comienza antes de que haya elegido, Claude le solicita que elija uno. Para cambiar de navegador más tarde, ejecuta /chrome y selecciona Select browser…. Claude sigue usando su elección incluso cuando se conecta otro navegador.
Para VS Code, consulta automatización del navegador en VS Code.
Instalar la extensión cuando Claude lo solicita
Cuando Claude necesita su navegador en una sesión interactiva y Claude Code no detecta la extensión, Claude Code muestra un aviso de instalación titulado "Claude wants to use your browser". Claude Code pregunta como máximo una vez por sesión.
El aviso ofrece tres opciones:
- Install extension: abre la página de instalación de la extensión en su navegador e inicia una configuración guiada. Claude Code espera la instalación, conecta la extensión y habilita las herramientas del navegador en la misma sesión. Cuando la conexión esté lista, seleccione "Continue with browser tools" y Claude reanuda la tarea en su navegador. Puede abandonar la configuración seleccionando "Continue without browser tools" y terminar más tarde con
/chrome. - Not now: continúa la tarea sin herramientas del navegador. Claude Code puede preguntar nuevamente en una sesión posterior.
- Don't ask again: detiene el aviso en futuras sesiones. Aún puede configurar la integración en cualquier momento con
/chrome.
Si su organización bloquea el servidor MCP claude-in-chrome con la configuración administrada deniedMcpServers, Claude Code no muestra el aviso de instalación.
Habilitar Chrome de forma predeterminada
Para evitar pasar --chrome en cada sesión, ejecuta /chrome y selecciona "Enabled by default".
Claude Code se inicia normalmente cuando Chrome no está ejecutándose. Antes de v2.1.211, el inicio podría colgarse cuando la integración de Chrome estaba habilitada pero Chrome no estaba ejecutándose.
En la extensión de VS Code, Chrome está disponible siempre que la extensión de Chrome esté instalada. No se necesita ninguna bandera adicional.
Habilitar Chrome de forma predeterminada en la CLI aumenta el uso del contexto ya que las herramientas del navegador siempre se cargan. Si nota un aumento en el consumo de contexto, deshabilite esta configuración y use --chrome solo cuando sea necesario.
Administrar permisos del sitio
Los permisos a nivel de sitio se heredan de la extensión de Chrome. Administre los permisos en la configuración de la extensión de Chrome para controlar qué sitios puede examinar Claude, hacer clic e introducir texto.
Herramientas del navegador en plan mode
En plan mode, las llamadas de herramientas del navegador que solo leen la página o el estado del navegador se ejecutan sin un aviso de permiso, y las llamadas que cambian el estado solicitan aprobación.
- Llamadas de solo lectura:
read_page,get_page_text,find, lectura de mensajes de consola o solicitudes de red, y captura de pantalla - Llamadas que cambian el estado: clics, escritura, navegación, gestión de pestañas y ventanas, y grabación de un GIF
Una llamada que de otro modo sería de solo lectura también solicita aprobación cuando establece una bandera de entrada que cambia el estado, como createIfEmpty en tabs_context_mcp, clear en los lectores de consola y red, o save_to_disk en una captura de pantalla. Una llamada browser_batch se ejecuta sin un aviso solo cuando cada acción dentro de ella es de solo lectura.
Flujos de trabajo de ejemplo
Estos ejemplos muestran formas comunes de combinar acciones del navegador con tareas de codificación. Ejecuta /mcp, selecciona claude-in-chrome y luego selecciona Ver herramientas para ver la lista completa de herramientas del navegador disponibles.
Probar una aplicación web local
Al desarrollar una aplicación web, pídele a Claude que verifique que tus cambios funcionen correctamente:
I just updated the login form validation. Can you open localhost:3000,
try submitting the form with invalid data, and check if the error
messages appear correctly?
Claude navega a tu servidor local, interactúa con el formulario e informa lo que observa.
Depurar con registros de consola
Claude puede leer la salida de la consola para ayudar a diagnosticar problemas. Dile a Claude qué patrones buscar en lugar de pedirle toda la salida de la consola, ya que los registros pueden ser detallados:
Open the dashboard page and check the console for any errors when
the page loads.
Claude lee los mensajes de la consola y puede filtrar patrones específicos o tipos de error.
Automatizar el relleno de formularios
Acelera tareas repetitivas de entrada de datos:
I have a spreadsheet of customer contacts in contacts.csv. For each row,
go to the CRM at crm.example.com, click "Add Contact", and fill in the
name, email, and phone fields.
Claude lee tu archivo local, navega por la interfaz web e introduce los datos para cada registro.
Cargar archivos en páginas web
Claude puede adjuntar archivos de tu máquina a campos de carga en una página. Claude Code lee el archivo y envía su contenido al navegador, por lo que las cargas funcionan tanto en sesiones locales como remotas. Requiere Claude Code v2.1.211 o posterior.
Este ejemplo adjunta un archivo de registro a un formulario:
Open the bug tracker at bugs.example.com, create a new issue,
and attach logs/session.log to it
Se aplican tres restricciones a las cargas:
- Permisos: Claude puede cargar un archivo solo cuando la sesión tiene permiso para leerlo, por lo que las reglas de permisos que deniegan acceso
Reada un archivo también bloquean su carga. - Tamaño: una sola carga puede incluir hasta 10 MB de archivos en total.
- Enlaces duros: Claude rechaza archivos que tienen múltiples enlaces duros, lo cual es común dentro de almacenes de administradores de paquetes como
node_modules. Copia el archivo y carga la copia.
Redactar contenido en Google Docs
Usa Claude para escribir directamente en tus documentos sin configuración de API:
Draft a project update based on the recent commits and add it to my
Google Doc at docs.google.com/document/d/abc123
Claude abre el documento, hace clic en el editor e introduce el contenido. Esto funciona con cualquier aplicación web en la que hayas iniciado sesión: Gmail, Notion, Sheets y más.
Extraer datos de páginas web
Extrae información estructurada de sitios web:
Go to the product listings page and extract the name, price, and
availability for each item. Save the results as a CSV file.
Claude navega a la página, lee el contenido y compila los datos en un formato estructurado.
Ejecutar flujos de trabajo multisitio
Coordina tareas en múltiples sitios web:
Check my calendar for meetings tomorrow, then for each meeting with
an external attendee, look up their company website and add a note
about what they do.
Claude trabaja en pestañas para recopilar información y completar el flujo de trabajo.
Grabar un GIF de demostración
Crea grabaciones compartibles de interacciones del navegador:
Record a GIF showing how to complete the checkout flow, from adding
an item to the cart through to the confirmation page.
Claude graba la secuencia de interacción y la guarda como un archivo GIF. La grabación captura todo lo visible en el navegador, incluidos los detalles de la cuenta en páginas con sesión iniciada, por lo que revísala antes de compartirla fuera de tu equipo.
Guardar capturas de pantalla en disco
Pídele a Claude que guarde una captura de pantalla como archivo:
Take a screenshot of the checkout page and save it to disk
Claude guarda la imagen en disco e informa la ruta del archivo. Antes de v2.1.211, la opción save_to_disk de la herramienta de captura de pantalla no escribía un archivo.
Solución de problemas
Extensión no detectada
Si Claude Code no puede detectar la extensión de Chrome:
- Verifica que la extensión de Chrome esté instalada y habilitada en
chrome://extensions - Verifica que Claude Code esté actualizado ejecutando
claude --version - Comprueba que Chrome se está ejecutando
- Ejecuta
/chromey selecciona "Reconectar extensión" para restablecer la conexión - Si el problema persiste, reinicia tanto Claude Code como Chrome
La primera vez que habilitas la integración de Chrome, Claude Code instala un archivo de configuración del host de mensajería nativa. Chrome lee este archivo al iniciarse, por lo que si la extensión no se detecta en tu primer intento, reinicia Chrome para recoger la nueva configuración.
Claude Code abre una pestaña del navegador pidiéndote que conectes la extensión solo en esa primera instalación. Claude Code no la vuelve a abrir cuando una sesión posterior reescribe el archivo de configuración, por ejemplo después de cambiar compilaciones o directorios de configuración.
Si la conexión aún falla, verifica que el archivo de configuración del host exista en:
Para Chrome:
- macOS:
~/Library/Application Support/Google/Chrome/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json - Linux:
~/.config/google-chrome/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json - Windows: comprueba
HKCU\Software\Google\Chrome\NativeMessagingHosts\en el Registro de Windows
Para Edge:
- macOS:
~/Library/Application Support/Microsoft Edge/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json - Linux:
~/.config/microsoft-edge/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json - Windows: comprueba
HKCU\Software\Microsoft\Edge\NativeMessagingHosts\en el Registro de Windows
Otros navegadores basados en Chromium leen el mismo archivo desde su propio directorio de configuración, nombrado según el navegador. Por ejemplo, Brave en macOS usa ~/Library/Application Support/BraveSoftware/Brave-Browser/NativeMessagingHosts/, y en Windows cada navegador tiene su propia clave de registro, como HKCU\Software\BraveSoftware\Brave-Browser\NativeMessagingHosts\.
El navegador no responde
Si los comandos del navegador de Claude dejan de funcionar:
- Comprueba si un cuadro de diálogo modal (alerta, confirmación, solicitud) está bloqueando la página. Los cuadros de diálogo de JavaScript bloquean eventos del navegador e impiden que Claude reciba comandos. Descarta el cuadro de diálogo manualmente, luego dile a Claude que continúe.
- Pídele a Claude que cree una nueva pestaña e intente de nuevo
- Reinicia la extensión de Chrome deshabilitándola y volviéndola a habilitar en
chrome://extensions
La conexión se cae durante sesiones largas
El trabajador de servicio de la extensión de Chrome puede quedarse inactivo durante sesiones extendidas, lo que rompe la conexión. Si las herramientas del navegador dejan de funcionar después de un período de inactividad, ejecuta /chrome y selecciona "Reconectar extensión".
Problemas específicos de Windows
En Windows, puedes encontrar:
- Conflictos de tuberías nombradas (EADDRINUSE): si otro proceso está usando la misma tubería nombrada, reinicia Claude Code. Cierra cualquier otra sesión de Claude Code que pueda estar usando Chrome.
- Errores del host de mensajería nativa: si el host de mensajería nativa falla al iniciarse, intenta reinstalar Claude Code para regenerar la configuración del host.
- Las páginas de configuración no se abren: actualiza Claude Code. Antes de v2.1.211, la pestaña del navegador que te pide que conectes la extensión podría no abrirse en Windows.
Mensajes de error comunes
Estos son los errores más frecuentes y cómo resolverlos:
| Error | Causa | Solución |
|---|---|---|
| "La extensión del navegador no está conectada" | El host de mensajería nativa no puede alcanzar la extensión, o la lista de permitidos de IP de tu organización rechaza la conexión a bridge.claudeusercontent.com |
Reinicia Chrome y Claude Code, luego ejecuta /chrome para reconectar. Si tu organización usa listas de permitidos de IP y el error persiste, consulta Listas de permitidos de IP de la organización y salida de proxy |
La extensión muestra "No detectada" en /chrome |
La extensión de Chrome no está instalada o está deshabilitada | Instala o habilita la extensión en chrome://extensions |
| "No hay pestaña disponible" | Claude intentó actuar antes de que una pestaña estuviera lista | Pídele a Claude que cree una nueva pestaña e intente de nuevo |
| "El extremo receptor no existe" | El trabajador de servicio de la extensión se quedó inactivo | Ejecuta /chrome y selecciona "Reconectar extensión" |
Ver también
- Usar la computadora: controlar aplicaciones nativas de macOS cuando una tarea no se puede realizar en un navegador
- Usar Claude Code en VS Code: automatización del navegador en la extensión de VS Code
- Referencia de CLI: banderas de línea de comandos incluyendo
--chrome - Flujos de trabajo comunes: más formas de usar Claude Code
- Datos y privacidad: cómo Claude Code maneja sus datos
- Comenzar con Claude en Chrome: documentación completa para la extensión de Chrome, incluyendo atajos de teclado, programación y permisos