zenpilot

Claude が Zen ブラウザーを使えるようにします。Claude Desktop と Claude Code で動作し、Chrome 版 Claude のようなものですが、Zen 向けです。

ブラウザー拡張機能はありません。zenpilot はリモートコントロールを有効にして Zen を起動し、 直接通信します。

アルファ版。 macOS と Zen 1.23 でのみテスト済みです。

インストール

Zen が /Applications にインストールされた Mac が必要です。

Claude Desktop： 最新リリースから zenpilot-<version>.mcpb をダウンロードして開きます。これだけです。

Claude Code（または両方）： uv がインストールされている状態で、次を実行します。

uv tool install zenpilot
zenpilot setup

セットアップでは、使用する Zen プロファイルと Claude のアクセスを許可するサイトを選択します。その後、 zenpilot を Claude Code（および使用している場合は Claude Desktop）に接続し、Zen を起動します。続けて Claude Desktop を再起動してください。

使い方

Claude にこう頼むだけです：「httpbin.org/forms/post で Sam のためにベーコン入りのラージピザを注文して、フォームを送信して」。

初回は、いくつかのポップアップが表示されることがあります。表示されるのはあなただけで、Claude には見えません。

• どのプロファイルを使いますか？ zenpilot は、どのサイトにもログインしていない新しいプロファイルです。Claude にログイン済みのサイトを使わせたい場合は、自分のプロファイルを選んでください。
• Zen を再起動しますか？ リモートコントロールが無効の状態ですでに Zen が開いている場合、zenpilot は再起動を提案します。タブは復元されます。
• このサイトを許可しますか？ Claude が使用できるのは、許可したサイトのみです。許可しない、このセッションのみ許可、または常に許可を選んでください。

Enter キーを押すと、常に安全な選択肢が選ばれます。

Claude はタブの新規作成、切り替え、閉じる操作、URL への移動、ページの読み取り、クリック、入力、スクロール、スクリーンショットの撮影ができます。Cookie、パスワード、ダウンロードにはアクセスできず、独自の JavaScript を実行することもできません。

安全を保つ

• 許可リスト。 Claude が使用できるのは、許可したサイトのみです。zenpilot allow github.com でサイトを追加できます。
• できる限り zenpilot プロファイルを使ってください。 どのサイトにもログインしていません。メインのプロファイルでは、悪意のあるページが Claude をだましてアカウント上で操作させようとする可能性があるため、信頼できるサイトだけを許可してください。
• 読み取り専用モード。 read_only = true に設定すると、Claude はページを見られますが、クリックや入力はできません。
• ログ。 Claude が行った操作はすべて ~/.local/state/zenpilot/audit.jsonl に記録されます。
• この方法で Zen を実行している間は、リモートコントロールが有効です。 Mac 上のほかのアプリも接続できるほか、一部のサイト（銀行、Cloudflare のチェックなど）はあなたをボットと判断することがあります。使用後は Zen を終了し、通常どおり起動してください。

zenpilot は、Zen が独自の保護機能（セーフブラウジング、ポップアップブロッカーなど）を無効にすることも防ぎます。これらはリモートコントロールが有効なときに無効になるためです。

コマンド

コマンド	説明
zenpilot setup	すべてをセットアップします（上記を参照）
zenpilot allow [site...]	サイトを許可します。--remove で許可を解除します。サイトを指定しないと一覧を表示します。
zenpilot launch	リモートコントロールを有効にして Zen を起動します
zenpilot doctor	セットアップを確認し、問題の修正方法を案内します

設定

設定は ~/.config/zenpilot/config.toml に保存され、変更はすぐに反映されます。

allowlist = ["localhost", "127.0.0.1"]   # "example.com" covers its subdomains too
read_only = false                        # true: Claude can look but not click or type
profile = "zenpilot"                     # which Zen profile Claude uses
auto_launch = true                       # open Zen when Claude needs it
prompts = true                           # show the popups above
port = 9222
audit_log = "~/.local/state/zenpilot/audit.jsonl"
dangerously_allow_all_sites = false      # skips the allowlist. Please don't.

知っておくとよいこと

• 一度に Zen を操作できる Claude は 1 つだけです。zenpilot は 2 分間操作がないと制御を解放するため、Claude Desktop と Claude Code が交互に使えます。
• Zen は非表示にしたり、ほかのウィンドウの背後に置いたりしても動作します。
• Zen は復元されたタブを遅延読み込みするため、開くまでは Claude に古いタブが表示されません。
• 動かなくなった場合は、zenpilot doctor を実行してください。クラッシュ後に Zen がすでにセッションがあると表示する場合は、Zen を再起動してください。

開発する

git clone https://github.com/beSaif/zenpilot.git && cd zenpilot
uv sync && uv run zenpilot setup     # points Claude at your clone
uv run pytest -m "not integration"   # unit tests
uv run pytest                        # all tests, needs Zen running (zenpilot launch)

pyproject.toml と一致する v* タグをプッシュすると、PyPI に公開され、.mcpb を含む GitHub リリースが作成されます。

ライセンス

MIT