安装 PandaNpc 和 PandaPaw

更新于

远程编码设置包含两个独立部分：

  • PandaNpc 客户端 — 用于阅读会话、发送提示和批准工具的界面。它可在 Web、iOS、Windows、macOS 和 Linux 上运行。
  • PandaPaw 主机 — 在计算机上实际执行 Claude Code、Codex 或 PandaCode 的后台服务。

仅安装客户端即可用于 PandaNpc 聊天和本地桌面使用。当你想访问运行在另一台机器上的编码代理时，则需要安装两个部分。

有关 Windows/macOS/Linux 应用在下方安装步骤之外还提供哪些功能（包括其发布历史），请参阅 PandaNpc 桌面版。

选择要安装的内容

场景 客户端 PandaPaw 主机
在浏览器中使用 PandaNpc 聊天 打开 Web 应用 不需要
在同一个桌面上控制代理 桌面应用 取决于所选的本地/远程模式
从手机或浏览器控制开发机器 在查看设备上安装/打开客户端 在开发机器上需要
在没有图形桌面的服务器上运行代理 在其他设备上使用 Web、桌面或 iOS 在服务器上需要

如需最短的端到端路径，请使用 快速入门指南。

安装 PandaNpc 客户端

请以 PandaNpc 下载页面 作为当前安装程序的权威来源。避免使用第三方下载站点，因为它们可能提供过时或被修改的软件包。

Web

在当前浏览器中打开 pandanpc.com/agent。无需安装任何内容。浏览器存储会保留本地登录状态，因此无痕/隐身窗口可能需要你重新登录。

iOS

按照下载页面上的 App Store 链接安装 PandaNpc。iOS 适合在离开主机时查看进度、回答问题以及批准工具。编码过程仍在所连接的主机机器上运行。请参阅 PandaNpc for iOS 了解该应用涵盖的内容，包括其发布历史。

Windows

  1. 下载当前的 Windows 安装程序。
  2. 运行它并按照安装程序提示操作。
  3. 从开始菜单启动 PandaNpc。
  4. 如果 Windows 显示发布者或信誉警告，请在继续之前确认文件来自 pandanpc.com。

macOS

  1. 下载 macOS .dmg 文件。
  2. 将 PandaNpc 拖入应用程序文件夹。
  3. 从应用程序文件夹启动它，并完成任何 macOS 安全提示。

macOS 版本是通用（universal）构建，因此同一个软件包同时支持 Apple Silicon 和 Intel Mac。

Linux

下载 x86_64 版 AppImage，赋予其可执行权限，然后运行：

bash
chmod +x PandaNpc_*.AppImage
./PandaNpc_*.AppImage

如果 AppImage 无法启动，请在终端中运行一次，并保留确切的错误输出。较旧的发行版可能缺少桌面 shell 所需的运行时库。

在代理主机上安装 PandaPaw

PandaPaw 目前为 Windows x64、macOS universal 和 Linux x86_64 提供主机安装程序。请在拥有项目文件并应执行代理工具的计算机上运行该命令。

推荐的方式是通过 已连接设备：选择添加设备，然后复制生成的一次性命令。该命令会在安装过程中将主机与你的账户配对。

macOS 或 Linux

纯安装程序（带浏览器授权）：

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

预设一次性密钥形式：

bash
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh -s -- --mesh pnkey-xxxx

Windows PowerShell

纯安装程序：

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

预设一次性密钥形式：

powershell
$env:PANDANET_KEY="pnkey-xxxx"; iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

PowerShell 的 iwr | iex 管道无法传递普通脚本参数，因此 Windows 安装程序会从 PANDANET_KEY 读取一次性密钥。

主机安装程序会更改什么

安装程序会：

  1. 将 PandaPaw 添加到当前用户的应用程序/二进制目录，并在需要时更新用户的 PATH。
  2. 注册相应的后台服务以自动启动。
  3. 在平台允许的情况下，安装缺失的受支持编码引擎。
  4. 当系统没有合适的版本时，提供专用的 Node.js 运行时。
  5. 启动账户授权或兑换预设的设备密钥。
  6. 记录其创建的文件，以便卸载时可以保留原本已存在的兼容工具。

安装引擎并不会自动购买或认证模型订阅。Claude Code 和 Codex 仍可能在首次运行时要求进行各自的提供商登录。

验证安装

安装后打开一个新的终端并运行：

bash
pandapaw status

然后打开 PandaNpc Agent。主机应显示为在线。在测试项目中启动一个会话，并要求它报告当前工作目录而不修改任何文件。这样可以验证二进制文件、后台服务、账户配对、中继连接、引擎以及所选目录——而不仅仅是下载步骤。

更新

桌面客户端会在有可用更新时通知你。iOS 通过 App Store 更新。

使用以下命令更新 PandaPaw 并重启其托管的服务：

bash
pandapaw update --restart

更新程序会在替换已安装副本之前，根据已发布的 SHA-256 校验和验证下载的二进制文件。你的账户配对和现有的连接身份将被保留。当更新程序本身不可用时，也支持重新运行安装命令。

卸载

  • Windows 客户端： 设置 → 应用 → 已安装的应用 → PandaNpc → 卸载。
  • macOS 客户端： 退出 PandaNpc，然后将其从应用程序文件夹移到废纸篓。
  • Linux 客户端： 删除 AppImage 以及你为其创建的任何启动器。
  • PandaPaw 主机： 在主机上运行 pandapaw uninstall。

PandaPaw 的卸载清单会区分安装程序创建的工具和原本已存在的兼容工具。它有意保持保守，而不是删除预先存在的 Claude Code、Codex、PandaCode 或 Node 安装。

安装问题

命令已完成，但主机未连接

运行 pandapaw login。主机安装和账户授权是两个独立阶段，即使浏览器授权被延迟或中断，安装程序也可能完成。

Shell 找不到 `pandapaw`

打开一个新的终端。在 macOS/Linux 上，检查 ~/.local/bin；在 Windows 上，检查 %LOCALAPPDATA%\Programs\pandapaw。在确认可执行文件是否存在且只是 PATH 过期之前，不要反复重新安装。

编码引擎安装失败

主机安装程序将可选的引擎下载视为尽力而为，因此某个提供商的故障不会破坏正常的 PandaPaw 安装。请使用该引擎的官方安装程序进行安装或修复，正常进行认证，然后再次运行 pandapaw status。

AppImage 或桌面应用无法打开

确认你下载了正确架构的软件包，然后从终端启动以捕获第一个错误。联系支持时请附上该错误和你的操作系统版本；通常，已关闭窗口的截图不足以诊断缺失的运行时库。

如需进行主机特定的连接检查，请继续参阅 PandaPaw 指南 或 常见问题。