Як користуватися Claude Code із телефона через VPS
Claude Code працює в tmux на VPS, а телефон лише підключається через SSH. Налаштуйте ключі SSH, mosh для нестабільної мережі, tmux attach і клавіатуру.
Claude Code із телефона: як це працює насправді
У цьому посібнику використовується термінальний застосунок на телефоні. Claude Code працює на VPS (віртуальному приватному сервері) всередині сеансу tmux, який залишається відкритим. Телефон встановлює SSH-з’єднання (захищене з’єднання оболонки) із цим сеансом на весь час, поки ви переглядаєте його. Якщо закрити застосунок, агент продовжить роботу, оскільки процес ніколи не запускався на телефоні.
Claude Code також підтримує Remote Control: виконайте /remote-control у сеансі, щоб використовувати його через мобільний застосунок Claude або браузер, поки процес залишається на сервері. Для цього потрібна підписка Claude. API key не підтримується.
У цьому полягає вся схема. Операційна система телефона призупиняє застосунок через кілька секунд після перемикання на інший застосунок, тому будь-яке тривале завдання, запущене на телефоні, зупиняється. Крім того, телефон отримує нову мережеву адресу щоразу, коли ви переходите з Wi-Fi на мобільні дані. Обидві проблеми зникають, коли процес працює на сервері, а телефон лише відображає екран.
На сервері потрібні чотири компоненти: tmux для збереження сеансу, SSH keys для підключення, mosh для роботи зі змінами мережі та сам Claude Code. На телефоні потрібен лише один термінальний застосунок із доступним рядом клавіш.
Що потрібно на VPS
Для частин про SSH і tmux достатньо невеликого сервера з Ubuntu 24.04. Claude Code потребує потужнішої конфігурації. Станом на November 2026 офіційні вимоги передбачають Ubuntu 20.04 або новішу версію на процесорі x64 або ARM64 і щонайменше 4 GB RAM. Claude Code також потребує платного облікового запису Claude (Pro, Max, Ultra, Team або Enterprise), облікового запису Console з доступом до API або доступу через підтримуваного cloud provider, наприклад Amazon Bedrock, оскільки безкоштовний план Claude.ai не включає цей продукт.
Налаштуйте сервер для звичайного користувача з sudo, а не для root. Якщо сервер новий, спочатку виконайте перші десять хвилин на новому VPS, оскільки зміни SSH далі в цьому посібнику простіше виконати після створення користувача та налаштування firewall.
sudo apt update && sudo apt install -y tmux mosh
curl -fsSL https://claude.ai/install.sh | bash
claude --versionInstaller встановлює binary у ~/.local/bin/claude, а claude --version виводить рядок на зразок 2.1.211 (Claude Code). Якщо виведено command not found, цей каталог ще не входить до вашого PATH: вийдіть із системи, увійдіть знову, а потім перевірте за допомогою command -v claude. claude doctor виводить діагностичні дані щодо встановлення та налаштувань, не запускаючи сесію.
Увійдіть на сервер один раз зараз із ноутбука, перш ніж покладатися на телефон. Виконайте claude у каталозі проєкту та дотримуйтеся підказок для входу. Процес попросить відкрити URL у браузері та ввести код назад у термінал. Виконувати це на екрані телефона, перемикаючись між двома застосунками, повільно. Зробіть це один раз на звичайній клавіатурі, і облікові дані залишаться на сервері.
Запускайте Claude Code у tmux, щоб розрив з’єднання не зупинив процес
tmux new -s claude
cd ~/projects/api
claudeВід’єднайтеся за допомогою Ctrl-b, а потім d. tmux виведе [detached (from session claude)] і поверне вас до оболонки. Тепер можна закрити застосунок, втратити сигнал або покласти телефон у кишеню. Панель продовжить працювати.
tmux ls
tmux attach -t claudetmux ls виводить по одному рядку для кожного сеансу, наприклад claude: 1 windows (created Thu Jul 30 09:14:02 2026). tmux attach -t claude повертає вас саме туди, де ви зупинилися, зокрема до незавершеного редагування.
Це працює, тому що tmux запускає власний серверний процес, а ваша оболонка та Claude Code є дочірніми процесами цього сервера, а не sshd. Коли SSH-з’єднання завершується, ядро надсилає сигнал завершення, SIGHUP, процесам, підключеним до цього з’єднання. Сервер tmux не належить до них. Без tmux те саме блокування екрана, яке розриває з’єднання, зупиняє Claude Code посеред виклику інструмента. У матеріалі Запуск Claude Code на VPS у tmux докладніше описано структуру сеансу.
Запускайте tmux на сервері, а не на телефоні. Якщо ввести tmux у сеансі, до якого ви вже підключені, tmux виведе sessions should be nested with care, unset $TMUX to force. Примусове виконання цієї команди створить два конфліктні префіксні клавіші.
Автоматичне підключення під час кожного входу
Введення команди attach на сенсорній клавіатурі швидко набридає. Додайте це в кінець файлу ~/.profile на сервері:
if command -v tmux >/dev/null 2>&1 && [ -z "$TMUX" ] && [ -t 1 ]; then
exec tmux new-session -A -s claude
finew-session -A -s claude підключається до сесії з назвою claude, якщо вона існує, або створює її, якщо ні, тому одна команда охоплює обидва випадки. exec замінює login shell на tmux, тому вихід із tmux закриває з’єднання, а не залишає вас у звичайному командному рядку. Коли вам потрібна звичайна оболонка, пропустіть цей файл: ssh you@server -t "bash --noprofile".
Додайте це в ~/.profile, а не в ~/.bashrc. Bash також зчитує ~/.bashrc для неінтерактивних SSH-команд, але перевірка [ -t 1 ] вище запобігає запуску tmux під час передачі файлів. Команди автозапуску без перевірок, що виводять текст, порушують роботу протоколів передачі, викликаючи помилки на кшталт Received message too long. ~/.profile виконується лише для login shells, якими і є інтерактивні SSH-сесії.
~/.profile — це також місце, де Ubuntu додає ~/.local/bin до PATH. Якщо claude працює коректно відразу після входу, але оболонка всередині tmux видає command not found, причина саме в порядку виконання, тому запускайте tmux із login shell, як показано вище, а не зі скрипта, який пропускає профіль.
iOS: Termius або Blink Shell
Обидва застосунки підтримують SSH і mosh та зберігають ключі всередині застосунку. Відмінність полягає в інтерфейсі.
Blink Shell працює через команди. У його командному рядку можна ввести ssh you@server або mosh you@server — так само, як у терміналі на настільній системі. Налаштування відкриваються командою config, а в розділі Keys можна створити пару ключів.
Termius працює через форми. Спочатку заповніть запис хоста, а потім увімкніть параметр Use Mosh у налаштуваннях цього хоста. Termius містить власну реалізацію mosh і підтримує mosh 1.3.0 та новіші версії, тому на сервері все одно має бути встановлено пакет mosh.
В обох випадках створюйте ключ у самому застосунку й ніколи не копіюйте на телефон наявний приватний ключ. Застосунок покаже відкриту частину ключа. Це один рядок, який потрібно додати до ~/.ssh/authorized_keys на сервері. У матеріалі SSH-ключі для кожного пристрою та відкликання ключа описано правила іменування та процедуру відкликання. Для телефона це важливіше, ніж для ноутбука.
Увімкніть власне блокування термінального застосунку за допомогою біометрії або коду доступу. Без цього розблокований телефон залишає відкриту shell-сесію на сервері на весь час, поки екран увімкнений.
Android: Termux
pkg upgrade
pkg install openssh mosh
ssh-keygen -t ed25519 -C "pixel"
cat ~/.ssh/id_ed25519.pubTermux надає OpenSSH і mosh у власному репозиторії пакетів, тому ssh, ssh-keygen і mosh працюють так само, як на настільній системі. Додайте надрукований рядок відкритого ключа до ~/.ssh/authorized_keys на сервері, а потім підключіться за допомогою mosh you@server.
Екранна клавіатура Android не має клавіш Esc і Ctrl, а Claude Code потребує обох. Termux може додати власний рядок клавіш. Додайте один рядок у ~/.termux/termux.properties:
extra-keys = [['ESC','|','/','HOME','UP','END','PGUP'],['TAB','CTRL','ALT','LEFT','DOWN','RIGHT','PGDN']]Потім виконайте termux-reload-settings, і над клавіатурою з’явиться цей рядок. Після такого самого перезавантаження Termux також підхопить моноширинний шрифт TrueType, скопійований у ~/.termux/font.ttf.
Android може зупинити Termux, коли той працює у фоновому режимі, але в цьому випадку ви лише повторно підключитеся. Сесія та агент працюють на сервері.
Чому термінал зависає при виході з Wi-Fi і що виправляє mosh?
SSH-з’єднання — це TCP-з’єднання (transmission control protocol), яке ідентифікується за обома адресами та обома портами. Коли ви виходите за межі зони дії Wi-Fi, телефон отримує нову адресу в мобільній мережі, тому старе з’єднання перестає відповідати будь-чому на обох кінцях. Жоден механізм не повідомляє про це. Термінал просто перестає реагувати, доки TCP не припинить спроби, після чого ssh виводить client_loop: send disconnect: Broken pipe. Щоб негайно завершити завислу сесію, натисніть Enter, потім ~, потім ..
mosh (mobile shell) усуває цей режим відмови. Він використовує SSH один раз для входу та запуску процесу mosh-server, зчитує UDP-порт (user datagram protocol), обраний сервером, і закриває SSH-з’єднання. Після цього обидві сторони обмінюються UDP-датаграмами, автентифікованими спільним сесійним ключем, тому сесія ідентифікується за цим ключем, а не за вашою адресою. Нова адреса просто продовжує роботу. mosh також локально відображає введені вами символи та оновлює екран, якщо сервер надає іншу інформацію, завдяки чому він залишається придатним для використання на повільному мобільному зв’язку.
mosh використовує UDP-порти в діапазоні від 60000 до 61000, тому відкрийте цей діапазон:
sudo ufw allow 60000:61000/udp
sudo ufw statusВідкриття портів за допомогою ufw містить решту інформації про налаштування фаєрвола. Якщо ваш провайдер надає окремий мережевий фаєрвол у панелі керування, додайте цей самий діапазон і там, оскільки правило ufw не може вплинути на фільтр, що стоїть перед машиною.
Часто трапляються дві помилки mosh. Якщо вхід успішний, але потім з’єднання зависає з повідомленням Nothing received from server on UDP port 60001., це означає, що mosh-server запустився, але клієнт не може підключитися до нього через цей UDP-порт. Зазвичай це означає, що фаєрвол між телефоном і сервером блокує UDP у діапазоні mosh. Якщо з’єднання повідомляє, що mosh-server не знайдено, це означає, що пакет відсутній на сервері або його немає в PATH для входу. Встановіть його або вкажіть шлях безпосередньо за допомогою mosh --server=/usr/bin/mosh-server you@server.
Якщо локаль входу на сервері не UTF-8, mosh-server намагається використати налаштування локалі, надані клієнтом, і перевіряє знову. Він відмовляється працювати лише в тому випадку, якщо це також не забезпечує UTF-8, повідомляючи mosh-server needs a UTF-8 native locale to run.. Спочатку виправте локаль на сервері.
locale
sudo locale-gen en_US.UTF-8
sudo update-locale LANG=en_US.UTF-8Обидва кінці потребують UTF-8 локалі, а mosh-server також застосовує налаштування локалі, які надсилає клієнт. Якщо помилка залишається після виправлення на сервері, встановіть LANG у значення UTF-8 також у термінальному застосунку на телефоні, що, як зазначає FAQ самого mosh, mosh-client може знадобитися.
Є дві речі, які mosh не робить. У його README зазначено, що mosh не підтримує X forwarding або неінтерактивне використання SSH, включаючи перенаправлення портів (port forwarding), тому для попереднього перегляду вебзастосунку, який щойно запустив Claude Code, все одно потрібен звичайний ssh -L 8080:127.0.0.1:8080 you@server. Він також синхронізує лише видиму частину екрана, тому не має власної історії прокрутки. Це обмеження не є проблемою, оскільки tmux зберігає історію: Ctrl-b, потім [ вмикає режим копіювання, прокрутка здійснюється перетягуванням або клавішами зі стрілками, а q виходить із режиму.
Зробіть екран телефона зручним для роботи
Чотири рядки в ~/.tmux.conf на сервері виконують основну роботу:
set -g mouse on
set -g status-position top
set -g default-terminal "tmux-256color"
set -g history-limit 20000mouse on перетворює перетягування пальцем на прокручування, а дотик — на вибір панелі або вікна. Це усуває потребу в більшості префіксних клавіш, які незручно натискати. status-position top переносить рядок стану tmux від нижнього краю екрана, де його закривають екранна клавіатура та панель підказок. default-terminal фіксує назву термінала, яку tmux повідомляє Claude Code. Без цього рядка tmux повідомляє назву, яку вибрала його збірка. Скрипт configure для tmux 3.4 починає з screen, потім перевіряє screen-256color, tmux і tmux-256color саме в такому порядку. Якщо перевірка не проходить, попередній вибір зберігається. Тому збірка, яка не знайшла запис tmux-256color у terminfo, зрештою використовує tmux, screen-256color або звичайний screen. Через це кольори та рамки можуть відображатися гірше, ніж потрібно.
Вивчіть чотири клавіші — і решта стане зручною.
Escперериває Claude під час відповіді та зберігає вже виконану роботу. Саме цю клавішу варто тримати найближче до великого пальця.Ctrl+Cтакож перериває поточну операцію. На порожньому запрошенні перше натискання очищає введений текст, а друге завершує Claude Code. Тому це грубіший інструмент.- Подвійне натискання
Escочищає чернетку запиту, а на порожньому запрошенні натомість відкриває меню перемотування. - Для запиту в кілька рядків введіть
\, а потім натисніть Enter. Така форма працює в кожному терміналі. Shift+Enter є вбудованою функцією лише в короткому списку настільних терміналів, і мобільні клієнти до нього не входять.
Не використовуйте розділені панелі. У вертикальній орієнтації телефон має приблизно 40 стовпців завширшки, тому горизонтальний поділ (Ctrl-b %, панелі розташовані поруч) залишає по 20 стовпців на панель, і кожен diff перетворюється на суцільні перенесення рядків. Вертикальний поділ (Ctrl-b ") зберігає всю ширину, але розміщує панелі одна під одною. Через це вдвічі зменшується кількість рядків, які залишає видимими екранна клавіатура. Натомість використовуйте вікна tmux: Ctrl-b c створює нове вікно, а Ctrl-b n переходить до наступного. Якщо у другому вікні опиниться окремий сеанс Claude Code, два сеанси можуть безпосередньо передавати роботу один одному, і вам не доведеться копіювати текст між вікнами на сенсорному екрані. Поверніть телефон боком, коли потрібно нормально прочитати diff.
Обсяг тексту, який потрапляє на цей екран, варто налаштувати заздалегідь, оскільки стиль виведення змінює системний prompt перед кожною відповіддю, а лаконічніший стиль означає менше екранів тексту, які потрібно прокручувати на телефоні.
Тривалий сеанс на малому екрані здебільшого є проблемою контексту, тому перед спробою працювати цілий день у поїзді варто прочитати про керування контекстним вікном Claude Code.
Захист: лише ключі, жодних паролів
Тепер на телефоні зберігається ключ до машини, яка редагує ваш код і виконує команди. Вимкніть автентифікацію за паролем. Використання окремого файлу конфігурації (drop-in file) безпечніше, ніж пряме редагування sshd_config, оскільки sshd_config в Ubuntu містить /etc/ssh/sshd_config.d/*.conf на початку, а перше знайдене значення параметра є пріоритетним.
sudo tee /etc/ssh/sshd_config.d/00-phone.conf >/dev/null <<'EOF'
PasswordAuthentication no
KbdInteractiveAuthentication no
PubkeyAuthentication yes
PermitRootLogin no
EOF
sudo sshd -t && sudo systemctl reload sshФайли drop-in зчитуються в алфавітному порядку їхніх назв. Перевірте sudo sshd -T на наявність passwordauthentication no, kbdinteractiveauthentication no, pubkeyauthentication yes та permitrootlogin no; файл, що зчитується раніше і встановлює одне з цих значень, матиме пріоритет, тому зміни слід вносити саме в ньому.
sshd -t аналізує конфігурацію і нічого не виводить, якщо вона коректна. Якщо пропустити цей крок, одна друкарська помилка призведе до того, що sshd не зможе перезавантажитися. Тримайте поточну сесію відкритою і протестуйте підключення з другого термінала, перш ніж закривати будь-що, оскільки помилковий ключ призведе до Permission denied (publickey)., а без паролів ви не матимете резервного способу входу. У такому разі єдиним шляхом відновлення буде консоль вашого провайдера. Якщо тестове підключення не вдалося, підключіться знову за допомогою ssh -v і виправте проблему, поки перша сесія ще активна, оскільки це повідомлення про помилку охоплює п'ять різних несправностей, а детальний вивід вкаже, яка саме у вас.
Створюйте окремий ключ для кожного пристрою. Якщо ви загубите телефон, достатньо буде видалити один рядок із ~/.ssh/authorized_keys, і ваш ноутбук продовжить працювати. Спільний ключ означає необхідність заміни ключа на всіх ваших пристроях.
Якщо ви переносите SSH на інший порт в Ubuntu 24.04, врахуйте, що слухач належить ssh.socket. Генератор systemd створює цей сокет на основі рядка Port у вашій конфігурації SSH, тому вам не потрібен override для ListenStream, але перезапуск лише ssh залишить сервер на порту 22. Додайте рядок Port у файл drop-in, дозвольте новий порт у ufw, а потім виконайте sudo systemctl daemon-reload і sudo systemctl restart ssh.socket. Hardening SSH on a VPS охоплює це та інші аспекти захисту.
fail2ban for SSH додає мінімум безпеки, коли паролі вимкнені, оскільки вгадати пароль неможливо в принципі. Його перевага — чистіші журнали, що дозволяє легко помітити реальну спробу входу.
Надійніший варіант — приховати SSH від публічного інтернету. Розмістіть сервер за власним VPN WireGuard, піднімайте тунель на телефоні за потреби та налаштуйте sshd на ListenAddress лише через тунель. mosh працює через тунель, оскільки обидві сторони використовують UDP. Зауваження: тунель додає накладні витрати на пакети, тому якщо передача великих обсягів даних зависає, зменште MTU (maximum transmission unit) у конфігурації WireGuard на телефоні.
Останній момент щодо такої роботи. З телефона ви підтверджуєте запити на дозвіл, бачачи на екрані лише кілька рядків diff за раз. Це причина зберігати запобіжники, а не вимикати їх. Також перевірте, у якому режимі дозволів запускаються ваші сесії, оскільки автоматичний режим тепер є вбудованим режимом за замовчуванням для інтерактивних термінальних сесій у Claude Code v2.1.283, і він вносить зміни у файли в робочій директорії без запитів на підтвердження. Running Claude Code safely on a VPS описує обмеження користувачів і директорій, які варто встановити, перш ніж вашим основним інструментом керування стане сенсорний екран.
Коли підключення не вдається або виникають помилки
tmux attach printing no server running on /tmp/tmux-1000/default означає, що tmux не знайшов сервер на цьому сокеті. Зазвичай це свідчить про те, що сервер завершив роботу, що майже завжди означає перезавантаження машини. Перевірте це за допомогою uptime. Якщо система не перезавантажувалася, а pgrep tmux все ще показує сервер, це не означає, що файл сокета було видалено, оскільки прапорці -L та -S дозволяють серверу слухати інший сокет. Якщо ви запускали tmux з одним із них, передайте такий самий прапорець команді tmux attach. Якщо сокет було випадково видалено, pkill -USR1 tmux змушує сервер відтворити його, що, як зазначено в посібнику tmux, неможливо, якщо відсутній будь-який із батьківських каталогів. Оновлення ядра через автоматичні оновлення безпеки потребують перезавантаження для застосування змін, але unattended-upgrades виконує перезавантаження автоматично лише тоді, коли увімкнено Unattended-Upgrade::Automatic-Reboot; за замовчуванням встановлено false. Після перезавантаження системи сеанси tmux не зберігаються, тому сприймайте будь-який запуск Claude Code як процес, який можна перезапустити.
can't find session: claude — це інша ситуація. Сервер tmux працює, але вказаного імені не існує. tmux ls показує, які сеанси доступні.
Якщо після підключення ви бачите звичайний командний рядок замість Claude Code, це означає, що процес завершився, але сеанс залишився активним. Перевірте dmesg -T | tail на наявність рядка на кшталт Out of memory: Killed process 4821 (claude), що підтверджує завершення процесу через брак оперативної пам'яті (OOM kill). Перегляньте історію виводу в терміналі над командним рядком, щоб знайти інші повідомлення про завершення роботи.
Якщо вікно відновлюється з неправильним розміром, обрізане по краях або з порожнім простором навколо, це означає, що підключено два клієнти з різними розмірами екрана. За замовчуванням tmux 3.4 підлаштовує розмір вікна під клієнта з найактивнішою взаємодією (window-size latest), тому ваш ноутбук, підключений із шириною 200 стовпців, і телефон із шириною 40 по черзі змінюють розмір вікна. Відключайте інші клієнти під час підключення: tmux attach -d -t claude.
FAQ
Чи можна запускати Claude Code безпосередньо на телефоні, а не на VPS?
Термінальний CLI не підтримується на Android або iOS. Станом на November 2026 підтримуються macOS, Windows, Ubuntu 20.04 або новіші, Debian 10 або новіші та Alpine 3.19 або новіші, за наявності щонайменше 4 GB RAM. Android та iOS у цьому списку немає. Телефон також переводить застосунки в режим сну та постійно змінює мережеву адресу, чого тривалий запуск агента не може нормально обробити. Запускайте його на сервері, а телефон використовуйте як дисплей.
Чи зберігається сеанс, якщо закрити застосунок або втратити сигнал?
Так. За це відповідають два окремі компоненти. tmux залишає процес запущеним на сервері, тому після завершення з’єднання нічого не зупиняється. mosh підтримує саме з’єднання під час зміни адреси, тому перехід із wifi на мобільні дані не потребує навіть повторного підключення. Якщо використовувати звичайний SSH без tmux, розірване з’єднання надсилає SIGHUP, і Claude Code зупиняється посеред завдання.
Чому mosh підключається, а потім нічого не показує?
Якщо вхід успішний, а потім сеанс зависає з Nothing received from server on UDP port 60001., клієнт не може підключитися до mosh-server через цей UDP-порт. Зазвичай це означає, що firewall блокує UDP-порти від 60000 до 61000. Додайте цей діапазон в ufw, а потім додайте його також у мережевий firewall вашого провайдера. У більшості панелей це окремий механізм керування. Якщо mosh натомість повідомляє, що mosh-server не знайдено, на сервері відсутній пакет або цей компонент не входить до його login PATH: встановіть його за допомогою sudo apt install mosh або використайте mosh --server=/usr/bin/mosh-server you@server.
Як перервати роботу Claude Code з клавіатури без клавіші Esc?
Додайте рядок клавіш. Termux налаштовує його за допомогою extra-keys у ~/.termux/termux.properties, а Termius і Blink постачають рядок, який можна редагувати в налаштуваннях. Esc перериває поточну відповідь і зберігає вже виконану роботу. Ctrl+C також перериває виконання, але подвійне натискання на порожньому запиті завершує Claude Code, тому спочатку використовуйте Esc.
Чи достатньо безпечно відкривати SSH в інтернет?
Якщо автентифікацію за паролем вимкнено, успішно пройти автентифікацію можна лише за допомогою ключа, який не залишає ваші пристрої. Для машини, яку можна перебудувати, це прийнятний ризик. Використовуйте окремий ключ для кожного пристрою, щоб у разі втрати телефона потрібно було видалити лише один рядок у authorized_keys. Якщо ви не хочете приймати з’єднання через публічний порт, розмістіть сервер за WireGuard і налаштуйте sshd на прослуховування адреси тунелю.