Диагностика удалённых обрывов Claude Code: симптомы, критерии и решения для шести типов обрывов

При удалённой работе с Claude Code самое неприятное — не невозможность подключиться, а подключение, которое обрывается, причём каждый раз по разной причине.

Слово «обрыв» на самом деле охватывает шесть совершенно разных неисправностей. У каждой свои симптомы и свои способы устранения, никак не связанные между собой — если принять разрыв длинного соединения из-за смены сети за сон машины, отключение спящего режима не поможет; если принять полумёртвое соединение за плохую сеть и ждать, оно не восстановится само даже к утру.

В этой статье мы идём от того, что вы реально видите, к причине: для каждого типа обрыва приведены симптомы, способ подтверждения диагноза и соответствующее решение. Тем, кто хочет сразу перейти к делу, — к чек-листу в последнем разделе.

Здесь рассматривается только диагностика обрывов. О том, как настроить удалённый доступ, см. «Удалённый доступ к Claude Code: управляйте сеансами где угодно, даже с выключенным компьютером»; об использовании с телефона см. «Claude Code на телефоне: просмотр сеансов и одобрение инструментов на iOS».

Сначала сверьте симптомы: какой из типов у вас

Удалённое соединение состоит из двух звеньев: машина разработчика, на которой работает Claude Code ←→ ваше устройство просмотра. Проблема в любом звене проявляется как «обрыв», но симптомы различаются:

Что вы видите	Вероятная причина	Перейти
Сеанс внезапно замер; после переподключения прогресс стоит на том же месте	Сон / блокировка экрана машины разработчика	§1
Обрыв в момент входа в лифт, переключения на 4G, смены WiFi	Длинное соединение разорвано	§2
При закрытии локального терминала или переходе в сон локальной машины удалённое соединение обрывается немедленно	Жёсткое ограничение схемы «трансляции экрана»	§3
Отображается «в сети», но сообщения уходят без ответа и без ошибок	Полумёртвое соединение	§4
Переподключение возможно, но возвращается пустой сеанс / сообщения за время обрыва пропали	Переподключение не вернуло исходный сеанс	§5
Через несколько часов сеанс исчезает	Процесс переработан, холодного восстановления нет	§6

Легче всего ошибиться с четвёртым типом: он не выдаёт ошибок. Статус соединения зелёный, сообщения уходят, но ответа нет никогда — это труднее диагностировать, чем прямое отключение, потому что все индикаторы говорят вам «всё в порядке».

1. Сон / блокировка экрана / закрытие крышки машины разработчика

Симптомы: сеанс в какой-то момент полностью замирает. После переподключения прогресс остаётся на моменте обрыва, ни шагу дальше.

Почему: многие думают: «моя машина разработчика всегда включена», но спящий режим системы, сон при закрытии крышки, автоматическая блокировка — всё это приостанавливает или убивает процесс Claude Code. На стороне просмотра это выглядит как «внезапно замерло».

Как подтвердить: вернитесь к машине разработчика и проверьте, существует ли процесс, есть ли в системном журнале записи о сне. Если процесс на месте, но временная метка остановилась в момент обрыва, почти наверняка это оно.

Решение: настройте схему электропитания машины разработчика на «без сна / без сна при закрытой крышке». Это единственный способ устранить причину — никакая удалённая схема не спасёт машину, которая уже уснула.

2. Разрыв длинного соединения при смене сети

Симптомы: обрыв происходит в чётко определённый момент — вход в лифт, переключение WiFi на 4G, ночной перезапуск домашнего широкополосного подключения.

Почему: удалённая синхронизация в реальном времени держится на длинном соединении (WebSocket / SSH). Как только IP меняется, соединение немедленно умирает, без всяких исключений.

Как подтвердить: если момент обрыва совпадает с моментом смены сети — это оно.

Решение: этот тип невозможно предотвратить, остаётся только автоматическое переподключение + backoff (1с → 2с → 5с…, чтобы не долбить сразу после обрыва). Голый SSH таким не обладает: оборвалось — значит оборвалось, придётся подключаться вручную. При выборе решения это жёсткий критерий.

3. Схема «трансляции экрана»: локальная машина должна работать в активном окне

Симптомы: как только локальный терминал закрыт или локальная машина уснула, телефонная сторона немедленно обрывается. Это не медленный тайм-аут, а мгновенная потеря синхронизации.

Почему: официальное удалённое управление от Anthropic проецирует сеанс, работающий на вашей локальной машине, на телефон/в браузер. Его предпосылка — локальный Claude Code всегда активен и локальная машина всегда в сети. Как только локальная машина падает, удалённой стороне не на что опереться: у неё нет собственного жизненного цикла.

Как подтвердить: закройте окно локального терминала и посмотрите, обрывается ли удалённое соединение в ту же секунду. Если да — вы используете схему «трансляции экрана».

Решение: перейдите на архитектуру с постоянно работающим фоновым сервисом на стороне машины разработчика — сторона, на которой выполняется сеанс, оформляется как фоновый сервис с автозапуском, живущий независимо от вашего устройства просмотра. Закрыли, сменили или потеряли устройство просмотра — он продолжает работать на машине разработчика. Это принципиальное различие между «трансляцией» и «постоянным сервисом», его нельзя выставить параметрами.

4. Полумёртвое соединение (half-open): самый труднообнаруживаемый тип

