Швидкий старт: запуск Claude Code або Codex віддалено

Оновлено

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

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

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

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

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

Якщо вам потрібен лише вбудований чат PandaNpc і ви не хочете керувати агентом на іншій машині, 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. Завершіть звичайний вхід у рушій, а потім повторіть сеанс.

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

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

Подальші кроки