Claude CodeГайд

Claude Code Remote Control: управляй сессией с телефона

Remote Control открывает локальную сессию Claude Code на телефоне и в браузере. Разбираю серверный режим с worktree, /rc, пуши и ошибки входа на версии 2.1.319.

Claude Code Remote Control: управляй сессией с телефона

Запускаешь в Claude Code длинную задачу, отходишь от ноутбука, а агент через пять минут останавливается и ждёт ответа на вопрос. Claude Code Remote Control снимает это ожидание: локальная сессия открывается в приложении Claude на телефоне или на claude.ai/code, и отвечаешь ты оттуда. Код при этом выполняется на твоём компьютере, со всеми файлами, MCP-серверами и настройками проекта.

Первая версия этого гайда вышла 25 февраля 2026 года, на следующий день после того, как Anthropic открыла команду claude remote-control всем пользователям (версия 2.1.51). За восемь месяцев функция заметно разрослась. Серверный режим держит до 32 сессий, каждая может работать в своём git worktree, на телефон приходят пуши, а флаг --sandbox, который я советовал в феврале, удалили. Я заново прошёл все шаги на Claude Code 2.1.319 в демо-проекте, кадры ниже из этого прогона.

В статье разберём:

  • как работает Remote Control и чем он отличается от облачных сессий, Dispatch и Channels;
  • что нужно для запуска: тарифы и вход;
  • как запустить сервер, подключить телефон и включить удалённый доступ в открытой сессии;
  • что можно делать с телефона, а что только в терминале;
  • как вернуть сессию после остановки и что делать при обрыве сети;
  • что Remote Control хранит у Anthropic;
  • какие ошибки встречаются и как их исправить.

Как работает Remote Control в Claude Code

Remote Control (удалённое управление) это мост между процессом claude на твоём компьютере и интерфейсом claude.ai/code или мобильным приложением Claude. Телефон показывает ту же сессию, что и терминал: переписку, вызовы инструментов, прогресс сабагентов и dynamic workflows. Писать можно с любого устройства по очереди, контекст общий.

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

Кроме Remote Control у Claude Code есть ещё несколько способов работать вдали от терминала. В документации Anthropic на 6 ноября 2026 года они сведены в одну таблицу.

Таблица из документации Claude Code: Dispatch, Remote Control, Channels, Slack, Self-hosted environments и Scheduled tasks с колонками Trigger, Claude runs on, Setup и Best for
Remote Control единственный из способов, где ты управляешь уже идущей сессией, а не запускаешь новую задачу. Скриншот: документация Claude Code

Коротко, чем они отличаются:

Способ Где работает Claude Когда брать
Remote Control Твой компьютер (CLI, Desktop, VS Code) Продолжить начатую работу с другого устройства
Облачная сессия (Claude Code on the web) Серверы Anthropic Задача без локальной настройки или по репозиторию, которого у тебя нет
Dispatch Твой компьютер, приложение Desktop Отправить задачу с телефона. По справке Anthropic это ограниченная бета, новым пользователям недоступна
Channels Твой компьютер (CLI) Реакция на события из Telegram, Discord или CI
Scheduled tasks CLI, Desktop или облако Задачи по расписанию

Channels и Remote Control часто путают. Channels пересылает в сессию сообщения из мессенджера, и Claude реагирует на них сам. Remote Control даёт тебе ту же сессию с полным интерфейсом. Как настроить первый вариант, я разбирал в гайде по Channels в Claude Code, а для повторяющихся задач есть запланированные задачи и /loop.

Channels в Claude Code: подключаем Telegram, Discord и вебхуки
Как пересылать в сессию сообщения из мессенджера и CI, чтобы Claude реагировал на них сам.

Что нужно для запуска: тарифы и вход

Remote Control работает только с подпиской claude.ai: Pro, Max, Ultra, Team или Enterprise. API-ключи не подходят. В феврале в списке были только Pro и Max, теперь добавились Ultra и командные тарифы.

Раздел Requirements документации Claude Code Remote Control: подписка, custom roles, аутентификация и ограничения по API endpoint
Список требований заметно вырос с февраля: роли Enterprise, шлюзы и переменные окружения теперь описаны отдельно. Скриншот: документация Claude Code

Перед запуском проверь четыре условия.

Вход через claude.ai. Запусти claude и выполни /login. Если в окружении есть ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN или настройка apiKeyHelper, сессия пойдёт через ключ, и Remote Control откажется стартовать.

Прямое подключение к api.anthropic.com. Remote Control недоступен через Amazon Bedrock, Google Cloud, Microsoft Foundry и любой ANTHROPIC_BASE_URL, который смотрит не на Anthropic. Это касается и всех схем, где Claude Code работает на сторонней модели, как в моей подборке провайдеров с Anthropic API.