Симптомы: отображается «в сети», сообщения не получают ответа и ошибок тоже нет. Может висеть несколько минут, а может висеть, пока вы вручную не переподключитесь.

Почему: при молчаливом разрыве сети (истечение записей NAT, потеря состояния промежуточными устройствами, сигнал настолько слабый, что пакеты теряются, но соединение не рвётся) обе стороны TCP могут считать, что всё ещё соединены, хотя данные больше не проходят. Без heartbeat обе стороны сохраняют эту иллюзию.

Как подтвердить: статус соединения нормальный, но отправленные сообщения не получают ни подтверждения доставки, ни ошибки; после ручного отключения и переподключения всё мгновенно восстанавливается — это оно.

Решение: на соединении должен работать heartbeat (keepalive ping): если за оговорённое время не получено ни одного ответа от другой стороны, соединение признаётся полумёртвым, и нужно активно разорвать его и переподключиться, а не ждать впустую. Критерием должно быть «нет ответа», а не «нет ошибок» — полумёртвое соединение никогда не выдаёт ошибок.

5. Переподключение не возвращает исходный сеанс / потеря сообщений

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

Почему: переподключение лишь создаёт новое соединение, но не подписывает его обратно на исходный сеанс; сообщения за время обрыва для вас не кэшируются.

Как подтвердить: после переподключения ID сеанса изменился, или история начинается только с момента переподключения.

Решение: выбирайте решение, которое умеет автоматически подписываться обратно на исходный сеанс после переподключения и воспроизводить историю за время обрыва. Уметь только переподключаться, но не возвращаться к сеансу — значит подключаться впустую.

6. Процесс сеанса переработан, холодного восстановления нет

Симптомы: короткие обрывы и переподключения проходят нормально, но через несколько часов сеанс исчезает.

Почему: процесс долго простаивающего сеанса может быть переработан; сам демон тоже мог перезапуститься (обновление, подъём после сбоя). Состояние сеанса в памяти исчезает вместе с этим.

Как подтвердить: воспроизводится только при долгом обрыве, при коротком не воспроизводится.

Решение: нужна возможность холодного восстановления — состояние сеанса сохраняется на диск, и даже при исчезновении процесса контекст можно восстановить с диска. В идеале вы отправляете одно сообщение, и он автоматически восстанавливается и продолжает работу — для вас это незаметно.

Чек-лист диагностики (работает с любым решением)

Проходите по порядку, каждый шаг можно проверить независимо:

1. Машина, на которой работает сеанс, уснула / экран заблокирован? → Отключите автоматический сон, режим без сна при закрытой крышке. (§1)
2. Момент обрыва совпадает с моментом смены сети? → Нужно решение с автоматическим переподключением + backoff, не полагайтесь на голый SSH. (§2)
3. Закрытие локального терминала немедленно обрывает удалённое соединение? → Жёсткое ограничение схемы «трансляции экрана»; нужна архитектура с постоянным демоном. (§3)
4. Застряли на «отображается в сети, но сообщения без ответа»? → Полумёртвое соединение; автоматически спасти может только heartbeat-детекция. (§4)
5. После переподключения сеанс пуст / сообщений меньше? → Нужно «возвращение к исходному сеансу + воспроизведение истории». (§5)
6. Сеанс теряется только при долгом обрыве? → Нужны сохранение на диск + холодное восстановление. (§6)

Применительно к конкретным решениям

Из шести пунктов выше только первый — вопрос настроек вашей собственной машины; остальные пять полностью определяются архитектурой — они зафиксированы при выборе решения, и после возникновения проблемы настройкой параметров их не спасти.

Устойчивое к обрывам удалённое решение должно одновременно обладать: постоянно работающим демоном на стороне машины разработчика (соответствует остаточному риску из §1 и §3), автоматическим переподключением + backoff (§2), heartbeat-детекцией (§4), возвращением к исходному сеансу при переподключении + воспроизведением истории (§5), сохранением на диск с холодным восстановлением (§6).

Стек PandaNpc + pandapaw сделан по этим шести пунктам один в один: pandapaw регистрируется на машине разработчика как постоянно работающий демон с автозапуском (это не окно терминала, которое вы должны держать открытым вручную; при сбое он автоматически поднимается заново); на стороне просмотра автоматическое переподключение с backoff; на соединении работает heartbeat — нет ответа, значит, полумёртвое, активное переподключение; после переподключения автоматически возвращается подписка на исходный сеанс и воспроизводится история за время обрыва; даже если процесс сеанса переработан, одно сообщение восстанавливает его с диска холодным способом.

Как именно установить и подключить, см. «Удалённый доступ к Claude Code»; просмотр сеансов и одобрение инструментов на телефоне — в «Claude Code на телефоне».

Попутная ловушка: при удалённой работе не нарвитесь на тарификацию

Диагностируя обрывы, легко машинально переключиться на claude -p (headless-режим), но с 15 июня 2026 года Anthropic изменила тарификацию — headless больше не расходует подписку, а тратит небольшой ежемесячный кредит SDK, после исчерпания которого тарифицируется по API, так что при активном использовании легко выйти за бюджет. Интерактивный режим (claude REPL) по-прежнему расходует подписку. Меняя решение для диагностики обрывов, следите, чтобы случайно не сменить и тарифную модель.