Skip to main content
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 /clear mientras 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: En las organizaciones Enterprise que tienen HIPAA habilitado, Claude en Chrome está desactivado de forma predeterminada, y un propietario puede activarlo en Configuración de la organización > Claude en Chrome. Tu Acuerdo de Asociado Comercial (BAA) con Anthropic no cubre los datos enviados a sitios de terceros a través de Claude en Chrome. Consulta la Guía de implementación para ver una lista de Servicios Elegibles. La integración de Chrome también requiere iniciar sesión con /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, porque la extensión del navegador no puede autenticarse con esas credenciales. Antes de v2.1.216, estas sesiones podí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

1

Lanzar Claude Code con Chrome

Inicia Claude Code con la bandera --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.
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 su terminal o editor:
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, consulte 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.
Dos políticas MCP administradas desactivan el aviso:

​
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 del 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, para que Claude pueda 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á 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.
Habilitar Chrome de forma predeterminada aumenta el uso del contexto, ya que las herramientas del navegador y sus instrucciones siempre se cargan. Si notas un aumento en el consumo de contexto, desactiva el ajuste y conéctate solo cuando sea necesario, con --chrome en la CLI o escribiendo @browser en el cuadro del prompt de VS Code.

​
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. En modo automático, cuando el 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 sus reglas de permisos denieguen cualquier sitio a Claude in Chrome.

​
Solicitudes de permiso en sesiones de VS Code

En una sesión de VS Code, cuando Claude Code te pregunta antes de una acción del 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 iniciar porque Enabled by default está activado, Claude Code te pregunta antes de las acciones del 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 Plan Mode

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 banderas de características está desactivada, estas llamadas se ejecutan sin una solicitud. Una llamada tabs_context_mcp también solicita aprobación cuando establece createIfEmpty, y lo mismo ocurre con una llamada browser_batch que incluya cualquiera de estas acciones.

​
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:
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:
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:
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:
Si Claude se niega a adjuntar un archivo o una carga falla, revisa estas causas:
  • 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 Read a 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.
  • Nombres de credenciales: Claude rechaza un archivo cuyo nombre o carpeta es uno de los que se usan para guardar credenciales, como .env, un archivo .pem o .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 configuración de API:
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:
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: