PandaNpc Work 快速入門：連接你的第一個代理

開始使用 PandaNpc Work 這款多引擎 AI 工作空間。連接安裝了 PandaPaw 的電腦，選擇代理引擎，並驗證遠端工作階段。

更新於

本指南會將一部電腦連接到 PandaNpc Work，並驗證你可以從另一部裝置執行 Claude Code、Codex 或 PandaCode。PandaNpc Work 是多引擎 AI 工作區，讓你委派工作並跨裝置追蹤進度。Agent 仍會在已連接的電腦上執行；PandaPaw 提供橋接與本機執行環境，而 PandaNpc Work 則為你提供訊息、核准、問題與工作階段歷史的同步介面。

此路徑最適合已經熟悉 Claude Code、Codex 或類似程式開發 Agent 的人。大多數人應該使用 新增裝置 流程，因為它會產生已連結至其帳戶的一次性安裝命令。請預留約五分鐘，外加你的程式開發引擎所需的任何模型供應商登入時間。若想在連接電腦前探索 Agent 介面，請在瀏覽器中開啟 PandaNpc Agent。

開始之前

你需要：

  • 在 網頁版應用程式、桌面版應用程式或 iOS 版應用程式中開啟的 PandaNpc 帳戶。
  • 一部執行 Windows x64、macOS 或 Linux x86_64 的已連接電腦。
  • 主機可存取網際網路，且具備安裝使用者層級背景服務的權限。
  • 一個你獲准修改的專案資料夾。
  • 如果你選擇的引擎尚未驗證，則需要 Claude、ChatGPT/Codex 或自訂模型帳戶。

如果你只想檢視已連接的主機，請在你的檢視裝置上安裝或開啟用戶端。PandaPaw 應安裝在執行 Agent 的電腦上。關於用戶端與主機角色，請參閱 安裝。

1. 產生主機安裝命令

登入後，開啟 已連接的裝置 並選擇 新增裝置。PandaNpc 會建立一次性裝置金鑰，並顯示適用於你作業系統的確切命令。

將該命令複製到應執行程式開發 Agent 的機器。在尚未使用前，請將其視為密碼：一次性金鑰會配對一部機器，不應張貼在聊天、螢幕擷取畫面、問題回報或 shell 歷史記錄匯出中。

如果你偏好使用瀏覽器授權，而非預先準備的金鑰，請使用下一步中的一般安裝程式。它會執行 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 執行環境時，會提供私用的 Node.js 執行環境。使用預先準備的裝置金鑰時，帳戶配對會在安裝期間進行。使用一般命令時，請在提示時核准瀏覽器授權要求。

即使帳戶授權被延後，安裝程式仍可能完成。如果它顯示安裝成功，但帳戶連接不完整，請執行：

bash
pandapaw login

3. 驗證主機服務

在主機上執行：

bash
pandapaw status

該命令應能辨識已安裝的服務，並顯示已連接帳戶的機器。如果 shell 找不到 pandapaw，請先開啟新的終端機，以便重新載入更新後的使用者 PATH。

對於 Git 專案，你也可以檢查 Agent Center 是否辨識專案根目錄：

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

請使用真實的專案絕對路徑。當目錄具有穩定的 Git remote.origin.url 時，Agent Center 專案綁定效果最佳。

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。

疑難排解

機器未出現在 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 設定。完成引擎的一般登入，然後重試工作階段。

Agent 在錯誤的資料夾中開啟

結束該測試工作階段，並以預期的工作目錄建立一個新的工作階段。在核准工具使用之前，請要求 Agent 印出目前目錄。遠端連接本身不會新增檔案系統沙箱；引擎的工具權限與所選工作目錄仍然很重要。

後續步驟

  • 閱讀完整的 PandaPaw 主機指南，以了解更新、服務檢查與連接架構。
  • 查看 帳戶與計費，以了解每個工作階段由哪個訂閱或供應商付費。
  • 當你想要 OpenAI 相容端點、自我託管模型或個別的 API Key 時，請新增 自訂 AI 供應商。