快速開始：遠端執行 Claude Code 或 Codex

更新於 2026-08-17

本指南將一台開發機器連接到 PandaNpc，並驗證您可以從另一台裝置執行 Claude Code、Codex 或 PandaCode。代理程式仍會在您的開發機器上執行；PandaNpc 為您提供同步的遠端介面，用於訊息、核准、問題與工作階段歷史紀錄。

大多數使用者應使用「新增裝置」流程，因為它會產生已連結至其帳戶的一次性安裝指令。大約需要五分鐘，外加您的編碼引擎所需的任何模型提供者登入。

開始之前

您需要：

如果您只需要 PandaNpc 內建的聊天功能，且不想控制另一台機器上的代理程式，則不需要 PandaPaw。請參閱安裝以了解僅限用戶端的選項。

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

將該指令複製到應執行編碼代理程式的機器上。在使用前請將其視為密碼：一次性金鑰會配對一部機器，不應張貼在聊天、螢幕截圖、議題或 shell 歷史匯出中。

如果您偏好瀏覽器授權而非準備好的金鑰，請使用下一步中的一般安裝程式。它會執行 pandapaw login 並為您開啟授權頁面。

執行「已連線裝置」中的準備指令，或使用一般安裝程式：

bash

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

執行「已連線裝置」中的準備指令，或使用：

powershell

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

安裝程式會新增 PandaPaw 及其背景服務，在可能的情況下安裝缺少的受支援編碼引擎，並在主機沒有合適的 Node.js 執行階段時提供私有的 Node.js 執行階段。使用準備好的裝置金鑰時，帳戶配對會在安裝期間完成。使用一般指令時，請在出現提示時核准瀏覽器授權請求。

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

bash

pandapaw login

在主機上執行：

bash

pandapaw status

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

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

bash

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

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

當回覆中顯示預期的專案目錄、檔案清單與主機相符，且任何權限問題都出現在遠端用戶端供您核准或拒絕時，您就完全連線了。

關閉檢視用戶端，等待幾秒鐘，然後重新開啟相同的工作階段。現有的歷史紀錄應會返回，且主機應保持線上。這會檢查實際的遠端路徑，而不僅僅是證明安裝程式已成功下載。

在此測試期間請勿讓主機進入睡眠。休眠或關機的主機無法執行代理程式，即使已儲存的連線仍出現在您的帳戶中。

在主機上執行 pandapaw status。如果安裝成功但未附加帳戶，請執行 pandapaw login。如果您使用了準備好的金鑰，但它已被兌換或過期，請在「已連線裝置」中產生新的金鑰，並重新執行顯示的指令。

開啟新的終端機。在 macOS/Linux 上，確認 ~/.local/bin 位於 PATH 中。在 Windows 上，安裝程式會將 %LOCALAPPDATA%\Programs\pandapaw 新增至使用者 PATH；在安裝前開啟的終端機將不會看到新值。

確認主機已開機、未休眠，且可連線至網際網路。然後檢查 pandapaw status。公司防火牆必須允許對外的 HTTPS/WebSocket 流量；您不應建立對內的連接埠轉送規則。

PandaPaw 配對與模型提供者登入是分開的。配對證明主機屬於您的 PandaNpc 帳戶；Claude Code 或 Codex 可能仍需要其自己的訂閱登入或 API 設定。請完成引擎的一般登入，然後重試工作階段。

結束該測試工作階段，並建立一個使用預期工作目錄的工作階段。在核准工具使用前，請要求代理程式列印目前的目錄。遠端連線本身不會新增檔案系統沙箱；引擎的工具權限和選取的工作目錄仍然很重要。