Zum Inhalt springen
claudemods

terminal-browser: ein echter Claude Code Browser im Pane für Live-Webseiten

Öffnet mit /browser einen echten Webbrowser in einem Pane in Claude Code, gezeichnet mit dem kitty-Grafikprotokoll.

Berechtigungen

  • Liest DateienKann Dateien lesen und Verzeichnisse auf deinem Rechner auflisten ($.fs.read / list / stat / exists).
  • Führt Befehle ausKann Shell-Programme auf deinem Rechner ausführen ($.process.run / spawn). Im Quellcode siehst du, welche genau.
  • NetzwerkKann HTTP-Anfragen senden oder mit MCP-Servern kommunizieren ($.http.fetch / $.mcp.*).
  • Fängt Tool-Aufrufe abSieht jeden Tool-Aufruf von Claude (tool.call / tool.check) und könnte ihn blockieren oder verändern.
  • Verändert die OberflächeZeichnet in die Oberfläche von Claude Code: Leisten, Bereiche, Statustext, Toasts (ui.render / $.ui.*).
  • Fügt Befehle/Tools hinzuRegistriert neue Slash-Befehle oder Tools, die du oder Claude aufrufen können ($.command.register / $.tool.register).
getestet mit
v2.1.310
zuletzt getestet
erfordert
Claude Code ≥ 2.1.287
Oberflächen
Bereich

In Claude Code installieren:

/plugin install terminal-browser --marketplace zenbu-labs/terminal-browser
Alle Installationswege ↓

Was macht diese Mod?

terminal-browser von Zenbu Labs ist eine Mod für einen Claude Code Browser: Sie lässt einen echten Webbrowser innerhalb von Claude Code laufen. Tippe /browser, und neben der Unterhaltung öffnet sich ein Pane mit einer Live-Seite. Tippe /browser example.com, und diese Seite wird geladen. Führe /browser erneut oder /browser close aus, um es zu schließen. Du kannst im Pane klicken, tippen und scrollen, und die Eingaben gehen an die Seite.

Ein Chromium-basierter Browser, Teil des separaten Programms terminal-browser, übernimmt das eigentliche Rendern. Das Plugin startet ihn, schickt ihm die Pane-Größe sowie deine Maus- und Tastatureingaben und zeichnet seine Frames als Bilder in das Pane. Deshalb funktioniert es nur in Terminals, die das kitty-Grafikprotokoll unterstützen, etwa Ghostty und kitty.

Das Plugin ist nützlich, wenn du mit Claude eine Web-App baust. Du kannst den Dev-Server unter localhost:3000 prüfen oder einen HTML-Bericht lesen, ohne die Sitzung zu verlassen. Der Autor kennzeichnet das Plugin als experimentell, weil es auf der Function-Hooks-API aufbaut, die sich noch ändert.

Installation

Nutze den Installationsblock, der den Marketplace des Autors hinzufügt und das Plugin daraus installiert. Außerdem brauchst du das Programm terminal-browser im PATH (siehe FAQ). Führe in jeder bereits geöffneten Sitzung /reload-plugins aus.

$ install terminal-browser

Erfordert Claude Code ≥ 2.1.287

Wird aus dem Marketplace des Autors installiert: zenbu-labs/terminal-browser

  1. 1.Eine Zeile, direkt in Claude Code

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

    In eine laufende Sitzung einfügen (v2.1.275+). Claude Code fragt zuerst, ob der Marketplace hinzugefügt werden soll.

  2. 2.Aus deiner Shell

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

    Führe danach in jeder bereits geöffneten Sitzung /reload-plugins aus.

  3. 3.Ohne Installation ausprobieren

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

    Lädt die Mod nur für eine Sitzung. An deinen Einstellungen wird nichts geändert.

So funktioniert es

Das Plugin registriert einen Befehl /browser, wenn im Terminal eine Sitzung startet. Der Befehls-Handler ist kurz. Er stammt aus 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 }
})

Beim ersten Öffnen des Browsers führt startBridge terminal-browser capabilities aus, um zu prüfen, ob die installierte Version embedding und image-frames unterstützt. Danach läuft terminal-browser claude-bridge launch, das einen lokalen Port und ein zufälliges Token ausgibt. Ab dann läuft alles per HTTP an 127.0.0.1 auf diesem Port, mit dem Token als Bearer-Header:

  • watchBridge fragt /state per Long-Polling ab und kopiert jeden neuen Frame mit $.ui.blit ins Pane. Der Frame kommt aus gemeinsamem Speicher, daher laufen keine Bilddaten durch die HTTP-Antwort.
  • surface.tsx sammelt deine Tastendrücke und Mausereignisse, etwa alle 20 ms, und das Plugin sendet sie per POST an /input. Scrollrad-Ereignisse gehen denselben Weg.
  • Änderungen der Pane-Größe gehen per POST an /size, die erste URL an /open.
  • Hat der Browser Text für den Agenten, holt das Plugin ihn von /inbox/take und setzt ihn mit $.prompt.fill in dein Prompt-Feld. Hat der Browser einen Screenshot angehängt, wird auch dessen Zeile ergänzt. Gesendet wird nichts, bis du Enter drückst.

