這些解答涵蓋目前以帳號為基礎的 PandaPaw 設定。首次安裝請遵循快速入門指南;其中包含指令與實際的成功檢查。
一般
什麼是 PandaNpc?
PandaNpc 是供程式碼代理使用的遠端介面與編排層。Claude Code、Codex 或 PandaCode 在您掌控的機器上執行,而您可以透過網頁、桌面、iOS 或 Chrome 用戶端閱讀輸出、傳送指令、核准工具,以及恢復工作階段。PandaNpc 也包含多模型聊天、筆記、排程任務、Agent Center 與 MCP 工具。
PandaNpc 會取代 Claude Code 或 Codex 嗎?
不會。PandaNpc 控制這些引擎,並在它們周圍加入跨裝置工作流程。實際引擎仍須在主機上安裝並完成驗證。當您想自行選擇 OpenAI 或 Anthropic 相容的模型後端時,PandaCode 是內建的替代方案。
支援哪些平台?
PandaNpc 用戶端可用於網頁、iOS、Windows、macOS 與 Linux。PandaPaw 主機安裝程式目前支援 Windows x64、macOS universal 與 Linux x86_64。請參閱安裝以了解套件詳細資訊與驗證步驟。
我需要 PandaNpc 帳號嗎?
需要。帳號用於以帳號為基礎的主機配對、共用 Agent Center 設定,以及跨裝置存取已連線的機器。支援電子郵件驗證碼、Google 與 GitHub 登入。Claude Code 或 Codex 所使用的模型供應商仍是獨立的帳號。
遠端 Claude Code、Codex 與 PandaCode
我現在要如何連接新機器?
登入後,開啟已連線裝置,然後選擇新增裝置。在主機上執行產生的一次性指令。機器會在安裝期間完成配對,然後自動出現在 PandaNpc Agent 中。
一般安裝程式仍然可用,並執行 pandapaw login 進行瀏覽器授權。pandapaw qr 是手動新增較舊或特殊連線的相容性途徑,並非新主機的主要設定方式。您通常不應手動複製 Bridge ID 與 token。
主機需要保持開機嗎?
需要。程式碼引擎及其工具會在主機上執行。PandaPaw 可以在重新開機後自動啟動,但無法在電腦關機或休眠時保持工作階段執行。請針對專用伺服器或長時間執行的任務,適當設定休眠行為。
我需要開啟連接埠或擁有公開 IP 嗎?
一般來說不需要。主機與檢視用戶端會建立對外連線。請勿為了讓 PandaNpc 運作而將 SSH、中繼連接埠或本機模型端點暴露到公開網際網路。受限的公司網路仍可能需要允許對外的 HTTPS 與 WebSocket 流量。
我可以從手機、瀏覽器和桌面同時控制同一台主機嗎?
可以。使用同一個 PandaNpc 帳號登入並開啟已儲存的連線。各用戶端會顯示相同的遠端主機與工作階段狀態。無論是哪個檢視裝置傳送指令,工具執行仍會在主機上進行。
當我的檢視裝置中斷連線時會發生什麼事?
PandaPaw 與用戶端會嘗試重新連線,而已儲存的工作階段可連同其歷史紀錄重新開啟。代理在中斷期間是否繼續產生內容,取決於引擎與網路失敗的時間點。重新連線後,請先確認最後一次已完成的工具呼叫,再重複可能產生副作用的操作。
為什麼機器顯示在清單中但處於離線狀態?
請依序檢查:
- 主機已開機且處於喚醒狀態。
pandapaw status能識別服務與帳號。- 主機可以連上網際網路。
- 防火牆未封鎖對外的 WebSocket/HTTPS 流量。
- 裝置金鑰或登入已完成,且使用您正在檢視的同一個 PandaNpc 帳號。
如果安裝成功但未完成授權,請執行 pandapaw login。請勿將建立對內連接埠轉送規則當作第一個疑難排解步驟。
PandaNpc 可以使用既有的 Claude Code 或 Codex 安裝嗎?
可以。安裝程式會偵測相容的引擎並加以重用。其解除安裝清單較為保守:pandapaw uninstall 不應移除 PandaPaw 之前即已存在的工具。
模型、訂閱方案與費用
遠端程式碼工作階段由哪個帳號付費?
由主機上為引擎設定的帳號付費。遠端 Claude Code 使用該 Claude 訂閱方案或後端;遠端 Codex 使用其 ChatGPT/Codex 登入或供應商;PandaCode 使用您選擇的供應商。PandaNpc 服務方案與模型供應商費用是分開的。請參閱帳號、方案與 AI 計費。
我可以使用 DeepSeek、Qwen、Kimi 或私人端點嗎?
可以,只要端點支援相容的 OpenAI 或 Anthropic 通訊協定,即可透過 PandaCode 或 PandaNpc 的自訂供應商設定使用。相容性不僅是接受 URL:模型識別碼、驗證標頭、串流回應、工具呼叫、上下文限制與輸出限制都必須與上游服務一致。
PandaNpc 是否包含不需要 API Key 的 AI 模型?
PandaNpc 內建聊天會提供一組不斷變化的模型。即時選取器是判斷目前可用性與帳號資格的權威依據。這與遠端 Claude Code 或 Codex 程序分開,後者通常使用引擎自身的憑證。請參閱支援的 AI 模型。
為什麼我的自訂供應商在桌面版可用,但在瀏覽器中失敗?
桌面用戶端可以發出原生 HTTP 請求,而瀏覽器必須遵守 CORS 與混合內容規則。從網頁使用時,供應商必須允許 pandanpc.com 來源與 HTTPS。另請記住,localhost 指的是執行瀏覽器的裝置,而不是您的遠端 PandaPaw 主機。
安全性與共用
指令與檔案編輯在哪裡執行?
在選定的主機機器上執行。遠端用戶端會傳送指令與核准;它不會將整個專案複製到檢視裝置。提示與參考內容仍可能被傳送到所選的模型供應商,而工作階段資料必須經由中繼伺服器傳輸才能遠端顯示。請閱讀隱私權政策以取得權威的資料說明。
連線共用是唯讀的嗎?
不是。連線共用會讓接收者操作該代理連線,包括工作階段可用的工具與工作目錄。若只要檢視存取,請改為共用工作階段紀錄。在授予存取權之前,請先閱讀連線共用。
我可以撤銷裝置或共用連線嗎?
可以。從「已連線裝置」中移除無法識別的主機,並從其管理畫面撤銷有效的連線共用。撤銷會封鎖該憑證未來的使用;它不會復原已於主機上執行的指令或檔案變更。
我應該傳送什麼資訊給支援團隊?
請提供主機作業系統、PandaPaw 版本、失敗的指令、確切的錯誤文字,以及問題發生在網頁、桌面還是 iOS。請移除電子郵件驗證碼、帳號 token、裝置金鑰、API Key、內部 IP 位址、私人儲存庫 URL,以及重現問題所不需要的原始碼。
若需特定版本的相關行為,請查閱 PandaPaw 版本歷史。如果這裡沒有回答您的問題,請寄電子郵件至 support@pandanpc.com。