Быстрый старт: удаленный запуск Claude Code или Codex

Обновлено

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

Большинству пользователей подойдет сценарий «Добавить устройство», поскольку он создает одноразовую команду установки, уже привязанную к их аккаунту. Заложите около пяти минут, плюс время на вход у поставщика моделей, если ваш инструмент написания кода требует авторизации.

Перед началом работы

Вам понадобятся:

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

Если вам нужен только встроенный чат PandaNpc и вы не хотите управлять агентом на другой машине, PandaPaw не требуется. См. раздел Установка для вариантов только с клиентом.

1. Создайте команду установки на хосте

Войдите в систему, откройте Подключенные устройства и выберите «Добавить устройство». PandaNpc создаст одноразовый ключ устройства и покажет точную команду для вашей операционной системы.

Скопируйте эту команду на машину, где должен запускаться агент кода. Относитесь к ней как к паролю, пока она не использована: одноразовый ключ привязывает одну машину, и его не следует публиковать в чатах, скриншотах, issue или экспортах истории командной оболочки.

Если вы предпочитаете авторизацию через браузер вместо готового ключа, воспользуйтесь обычным установщиком из следующего шага. Он запустит 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. Выполните обычный вход в инструменте и повторите сессию.

Агент открывается не в той папке

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

Дальнейшие шаги