PandaNpc と PandaPaw のインストール

更新日

リモートコーディングエージェントのセットアップには、独立した2つの部分があります。

  • PandaNpc クライアント — セッションの読み取り、プロンプトの送信、ツールの承認に使用するインターフェースです。ウェブ、iOS、Windows、macOS、Linux で動作します。
  • PandaPaw ホスト — Claude Code、Codex、PandaCode が実際に実行されるコンピューター上のバックグラウンドサービスです。

チャットとローカルデスクトップ利用のみの場合は、PandaNpc クライアントだけをインストールしてください。別のマシンで実行中のコーディングエージェントにアクセスしたい場合は、両方のコンポーネントをインストールします。

PandaNpc デスクトップ版 で、以下のインストール手順に加えて Windows/macOS/Linux アプリが提供する機能とリリース履歴を参照してください。

インストールするものの選択

シナリオ クライアント PandaPaw ホスト
ブラウザで PandaNpc チャットを使用する ウェブアプリを開く 不要
同じデスクトップ上のエージェントを制御する デスクトップアプリ 選択したローカル/リモートモードに依存
電話やブラウザから開発マシンを制御する 表示デバイスにクライアントをインストール/開く 開発マシンで必要
グラフィカルデスクトップのないサーバーでエージェントを実行する ウェブ、デスクトップ、または iOS を別の場所で サーバーで必要

最短のエンドツーエンドの手順については、クイックスタートガイド を参照してください。

PandaNpc クライアントのインストール

最新のインストーラーの正式な情報源として、PandaNpc ダウンロードページ を使用してください。古いパッケージや改変されたパッケージを配布する可能性があるため、サードパーティのダウンロードサイトは避けてください。

ウェブ

最新のブラウザで pandanpc.com/agent を開きます。何もインストールされません。ブラウザストレージにローカルサインイン状態が保持されるため、プライベート/シークレットウィンドウでは再度サインインが必要になる場合があります。

iOS

ダウンロードページの App Store リンクに従って、PandaNpc をインストールします。iOS は、ホストから離れているときに進捗の確認、質問への回答、ツールの承認に便利です。コーディングプロセスは、接続されたホストマシン上で引き続き実行されます。アプリの対象範囲とリリース履歴については、PandaNpc iOS 版 を参照してください。

Windows

  1. 最新の Windows インストーラーをダウンロードします。
  2. 実行してインストーラーの指示に従います。
  3. スタートメニューから PandaNpc を起動します。
  4. Windows に発行元または信頼性に関する警告が表示された場合は、続行する前にファイルが pandanpc.com から取得されたものであることを確認します。

macOS

  1. macOS の .dmg をダウンロードします。
  2. PandaNpc を アプリケーション にドラッグします。
  3. アプリケーションから起動し、macOS のセキュリティプロンプトに従います。

macOS ビルドはユニバーサルなので、同じパッケージが Apple Silicon と Intel Mac をサポートします。

Linux

x86_64 AppImage をダウンロードし、実行可能にして、実行します:

bash
chmod +x PandaNpc_*.AppImage
./PandaNpc_*.AppImage

AppImage が起動しない場合は、ターミナルから一度実行し、正確なエラー出力を保存してください。古いディストリビューションでは、デスクトップシェルに必要なランタイムライブラリが不足している場合があります。

エージェントホストへの PandaPaw のインストール

PandaPaw は現在、Windows x64、macOS ユニバーサル、Linux x86_64 向けのホストインストーラーを提供しています。プロジェクトファイルを所有し、エージェントのツールを実行するコンピューター上でコマンドを実行してください。

推奨される方法は、接続デバイス です。デバイスの追加 を選択し、生成されたワンタイムコマンドをコピーします。インストール中にホストがアカウントとペアリングされます。

macOS または Linux

ブラウザ認証付きの通常インストーラー:

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

準備済みワンタイムキー形式:

bash
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh -s -- --mesh pnkey-xxxx

Windows PowerShell

通常インストーラー:

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

準備済みワンタイムキー形式:

powershell
$env:PANDANET_KEY="pnkey-xxxx"; iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

