PandaNpc Work クイックスタート: 最初のエージェントを接続

PandaNpc Work（マルチエンジンAIワークスペース）を使い始めましょう。PandaPawでコンピュータを接続し、エージェントエンジンを選択して、リモートセッションを確認します。

更新日

このガイドでは、1 台のコンピューターを PandaNpc Work に接続し、別のデバイスから Claude Code、Codex、または PandaCode を実行できることを確認します。PandaNpc Work は、作業を委任し、複数のデバイスでそれを追跡できるマルチエンジン AI ワークスペースです。エージェントは引き続き接続されたコンピューター上で実行されます。PandaPaw がブリッジとローカルランタイムを提供し、PandaNpc Work がメッセージ、承認、質問、セッション履歴のための同期されたインターフェースを提供します。

この方法は、Claude Code、Codex、または同様のコーディングエージェントにすでに慣れている人に最適です。ほとんどの人は デバイスを追加 フローを使用するべきです。これは、アカウントにすでにリンクされた 1 回限りのインストールコマンドを生成するためです。約 5 分を確保してください。さらに、使用するコーディングエンジンが必要とするモデルプロバイダーのサインインも必要です。コンピューターを接続する前に Agent インターフェースを試すには、ブラウザーで PandaNpc Agent を開きます。

始める前に

必要なもの:

  • ウェブアプリ、デスクトップアプリ、または iOS アプリで開いた PandaNpc アカウント。
  • Windows x64、macOS、または Linux x86_64 を実行している接続済みのコンピューター。
  • ホストからのインターネットアクセスと、ユーザーレベルのバックグラウンドサービスをインストールする権限。
  • 変更が許可されているプロジェクトフォルダー。
  • 選択したエンジンがまだ認証されていない場合は、Claude、ChatGPT/Codex、またはカスタムモデルのアカウント。

すでに接続されているホストを表示するだけの場合は、表示デバイスにクライアントをインストールするか、開きます。PandaPaw はエージェントを実行しているコンピューター上にあります。クライアントとホストの役割については、インストール を参照してください。

1. ホストのインストールコマンドを生成する

サインインした状態で、接続済みデバイス を開き、デバイスを追加 を選択します。PandaNpc は 1 回限りのデバイスキーを作成し、お使いのオペレーティングシステム用の正確なコマンドを表示します。

そのコマンドを、コーディングエージェントを実行するマシンにコピーします。使用されるまで、パスワードのように扱ってください。1 回限りのキーは 1 台のマシンをペアリングするものであり、チャット、スクリーンショット、issue、シェル履歴のエクスポートに投稿しないでください。

準備済みのキーの代わりにブラウザー認証を希望する場合は、次のステップで通常のインストーラーを使用します。これは pandapaw login を実行し、認証ページを開きます。

2. ホストに PandaPaw をインストールする

macOS または Linux

接続済みデバイスから準備済みのコマンドを実行するか、通常のインストーラーを使用します:

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

Windows PowerShell

接続済みデバイスから準備済みのコマンドを実行するか、次を使用します:

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

インストーラーは PandaPaw とそのバックグラウンドサービスを追加し、可能な場合は不足しているサポート対象のコーディングエンジンをインストールし、ホストに適切なものがない場合はプライベートな Node.js ランタイムを提供します。準備済みのデバイスキーを使用すると、インストール中にアカウントのペアリングが行われます。通常のコマンドを使用する場合は、プロンプトが表示されたらブラウザーの認証リクエストを承認します。

アカウントの認証が延期された場合でも、インストーラーが完了することがあります。インストールは成功したがアカウント接続が不完全であると表示された場合は、次を実行します:

bash
pandapaw login

3. ホストサービスを確認する

ホストで次を実行します:

bash
pandapaw status

コマンドは、インストールされたサービスを認識し、アカウントに接続されたマシンを表示する必要があります。シェルが pandapaw を見つけられない場合は、まず新しいターミナルを開いて、更新されたユーザー PATH を再読み込みします。