Nackte Hostnamen werden zu https://-URLs, localhost-Adressen zu http://. Die Hilfsfunktion steht in hooks/urls.ts.

Anpassen

Das Plugin hat eine Option, agentTool, die standardmäßig aus ist. Ist sie an, registriert das Plugin zwei Tools, open und close. Claude kann sie aufrufen, um eine Seite im Pane zu zeigen. Setze sie in /config oder unter pluginConfigs in ~/.claude/settings.json, wie die README zeigt.

Auch andere Plugins können den Browser steuern. Das Plugin fügt der Engine $.browser.open({ url }) und $.browser.close() hinzu und liefert die Typen in hooks/browser.d.ts mit. Damit kann eine Mod Befehle wie /tldraw oder /open-pr ergänzen, die eine Seite im Pane öffnen.

Berechtigungen & Sicherheit

Wir haben jede Datei in claude-code-plugin/ beim Commit 2165ae7 gelesen. Das sind register.tsx, surface.tsx, bridge-protocol.ts, urls.ts und die Typdatei. Der Code ist einfaches TypeScript, ohne minifizierten oder gebündelten Code.

  • Führt Befehle aus ($.process.run): nur das Programm terminal-browser, mit capabilities und claude-bridge launch. Das sind argv-Arrays mit Timeouts von 10 s und 20 s. In einem Entwicklungs-Checkout läuft stattdessen node ../cli/dist/main.js, falls diese Datei existiert.
  • Netzwerk ($.http.fetch): nur http://127.0.0.1:<port>, die oben gestartete lokale Bridge, mit einem Token pro Start. Die README weist darauf hin, dass dein Betriebssystem fragen kann, ob dein Terminal auf das lokale Netzwerk zugreifen darf.
  • Füllt den Prompt ($.prompt.fill): Text, den der Browser für den Agenten schickt, landet im Eingabefeld. Er wird nie von selbst abgeschickt.
  • Fügt Tools hinzu ($.tool.register): nur wenn du agentTool einschaltest.
  • Sie schreibt keine Dateien, ändert keine Einstellungen und liest dein Transkript nicht.

Der Browser selbst ist das separate Programm terminal-browser. Es wird mit einem curl | bash-Skript installiert und ist nicht Teil dieses Plugins. Im selben Repository enthält dieses Programm Code, der anonyme Nutzungsereignisse (Start, täglich aktiv, Upgrade, Absturztyp) an den EU-Endpunkt von PostHog sendet. Der Code überspringt sie, wenn DO_NOT_TRACK oder TERMINAL_BROWSER_NO_TELEMETRY gesetzt ist. Der Browser lädt außerdem alle Seiten, die du öffnest, wie jeder Browser.

Liest Dateien
Kann Dateien lesen und Verzeichnisse auf deinem Rechner auflisten ($.fs.read / list / stat / exists).
Führt Befehle aus
Kann Shell-Programme auf deinem Rechner ausführen ($.process.run / spawn). Im Quellcode siehst du, welche genau.
Netzwerk
Kann HTTP-Anfragen senden oder mit MCP-Servern kommunizieren ($.http.fetch / $.mcp.*).
Fängt Tool-Aufrufe ab
Sieht jeden Tool-Aufruf von Claude (tool.call / tool.check) und könnte ihn blockieren oder verändern.
Verändert die Oberfläche
Zeichnet in die Oberfläche von Claude Code: Leisten, Bereiche, Statustext, Toasts (ui.render / $.ui.*).
Fügt Befehle/Tools hinzu
Registriert neue Slash-Befehle oder Tools, die du oder Claude aufrufen können ($.command.register / $.tool.register).

Kompatibilität & Fehlerbehebung