PowerShell の iwr | iex パイプラインは通常のスクリプト引数を渡せないため、Windows インストーラーは PANDANET_KEY からワンタイムキーを読み取ります。

ホストインストーラーが変更する内容

インストーラーは次のことを行います:

  1. PandaPaw を現在のユーザーの application/bin ディレクトリに追加し、必要に応じてユーザーの PATH を更新します。
  2. 自動起動する適切なバックグラウンドサービスを登録します。
  3. プラットフォームが許可する場合、不足しているサポート対象のコーディングエンジンをインストールします。
  4. システムに適切なバージョンがない場合、プライベートな Node.js ランタイムを提供します。
  5. アカウント認証を開始するか、準備済みのデバイスキーを利用します。
  6. 作成したファイルを記録し、アンインストール時に既存の互換ツールを保持できるようにします。

エンジンをインストールしても、モデルサブスクリプションが自動的に購入または認証されるわけではありません。Claude Code と Codex は、初回実行時に独自のプロバイダーログインを求める場合があります。

インストールの確認

インストール後に新しいターミナルを開き、次のコマンドを実行します:

bash
pandapaw status

次に、PandaNpc エージェント を開きます。ホストがオンラインとして表示されるはずです。テストプロジェクトでセッションを開始し、ファイルを変更せずに現在の作業ディレクトリを報告するように依頼します。これにより、ダウンロードのステップだけでなく、バイナリ、バックグラウンドサービス、アカウントペアリング、リレー接続、エンジン、選択したディレクトリが検証されます。

アップデート

デスクトップクライアントは、アップデートが利用可能になると通知します。iOS は App Store 経由でアップデートします。

次のコマンドで PandaPaw をアップデートし、管理対象サービスを再起動します:

bash
pandapaw update --restart

アップデータは、インストール済みのコピーを置き換える前に、ダウンロードしたバイナリを公開された SHA-256 チェックサムと照合して検証します。アカウントのペアリングと既存の接続 ID は保持されます。アップデータ自体が利用できない場合は、インストールコマンドを再実行することもできます。

アンインストール

  • Windows クライアント: 設定 → アプリ → インストールされているアプリ → PandaNpc → アンインストール。
  • macOS クライアント: PandaNpc を終了し、アプリケーションからゴミ箱に移動します。
  • Linux クライアント: AppImage と作成したランチャーを削除します。
  • PandaPaw ホスト: ホスト上で pandapaw uninstall を実行します。

PandaPaw のアンインストールマニフェストは、インストーラーが作成したツールと、既に存在していた互換ツールを区別します。既存の Claude Code、Codex、PandaCode、Node のインストールを削除するのではなく、意図的に慎重な動作になっています。

インストールの問題

コマンドは完了したがホストが接続されない

pandapaw login を実行してください。ホストのインストールとアカウント認証は別の段階であり、ブラウザ認証が延期または中断された場合でもインストーラーは完了できます。

シェルが `pandapaw` を見つけられない

新しいターミナルを開きます。macOS/Linux では ~/.local/bin を確認し、Windows では %LOCALAPPDATA%\Programs\pandapaw を確認してください。実行ファイルが存在し、PATH だけが古いかどうかを確認するまでは、再インストールを繰り返さないでください。

コーディングエンジンのインストールに失敗した

ホストインストーラーは、オプションのエンジンダウンロードをベストエフォートとして扱うため、1つのプロバイダーの障害が原因で動作中の PandaPaw インストールが削除されることはありません。そのエンジンを公式インストーラーを使用してインストールまたは修復し、通常どおり認証してから、再度 pandapaw status を実行してください。

AppImage またはデスクトップアプリケーションが開かない

正しいアーキテクチャ用のパッケージをダウンロードしたことを確認し、ターミナルから起動して最初のエラーを取得してください。サポートに連絡する際は、そのエラーと OS のバージョンを含めてください。閉じたウィンドウのスクリーンショットだけでは、通常、不足しているランタイムライブラリを診断するのに十分ではありません。

ホスト固有の接続チェックについては、PandaPaw ガイド または FAQ を参照してください。