Saltar al contenido
claudemods

terminal-browser: un navegador en Claude Code con páginas web en vivo en un panel

Abre un navegador web real en un panel de Claude Code con /browser, dibujado con el protocolo de gráficos de kitty.

Permisos

  • Lee archivosPuede leer archivos y listar directorios en tu equipo ($.fs.read / list / stat / exists).
  • Ejecuta comandosPuede ejecutar programas de shell en tu equipo ($.process.run / spawn). Revisa el código fuente para ver exactamente cuáles.
  • RedPuede hacer peticiones HTTP o comunicarse con servidores MCP ($.http.fetch / $.mcp.*).
  • Intercepta llamadas a herramientasVe cada llamada a herramienta que hace Claude (tool.call / tool.check) y podría bloquearla o modificarla.
  • Modifica la interfazDibuja en la interfaz de Claude Code: bandas, paneles, texto de estado, avisos (ui.render / $.ui.*).
  • Añade comandos/herramientasRegistra nuevos comandos de barra o herramientas invocables por ti o por Claude ($.command.register / $.tool.register).
probado con
v2.1.310
última prueba
requiere
Claude Code ≥ 2.1.287
superficies
panel

Instalar dentro de Claude Code:

/plugin install terminal-browser --marketplace zenbu-labs/terminal-browser
Todas las opciones de instalación ↓

¿Qué hace este mod?

terminal-browser, de Zenbu Labs, es un mod de navegador en Claude Code: ejecuta un navegador web real dentro de Claude Code. Escribe /browser y se abre un panel junto a la conversación con una página en vivo. Escribe /browser example.com y se carga ese sitio. Ejecuta /browser otra vez, o /browser close, para cerrarlo. Puedes hacer clic, escribir y desplazarte en el panel, y la entrada llega a la página.

Un navegador basado en Chromium, parte del programa independiente terminal-browser, hace el renderizado. El plugin lo inicia, le envía el tamaño del panel y tu entrada de ratón y teclado, y dibuja sus fotogramas como imágenes en el panel. Por eso solo funciona en terminales que admiten el protocolo de gráficos de kitty, como Ghostty y kitty.

El plugin es útil cuando creas una aplicación web con Claude. Puedes revisar el servidor de desarrollo en localhost:3000 o leer un informe HTML sin salir de la sesión. El autor marca el plugin como experimental porque depende de la API de function hooks, que sigue cambiando.

Instalación

Usa el bloque de instalación, que añade el marketplace del autor e instala el plugin desde allí. También necesitas el programa terminal-browser en tu PATH (consulta las preguntas frecuentes). Ejecuta /reload-plugins en cualquier sesión que ya estuviera abierta.

$ install terminal-browser

Requiere Claude Code ≥ 2.1.287

Se instala desde el marketplace del autor: zenbu-labs/terminal-browser

  1. 1.Una línea, dentro de Claude Code

    /plugin install terminal-browser --marketplace zenbu-labs/terminal-browser

    Pégala en una sesión abierta (v2.1.275+). Claude Code te pedirá primero añadir el marketplace.

  2. 2.Desde tu shell

    claude plugin marketplace add zenbu-labs/terminal-browser
    claude plugin install terminal-browser@terminal-browser

    Después ejecuta /reload-plugins en cualquier sesión que ya esté abierta.

  3. 3.Pruébalo sin instalarlo

    git clone https://github.com/zenbu-labs/terminal-browser
    claude --plugin-dir ./terminal-browser/claude-code-plugin

    Carga el mod solo para una sesión. No se añade nada a tu configuración.

Cómo funciona

El plugin registra un comando /browser cuando una sesión se inicia en la terminal. El manejador del comando es corto. Está en hooks/register.tsx:

on('command.run', { command: 'browser' }, async ($, e) => {
  const arg = e.args.trim()
  if (arg === 'close' || (!arg && state.open)) {
    await closeBrowser($)
    return { text: 'Closed terminal-browser' }
  }
  const opened = await openBrowser($, arg || null)
  return { text: opened.ok ? 'Opened terminal-browser' : opened.error }
})

