Paseo позволяет запускать ИИ-агентов на вашем компьютере и управлять ими с телефона, из браузера или настольного приложения. Это руководство поможет подключить телефон, отправить первую задачу и проверить, что вы продолжаете работу в той же сессии.
Что вы найдёте в руководстве
- Как устроен Paseo и кому пригодится.
- Что подготовить и как подключить телефон.
- Как проверить первую задачу.
- Полезные сценарии с примерами запросов.
- Ограничения доступа и типичные ошибки.
- Официальные ссылки и следующий шаг.
Как устроен Paseo
На рабочем компьютере запускается фоновая служба Paseo. Она управляет установленными агентами, а приложение на телефоне показывает их работу и передаёт ваши сообщения. Сам агент выполняет задачу на компьютере, где находятся файлы. Устройство Paseo.
Фоновая служба, или daemon, — программа, которая работает без постоянно открытого окна. Компьютер с этой службой в интерфейсе Paseo называется host. Дальше будем называть его рабочим компьютером.
Paseo поддерживает Claude Code, Codex, OpenCode и Pi; другие агенты доступны через каталог совместимых провайдеров. Для первого подключения достаточно одного уже настроенного агента. Поддерживаемые провайдеры.
| Возможность | Что это даёт | Когда пригодится |
| Доступ с разных устройств | Можно продолжить управление задачей с телефона | Нужно отойти от рабочего стола |
| Несколько сессий в рабочей области | Исполнитель и проверяющий видят файлы одной задачи | Хотите перепроверить готовую правку |
| Отдельные рабочие копии Git | У каждой независимой правки своя папка и ветка | Делаете две задачи одновременно |
| Голосовой ввод | Можно надиктовать поручение | Длинный запрос неудобно набирать на телефоне |
Рабочая область (workspace) объединяет папку задачи и её сессии. В режиме Local используется существующая папка. Режим Worktree создаёт или открывает отдельную рабочую копию Git. Несколько сессий внутри одной области могут обращаться к одним файлам: отдельная вкладка сама по себе их не изолирует. Рабочие области.
Paseo подходит, если вы уже пользуетесь агентом и хотите управлять им с разных устройств. Для обычных вопросов без доступа к проекту привычного чата может быть достаточно. Сам Paseo бесплатный и с открытым кодом; доступ к моделям обеспечивается вашими учётными записями и оплачивается по условиям выбранных провайдеров. Сайт и FAQ.
Подготовка и подключение телефона
Понадобятся компьютер с файлами проекта, установленный и авторизованный агент, приложение Paseo на компьютере и телефоне. Компьютер должен оставаться включённым и доступным по сети. Для проверки возьмите учебную папку с README или небольшой проект без секретных данных.
- Сначала убедитесь, что выбранный агент работает самостоятельно на этом компьютере. Если его ещё нет, начните со ссылки на установку в каталоге провайдеров.
- Скачайте настольный Paseo с официальной страницы и откройте его. Фоновая служба входит в приложение и запускается автоматически.
- Установите мобильное приложение по ссылке App Store или Google Play с той же страницы.
- На компьютере откройте Settings → ваш host → Pair a device, затем выберите Enable relay.
- В Paseo на телефоне отсканируйте QR-код или вставьте ссылку подключения. Это штатный способ связать устройства через relay, сервер-посредник. Проброс портов для этого варианта не требуется. Инструкция подключения.
QR-код и ссылку сопряжения храните как пароль: они дают возможность подключиться к вашей службе Paseo. Не публикуйте их и не включайте в скриншоты для общего доступа. Модель безопасности.
Для компьютера без графического интерфейса предусмотрен отдельный путь. Если Node.js и npm уже установлены, официальная инструкция предлагает:
npm install -g @getpaseo/cli
paseoПри запуске Paseo предложит включить relay и вывести QR-код. При отказе потребуется настроенное прямое соединение, например через VPN. Этот вариант заменяет установку настольного приложения; для первого знакомства достаточно основного пути выше. Установка службы.
Проверка: одна задача на двух устройствах
Добавьте учебную папку как проект, создайте рабочую область Local и запустите сессию выбранного агента. В этой папке должен быть README с описанием проекта. Отправьте на компьютере:
Прочитай README в текущей папке. Ничего не меняй и не запускай команды проекта. Объясни назначение проекта в пяти предложениях. Если README нет, сообщи об этом.Откройте на телефоне тот же рабочий компьютер, рабочую область и сессию. Дождитесь ответа, затем отправьте с телефона:
По прочитанному README назови один вопрос, который нужно уточнить перед изменениями. Файлы не меняй.Проверка пройдена, если на обоих устройствах видна одна переписка, ответ относится к вашему README, а новое сообщение с телефона появляется и на компьютере. Проверьте учебную папку: исходный README не изменён и новые файлы не появились.
Это предложенный проверочный сценарий для модели рабочих областей Paseo. Он проверяет связь и доступ к выбранной папке; качество будущих программных изменений нужно проверять отдельно. Сессии и рабочие области.
Полезные сценарии
Продолжить задачу, когда отошли от компьютера
Условие: агент уже разбирает небольшую ошибку, а вам нужно уйти от стола. Откройте ту же сессию на телефоне и запросите состояние:
Кратко сообщи, что удалось выяснить, какие файлы затронуты и нужна ли моя помощь. Если упёрся в неизвестное, сформулируй один конкретный вопрос. Не публикуй изменения.Результат: вы видите текущее состояние и можете ответить на уточнение в той же задаче. Подключение с телефона не переносит выполнение на телефон: при выключении рабочего компьютера этот способ продолжения недоступен. Мобильный доступ к тем же рабочим областям описан на сайте Paseo.
Поручить проверку второму агенту
Условие: первый агент закончил правку в отдельной рабочей области. Откройте в ней вторую сессию, при желании с другим настроенным провайдером, и дайте поручение:
Проверь текущие изменения. Не редактируй файлы. Найди ошибки поведения, пропущенные проверки и лишние изменения. Для каждого замечания укажи файл, условие возникновения и последствия. Если для вывода нужны дополнительные данные, перечисли их.Результат: отдельный разбор конкретной правки, который можно сопоставить с исходной задачей и тестами. Сначала дождитесь окончания редактирования: проверять меняющиеся файлы неудобно. Второй агент тоже может ошибаться; его согласие не заменяет проверку результата. Это применение описанного разработчиками сценария «реализация, затем ревью».
Разделить две независимые правки
Условие: нужно исправить текст подсказки и отдельно добавить проверку входных данных. В Git-проекте создайте две рабочие области с изоляцией Worktree, каждой назначьте свою задачу. Укажите актуальную исходную ветку; документация рекомендует явно выбирать удалённую ссылку, например origin/main, если именно она является базой проекта.
Результат: две отдельные ветки с изменениями, которые можно проверять по очереди. Перед объединением просмотрите различия и выполните проверки проекта. Не поручайте параллельно тесно связанные изменения одного модуля: отдельные папки не устраняют логические конфликты. Учтите, что свежей рабочей копии могут понадобиться зависимости и локальная конфигурация. Работа с Git worktrees.
Git worktree — отдельная папка того же репозитория со своей веткой. Это способ разделить изменения в файлах; права агента на компьютер и внешние системы нужно ограничивать отдельно.
Надиктовать задачу по-русски
Условие: вы подключились с телефона и хотите описать задачу голосом. Начните с диктовки и проверьте, верно ли распознаны имена файлов и названия функций.
По документации локальная модель распознавания по умолчанию, parakeet-tdt-0.6b-v2-int8, понимает английский. Для русского в локальной диктовке используйте parakeet-tdt-0.6b-v3-int8. Она определяет язык автоматически. Голосовые функции.
В файле ~/.paseo/config.json добавьте или обновите только соответствующие поля, сохранив остальные настройки. Ниже фрагмент конфигурации: provider выбирает локальную обработку речи, model — многоязычную модель.
{
"version": 1,
"features": {
"dictation": {
"stt": {
"provider": "local",
"model": "parakeet-tdt-0.6b-v3-int8"
}
}
}
}Для применения изменений выполните:
paseo reloadЕсли команда сообщит, что необходим перезапуск, выполните его через Settings → ваш host → Overview → Restart daemon. Применение конфигурации.
Результат: короткая русская фраза корректно появляется в поле ввода. Начните с «Прочитай README и кратко объясни назначение проекта». Этот фрагмент настраивает диктовку; разговорный голосовой режим и озвучивание ответов имеют отдельные параметры. Локальная обработка речи также не означает, что последующий запрос к агенту выполняется без облачной модели.
Доступ к данным и ограничения
По документации Paseo, соединение через relay защищено сквозным шифрованием. При этом агент обращается к API своего провайдера обычным способом. Поэтому утверждение «все данные остаются на компьютере» было бы неверным для агента, который отправляет контекст облачной модели. Как работает Paseo.
Для первого подключения используйте штатный relay. Если выбираете прямой доступ через локальную сеть или VPN, настройте пароль и защищённый транспорт по инструкции безопасности. Пароль сам по себе не шифрует соединение. Не открывайте порт службы в интернет ради ускорения настройки.
Для рабочих проектов заранее определите папки и доступные агенту инструменты. Текст «не публикуй» в запросе полезен как инструкция, но техническую границу задают реальные разрешения и доступы. Проверку большой правки удобнее завершить на большом экране, где можно внимательно просмотреть файлы и результат тестов.
Что делать, если не работает
| Симптом | Что проверить | Следующее действие |
| Агент отмечен как Not installed | Settings → ваш host → Providers → провайдер → Diagnostic | Посмотрите Resolved path и Version; убедитесь, что команда агента доступна в новом терминале |
| Телефон не подключается | Работает ли компьютер и включён ли relay | Повторно откройте Pair a device и проверьте выбранный способ подключения |
| Папка открылась, но агент не отвечает | Работает ли сам агент с его авторизацией | Исправьте вход или доступ к провайдеру на рабочем компьютере |
| Изменение config.json не подействовало | Ответ команды paseo reload | Исправьте ошибку конфигурации; перезапускайте службу, когда это требуется |
Диагностика провайдеров и загрузки настроек описана в разделе Troubleshooting, сетевые ошибки — в разделе Connectivity. Не начинайте с переустановки: сначала определите, на каком шаге пропал доступ.
Официальные ссылки
- Сайт Paseo и загрузки.
- Документация и изменения версий.
- Исходный код, сообщения об ошибках и обсуждения сообщества.
Начните с учебной папки и проверки одной сессии на двух устройствах. Когда этот путь работает, выберите один полезный сценарий и заранее определите, какой результат будете проверять.
Следующий шаг
Перед работой с реальным проектом задайте агенту правила и способ передачи контекста: AGENTS.md / SESSION_NOTES — проектная память для coding-агентов.
Связанные материалы
- Статья: Как я собрал личную Codex-станцию: новый MacBook, Mac mini и два iPhone
- Блог: Cursor для iOS: телефон как пульт управления агентами
- База знаний: Claude Code — кодинг-агент от Anthropic
Если вы хотите управлять агентами с нескольких устройств, полезно заранее определить доступ к проектам и порядок проверки изменений.
Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov