本文へスキップ
claudemods

terminal-browser:ウェブページをライブ表示する Claude Code ブラウザペイン

/browser で Claude Code 内のペインに本物のウェブブラウザを開きます。描画には kitty graphics protocol を使います。

権限

  • ファイルを読み取るお使いのマシン上のファイルの読み取りやディレクトリの一覧取得ができます($.fs.read / list / stat / exists)。
  • コマンドを実行お使いのマシン上でシェルのプログラムを実行できます($.process.run / spawn)。具体的に何を実行するかはソースで確認してください。
  • ネットワークHTTP リクエストを送信したり、MCP サーバーと通信したりできます($.http.fetch / $.mcp.*)。
  • ツール呼び出しを傍受Claude が行うすべてのツール呼び出しを参照でき(tool.call / tool.check)、ブロックや変更も可能です。
  • UI を変更Claude Code の画面に描画します。バンド、ペイン、ステータス表示、トーストなど(ui.render / $.ui.*)。
  • コマンド・ツールを追加あなたや Claude が呼び出せる新しいスラッシュコマンドやツールを登録します($.command.register / $.tool.register)。
検証バージョン
v2.1.310
最終検証日
必要バージョン
Claude Code ≥ 2.1.287
表示先
ペイン

Claude Code 内でインストール:

/plugin install terminal-browser --marketplace zenbu-labs/terminal-browser
すべてのインストール方法 ↓

このModでできること

terminal-browser は Zenbu Labs による Claude Code ブラウザ Mod で、Claude Code の中で本物のウェブブラウザを動かします。/browser と入力すると、会話の横にペインが開き、ライブのページが表示されます。/browser example.com と入力すればそのサイトが読み込まれます。もう一度 /browser を実行するか /browser close を実行すると閉じます。ペイン内でクリック、入力、スクロールができ、その入力はページに渡されます。

実際の描画は、別プログラムである terminal-browser に含まれる Chromium ベースのブラウザが行います。プラグインはそれを起動し、ペインのサイズとマウス・キーボードの入力を送り、返ってきたフレームを画像としてペインに描画します。そのため、Ghostty や kitty のような kitty graphics protocol に対応したターミナルでしか動作しません。

このプラグインは、Claude と一緒にウェブアプリを作るときに便利です。セッションを離れずに、localhost:3000 の開発サーバーを確認したり、HTML のレポートを読んだりできます。作者はこのプラグインを実験的なものとしています。まだ変更が続いている function hooks API を利用しているためです。

インストール

インストールブロックを使ってください。作者のマーケットプレイスを追加し、そこからプラグインをインストールします。terminal-browser プログラムも PATH 上に必要です(FAQ を参照)。すでに開いているセッションでは /reload-plugins を実行してください。

$ install terminal-browser

Claude Code 2.1.287 以上が必要

作者のマーケットプレイスからインストール: zenbu-labs/terminal-browser

  1. 1.Claude Code 内で1行

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

    実行中のセッション(v2.1.275 以降)に貼り付けます。最初に Claude Code がマーケットプレイスの追加を確認します。

  2. 2.シェルから

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

    その後、すでに開いているセッションでは /reload-plugins を実行してください。

  3. 3.インストールせずに試す

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

    その1セッションだけ Mod を読み込みます。設定には何も追加されません。

仕組み

プラグインは、ターミナルでセッションが始まると /browser コマンドを登録します。コマンドハンドラは短いものです。以下は 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 }
})

ブラウザを初めて開くとき、startBridge が terminal-browser capabilities を実行して、インストール済みのバージョンが embedding と image-frames に対応しているかを確認します。次に terminal-browser claude-bridge launch を実行し、ローカルのポート番号とランダムなトークンを出力させます。その後のやり取りはすべて、そのポートの 127.0.0.1 への HTTP で行われ、トークンは bearer ヘッダーとして付与されます。

  • watchBridge は /state をロングポーリングし、新しいフレームが届くたびに $.ui.blit でペインにコピーします。フレームは共有メモリから取得されるため、HTTP レスポンスに画像データは載りません。
  • surface.tsx は、キー入力とマウスイベントを約 20 ms ごとに集め、プラグインがそれを /input に POST します。スクロールホイールのイベントも同じ経路で送られます。
  • ペインサイズの変更は /size に、最初の URL は /open に POST されます。
  • ブラウザがエージェントに渡すテキストを持っているとき、プラグインは /inbox/take からそれを取り出し、$.prompt.fill でプロンプト入力欄に入れます。ブラウザがスクリーンショットを添付していた場合は、その行も追加されます。Enter を押すまで何も送信されません。

ホスト名だけの入力は https:// の URL になり、localhost のアドレスは http:// になります。このヘルパーは hooks/urls.ts にあります。

カスタマイズ

このプラグインのオプションはひとつだけで、既定でオフの agentTool です。オンにすると、プラグインは open と close の 2 つのツールを登録します。Claude はこれらを呼び出して、ペインにページを表示できます。README にあるとおり、/config か、~/.claude/settings.json の pluginConfigs で設定してください。

ほかのプラグインからブラウザを操作することもできます。このプラグインはエンジンに $.browser.open({ url }) と $.browser.close() を追加し、型定義を hooks/browser.d.ts で提供します。これを使えば、ペインでページを開く /tldraw や /open-pr のようなコマンドを Mod に追加できます。

権限と安全性

私たちは、コミット 2165ae7 の claude-code-plugin/ 内のすべてのファイルを読みました。対象は register.tsx、surface.tsx、bridge-protocol.ts、urls.ts、そして型ファイルです。コードは素の TypeScript で、minify されたコードやバンドルされたコードはありません。

  • コマンドの実行($.process.run):実行するのは terminal-browser プログラムだけで、capabilities と claude-bridge launch のみです。これらは argv 配列で渡され、タイムアウトはそれぞれ 10 秒と 20 秒です。開発用のチェックアウトでは、../cli/dist/main.js が存在する場合に代わりに node ../cli/dist/main.js を実行します。
  • ネットワーク($.http.fetch):通信先は http://127.0.0.1:<port>、つまり上で起動したローカルのブリッジだけで、起動ごとのトークンが使われます。README には、お使いの OS がターミナルによるローカルネットワークへのアクセスを許可するか確認する場合がある、と記されています。
  • プロンプトの入力欄への挿入($.prompt.fill):ブラウザがエージェント向けに送ったテキストは入力欄に置かれます。自動的に送信されることはありません。
  • ツールの追加($.tool.register):agentTool をオンにしたときだけです。
  • ファイルの書き込み、設定の変更、トランスクリプトの読み取りは行いません。

ブラウザ本体は、別プログラムの terminal-browser です。curl | bash のスクリプトでインストールされ、このプラグインには含まれません。同じリポジトリ内のそのプログラムには、匿名の利用イベント(起動、デイリーアクティブ、アップグレード、クラッシュの種類)を PostHog の EU エンドポイントに送信するコードがあります。DO_NOT_TRACK または TERMINAL_BROWSER_NO_TELEMETRY が設定されていると、コードはその送信をスキップします。また、ブラウザは一般的なブラウザと同様に、あなたが開いたサイトをそのまま読み込みます。

ファイルを読み取る
お使いのマシン上のファイルの読み取りやディレクトリの一覧取得ができます($.fs.read / list / stat / exists)。
コマンドを実行
お使いのマシン上でシェルのプログラムを実行できます($.process.run / spawn)。具体的に何を実行するかはソースで確認してください。
ネットワーク
HTTP リクエストを送信したり、MCP サーバーと通信したりできます($.http.fetch / $.mcp.*)。
ツール呼び出しを傍受
Claude が行うすべてのツール呼び出しを参照でき(tool.call / tool.check)、ブロックや変更も可能です。
UI を変更
Claude Code の画面に描画します。バンド、ペイン、ステータス表示、トーストなど(ui.render / $.ui.*)。
コマンド・ツールを追加
あなたや Claude が呼び出せる新しいスラッシュコマンドやツールを登録します($.command.register / $.tool.register)。

互換性とトラブルシューティング

