- 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, Ultra, Team o Enterprise)
/login. Si te autenticas con una clave de 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. La extensión del navegador no puede autenticarse con esas credenciales.
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
1
Inicia Claude Code con Chrome
Inicia Claude Code con el flag La primera vez que lo inicias con Chrome, Claude Code muestra un diálogo único que presenta la integración y explica cómo funcionan los permisos de sitio. Presiona Enter para continuar.Para habilitar Chrome en futuras sesiones sin el flag, consulta Habilitar Chrome de forma predeterminada.
--chrome:2
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 tu terminal o editor:Si Claude Code te pide permiso antes de una acción en el navegador, apruébala. 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 y comienza la tarea./chrome en cualquier momento para comprobar 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 hay más de un navegador conectado, tú eliges cuál usa Claude. Cuando una acción en el navegador comienza antes de que hayas elegido, Claude te pide que elijas uno. Para cambiar de navegador más adelante, ejecuta /chrome y selecciona Select browser…. Claude sigue usando tu 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 solicite
Cuando Claude necesita tu navegador en una sesión interactiva y Claude Code no detecta la extensión, Claude Code muestra una solicitud de instalación titulada “Claude wants to use your browser”. Claude Code pregunta como máximo una vez por sesión. La solicitud ofrece tres opciones:- Install extension: abre la página de instalación de la extensión en tu navegador e inicia una configuración guiada. Claude Code espera a que se complete la instalación, conecta la extensión y habilita las herramientas del navegador en la misma sesión. Cuando la conexión esté lista, selecciona “Continue with browser tools” y Claude retoma la tarea en tu navegador. Puedes salir de la configuración seleccionando “Continue without browser tools” y terminarla más tarde con
/chrome. - Not now: continúa la tarea sin herramientas del navegador. Claude Code puede volver a preguntar en una sesión posterior.
- Don’t ask again: detiene la solicitud en futuras sesiones. Aún puedes configurar la integración en cualquier momento con
/chrome.
- Si tu organización bloquea el servidor MCP
claude-in-chromecon el ajuste administradodeniedMcpServers, Claude Code no muestra la solicitud de instalación. - Si tu organización implementa un archivo
managed-mcp.jsonsin permitir Claude in Chrome junto con el conjunto administrado, Claude Code no muestra la solicitud de instalación.
Habilitar Chrome de forma predeterminada
Para conectar Chrome sin pasar--chrome cada vez, ejecuta /chrome en una sesión de la CLI y selecciona Enabled by default. En la extensión de VS Code, escribe /chrome en el cuadro de prompt y activa el interruptor Enabled by default. Ambos comparten un mismo ajuste, así que activarlo en cualquiera de los dos lugares lo activa tanto para la CLI como para VS Code.
Con el ajuste activado y Claude Code v2.1.287 o posterior, cada sesión de VS Code se conecta a tu navegador al iniciarse, de modo que Claude puede usarlo antes de que escribas @browser. En versiones anteriores, o con el ajuste desactivado, una sesión de VS Code se conecta cuando escribes @browser.
Claude Code se inicia normalmente cuando Chrome no está en ejecución.
Habilitar Chrome de forma predeterminada aumenta el uso de contexto, ya que las herramientas del navegador y sus instrucciones siempre están cargadas. Si notas un mayor consumo de contexto, desactiva el ajuste y conéctate solo cuando lo necesites, con
--chrome en la CLI o escribiendo @browser en el cuadro de prompt de VS Code.Responder al diálogo de inicio
Si aparece el diálogo “Claude in Chrome extension detected” cuando iniciasclaude, tu respuesta cambia el ajuste Enabled by default:
- Yes, use my browser: activa el ajuste y conecta esta sesión
- No, keep browser tools off, o Esc: desactiva el ajuste, y Claude Code deja de ofrecer configurar Chrome
/chrome.
Administrar permisos de sitio
Los permisos a nivel de sitio se heredan de la extensión de Chrome. Administra los permisos en la configuración de la extensión de Chrome para controlar en qué sitios Claude puede navegar, hacer clic y escribir. En modo automático, cuando el propio clasificador del modo automático aprueba una llamada del navegador a un sitio, la extensión omite su propia verificación por sitio para esa llamada, a menos que tus reglas de permisos denieguen algún sitio a Claude in Chrome.Solicitudes de permiso en sesiones de VS Code
En una sesión de VS Code, cuando Claude Code pregunta antes de una acción en el navegador, la solicitud aparece como una tarjeta en el panel de chat. Cuando la acción se dirige a un sitio que no has permitido, la tarjeta también ofrece permitir ese sitio. En una sesión que se conectó a tu navegador al iniciarse porque Enabled by default está activado, Claude Code te pregunta antes de realizar acciones en el navegador en un sitio que no has permitido, en los modos de permisos Manual, Edit automatically, Auto y Bypass permissions. En los modos de permisos Auto y Bypass permissions, esto se aplica hasta que escribas@browser en esa sesión.
Herramientas del navegador en modo plan
En modo plan, aparece una solicitud de permiso antes de que Claude grabe un GIF, abra una nueva pestaña o ejecute un atajo. En una sesión interactiva de la CLI, si el modo bypass permissions está disponible y la obtención de feature flags está desactivada, estas llamadas se ejecutan sin solicitud. Una llamada atabs_context_mcp también solicita permiso cuando establece createIfEmpty, al igual que una llamada a browser_batch que incluya cualquiera de estas acciones.
Ejemplos de flujos de trabajo
Estos ejemplos muestran formas comunes de combinar acciones del navegador con tareas de programación. Ejecuta/mcp, selecciona claude-in-chrome y luego selecciona View tools para ver la lista completa de herramientas del navegador disponibles.
Probar una aplicación web local
Cuando desarrolles una aplicación web, pídele a Claude que verifique que tus cambios funcionen correctamente:Depurar con registros de la consola
Claude puede leer la salida de la consola para ayudar a diagnosticar problemas. Indícale a Claude qué patrones buscar en lugar de pedirle toda la salida de la consola, ya que los registros pueden ser extensos:Automatizar el llenado de formularios
Agiliza las tareas repetitivas de ingreso de datos:Subir archivos a páginas web
Claude puede adjuntar archivos de tu máquina a los campos de carga de 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. Este ejemplo adjunta un archivo de log a un formulario:- Permisos: Claude solo puede subir un archivo cuando la sesión tiene permitido leerlo, por lo que las reglas de permisos que deniegan el acceso de
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 varios enlaces duros, algo común dentro de los almacenes de gestores de paquetes como
node_modules. Copia el archivo y sube la copia. - Nombres de credenciales: Claude rechaza un archivo cuyo nombre o carpeta sea uno en el que se guardan credenciales, como
.env, un archivo.pemo.key, o cualquier cosa dentro de.ssh. Requiere Claude Code v2.1.293 o posterior.
Redactar contenido en Google Docs
Usa Claude para escribir directamente en tus documentos sin configurar una API:Extraer datos de páginas web
Obtén información estructurada de sitios web:Ejecutar flujos de trabajo en varios sitios
Coordina tareas en varios sitios web:Grabar un GIF de demostración
Crea grabaciones compartibles de interacciones en el navegador:Guardar capturas de pantalla en el disco
Pídele a Claude que conserve una captura de pantalla como 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
- 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
- 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
~/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\.
La configuración del proyecto no puede activar Chrome
Esta advertencia en tu terminal significa que el proyecto en el que estás trabajando intentó activar la integración de Chrome, y Claude Code no lo permitió:.claude/settings.json o .claude/settings.local.json del proyecto establece CLAUDE_CODE_ENABLE_CFC en 1 en su bloque env para activar la integración de Chrome. Claude Code no aplicó ese ajuste, por lo que la integración de Chrome está desactivada en esta sesión y Claude no tiene herramientas del navegador.
Claude Code omite el ajuste porque esos archivos se almacenan en el directorio del proyecto, y un repositorio que descargas no debe poder conectar a Claude con tu navegador.
Puedes seguir trabajando como estás. Si quieres herramientas del navegador, o quieres que desaparezca la advertencia, haz una de estas cosas:
- Para obtener herramientas del navegador ahora: sal y vuelve a iniciar con
claude --chromeen tu shell. - Para obtener herramientas del navegador en sesiones posteriores: ejecuta
/chromeen el prompt de Claude Code y selecciona Habilitado de forma predeterminada. Esto se aplica a las sesiones que inicies después, no a la que está en ejecución. - Para detener la advertencia sin herramientas del navegador: elimina la línea
CLAUDE_CODE_ENABLE_CFCdel archivo de configuración del proyecto.
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”.
Cuando ejecutes /chrome, revisa su línea Status. Si indica “No conectado”, la propia conexión de la sesión en ejecución con Chrome ha fallado. Selecciona “Reconectar extensión” para reiniciar esa conexión. Después de que la conexión tenga éxito, la página de reconexión de la extensión se abre en Chrome. Antes de v2.1.290, “Reconectar extensión” solo abría esa página y no reiniciaba una conexión fallida, así que si las herramientas del navegador no regresan en una versión anterior, actualiza Claude Code.
Extensión con sesión iniciada en una organización diferente
Si perteneces a más de una organización de claude.ai, la extensión debe tener la sesión iniciada en la misma organización que Claude Code. Si las dos difieren, las herramientas del navegador de Claude devuelven “Browser extension is not connected”, incluso cuando ambas usan la misma cuenta de claude.ai. Para ver en qué organización tiene la sesión iniciada Claude Code, ejecuta/status en el prompt de Claude Code y lee la fila Organization.
Para cambiar la organización de la extensión, cierra sesión en la configuración de la extensión, luego inicia sesión y selecciona la organización que muestra /status.
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: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