PandaPaw: Claude Code、Codex、および PandaCode 向けリモートホスト

PandaPaw は、ユーザーが管理する Windows、macOS、または Linux マシンを PandaNpc エージェントホストに変換します。コーディングエンジン、プロジェクトファイル、シェル、ツールはそのホスト上に残ります。PandaNpc クライアントは、スマートフォン、ブラウザ、または別のデスクトップから同期されたインターフェースを提供します。

作業を実行するマシンが手元のデバイスと異なる場合、クライアントの切断後もホストが機能し続けることを望む場合、または複数のコーディングエンジンが同じアカウントベースの設定と Agent Center 構成を共有する必要がある場合に、PandaPaw を使用してください。

PandaP が管理するもの

• Claude Code、OpenAI Codex、および PandaCode 向けのリモートエージェント接続。
• 通常の再起動後にホストが復帰できるようにするバックグラウンドサービスと自動起動。
• 長期間有効な Bridge ID、トークン、または署名キーを手動でコピーする必要のないアカウントベースのマシン認証。
• サポート対象のコーディングエンジンがない場合のエンジンインストール支援。
• 各エンジンのガイダンス、スキル、メモリ、エージェント定義をネイティブレイアウトで描画するAgent Center プロジェクション。
• Connected Devices フローを通じて参加したマシン向けのプライベートデバイスネットワーキング。
• PandaPaw より前に存在したツールが保持されるようにする更新およびアンインストールの管理。

PandaPaw 自体がモデルサブスクリプションを提供するわけではありません。Claude Code、Codex、PandaCode は引き続き、各エンジン用に構成されたプロバイダー認証情報と制限を使用します。

リモート実行の仕組み

両側がアウトバウンド接続を開始するため、通常の自宅やオフィスのセットアップでは、インバウンドのファイアウォールルール、パブリック IP アドレス、ルーターのポート転送、公開された SSH サーバーは必要ありません。リレーはメッセージ、ステータス、承認を転送し、ツールの実行はホスト上で行われます。

ホストがスリープ、電源オフ、またはアウトバウンドネットワーク経路を失った場合、保存された接続はアカウントに残りますが、ホストが復帰するまで作業を実行できません。

対応ホストプラットフォーム

PandaNpc ビューイングクライアントは、より広範なプラットフォームマトリクスを備えています。クライアントとホストのパッケージを選択する際は、PandaNpc と PandaPaw のインストール を参照してください。

推奨インストール方法

1. PandaNpc にサインインします。
2. Connected Devices を開きます。
3. デバイスを追加 を選択します。ワンタイムキーが発行され、ダイアログに検出されたオペレーティングシステム用のコマンドが 1 つ表示されます。
4. そのコマンドをホストにコピーして実行します。
5. 新しいマシンを自動的に検出させたい場合は、ダイアログを開いたままにします。

準備されたキーは使い捨てです。コマンド全体をコピーし、非公開に保ち、有効期限が切れた場合やすでに使用された場合は、新しいキーを生成してください。

通常の macOS/Linux インストーラー

準備されたキーの代わりにブラウザでの認証を使用する場合は、次の形式を使用してください:

curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh

通常の Windows PowerShell インストーラー

iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

通常のインストーラーは pandapaw login を実行します。開かれたブラウザページでマシンを承認してください。認証が中断された場合でも、バイナリとサービスはインストールできます。後で pandapaw login を実行してアカウント接続を完了してください。

ホストの確認

まずホスト自体を確認します:

pandapaw status

次に PandaNpc Agent を開き、マシンに緑色のオンラインインジケーターが表示されていることを確認します。使い捨てまたは読み取り専用のテストディレクトリでセッションを開始し、次のように質問します:

テストプロンプト: 現在の作業ディレクトリを出力し、トップレベルのファイルを一覧表示してください。何も変更しないでください。

応答が成功すれば、緑色のステータスライト以上のことが証明されます: アカウントのペアリング、リレー接続、選択したエンジン、プロバイダー認証、作業ディレクトリのマッピングが検証されます。

Agent Center プロジェクトの場合は、次を実行します:

pandapaw agent status --root /absolute/path/to/project

これにより、プロジェクトがバインドされているかどうか、管理対象の構成がローカルで利用可能かどうかが表示されます。安定した Git リモートは、PandaPaw が複数のマシン間で同じプロジェクトを識別するのに役立ちます。

アカウント認証と接続 ID

pandapaw login はブラウザのデバイス認可セッションを使用します。承認すると、ホストは TLS 経由でデバイススコープの認証情報と Agent Center 検証キーを受け取り、~/.pandapaw/ の下にマシン構成を書き込み、サポートされているエンジン接続を登録し、認識可能な Git プロジェクトをバインドします。

pandapaw login --force は、意図的にアカウントを切り替える場合、または期限切れのホスト認証情報を置き換える場合にのみ実行してください。理由もなく正常なマシンを再認証すると、混乱を招く重複または置き換えられた ID が作成される可能性があります。

