Встановлення PandaNpc та PandaPaw

Оновлено

Віддалене налаштування агента для кодування має дві незалежні частини:

  • Клієнт PandaNpc — інтерфейс, який ви використовуєте для читання сеансів, надсилання запитів і схвалення інструментів. Він працює у вебі, iOS, Windows, macOS і Linux.
  • Хост PandaPaw — фонова служба на комп’ютері, де фактично виконуються Claude Code, Codex або PandaCode.

Встановлюйте лише клієнт для чату PandaNpc і локального використання на робочому столі. Встановлюйте обидві частини, коли потрібно отримати доступ до агента для кодування, що працює на іншому комп’ютері.

Перегляньте PandaNpc Desktop, щоб дізнатися, що програма для Windows/macOS/Linux додає понад наведені нижче кроки встановлення, включно з історією її випусків.

Виберіть, що встановити

Сценарій Клієнт Хост PandaPaw
Використання чату PandaNpc у браузері Відкрийте вебзастосунок Не обов’язково
Керування агентом на цьому ж робочому столі Десктопний застосунок Залежить від вибраного локального/віддаленого режиму
Керування машиною розробника з телефону або браузера Встановіть/відкрийте клієнт на пристрої перегляду Обов’язково на машині розробника
Запуск агентів на сервері без графічного робочого столу Веб, десктоп або iOS в іншому місці Обов’язково на сервері

Для найкоротшого наскрізного шляху скористайтеся Посібником із швидкого старту.

Встановлення клієнта PandaNpc

Використовуйте сторінку завантаження PandaNpc як основне джерело для поточних інсталяторів. Уникайте сторонніх сайтів завантаження, оскільки вони можуть надавати старі або модифіковані пакети.

Web

Відкрийте 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

Завантажте x86_64 AppImage, зробіть його виконуваним і запустіть:

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.