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-затримкою (1s→2s→5s…, щоб не атакувати сервер одразу після обриву). Голий SSH такої можливості не має: обірвалося — значить обірвалося, треба підключатися вручну. Під час вибору рішення це жорсткий критерій.

3. Схема з трансляцією: локальна машина має бути відкрита на передньому плані

Симптоми: щойно закриваєте локальний термінал або локальна машина засинає, на телефоні з'єднання обривається миттєво. Це не повільний таймаут, а втрата синхронізації.

Чому: офіційний Remote Control від 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) і далі працює за підписковою квотою. Змінюючи рішення для діагностики обривів, слідкуйте, щоб ви ненароком не змінили й модель оплати.