Швидкий старт із PandaNpc Work: підключіть першого агента

Почніть користуватися PandaNpc Work — мультидвижковим ШІ-робочим простором. Підключіть комп’ютер із PandaPaw, виберіть рушій агента та перевірте віддалену сесію.

Оновлено

Цей посібник підключає один комп’ютер до PandaNpc Work і перевіряє, що ви можете запускати Claude Code, Codex або PandaCode з іншого пристрою. PandaNpc Work — це багатодвижковий робочий простір ШІ, де ви делегуєте роботу й відстежуєте її на різних пристроях. Агент усе ще виконується на підключеному комп’ютері; PandaPaw забезпечує міст і локальне середовище виконання, а PandaNpc Work дає вам синхронізований інтерфейс для повідомлень, схвалень, запитань і історії сеансів.

Цей шлях найкращий для людей, які вже впевнено працюють із Claude Code, Codex або подібним агентом для програмування. Більшості варто скористатися сценарієм Додати пристрій, оскільки він генерує одноразову команду встановлення, уже прив’язану до їхнього облікового запису. Закладіть близько п’яти хвилин, а також час на вхід до постачальника моделей, який потребує ваш рушій для програмування. Щоб оглянути інтерфейс Agent перед підключенням комп’ютера, відкрийте PandaNpc Agent у браузері.

Перед початком

Вам потрібно:

  • Обліковий запис PandaNpc, відкритий у вебзастосунку, десктопному застосунку або застосунку для iOS.
  • Підключений комп’ютер під керуванням Windows x64, macOS або Linux x86_64.
  • Доступ до інтернету з хоста й дозвіл на встановлення фонової служби рівня користувача.
  • Папка проєкту, яку вам дозволено змінювати.
  • Обліковий запис Claude, ChatGPT/Codex або для користувацької моделі, якщо ваш вибраний рушій ще не пройшов автентифікацію.

Якщо ви лише хочете переглядати вже підключений хост, установіть або відкрийте клієнт на пристрої, з якого переглядатимете. PandaPaw має бути на комп’ютері, де запущено агента. Див. Встановлення щодо ролей клієнта й хоста.

1. Згенеруйте команду встановлення для хоста

Увійшовши, відкрийте Підключені пристрої і виберіть Додати пристрій. PandaNpc створює одноразовий ключ пристрою й показує точну команду для вашої операційної системи.

Скопіюйте цю команду на машину, де має запускатися агент для програмування. Поводьтеся з нею як із паролем, доки її не використано: одноразовий ключ прив’язує одну машину й не повинен публікуватися в чаті, знімках екрана, зверненнях чи експортах історії оболонки.

Якщо ви віддаєте перевагу авторизації через браузер замість підготовленого ключа, скористайтеся звичайним інсталятором на наступному кроці. Він запускає pandapaw login і відкриває сторінку авторизації для вас.

2. Установіть PandaPaw на хості

macOS або Linux

Виконайте підготовлену команду з Підключених пристроїв або скористайтеся звичайним інсталятором:

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

Windows PowerShell

Виконайте підготовлену команду з Підключених пристроїв або використайте:

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

Інсталятор додає PandaPaw та його фонові служби, установлює відсутні підтримувані рушії для програмування, коли це можливо, і надає приватне середовище виконання Node.js, якщо на хості немає відповідного. Із підготовленим ключем пристрою прив’язування облікового запису відбувається під час встановлення. Зі звичайною командою схваліть запит на авторизацію в браузері, коли з’явиться відповідне запрошення.

Інсталятор може завершитися, навіть якщо авторизацію облікового запису відкладено. Якщо він повідомляє, що встановлення успішне, але з’єднання з обліковим записом неповне, виконайте:

bash
pandapaw login

3. Перевірте служби хоста

На хості виконайте:

bash
pandapaw status

Команда має розпізнати встановлені служби й показати машину, підключену до облікового запису. Якщо оболонка не може знайти pandapaw, спершу відкрийте новий термінал, щоб вона перезавантажила оновлений PATH користувача.

Для проєкту Git ви також можете перевірити, чи Agent Center розпізнає корінь проєкту:

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

Використовуйте реальний абсолютний шлях до проєкту. Прив’язування проєкту в Agent Center працює найкраще, коли каталог має стабільний Git remote.origin.url.

4. Запустіть перший віддалений сеанс

  1. Відкрийте PandaNpc Agent на телефоні, у браузері або на іншому десктопі.
  2. Знайдіть щойно підключену машину. Зелений індикатор стану означає, що хост зараз доступний.
  3. Виберіть Claude Code, Codex або PandaCode і вкажіть робочий каталог проєкту.
  4. Запустіть сеанс. Якщо рушій просить увійти, завершіть авторизацію цього постачальника на хості або через показаний потік входу.
  5. Надішліть недеструктивний тестовий запит, наприклад: Show the current working directory and list the top-level files. Do not edit anything.

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

5. Перевірте поведінку повторного підключення

Закрийте клієнт перегляду, зачекайте кілька секунд і знову відкрийте той самий сеанс. Наявна історія має повернутися, а хост має залишатися онлайн. Це перевіряє фактичний віддалений шлях, а не лише підтверджує, що інсталятор успішно завантажився.

Не переводьте хост у режим сну під час цієї перевірки. Хост у режимі сну або вимкнений не може запускати агента, навіть якщо збережене підключення все ще відображається у вашому обліковому записі.

Усунення несправностей

Машина не з’являється в Agent

Виконайте pandapaw status на хості. Якщо встановлення успішне, але обліковий запис не приєднано, виконайте pandapaw login. Якщо ви використали підготовлений ключ, а його вже активовано або термін дії минув, згенеруйте новий у Підключених пристроях і повторно виконайте показану команду.

`pandapaw` не розпізнається

Відкрийте новий термінал. У macOS/Linux переконайтеся, що ~/.local/bin є в PATH. У Windows інсталятор додає %LOCALAPPDATA%\Programs\pandapaw до PATH користувача; термінал, відкритий до встановлення, не побачить нового значення.

Машина є в списку, але вона офлайн

Переконайтеся, що хост увімкнено, він не спить і може підключитися до інтернету. Потім перевірте pandapaw status. Корпоративні брандмауери мають дозволяти вихідний трафік HTTPS/WebSocket; вам не слід створювати правило вхідного переспрямування портів.

Підключення працює, але рушій вимагає автентифікації

Прив’язування PandaPaw і вхід до постачальника моделей є окремими. Прив’язування підтверджує, що хост належить вашому обліковому запису PandaNpc; Claude Code або Codex усе ще можуть вимагати власного входу за підпискою або налаштування API. Завершіть звичайний вхід у рушій, потім повторіть спробу сеансу.

Агент відкривається не в тій папці

Заверште той тестовий сеанс і створіть новий із потрібним робочим каталогом. Перш ніж схвалювати використання інструментів, попросіть агента вивести поточний каталог. Віддалене підключення саме по собі не додає пісочницю файлової системи; дозволи інструментів рушія й вибраний робочий каталог залишаються важливими.

Наступні кроки