Установка PandaNpc и PandaPaw

Обновлено

Удалённая настройка кодинг-агента состоит из двух независимых частей:

  • PandaNpc client — интерфейс, с помощью которого вы читаете сессии, отправляете промпты и одобряете инструменты. Он работает в вебе, iOS, Windows, macOS и Linux.
  • хост PandaPaw — фоновый сервис на компьютере, где фактически выполняются Claude Code, Codex или PandaCode.

Устанавливайте только клиент для чата PandaNpc и локального использования на рабочем столе. Устанавливайте обе части, когда вам нужно подключиться к кодинг-агенту, запущенному на другой машине.

См. PandaNpc Desktop о том, что приложение для Windows/macOS/Linux добавляет помимо шагов установки ниже, включая историю релизов.

Выберите, что установить

Сценарий Клиент хост PandaPaw
Использование чата PandaNpc в браузере Откройте веб-приложение Не требуется
Управление агентом на этом же рабочем столе Настольное приложение Зависит от выбранного локального/удалённого режима
Управление машиной разработки с телефона или браузера Установите/откройте клиент на устройстве просмотра Требуется на машине разработки
Запуск агентов на сервере без графического рабочего стола Веб, десктоп или iOS на другом устройстве Требуется на сервере

Для самого короткого сквозного пути используйте Краткое руководство по началу работы.

Установка клиента PandaNpc

Используйте страницу загрузки PandaNpc как источник актуальных установщиков. Избегайте сторонних сайтов загрузки, так как они могут предлагать старые или изменённые пакеты.

Веб

Откройте pandanpc.com/agent в актуальном браузере. Ничего не устанавливается. Хранилище браузера сохраняет локальное состояние входа, поэтому в приватных/инкогнито окнах может потребоваться снова войти в систему.

iOS

Перейдите по ссылке App Store на странице загрузки и установите PandaNpc. iOS полезен для проверки прогресса, ответов на вопросы и одобрения инструментов, когда вы находитесь не рядом с хостом. Процесс кодинга по-прежнему выполняется на подключённой хост-машине. См. PandaNpc для iOS о том, что охватывает приложение, включая историю релизов.

Windows

  1. Скачайте текущий установщик для Windows.
  2. Запустите его и следуйте подсказкам установщика.
  3. Запустите PandaNpc из меню «Пуск».
  4. Если Windows отображает предупреждение об издателе или репутации, проверьте, что файл получен с pandanpc.com, прежде чем продолжить.

macOS

  1. Скачайте .dmg для macOS.
  2. Перетащите PandaNpc в папку Программы.
  3. Запустите его из «Программ» и пройдите все запросы безопасности macOS.

Сборка для macOS универсальная, поэтому один и тот же пакет поддерживает Apple Silicon и Intel Mac.

Linux

Скачайте AppImage для x86_64, сделайте его исполняемым и запустите:

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

Если AppImage не запускается, запустите его из терминала один раз и сохраните точный вывод ошибки. В старых дистрибутивах может отсутствовать библиотека времени выполнения, необходимая для оболочки рабочего стола.

Установка 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. Установка хоста и авторизация учётной записи — это отдельные этапы, и установщик может завершиться, даже если авторизация через браузер была отложена или прервана.

Оболочка не может найти `pandapaw`

Откройте новый терминал. В macOS/Linux проверьте ~/.local/bin; в Windows проверьте %LOCALAPPDATA%\Programs\pandapaw. Не переустанавливайте многократно, пока не подтвердите, существует ли исполняемый файл и просто ли PATH устарел.

Не удалось установить кодинг-движок

Установщик хоста рассматривает необязательные загрузки движков как попытку с максимальными усилиями, поэтому сбой одного провайдера не удаляет рабочую установку PandaPaw. Установите или восстановите этот движок с помощью его официального установщика, выполните обычную аутентификацию, затем снова запустите pandapaw status.

AppImage или настольное приложение не открывается

Убедитесь, что вы загрузили пакет для правильной архитектуры, затем запустите его из терминала, чтобы получить первую ошибку. Включите эту ошибку и версию вашей ОС при обращении в поддержку; скриншоты закрытого окна обычно недостаточны для диагностики отсутствующей библиотеки времени выполнения.

Для проверок подключения, характерных для хоста, продолжайте с руководством по PandaPaw или FAQ.