クイックスタート: Claude Code または Codex をリモートで実行する

更新日

このガイドでは、ある開発マシンを PandaNpc に接続し、別のデバイスから Claude Code、Codex、または PandaCode を実行できることを確認します。エージェントは依然として開発マシン上で動作します。PandaNpc は、メッセージ、承認、質問、セッション履歴のための同期されたリモートインターフェースを提供します。

ほとんどのユーザーは デバイスを追加 フローを使用してください。アカウントにリンクされた一回限りのインストールコマンドが生成されるためです。所要時間は約5分に加えて、コーディングエンジンに必要なモデルプロバイダーへのサインイン時間がかかります。

始める前に

必要なもの:

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

PandaNpc の組み込みチャットのみが必要で、別のマシン上のエージェントを制御する必要がない場合は、PandaPaw は不要です。クライアントのみのオプションについては インストール を参照してください。

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

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

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

準備されたキーではなくブラウザ認証を希望する場合は、次のステップの通常のインストーラーを使用してください。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 エージェント を開きます。
  2. 新しく接続されたマシンを見つけます。緑のステータスインジケーターは、ホストが現在到達可能であることを意味します。
  3. Claude Code、Codex、または PandaCode を選択し、プロジェクトの作業ディレクトリを選択します。
  4. セッションを開始します。エンジンがサインインを求める場合は、ホスト上または表示されたログインフローを使用して、そのプロバイダーの認証を完了します。
  5. 破壊的でないテストプロンプトを送信します。例: 現在の作業ディレクトリを表示し、トップレベルのファイルを一覧表示してください。何も編集しないでください。

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

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

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

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

トラブルシューティング

マシンがエージェントに表示されない

ホスト上で 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 キーが必要な場合は、カスタム AI プロバイダー を追加してください。