快速开始：远程运行 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 项目，你还可以检查代理中心是否识别项目根目录：

bash

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

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

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

关闭查看客户端，等待几秒，然后重新打开同一会话。现有历史记录应恢复，主机应保持在线。这会检查实际的远程路径，而不是仅仅证明安装程序已成功下载。

测试期间不要让主机进入睡眠状态。睡眠或关机的主机无法运行代理，即使已保存的连接仍出现在你的账户中。

在主机上运行 pandapaw status。如果安装成功但没有关联账户，请运行 pandapaw login。如果你使用了准备好的密钥，但该密钥已兑换或过期，请在已连接设备中生成一个新密钥并重新运行所显示的命令。

打开一个新终端。在 macOS/Linux 上，确认 ~/.local/bin 位于 PATH 中。在 Windows 上，安装程序将 %LOCALAPPDATA%\Programs\pandapaw 添加到用户 PATH；在安装前打开的终端将看不到新值。

确认主机已开机、处于唤醒状态并能访问互联网。然后检查 pandapaw status。公司防火墙必须允许出站 HTTPS/WebSocket 流量；你不应创建入站端口转发规则。

PandaPaw 配对与模型提供商登录是分开的。配对证明主机属于你的 PandaNpc 账户；Claude Code 或 Codex 可能仍需要其自己的订阅登录或 API 配置。完成引擎的正常登录，然后重试会话。

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