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
- código fuente
- Zenbu Labs (zenbu-labs) (MIT)
Instalar dentro de Claude Code:
/plugin install terminal-browser --marketplace zenbu-labs/terminal-browser¿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.Una línea, dentro de Claude Code
/plugin install terminal-browser --marketplace zenbu-labs/terminal-browserPégala en una sesión abierta (v2.1.275+). Claude Code te pedirá primero añadir el marketplace.
2.Desde tu shell
claude plugin marketplace add zenbu-labs/terminal-browser claude plugin install terminal-browser@terminal-browserDespués ejecuta /reload-plugins en cualquier sesión que ya esté abierta.
3.Pruébalo sin instalarlo
git clone https://github.com/zenbu-labs/terminal-browser claude --plugin-dir ./terminal-browser/claude-code-pluginCarga 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:
watchBridgehace long-polling a/statey 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.tsxrecoge 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/takey 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 programaterminal-browser, concapabilitiesyclaude-bridge launch. Son arrays de argv con tiempos límite de 10 s y 20 s. En un checkout de desarrollo ejecutanode ../cli/dist/main.jsen su lugar, si ese archivo existe. - Red (
$.http.fetch): solohttp://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.
/browserdice "Please install terminal-browser first": instala el programa y asegúrate de que está en tuPATH.- 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.
# Mods relacionados
DestacadoAgent 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
DestacadoAgent 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
DestacadoAgent 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
DestacadoContext 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.