PandaPaw перетворює машину з Windows, macOS або Linux, яку ви контролюєте, на хост агента PandaNpc. Рушій кодування, файли проєкту, оболонка та інструменти залишаються на цьому хості; клієнти PandaNpc надають вам синхронізований інтерфейс з телефона, браузера або іншого комп'ютера.
Використовуйте PandaPaw, коли машина, яка виконує роботу, відрізняється від пристрою, який ви тримаєте в руках, коли ви хочете, щоб хост переживав відключення клієнтів, або коли кілька рушіїв кодування мають спільно використовувати однакове налаштування на основі облікового запису та конфігурацію Центру агентів.
Чим керує PandaPaw
- Віддалені з'єднання агентів для Claude Code, OpenAI Codex та PandaCode.
- Фонові служби та автозапуск, щоб хост міг повернутися після звичайного перезавантаження.
- Авторизація машини на основі облікового запису без ручного копіювання довгоживучого Bridge ID, токена або ключа підпису.
- Допомога зі встановленням рушія, коли підтримуваний рушій кодування відсутній.
- Проєкції Центру агентів, які відображають інструкції, навички, пам'ять і визначення агентів кожного рушія в його рідному форматі.
- Приватний мережевий зв'язок пристроїв для машин, приєднаних через процес «Підключені пристрої».
- Облік оновлень і видалень, щоб інструменти, які існували до PandaPaw, були збережені.
PandaPaw сам по собі не надає підписку на модель. Claude Code, Codex і PandaCode, як і раніше, використовують облікові дані постачальника та ліміти, налаштовані для їхнього рушія.
Як працює віддалене виконання
Обидві сторони ініціюють вихідні з'єднання, тому звичайна домашня або офісна конфігурація не потребує правила вхідного брандмауера, публічної IP-адреси, переадресації портів маршрутизатора або публічно відкритого SSH-сервера. Реле передає повідомлення, статус і підтвердження; виконання інструментів відбувається на хості.
Якщо хост переходить у режим сну, вимикається або втрачає вихідний мережевий шлях, збережене з'єднання залишається у вашому обліковому записі, але не може виконувати роботу, доки хост не повернеться.
Підтримувані платформи хостів
| Платформа хоста | Пакет | Примітки |
|---|---|---|
| Windows x64 | Нативний виконуваний файл і служби рівня користувача | Запустіть інсталятор у PowerShell |
| macOS, Apple Silicon або Intel | Універсальний застосунок/бінарний файл PandaPaw | Один пакет підтримує обидві архітектури |
| Linux x86_64 | Нативний бінарний файл і служба користувача | Призначений для поширених дистрибутивів на основі glibc |
Клієнт перегляду PandaNpc має ширший перелік підтримуваних платформ. Перегляньте Встановлення PandaNpc і PandaPaw, коли обираєте пакети клієнта та хоста.
Рекомендоване встановлення
- Увійдіть у PandaNpc.
- Відкрийте Підключені пристрої.
- Оберіть Додати пристрій. Видається одноразовий ключ, і діалогове вікно показує одну команду для виявленої операційної системи.
- Скопіюйте цю команду на хост і запустіть її там.
- Залиште діалогове вікно відкритим, якщо хочете, щоб воно автоматично виявило нову машину.
Підготовлений ключ є одноразовим. Скопіюйте всю команду, тримайте її в таємниці та створіть новий ключ, якщо він закінчився або вже був використаний.
Звичайний інсталятор для macOS/Linux
Використовуйте цю форму, коли потрібна авторизація через браузер замість підготовленого ключа:
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | shЗвичайний інсталятор для Windows PowerShell
iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iexЗвичайний інсталятор запускає pandapaw login. Підтвердьте машину на сторінці браузера, яку він відкриває. Якщо авторизацію перервано, бінарний файл і служби все одно можуть бути встановлені; запустіть pandapaw login пізніше, щоб завершити підключення облікового запису.
Перевірка хоста
Спочатку перевірте сам хост:
pandapaw statusПотім відкрийте PandaNpc Agent і переконайтеся, що машина має зелений індикатор онлайн. Почніть сеанс у тимчасовому або доступному лише для читання тестовому каталозі та запитайте:
Тестовий запит: Надрукуйте поточний робочий каталог і перелічіть файли верхнього рівня. Нічого не змінюйте.
Успішна відповідь доводить більше, ніж зелений індикатор статусу: вона підтверджує зв'язування облікового запису, з'єднання з реле, вибраний рушій, автентифікацію постачальника та зіставлення робочого каталогу.
Для проєкту Центру агентів виконайте:
pandapaw agent status --root /absolute/path/to/projectЦе показує, чи прив'язаний проєкт і чи доступна керована конфігурація локально. Стабільний віддалений Git-репозиторій допомагає PandaPaw ідентифікувати той самий проєкт на різних машинах.
Авторизація облікового запису та ідентичність з'єднання
pandapaw login використовує сеанс авторизації пристрою через браузер. Після вашого підтвердження хост отримує облікові дані з обмеженням для пристрою та ключ перевірки Центру агентів через TLS, записує конфігурацію машини в ~/.pandapaw/, реєструє з'єднання підтримуваних рушіїв і прив'язує впізнавані Git-проєкти.
Запускайте pandapaw login --force лише тоді, коли ви навмисно перемикаєте облікові записи або замінюєте прострочені облікові дані хоста. Повторна авторизація справної машини без причини може створити заплутані дубльовані або замінені ідентичності.
pandapaw qr, як і раніше, створює короткочасне ручне посилання для підключення для сумісності та особливих випадків. Це не основний процес для нового хоста; «Підключені пристрої» легше аудитувати, і вони не вимагають від користувачів розуміти Bridge ID.
Синхронізація Центру агентів
У сталому стані Центр агентів керується подіями:
- Локальні зміни керованих файлів виявляються та публікуються в прив'язаний проєкт.
- Підписані випуски надходять через потік подій.
- Незмінені маніфести та блоби вмісту використовуються повторно, а не завантажуються знову.
- Періодична перевірка відновлення виявляє події, пропущені під час тимчасового відключення.
Claude Code, Codex і PandaCode отримують окремі проєкції, оскільки вони очікують різні каталоги та формати інструкцій. PandaCode готує останній перевірений випуск перед збиранням нового запиту сеансу, тому конфігурація, отримана під час запуску, може вплинути на той самий сеанс.
Якщо Центр агентів тимчасово недоступний, рушій продовжує роботу з останнього перевіреного локального випуску. Мережевий збій не повинен мовчки замінювати підписану конфігурацію неперевіреним вмістом.
Корисні команди
pandapaw login
pandapaw status
pandapaw agent status --root /absolute/path/to/project
pandapaw update --restart
pandapaw uninstall| Команда | Використання |
|---|---|
pandapaw login |
Авторизувати встановлену машину, яка ще не підключена до облікового запису |
pandapaw status |
Перевірити встановлені служби, підключення машини та базовий стан |
pandapaw agent status --root … |
Переглянути стан Центру агентів для одного проєкту |
pandapaw update --restart |
Перевірити, встановити та активувати найновіший випуск PandaPaw |
pandapaw uninstall |
Консервативно видалити служби та файли, керовані PandaPaw |
Перегляньте історію версій PandaPaw, коли команда або інтерфейс відрізняється від старішого скріншота чи посібника.
Межі безпеки
- Віддалений оператор може використовувати будь-які інструменти та робочий каталог, які дозволяє вибраний сеанс агента. Віддалений доступ не є автоматично лише для читання.
- Не допускайте потрапляння одноразових команд пристрою, ручних посилань для підключення, ключів постачальника та токенів облікового запису до журналів і скріншотів.
- Не відкривайте вхідні порти маршрутизатора лише для того, щоб зробити PandaPaw доступним.
- Видаляйте хости, якими ви більше не володієте, з «Підключених пристроїв».
- Переглядайте підтвердження інструментів і перевіряйте робочий каталог, перш ніж дозволяти редагування або команди оболонки.
- Під час надання спільного доступу до активного з'єднання одержувач споживає квоту рушія власника хоста та може діяти на хості. Спочатку прочитайте Спільний доступ до з'єднання.
Усунення несправностей
`pandapaw` не знайдено після встановлення
Відкрийте новий термінал, щоб він перезавантажив PATH користувача. Звичайні розташування: ~/.local/bin на macOS/Linux та %LOCALAPPDATA%\Programs\pandapaw на Windows. Переконайтеся, що файл існує, перш ніж повторно запускати інсталятор.
Встановлення успішне, але машина не з'являється
Виконайте pandapaw status. Якщо машина не має авторизації облікового запису, виконайте pandapaw login. Якщо було використано підготовлений одноразовий ключ, створіть новий ключ, а не повторюйте використану команду.
Машина з'являється, але залишається офлайн
Переконайтеся, що хост увімкнено та має доступ до інтернету. Перевірте статус PandaPaw локально. Корпоративний проксі або брандмауер повинен дозволяти вихідний шлях HTTPS/WebSocket; вхідний порт не вирішує проблему заблокованого вихідного з'єднання.
Хост онлайн, але Claude Code або Codex не відповідає
Зв'язування хоста не автентифікує кожного постачальника моделей. Відкрийте рушій локально або дотримуйтесь підказки входу, показаної у віддаленому сеансі. Також переконайтеся, що вибрана модель існує для цього облікового запису та що її ліміт використання не вичерпано.
Сеанс відкривається не в тому проєкті
Завершіть тест, виберіть потрібний абсолютний робочий каталог і попросіть агента надрукувати його перед підтвердженням інструментів. PandaPaw не вгадує, який репозиторій ви мали на увазі, і не додає пісочницю файлової системи понад власну модель дозволів рушія.
Зміни Центру агентів не з'являються
Виконайте pandapaw agent status --root /path/to/project із правильного кореня Git-репозиторію. Переконайтеся, що проєкт прив'язаний, хост увійшов у систему, а локальний файл є частиною керованої проєкції. Під час розслідування залиште останній перевірений випуск на місці, а не видаляйте керовані каталоги.
Оновлення та видалення
pandapaw update --restart завантажує поточний бінарний файл, перевіряє його контрольну суму SHA-256, замінює встановлену копію та перезапускає керовані служби, щоб версія стала активною. Існуюче зв'язування облікового запису зберігається.
pandapaw uninstall використовує маніфест встановлення, щоб видалити елементи, створені PandaPaw. Сумісні інсталяції Claude Code, Codex, PandaCode або Node, які вже існували, навмисно зберігаються. Після видалення приберіть хост із «Підключених пристроїв», якщо йому більше не слід довіряти.