pandapaw qr は、互換性と特別なケースのために、短期間有効な手動接続リンクを引き続き作成します。これは新しいホストの主要なフローではありません。Connected Devices は監査が容易で、ユーザーが Bridge ID を理解する必要もありません。

Agent Center の同期

Agent Center は定常状態ではイベント駆動型です:

1. ローカルの管理対象ファイルの変更が検出され、バインドされたプロジェクトに公開されます。
2. 署名付きリリースがイベントストリームを通じて届きます。
3. 変更されていないマニフェストとコンテンツブロブは、再ダウンロードではなく再利用されます。
4. 定期的なリカバリチェックが、一時的な切断中に見逃されたイベントを検出します。

Claude Code、Codex、PandaCode は、異なるディレクトリと指示形式を想定しているため、それぞれ別のプロジェクションを受け取ります。PandaCode は新しいセッションプロンプトを組み立てる前に最新の検証済みリリースを準備するため、起動時に取得した構成が同じセッションに影響を与える可能性があります。

Agent Center が一時的に利用できない場合、エンジンは最後に検証されたローカルリリースで動作を続けます。ネットワーク障害によって、署名付き構成が検証されていないコンテンツに静かに置き換えられるべきではありません。

便利なコマンド

pandapaw login
pandapaw status
pandapaw agent status --root /absolute/path/to/project
pandapaw update --restart
pandapaw uninstall

コマンドや UI が古いスクリーンショットやチュートリアルと異なる場合は、PandaPaw ージョン履歴 を確認してください。

セキュリティ境界

• リモートオペレーターは、選択したエージェントセッションが許可するツールと作業ディレクトリを実行できます。リモートアクセスは自動的に読み取り専用になるわけではありません。
• ワンタイムデバイスコマンド、手動接続リンク、プロバイダーキー、アカウントトークンをログやスクリーンショットに含めないでください。
• PandaPaw に到達可能にするためだけに、インバウンドのルーターポートを開けないでください。
• 所有しなくなったホストは Connected Devices から削除してください。
• 編集やシェルコマンドを許可する前に、ツールの承認を確認し、作業ディレクトリを検証してください。
• ライブ接続を共有する場合、受信者はホスト所有者のエンジンクォータを消費し、ホスト上で操作できます。最初に 接続共有 をお読みください。

トラブルシューティング

インストール後に `pandapaw` が見つからない

新しいターミナルを開いて、ユーザーの PATH を再読み込みしてください。通常の場所は、macOS/Linux では ~/.local/bin、Windows では %LOCALAPPDATA%\Programs\pandapaw です。インストーラーを再実行する前に、ファイルが存在することを確認してください。

インストールは成功したが、マシンが表示されない

pandapaw status を実行してください。マシンにアカウント認証がない場合は、pandapaw login を実行してください。準備済みのワンタイムキーを使用した場合は、使用済みのコマンドを再試行するのではなく、新しいキーを作成してください。

マシンは表示されるがオフラインのまま

ホストが起動していてインターネットにアクセスできることを確認してください。PandaPaw のステータスをローカルで確認してください。企業のプロキシまたはファイアウォールは、アウトバウンドの HTTPS/WebSocket 経路を許可する必要があります。インバウンドポートでは、ブロックされたアウトバウンド接続は解決できません。

ホストはオンラインだが、Claude Code または Codex が応答しない

ホストをペアリングしても、すべてのモデルプロバイダーが認証されるわけではありません。エンジンをローカルで開くか、リモートセッションに表示されるログインプロンプトに従ってください。また、選択したモデルがそのアカウントに存在し、使用制限に達していないことを確認してください。

セッションが間違ったプロジェクトで開かれる

テストを終了し、意図した絶対作業ディレクトリを選択し、ツールを承認する前にエージェントにそれを出力するよう依頼してください。PandaPaw はユーザーが意図したリポジトリを推測せず、エンジン自体の権限モデルを超えたファイルシステムサンドボックスも追加しません。

Agent Center の変更が表示されない

正しい Git ルートから pandapaw agent status --root /path/to/project を実行してください。プロジェクトがバインドされていること、ホストがログインしていること、ローカルファイルが管理対象のプロジェクションの一部であることを確認してください。調査中は、管理対象ディレクトリを削除するのではなく、最後に検証されたリリースをそのまま保持してください。

更新とアンインストール

pandapaw update --restart は現在のバイナリをダウンロードし、SHA-256 チェックサムを検証し、インストール済みのコピーを置き換え、管理対象サービスを再起動してバージョンをアクティブにします。既存のアカウントペアリングは保持されます。

pandapaw uninstall はインストールマニフェストを使用して、PandaPaw が作成した項目を削除します。以前から存在していた互換性のある Claude Code、Codex、PandaCode、または Node のインストールは意図的に保持されます。アンインストール後、ホストを信頼すべきでない場合は Connected Devices から削除してください。