Включённый переключатель на Team и Enterprise. На командных тарифах Remote Control по умолчанию выключен, его включает Owner в настройках Claude Code в админке. Где эти настройки, я показывал в статье про Claude Code для Team и Enterprise.

Фичефлаги не выключены. Переменные CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC и DISABLE_GROWTHBOOK выключают Remote Control целиком. DISABLE_TELEMETRY и DO_NOT_TRACK с версии 2.1.283 ему уже не мешают, если организация не требует Trusted Devices (о них ниже).

Шаг 1. Запустить сервер в папке проекта

Самый полный способ это серверный режим. Перейди в папку проекта и выполни claude remote-control. Процесс останется в терминале и будет ждать подключений, а новые сессии создаст по запросу с телефона или из браузера. Флаг --name задаёт имя, под которым сессия видна в списке.

Справка claude remote-control --help в Claude Code 2.1.319: флаги --name, --continue, --session-id, --permission-mode, --spawn, --capacity и описание режима
В справке версии 2.1.319 нет --sandbox, зато появились --spawn, --capacity, --continue и --permission-mode. Скриншот: терминал / matveev.tech

При первом запуске в новой папке Claude Code задаёт два вопроса. Сначала он спрашивает, доверяешь ли ты папке: сессии из неё смогут читать, править и запускать файлы, а хуки и MCP-серверы проекта применятся к ним. Потом просит выбрать режим создания сессий (spawn mode).

Первый запуск claude remote-control: вопрос Trust для папки todo-app и выбор Spawn mode между same-dir и worktree
Ответ на вопрос о доверии и выбранный режим сохраняются для папки, второй раз Claude Code их не спросит. Скриншот: терминал / matveev.tech

Режимов три, их задаёт флаг --spawn.

same-dir. Все сессии работают в текущей папке. Это режим по умолчанию, и он же самый рискованный: две сессии могут одновременно править один файл.

worktree. Каждая новая сессия получает свою копию репозитория в git worktree. Нужен git-репозиторий или хук WorktreeCreate. Я выбрал этот режим для демо-проекта.

session. Классический одиночный режим, как в феврале: сервер обслуживает одну сессию и завершается вместе с ней.

После выбора сервер пишет Connected, показывает счётчик Capacity: 1/32 и ссылку на сессию. Пробел выводит QR-код для телефона, клавиша w переключает same-dir и worktree прямо на ходу.

Сервер claude remote-control в режиме worktree: QR-код для телефона, статус Connected и Capacity 1/32
Одна сессия создана сразу при старте, остальные 31 место сервер отдаст по запросу с телефона. Скриншот: терминал / matveev.tech

Пригодятся и другие флаги. --capacity меняет лимит одновременных сессий (по умолчанию 32). --permission-mode задаёт стартовый режим разрешений для всех сессий сервера, например acceptEdits или auto; что делает каждый, я разбирал в статье про auto mode в Claude Code. --chrome разрешает сессиям управлять Chrome на твоём компьютере, без флага он выключен.

💡
Глобальные флаги перед remote-control, например claude --settings x.json remote-control, сервер не переносит в свои сессии и отказывается стартовать. Пропускает он только безвредные вроде --verbose и --model. Песочницу для сессий сервера включай через sandbox.enabled в settings.json.

Шаг 2. Подключиться к сессии с телефона или браузера

Подключиться можно тремя способами: открыть ссылку из терминала в любом браузере, отсканировать QR-код камерой телефона или найти сессию по имени в списке. В мобильном приложении список открывается вкладкой Code, сессии Remote Control помечены значком компьютера с зелёной точкой, пока компьютер онлайн. Если приложения Claude ещё нет, команда /mobile в Claude Code покажет QR-код на App Store и Google Play.

С телефона можно отправлять фото и файлы. Фото Claude видит сразу как часть сообщения, остальные файлы Claude Code скачивает на компьютер и передаёт как ссылки @файл. Если файл не дошёл, в сообщении появится пометка вроде [1 of 3 attachments did not arrive].

Чтобы не держать телефон в руке, включи пуши. В /config для этого два переключателя: «Push when actions required» присылает уведомление, когда агент ждёт разрешения или ответа, а «Push when Claude decides» отдаёт решение самому Claude, обычно он пишет по завершении долгой задачи. Пуш можно и попросить прямо в промпте: «напиши мне, когда тесты пройдут».

Настройки /config в Claude Code с фильтром push: Push when actions required и Push when Claude decides включены
Оба переключателя включены: пуш придёт и на запрос разрешения, и когда Claude сам решит, что пора. Скриншот: терминал / matveev.tech

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

Шаг 3. Включить удалённый доступ в открытой сессии

Сервер удобен, когда новые сессии хочется заводить прямо с телефона. Думаю, большинству хватит варианта попроще: если хочешь печатать и в терминале, и с телефона, запусти обычную сессию с флагом --remote-control (коротко --rc). Через пробел можно передать имя.