La primera vez que se abre el navegador, startBridge ejecuta terminal-browser capabilities para comprobar que la versión instalada admite embedding e image-frames. Después ejecuta terminal-browser claude-bridge launch, que imprime un puerto local y un token aleatorio. A partir de ahí, todo va por HTTP a 127.0.0.1 en ese puerto, con el token como cabecera bearer:

  • watchBridge hace long-polling a /state y copia cada fotograma nuevo en el panel con $.ui.blit. El fotograma viene de memoria compartida, así que ningún dato de imagen pasa por la respuesta HTTP.
  • surface.tsx recoge tus pulsaciones de teclas y eventos de ratón, aproximadamente cada 20 ms, y el plugin los envía por POST a /input. Los eventos de la rueda de desplazamiento siguen el mismo camino.
  • Los cambios de tamaño del panel se envían por POST a /size, y la primera URL a /open.
  • Cuando el navegador tiene texto para el agente, el plugin lo toma de /inbox/take y lo pone en tu cuadro de prompt con $.prompt.fill. Si el navegador adjuntó una captura de pantalla, también se añade su línea. No se envía nada hasta que pulses Enter.

Los nombres de host sin esquema se convierten en URL https:// y las direcciones localhost en http://. La función auxiliar está en hooks/urls.ts.

Personalízalo

El plugin tiene una sola opción, agentTool, desactivada por defecto. Cuando está activada, el plugin registra dos herramientas, open y close. Claude puede llamarlas para mostrar una página en el panel. Configúrala en /config o en pluginConfigs dentro de ~/.claude/settings.json, como muestra el README.

Otros plugins también pueden controlar el navegador. El plugin añade $.browser.open({ url }) y $.browser.close() al motor y distribuye los tipos en hooks/browser.d.ts. Con ellos, un mod puede añadir comandos como /tldraw o /open-pr que abren una página en el panel.

Permisos y seguridad

Leemos todos los archivos de claude-code-plugin/ en el commit 2165ae7. Son register.tsx, surface.tsx, bridge-protocol.ts, urls.ts y el archivo de tipos. El código es TypeScript simple, sin código minificado ni empaquetado.

  • Ejecuta comandos ($.process.run): solo el programa terminal-browser, con capabilities y claude-bridge launch. Son arrays de argv con tiempos límite de 10 s y 20 s. En un checkout de desarrollo ejecuta node ../cli/dist/main.js en su lugar, si ese archivo existe.
  • Red ($.http.fetch): solo http://127.0.0.1:<port>, el puente local iniciado arriba, con un token por lanzamiento. El README señala que tu sistema operativo puede preguntar si tu terminal puede acceder a la red local.
  • Rellena el prompt ($.prompt.fill): el texto que el navegador envía para el agente se coloca en el cuadro de entrada. Nunca se envía por sí solo.
  • Añade herramientas ($.tool.register): solo cuando activas agentTool.
  • No escribe archivos, no cambia ajustes y no lee tu transcripción.

El navegador en sí es el programa independiente terminal-browser. Se instala con un script curl | bash y no forma parte de este plugin. En el mismo repositorio, ese programa tiene código que envía eventos de uso anónimos (lanzamiento, activo diario, actualización, tipo de fallo) al endpoint de la UE de PostHog. El código los omite cuando DO_NOT_TRACK o TERMINAL_BROWSER_NO_TELEMETRY están definidas. El navegador también carga los sitios que abras, como cualquier navegador.

Lee archivos
Puede leer archivos y listar directorios en tu equipo ($.fs.read / list / stat / exists).
Ejecuta comandos
Puede ejecutar programas de shell en tu equipo ($.process.run / spawn). Revisa el código fuente para ver exactamente cuáles.
Red
Puede hacer peticiones HTTP o comunicarse con servidores MCP ($.http.fetch / $.mcp.*).
Intercepta llamadas a herramientas
Ve cada llamada a herramienta que hace Claude (tool.call / tool.check) y podría bloquearla o modificarla.
Modifica la interfaz
Dibuja en la interfaz de Claude Code: bandas, paneles, texto de estado, avisos (ui.render / $.ui.*).
Añade comandos/herramientas
Registra nuevos comandos de barra o herramientas invocables por ti o por Claude ($.command.register / $.tool.register).

Compatibilidad y solución de problemas