Git プロジェクトの場合は、Agent Center がプロジェクトルートを認識しているかどうかも確認できます:

bash
pandapaw agent status --root /path/to/your/project

実際の絶対プロジェクトパスを使用してください。Agent Center のプロジェクトバインドは、ディレクトリに安定した Git remote.origin.url がある場合に最適に機能します。

4. 最初のリモートセッションを開始する

  1. スマートフォン、ブラウザー、または別のデスクトップで PandaNpc Agent を開きます。
  2. 新しく接続されたマシンを見つけます。緑色のステータスインジケーターは、ホストに現在到達可能であることを意味します。
  3. Claude Code、Codex、または PandaCode を選択し、プロジェクトの作業ディレクトリを選択します。
  4. セッションを開始します。エンジンがサインインを求める場合は、ホスト上で、または表示されるログインフローを通じて、そのプロバイダーの認証を完了します。
  5. 次のような非破壊的なテストプロンプトを送信します: Show the current working directory and list the top-level files. Do not edit anything.

応答が期待されるプロジェクトディレクトリを示し、ファイル一覧がホストと一致し、許可の質問がリモートクライアントに表示されて承認または拒否できるとき、完全に接続されています。

5. 再接続の動作を確認する

表示クライアントを閉じ、数秒待ってから、同じセッションを再度開きます。既存の履歴が戻り、ホストはオンラインのままであるはずです。これは、インストーラーが正常にダウンロードされたことだけを証明するのではなく、実際のリモートパスを確認します。

このテスト中は、ホストをスリープ状態にしないでください。スリープ状態または電源オフのホストは、保存された接続がアカウントにまだ表示されていても、エージェントを実行できません。

トラブルシューティング

マシンが Agent に表示されない

ホストで pandapaw status を実行します。インストールは成功したがアカウントが接続されていない場合は、pandapaw login を実行します。準備済みのキーを使用し、それがすでに引き換え済みまたは期限切れの場合は、接続済みデバイスで新しいキーを生成し、表示されたコマンドを再実行します。

`pandapaw` が認識されない

新しいターミナルを開きます。macOS/Linux では、~/.local/bin が PATH にあることを確認します。Windows では、インストーラーが %LOCALAPPDATA%\Programs\pandapaw をユーザー PATH に追加します。インストール前に開いたターミナルは新しい値を認識しません。

マシンは一覧に表示されるがオフライン

ホストの電源が入っており、スリープ状態でなく、インターネットに到達できることを確認します。次に pandapaw status を確認します。企業のファイアウォールは送信 HTTPS/WebSocket トラフィックを許可する必要があります。受信ポート転送ルールを作成しないでください。

接続は機能するが、エンジンが認証を求める

PandaPaw のペアリングとモデルプロバイダーのログインは別です。ペアリングはホストがあなたの PandaNpc アカウントに属することを証明します。Claude Code または Codex は、独自のサブスクリプションログインまたは API 設定を引き続き必要とする場合があります。エンジンの通常のサインインを完了してから、セッションを再試行します。

エージェントが間違ったフォルダーで開く

そのテストセッションを終了し、意図した作業ディレクトリで新しいセッションを作成します。ツールの使用を承認する前に、エージェントに現在のディレクトリを表示するよう依頼します。リモート接続自体はファイルシステムサンドボックスを追加しません。エンジンのツール権限と選択された作業ディレクトリは引き続き重要です。

次のステップ

  • 更新、サービスチェック、接続アーキテクチャについては、完全な PandaPaw ホストガイド をお読みください。
  • 各セッションの支払いを行うサブスクリプションまたはプロバイダーを理解するには、アカウントと請求 を確認してください。
  • OpenAI 互換エンドポイント、セルフホストモデル、または別の API Key が必要な場合は、カスタム AI プロバイダー を追加します。