claude --rc "todo-app: тесты"
Интерактивная сессия Claude Code 2.1.319, запущенная с --rc: метка /rc в шапке и строка /remote-control is active со ссылкой на claude.ai/code
Метка /rc в шапке ведёт на сессию в claude.ai. В узком окне терминала она скрывается. Скриншот: терминал / matveev.tech

Если сессия уже идёт, набери /remote-control или /rc. Вся история разговора переедет на телефон. При первом включении Claude Code покажет диалог подтверждения, дальше подключает сразу. Повторный /remote-control открывает панель: там ссылка, QR-код и кнопка, которая отключает Remote Control, не закрывая локальную сессию.

Панель Remote Control в Claude Code: ссылка на сессию, пункты Disconnect this session, Show QR code и Continue
Disconnect отключает только удалённый доступ, локальная сессия продолжает работать. Скриншот: терминал / matveev.tech

Та же команда /remote-control работает в расширении Claude Code для VS Code и во вкладке Code приложения Claude Desktop. Имени и QR-кода в VS Code нет, сессию ищи в списке на claude.ai/code.

Чтобы каждая новая сессия подключалась сама, в /config поставь «Enable Remote Control for all sessions» в true. У параметра три значения: true, false и default (следовать настройке организации).

Настройка Enable Remote Control for all sessions в /config Claude Code со значением true
С этой настройкой каждый процесс claude регистрирует свою удалённую сессию. Скриншот: терминал / matveev.tech

То же самое задаётся ключом в пользовательском ~/.claude/settings.json:

{
  "remoteControlAtStartup": true
}

В проектном .claude/settings.json этот ключ работает только в одну сторону: false выключает автоподключение для репозитория, а true игнорируется. Так закоммиченный файл не включит Remote Control всем, кто клонировал репозиторий. Остальные ключи и уровни настроек описаны в гайде по settings.json.

Короткие разборы новых команд Claude Code вроде /rc и --spawn я выкладываю в канале раньше, чем успеваю обновить гайды: подписывайся в телеге.

Что можно делать с телефона, а что только в терминале

С телефона работает обычная переписка, разрешения и вопросы агента. Слеш-команды с интерфейсом в терминале (выбор из списка, слайдер) на телефоне принимают значение аргументом. Вот что я сверил по документации на 6 ноября 2026 года:

Команда С телефона и из браузера
/compact, /clear, /context, /usage, /exit Работают, ответ текстом
/model, /effort, /fast, /rename Работают с аргументом: /model sonnet, /effort high
/mcp В приложении текстовая сводка по серверам, в браузере каталог коннекторов
/config В приложении /config ключ=значение, в браузере открывает настройки
/plugin, /resume Только в терминале

Модель и effort, выбранные с телефона, применяются к сессии на компьютере. Чем отличаются уровни effort, я разбирал в статье про модель и effort level в Claude Code.

Кое-что заметно не сразу. Сабагентов и workflows, запущенных в фоне, видно и на телефоне, и их можно остановить оттуда. Панель diff показывает изменения в git-репозитории. А служебные диалоги, кроме разрешений и вопросов агента, закрываются через пять минут без ответа с вариантом по умолчанию; срок меняет настройка dialogExpiry.

Чтобы следить за несколькими сессиями на самом компьютере, удобнее Agent View в Claude Code: он собирает их в одну панель.

Как вернуть сессию после остановки

Ctrl+C в терминале с claude remote-control останавливает сервер, и сессии на телефоне перестают отвечать. Но Claude Code их не архивирует. В течение примерно четырёх часов их можно вернуть командой из той же папки: claude remote-control возвращает все сессии сервера, --continue только ту, с которой он стартовал, --session-id одну по её идентификатору из ссылки.

Команда claude remote-control --continue возвращает сессию todo-app demo, остановленную шесть минут назад, в режиме Single session
Я остановил сервер и через шесть минут вернул сессию с той же ссылкой. Скриншот: терминал / matveev.tech

Сессию, запущенную через --rc или /rc, возвращают обычным claude --continue или claude --resume: Remote Control переподключится сам.

С обрывами сети режимы ведут себя по-разному, и в старой версии статьи этого не было. Интерактивная сессия переподключается сколько угодно долго, пока сеть не вернётся. Серверный режим ждёт около 10 минут и завершается, после этого claude remote-control придётся запустить заново. Если Claude Code работает на удалённой машине по SSH, запускай его внутри tmux или screen, иначе сессия умрёт вместе с подключением.

Безопасность: что хранит Anthropic

Входящих портов Remote Control не открывает. Локальная сессия делает только исходящие HTTPS-запросы к API Anthropic по TLS, а телефон получает сообщения через тот же API. Для связи используется несколько короткоживущих ключей, у каждого своя задача и свой срок.

