PandaNpc Work 快速开始：连接你的首个智能体

PandaNpc Work 是一个多引擎 AI 工作空间，可通过 Codex 远程控制或 Claude Code 远程控制开始使用：用 PandaPaw 连接一台电脑，选择智能体引擎，并验证远程会话。

更新于

本指南将一台计算机连接到 PandaNpc Work，并验证你可以从另一台设备运行 Claude Code、Codex 或 PandaCode。PandaNpc Work 是多引擎 AI 工作区，你可以在其中委派工作并跨设备跟进。智能体仍在已连接的计算机上执行；PandaPaw 提供桥接和本地运行时，而 PandaNpc Work 为你提供用于消息、审批、问题和会话历史的同步界面。

这条路径最适合已经熟悉 Claude Code、Codex 或类似编码智能体的人。大多数人应使用 添加设备 流程，因为它会生成一个已与其账户关联的一次性安装命令。预留大约五分钟，外加你的编码引擎所需的任何模型提供商登录时间。若要在连接计算机之前探索智能体界面，请在浏览器中打开 PandaNpc 智能体。

开始之前

你需要：

  • 一个可在 Web 应用、桌面应用或 iOS 应用中打开的 PandaNpc 账户。
  • 一台已连接、运行 Windows x64、macOS 或 Linux x86_64 的计算机。
  • 主机可访问互联网，并且有权安装用户级后台服务。
  • 一个你获准修改的项目文件夹。
  • 如果你选择的引擎尚未通过认证，则需要一个 Claude、ChatGPT/Codex 或自定义模型账户。

如果你只想查看已连接的主机，请在查看设备上安装或打开客户端。PandaPaw 应安装在运行智能体的计算机上。有关客户端和主机角色，请参阅 安装。

1. 生成主机安装命令

登录后，打开 已连接设备 并选择 添加设备。PandaNpc 会创建一个一次性设备密钥，并显示适用于你的操作系统的确切命令。

将该命令复制到应运行编码智能体的机器上。在使用之前，请像对待密码一样对待它：一次性密钥用于配对一台机器，不应发布在聊天、截图、议题或 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 项目，你还可以检查智能体中心是否识别项目根目录：

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

使用真实的绝对项目路径。当目录具有稳定的 Git remote.origin.url 时，智能体中心项目绑定效果最佳。

4. 启动第一个远程会话

  1. 在手机、浏览器或其他桌面设备上打开 PandaNpc 智能体。
  2. 找到新连接的机器。绿色状态指示器表示主机当前可访问。
  3. 选择 Claude Code、Codex 或 PandaCode，并选择项目工作目录。
  4. 启动会话。如果引擎要求你登录，请在主机上或通过显示的登录流程完成该提供商的授权。
  5. 发送一个非破坏性测试提示，例如：Show the current working directory and list the top-level files. Do not edit anything.

当回复命名了预期的项目目录、文件列表与主机匹配，并且任何权限问题都出现在远程客户端上供你批准或拒绝时，即表示已完全连接。

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 配置。完成引擎的正常登录，然后重试会话。

智能体在错误的文件夹中打开

结束该测试会话，并使用预期的工作目录创建一个新会话。在批准工具使用之前，请让智能体打印当前目录。远程连接本身不会添加文件系统沙盒；引擎的工具权限和选定的工作目录仍然很重要。

后续步骤