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-browserWas 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.Eine Zeile, direkt in Claude Code
/plugin install terminal-browser --marketplace zenbu-labs/terminal-browserIn eine laufende Sitzung einfügen (v2.1.275+). Claude Code fragt zuerst, ob der Marketplace hinzugefügt werden soll.
2.Aus deiner Shell
claude plugin marketplace add zenbu-labs/terminal-browser claude plugin install terminal-browser@terminal-browserFühre danach in jeder bereits geöffneten Sitzung /reload-plugins aus.
3.Ohne Installation ausprobieren
git clone https://github.com/zenbu-labs/terminal-browser claude --plugin-dir ./terminal-browser/claude-code-pluginLä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:
watchBridgefragt/stateper Long-Polling ab und kopiert jeden neuen Frame mit$.ui.blitins Pane. Der Frame kommt aus gemeinsamem Speicher, daher laufen keine Bilddaten durch die HTTP-Antwort.surface.tsxsammelt 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/takeund setzt ihn mit$.prompt.fillin 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 Programmterminal-browser, mitcapabilitiesundclaude-bridge launch. Das sind argv-Arrays mit Timeouts von 10 s und 20 s. In einem Entwicklungs-Checkout läuft stattdessennode ../cli/dist/main.js, falls diese Datei existiert. - Netzwerk (
$.http.fetch): nurhttp://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.
/browsermeldet „Please install terminal-browser first“: Installiere das Programm und stelle sicher, dass es imPATHliegt.- Es meldet, dass eine neuere Version nötig ist: Führe
terminal-browser upgradeaus. - 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.
# Ähnliche Mods
EmpfohlenAgent 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
EmpfohlenAgent 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
EmpfohlenAgent 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
EmpfohlenContext 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.