Одну деталь в феврале я упустил. Пока Remote Control подключён, расшифровка сессии хранится на серверах Anthropic: твои сообщения, ответы Claude и вызовы инструментов. Так работает синхронизация между устройствами и переподключение после обрыва. Для пет-проекта это неважно, а для рабочего репозитория я бы сначала уточнил, что разрешает политика компании. Код и файлы остаются у тебя, а расшифровка хранится по правилам использования данных Anthropic. Поэтому организации с Zero Data Retention и конфигурацией HIPAA включить Remote Control не могут, а администратор может запретить его на устройстве настройкой disableRemoteControl.

Для тех, кто боится потерять телефон, появились Trusted Devices (бета). С ними смотреть и вести сессию можно только с зарегистрированного устройства и только если вход был не позже 18 часов назад. Вместо повторного входа хватает Face ID, Touch ID или ключа доступа. На Pro, Max и Ultra это включается в настройках аккаунта, на Team и Enterprise его включает Owner для всей организации.

Разрешения в Claude Code: allow, deny и sandbox
Какие правила поставить сразу и как включить песочницу, чтобы агент не выходил за пределы проекта.

Права агента на компьютере Remote Control не меняет: действуют те же правила allow, ask и deny, что и в терминале. Если нужна изоляция, включи песочницу в настройках, как описано в гайде по разрешениям выше.

Ошибки при запуске и как их исправить

Большинство ошибок Remote Control сводится к тому, как ты вошёл и куда смотрит Claude Code. Я специально воспроизвёл три самые частые в демо-проекте.

Remote Control requires claude.ai subscription auth. В окружении есть ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN или apiKeyHelper. Убери переменную из оболочки или из блока env в settings.json и выполни claude auth login со входом через claude.ai.

Remote Control is only available when using Claude via api.anthropic.com. Задан ANTHROPIC_BASE_URL на шлюз или стороннего провайдера. Если ты подключал GLM по гайду про Z.ai и Claude Code, Remote Control в этой оболочке не заработает. Запускай его в отдельном терминале без переменной.

Две ошибки claude remote-control: с ANTHROPIC_BASE_URL на api.z.ai и с ANTHROPIC_API_KEY в окружении
Обе ошибки называют переменную, из-за которой Remote Control не стартует, так что искать причину не придётся. Скриншот: терминал / matveev.tech

--sandbox is not supported by claude remote-control. Флаги --sandbox и --no-sandbox удалили в версии 2.1.300 от 14 октября 2026 года. По changelog они и раньше ни на что не влияли, так что совет из февральской версии статьи был пустым. Песочницу включает sandbox.enabled: true в настройках.

Ошибка claude remote-control --sandbox: флаг не поддерживается и удалён, песочницу включает sandbox.enabled в настройках
Сообщение сразу подсказывает замену удалённому флагу. Скриншот: терминал / matveev.tech

Remote Control requires a full-scope login token. Ты вошёл долгоживущим токеном из claude setup-token или CLAUDE_CODE_OAUTH_TOKEN. Такие токены умеют только запросы к модели, нужен обычный claude auth login.

Workspace not trusted. Сервер запущен без терминала, например из скрипта, и не может спросить про доверие к папке. Один раз запусти claude в этой папке вручную и ответь y.

Remote Control is disabled by your organization's policy. На Team и Enterprise Owner не включил переключатель Remote Control. Если у тебя личный Pro или Max, проверь /status: возможно, Claude Code всё ещё вошёл под старой организацией, тогда помогут claude auth logout и claude auth login.

Если сообщение непонятное, запусти claude doctor: он показывает, какая именно проверка доступа к Remote Control не прошла.

Главное о Remote Control в 4 пунктах

  1. Remote Control превращает телефон и браузер в окно в сессию на твоём компьютере. Если работа уже идёт локально и нужны твои файлы и MCP-серверы, это правильный выбор, а для задач с нуля подойдёт облачная сессия.
  2. Серверный режим claude remote-control с --spawn worktree держит до 32 сессий с отдельными копиями репозитория. Для одной сессии с вводом и в терминале, и на телефоне хватит claude --rc.
  3. Remote Control работает только со входом через claude.ai и прямым подключением к api.anthropic.com. Ключи API, сторонние провайдеры и шлюзы его отключают, а ошибка всегда называет мешающую переменную.
  4. Пока сессия подключена, её расшифровка хранится у Anthropic. Для рабочих проектов включи Trusted Devices, а песочницу настраивай через sandbox.enabled: флаг --sandbox удалён.

Другие гайды по агенту собраны в разделе о Claude Code.

Читайте также

CTO говорит

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

Читать в Telegram

Ещё в разделе Claude Code

Весь раздел