Wir haben das Plugin mit claude plugin validate unter Claude Code 2.1.310 beim Commit 2165ae7 geprüft. Die Validierung ging mit einer Warnung zum Plugin-Verzeichnis durch. Das Plugin hat keine Tests, daher wurde claude plugin test nicht ausgeführt. Das Upstream-Repository ist seit diesem Commit weitergegangen, aber keiner der späteren Commits berührt claude-code-plugin/, sodass der geprüfte Code weiterhin das aktuelle Plugin ist. Dies ist eine Standard-Seite: keine Demo-Aufnahme. Function Hooks sind erforderlich, daher brauchst du Claude Code 2.1.287 oder neuer.

  • /browser meldet „Please install terminal-browser first“: Installiere das Programm und stelle sicher, dass es im PATH liegt.
  • Es meldet, dass eine neuere Version nötig ist: Führe terminal-browser upgrade aus.
  • Der Bildschirm ist durcheinander oder das Pane bleibt leer: Dein Terminal unterstützt wahrscheinlich kein kitty-Grafikprotokoll mit Unicode-Platzhaltern, oder du bist in tmux oder einem anderen Multiplexer.
  • Die Maus ist leicht daneben: Die README führt das als bekannte Einschränkung auf, weil Claude Code keine Pixel-Mauspositionen meldet.
  • Das Pane lässt sich nicht breiter ziehen: Claude Code behält eine Mindestbreite für den Chatbereich.

FAQ

Brauche ich außer dem Plugin noch etwas, um diesen Claude Code Browser zu nutzen?
Ja. Das Plugin zeichnet nur das Pane; der Browser selbst ist das Programm terminal-browser, das du separat installierst (curl -fsSL https://terminal-browser.sh/install | bash oder brew install terminal-browser). Ohne es antwortet /browser mit „Please install terminal-browser first“. Ist die installierte Version zu alt, wirst du gebeten, terminal-browser upgrade auszuführen.
In welchen Terminals funktioniert es?
Nur in Terminals, die das kitty-Grafikprotokoll mit Unicode-Platzhaltern unterstützen, etwa Ghostty, kitty und auf libghostty basierende Terminals wie cmux und supacode. In anderen Terminals warnt die README, dass das Öffnen des Browsers den Bildschirm durcheinanderbringen kann. Multiplexer wie tmux brechen es derzeit meist.
Kann Claude Seiten von selbst im Browser öffnen?
Nur wenn du die Option agentTool einschaltest, die standardmäßig aus ist. Sie fügt die Tools open und close hinzu, die das Modell aufrufen kann. Ohne sie kann Claude trotzdem die terminal-browser-CLI nutzen, um den Browser in einem geteilten Pane zu öffnen, wie die README anmerkt.
Wie schließe ich das Browser-Pane?
Führe /browser close aus oder /browser ohne Argument, solange das Pane offen ist. Schließt du das Pane in Claude Code, erfährt auch terminal-browser, dass der Browser geschlossen wurde.
Können andere Mods den Browser öffnen?
Ja. Das Plugin fügt $.browser.open({ url }) und $.browser.close() für die Hooks anderer Plugins hinzu. Die README zeigt einen auf diese Weise gebauten /tldraw-Befehl.
Agent Profiler in Claude CodeEmpfohlen

Agent Profiler

Wohin die Zeit einer Claude-Code-Sitzung geht: Modell, Tools, Subagenten, live in der Statuszeile. Mit OTLP-Export.

  • Statuszeile
  • Bereich
  • Toast
  • Schreibt Dateien
  • Netzwerk
  • Fängt Tool-Aufrufe ab
  • Verändert die Oberfläche
  • Fügt Befehle/Tools hinzu

getestet mit v2.1.303

Agent Radar in Claude CodeEmpfohlen

Agent Radar

Pro laufendem Subagent eine Live-Zeile über der Eingabe: Zeit, Tool-Anzahl und aktuelle Aktion, dazu ein /radar-Pane.

  • über dem Prompt
  • Bereich
  • Toast
  • Fängt Tool-Aufrufe ab
  • Liest deine Prompts
  • Verändert die Oberfläche
  • Fügt Befehle/Tools hinzu

getestet mit v2.1.291

Agent Tree in Claude CodeEmpfohlen

Agent Tree

Eine Seitenleiste, die Unteragenten als Kästen zeichnet, mit Hauptsitzung, Berater und Sitzungsprotokoll.

  • Bereich
  • Statuszeile
  • Fängt Tool-Aufrufe ab
  • Liest deine Prompts
  • Verändert die Oberfläche
  • Fügt Befehle/Tools hinzu

getestet mit v2.1.310

Context Inspector in Claude CodeEmpfohlen

Context Inspector

Zeigt, was das Claude-Code-Kontextfenster füllt, wie viel davon Verschwendung ist und was die Kompaktierung behielt.

  • Statuszeile
  • Bereich
  • Toast
  • Schreibt Dateien
  • Fängt Tool-Aufrufe ab
  • Liest deine Prompts
  • Verändert die Oberfläche
  • Fügt Befehle/Tools hinzu

getestet mit v2.1.303

Mehr in Panes & Dashboards, Tools, die du Claude gibst.