コミット 2165ae7 のプラグインを、Claude Code 2.1.310 で claude plugin validate により検証しました。検証は、プラグインディレクトリに関する警告が 1 件出たものの成功しました。プラグインにテストはないため、claude plugin test は実行していません。上流のリポジトリはそのコミット以降も更新されていますが、その後のコミットで claude-code-plugin/ に触れたものはないため、レビューしたコードは今も現行のプラグインです。このページはスタンダード階層で、デモの録画はありません。function hooks が必須のため、Claude Code 2.1.287 以降が必要です。

  • /browser が「Please install terminal-browser first」と表示する場合:プログラムをインストールし、PATH 上にあることを確認してください。
  • 新しいバージョンが必要と表示される場合:terminal-browser upgrade を実行してください。
  • 画面が崩れる、またはペインが空のままの場合:お使いのターミナルが Unicode プレースホルダー付きの kitty graphics に対応していないか、tmux などのマルチプレクサの中で動かしている可能性があります。
  • マウス位置が少しずれる場合:Claude Code がピクセル単位のマウス位置を報告しないため、README が既知の制限として挙げています。
  • ペインの幅がこれ以上広がらない場合:Claude Code がチャット領域の最小幅を確保しているためです。

よくある質問

この Claude Code ブラウザを使うのに、プラグイン以外に必要なものはありますか?
はい。プラグインはペインを描画するだけで、ブラウザ本体は別途インストールする terminal-browser プログラムです(curl -fsSL https://terminal-browser.sh/install | bash、または brew install terminal-browser)。未インストールだと、/browser は「Please install terminal-browser first」と応答します。インストール済みのバージョンが古すぎる場合は、terminal-browser upgrade の実行を求められます。
どのターミナルで動作しますか?
Unicode プレースホルダー付きの kitty graphics protocol に対応したターミナルのみです。Ghostty、kitty、そして cmux や supacode のような libghostty ベースのターミナルが該当します。それ以外のターミナルでは、ブラウザを開くと画面が崩れる可能性があると README が警告しています。tmux などのマルチプレクサは、現時点では多くの場合動作しません。
Claude が自分でブラウザのページを開くことはできますか?
agentTool オプションをオンにした場合のみ可能です。このオプションは既定でオフで、モデルが呼び出せる open と close のツールを追加します。オフのままでも、README にあるとおり、Claude は terminal-browser の CLI を使って分割ペインでブラウザを開けます。
ブラウザのペインを閉じるには?
/browser close を実行するか、ペインが開いている状態で引数なしの /browser を実行してください。Claude Code 側でペインを閉じた場合も、ブラウザが閉じられたことが terminal-browser に伝わります。
ほかの Mod からブラウザを開けますか?
はい。このプラグインは、ほかのプラグインのフック向けに $.browser.open({ url }) と $.browser.close() を追加します。README には、この方法で作られた /tldraw コマンドの例があります。
Claude Code で動作中の Agent Profilerおすすめ

Agent Profiler

Claude Code セッションの時間がどこで使われたかを、モデル待ち・ツール・サブエージェントに分けてステータスラインに表示。OTLP トレースも出力できます。

  • ステータス
  • ペイン
  • トースト
  • ファイルを書き込む
  • ネットワーク
  • ツール呼び出しを傍受
  • UI を変更
  • コマンド・ツールを追加

v2.1.303 で検証済み

Claude Code で動作中の Agent Radarおすすめ

Agent Radar

実行中のサブエージェントごとに入力欄の上へ 1 行表示:経過時間、ツール数、現在の動作。/radar ペイン付き。

  • プロンプト上部
  • ペイン
  • トースト
  • ツール呼び出しを傍受
  • プロンプトを読み取る
  • UI を変更
  • コマンド・ツールを追加

v2.1.291 で検証済み

Claude Code で動作中の Agent Treeおすすめ

Agent Tree

サブエージェントを箱で描くサイドペイン。メインセッション、アドバイザー、セッションログも表示します。

  • ペイン
  • ステータス
  • ツール呼び出しを傍受
  • プロンプトを読み取る
  • UI を変更
  • コマンド・ツールを追加

v2.1.310 で検証済み

Claude Code で動作中の Context Inspectorおすすめ

Context Inspector

Claude Code のコンテキストを何が埋めているか、再読み込みや重複がどれだけあるか、コンパクトで何が残ったかを表示します。

  • ステータス
  • ペイン
  • トースト
  • ファイルを書き込む
  • ツール呼び出しを傍受
  • プロンプトを読み取る
  • UI を変更
  • コマンド・ツールを追加

v2.1.303 で検証済み

同じカテゴリの Mod: ペインとダッシュボード、Claude に追加するツール。