Это руководство подключает один компьютер к 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 создаёт одноразовый ключ устройства и показывает точную команду для вашей операционной системы.
Скопируйте эту команду на машину, где должен запускаться агент для программирования. Относитесь к ней как к паролю, пока она не была использована: одноразовый ключ привязывает одну машину, и его не следует публиковать в чате, скриншотах, issue или экспортах истории оболочки.
Если вы предпочитаете авторизацию через браузер вместо готового ключа, используйте обычный установщик на следующем шаге. Он запускает pandapaw login и открывает для вас страницу авторизации.
2. Установите PandaPaw на хост
macOS или Linux
Выполните подготовленную команду из Подключённых устройств или используйте обычный установщик:
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | shWindows PowerShell
Выполните подготовленную команду из Подключённых устройств или используйте:
iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iexУстановщик добавляет PandaPaw и его фоновые службы, при возможности устанавливает отсутствующие поддерживаемые движки для программирования и предоставляет приватную среду выполнения Node.js, если на хосте нет подходящей. При использовании подготовленного ключа устройства привязка аккаунта происходит во время установки. При использовании обычной команды подтвердите запрос авторизации в браузере, когда появится приглашение.
Установщик может завершиться, даже если авторизация аккаунта отложена. Если он сообщает, что установка успешна, но подключение аккаунта не завершено, выполните:
pandapaw login3. Проверьте службы хоста
На хосте выполните:
pandapaw statusКоманда должна распознать установленные службы и показать машину, подключённую к аккаунту. Если оболочка не находит pandapaw, сначала откройте новый терминал, чтобы он перезагрузил обновлённый пользовательский PATH.
Для проекта Git вы также можете проверить, распознаёт ли Agent Center корень проекта:
pandapaw agent status --root /path/to/your/projectИспользуйте реальный абсолютный путь к проекту. Привязка проекта в Agent Center работает лучше всего, когда у каталога есть стабильный Git remote.origin.url.
4. Запустите первую удалённую сессию
- Откройте PandaNpc Agent на телефоне, в браузере или на другом десктопе.
- Найдите недавно подключённую машину. Зелёный индикатор статуса означает, что хост сейчас доступен.
- Выберите Claude Code, Codex или PandaCode и укажите рабочий каталог проекта.
- Запустите сессию. Если движок попросит войти, завершите авторизацию у этого поставщика на хосте или через отображаемый процесс входа.
- Отправьте неразрушающий тестовый запрос, например:
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. Завершите обычный вход движка, затем повторите попытку сессии.
Агент открывается не в той папке
Завершите эту тестовую сессию и создайте новую с нужным рабочим каталогом. Прежде чем одобрять использование инструментов, попросите агента вывести текущий каталог. Удалённое подключение само по себе не добавляет песочницу файловой системы; разрешения инструментов движка и выбранный рабочий каталог остаются важными.
Следующие шаги
- Прочитайте полное руководство по хосту PandaPaw, чтобы узнать об обновлениях, проверках служб и архитектуре подключения.
- Ознакомьтесь с разделом Аккаунт и оплата, чтобы понять, какая подписка или поставщик оплачивает каждую сессию.
- Добавьте пользовательских поставщиков ИИ, если вам нужна конечная точка, совместимая с OpenAI, самостоятельно размещённая модель или отдельный API Key.