这些解答涵盖了当前基于账户的 PandaPaw 设置。对于首次安装，请遵循快速入门指南；其中包含命令和真实成功检查。
通用
什么是 PandaNpc？
PandaNpc 是编码智能体的远程接口和编排层。Claude Code、Codex 或 PandaCode 在您控制的机器上运行，而您可以从 Web、桌面、iOS 或 Chrome 客户端读取输出、发送指令、批准工具并恢复会话。PandaNpc 还包括多模型聊天、笔记、定时任务、智能体中心和 MCP 工具。
PandaNpc 会取代 Claude Code 或 Codex 吗？
不是。PandaNpc 控制这些引擎并围绕它们添加跨设备工作流。实际引擎仍需要在宿主机上安装并完成身份验证。当您想自己选择 OpenAI 或 Anthropic 兼容的模型后端时，PandaCode 是捆绑的替代方案。
支持哪些平台？
PandaNpc 客户端可在 Web、iOS、Windows、macOS 和 Linux 上使用。PandaPaw 宿主安装程序目前支持 Windows x64、macOS 通用版和 Linux x86_64。请查看安装以了解软件包详情和验证步骤。
我需要 PandaNpc 账户吗？
是的，用于基于账户的宿主配对、共享的智能体中心配置以及跨设备访问已连接的机器。支持邮箱验证码、Google 和 GitHub 登录。Claude Code 或 Codex 使用的模型提供商仍是一个独立的账户。
远程 Claude Code、Codex 和 PandaCode
现在如何连接新机器？
登录后，打开已连接设备，然后选择添加设备。在宿主机上运行生成的一次性命令。机器在安装过程中完成配对，然后自动出现在 PandaNpc Agent 中。
普通安装程序仍然可用，并运行 pandapaw login 进行浏览器授权。pandapaw qr 是用于手动添加旧版或特殊连接的兼容路径，不是新宿主的首选设置。您通常不应手动复制桥接 ID 和令牌。
宿主机需要保持开机吗？
是的。编码引擎及其工具在该宿主机上执行。PandaPaw 可以在重启后自动启动，但无法在计算机关机或休眠时保持会话运行。请为专用服务器或长时间运行的任务适当地配置休眠行为。
我需要开放端口或拥有公网 IP 吗？
通常不需要。宿主机和查看客户端发起出站连接。不要仅仅为了让 PandaNpc 工作而将 SSH、中继端口或本地模型端点暴露到公共互联网。受限的企业网络可能仍需要允许出站的 HTTPS 和 WebSocket 流量。
我可以通过手机、浏览器和桌面端控制同一台宿主机吗？
可以。使用相同的 PandaNpc 账户登录并打开已保存的连接。客户端显示相同的远程主机和会话状态。无论哪个查看设备发送指令，工具执行始终在宿主机上进行。
当我的查看设备断开连接时会发生什么？
PandaPaw 和客户端会尝试重新连接，已保存的会话可以连同其历史记录一起重新打开。在断连期间智能体是否继续生成取决于引擎以及网络失败的时间点。重新连接后，请验证最后完成的工具调用，然后再重复可能产生副作用的操作。
为什么机器已列出但处于离线状态？
请按顺序检查：
- 宿主机已开机并处于唤醒状态。
pandapaw status能识别服务和账户。- 宿主机可以访问互联网。
- 防火墙未阻止出站 WebSocket/HTTPS 流量。
- 已完成与您正在查看的相同 PandaNpc 账户的设备密钥或登录。
如果安装成功但未授权，请运行 pandapaw login。不要将创建入站端口转发规则作为首要的故障排查步骤。
PandaNpc 可以使用现有的 Claude Code 或 Codex 安装吗？
可以。安装程序会检测兼容的引擎并复用它们。其卸载清单是保守的：PandaPaw 之前已存在的工具不应被 pandapaw uninstall 移除。
模型、订阅和费用
远程编码会话由哪个账户付费？
是在宿主机上为引擎配置的账户。远程 Claude Code 使用该 Claude 订阅或后端；远程 Codex 使用其 ChatGPT/Codex 登录或提供商；PandaCode 使用您选择的提供商。PandaNpc 服务套餐和模型提供商费用是分开的。请参阅账户、套餐和 AI 计费。
我可以使用 DeepSeek、Qwen、Kimi 或私有端点吗？
可以，通过 PandaCode 或 PandaNpc 自定义提供商配置，只要端点支持 OpenAI 或 Anthropic 兼容的协议。兼容性不仅仅是接受 URL：模型标识符、认证头、流式响应、工具调用、上下文限制和输出限制必须与上游服务一致。
PandaNpc 是否包含无需 API Key 的 AI 模型？
PandaNpc 内置聊天提供一组不断变化的模型。实时选择器是当前可用性和账户资格的依据。这不同于远程 Claude Code 或 Codex 进程，后者通常使用引擎自身的凭据。请参阅支持的 AI 模型。
为什么我的自定义提供商在桌面端可用但在浏览器中失败？
桌面客户端可以发出原生 HTTP 请求，而浏览器必须遵守 CORS 和混合内容规则。从 Web 使用时，提供商必须允许 pandanpc.com 来源和 HTTPS。另请记住，localhost 指的是运行浏览器的设备，而不是您的远程 PandaPaw 宿主机。
安全与共享
命令和文件编辑在哪里执行？
在选定的宿主机上执行。远程客户端发送指令和批准；它不会将整个项目复制到查看设备。提示词和引用的内容仍可能被发送到所选的模型提供商，并且会话数据必须通过中继传输才能在远程显示。请阅读隐私政策以获取权威的数据描述。
连接共享是只读的吗？
不是。连接共享允许接收者驱动该智能体连接，包括会话可用的工具和工作目录。如需只读访问，请改为共享会话记录。在授予访问权限之前，请阅读连接共享。
我可以撤销设备或共享连接吗？
可以。从“已连接设备”中移除无法识别的主机，并在其管理界面中撤销活动的连接共享。撤销会阻止该凭据的未来使用；但不会撤销已在该宿主机上执行的命令或文件更改。
我应该向支持团队发送哪些信息？
请包含宿主机操作系统、PandaPaw 版本、失败的命令、确切的错误文本，以及问题是否发生在 Web、桌面或 iOS 上。请移除电子邮件验证码、账户令牌、设备密钥、API Key、内部 IP 地址、私有仓库 URL 以及非复现问题所必需的源代码。
有关特定版本的行为，请查看PandaPaw 版本历史。如果此处未能解答您的问题，请发送电子邮件至 support@pandanpc.com。