Validamos el plugin con claude plugin validate en Claude Code 2.1.310 en el commit 2165ae7. La validación pasó con un aviso sobre el directorio del plugin. El plugin no tiene tests, así que no se ejecutó claude plugin test. El repositorio original ha avanzado desde ese commit, pero ninguno de los commits posteriores toca claude-code-plugin/, así que el código revisado sigue siendo el plugin actual. Esta es una página de nivel estándar: sin grabación de demo. Se requieren function hooks, por lo que necesitas Claude Code 2.1.287 o posterior.

  • /browser dice "Please install terminal-browser first": instala el programa y asegúrate de que está en tu PATH.
  • Dice que se requiere una versión más reciente: ejecuta terminal-browser upgrade.
  • La pantalla se ve ilegible o el panel queda vacío: lo más probable es que tu terminal no admita gráficos de kitty con marcadores unicode, o que estés dentro de tmux u otro multiplexor.
  • El ratón queda ligeramente desviado: el README lo enumera como limitación conocida, porque Claude Code no informa de posiciones de ratón en píxeles.
  • El panel no se ensancha: Claude Code mantiene un ancho mínimo para el área del chat.

Preguntas frecuentes

¿Necesito algo más que el plugin para usar este navegador en Claude Code?
Sí. El plugin solo dibuja el panel; el navegador en sí es el programa terminal-browser, que se instala por separado (curl -fsSL https://terminal-browser.sh/install | bash, o brew install terminal-browser). Sin él, /browser responde "Please install terminal-browser first". Si la versión instalada es demasiado antigua, te pide ejecutar terminal-browser upgrade.
¿En qué terminales funciona?
Solo en terminales que admiten el protocolo de gráficos de kitty con marcadores unicode, como Ghostty, kitty y terminales basadas en libghostty como cmux y supacode. En otras terminales el README advierte de que abrir el navegador puede dejar la pantalla ilegible. Los multiplexores como tmux suelen romperlo por ahora.
¿Puede Claude abrir páginas en el navegador por sí solo?
Solo si activas la opción agentTool, que viene desactivada por defecto. Añade las herramientas open y close que el modelo puede llamar. Sin ella, Claude aún puede usar la CLI de terminal-browser para abrir el navegador en un panel dividido, como indica el README.
¿Cómo cierro el panel del navegador?
Ejecuta /browser close, o /browser sin argumento mientras el panel esté abierto. Cerrar el panel en Claude Code también avisa a terminal-browser de que el navegador se cerró.
¿Pueden otros mods abrir el navegador?
Sí. El plugin añade $.browser.open({ url }) y $.browser.close() para los hooks de otros plugins. El README muestra un comando /tldraw creado de esta forma.
Agent Profiler funcionando en Claude CodeDestacado

Agent Profiler

Adónde va el tiempo de una sesión de Claude Code: modelo, herramientas, subagentes, en vivo. Con exportación OTLP.

  • estado
  • panel
  • aviso
  • Escribe archivos
  • Red
  • Intercepta llamadas a herramientas
  • Modifica la interfaz
  • Añade comandos/herramientas

probado con v2.1.303

Agent Radar funcionando en Claude CodeDestacado

Agent Radar

Una línea en vivo sobre el prompt por subagente en ejecución: tiempo, herramientas y acción actual, más un panel /radar.

  • sobre el prompt
  • panel
  • aviso
  • Intercepta llamadas a herramientas
  • Lee tus prompts
  • Modifica la interfaz
  • Añade comandos/herramientas

probado con v2.1.291

Agent Tree funcionando en Claude CodeDestacado

Agent Tree

Un panel lateral que dibuja los subagentes como cajas, con la sesión principal, el asesor y un registro de la sesión.

  • panel
  • estado
  • Intercepta llamadas a herramientas
  • Lee tus prompts
  • Modifica la interfaz
  • Añade comandos/herramientas

probado con v2.1.310

Context Inspector funcionando en Claude CodeDestacado

Context Inspector

Muestra qué llena el contexto de Claude Code, cuánto es desperdicio y qué conservó la compactación.

  • estado
  • panel
  • aviso
  • Escribe archivos
  • Intercepta llamadas a herramientas
  • Lee tus prompts
  • Modifica la interfaz
  • Añade comandos/herramientas

probado con v2.1.303

Más en Paneles y dashboards, Herramientas que añades a Claude.