Claude Code Remote Control: как продолжить локальную сессию с телефона

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

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

Claude Code Remote Control: что остаётся локальным

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

Важно различать исполнение и передачу данных. Код и команды запускаются локально, но сообщения, ответы и активность инструментов во время удалённого подключения синхронизируются через серверы Anthropic. Это прямо написано в разделе безопасности документации. Для приватного проекта этот нюанс важнее красивого слова «локально». Решите заранее, можно ли отправлять содержимое этой сессии через сервис.

Режим не заменяет удалённый рабочий стол. Вы управляете разговором с агентом, а не всем экраном компьютера. И это отдельная функция от Claude Code on the web: облачная сессия исполняет работу на инфраструктуре провайдера, Remote Control управляет процессом на вашей машине. Общий обзор терминального агента и команд есть в статье Claude Code CLI и API.

Что проверить перед запуском

Официальная документация перечисляет подписки Pro, Max, Team и Enterprise. Для Team и Enterprise владелец организации должен включить Remote Control в административных настройках. Вход нужен через claude.ai: если ваша рабочая сессия оплачивается только API-ключом, соединение не установится. Не надо рассчитывать, что любой способ авторизации Claude Code автоматически подойдёт.

Если переменная ANTHROPIC_BASE_URL направляет запросы не на api.anthropic.com, Remote Control также недоступен. Это важная оговорка для людей, которые пользуются шлюзами моделей. В той же категории ограничения для Amazon Bedrock, Google Cloud Agent Platform, Microsoft Foundry и корпоративного Claude apps gateway. Менять конфигурацию рабочего проекта ради одного удалённого сеанса вслепую не советую: проверьте, не затронете ли оплату, окружение и другие процессы.

Наконец, машина должна быть включена и иметь сеть. Сон ноутбука прерывает доступ; после пробуждения и восстановления сети Claude Code пытается подключиться снова. Если процесс закрыли, телефон не сможет внезапно запустить код на выключенной машине. Прежде чем уходить, убедитесь, что сеанс виден на втором устройстве.

Как продолжить открытую сессию с телефона

1. В терминале перейдите в нужный проект и запустите claude. Если ещё не вошли под подпиской, выполните /login и выберите авторизацию через claude.ai. Откройте обычный рабочий диалог или продолжите уже начатый.
2. Прямо в этой сессии введите /remote-control. Можно дать понятное имя, например /remote-control Личный проект. При первом использовании подтвердите включение функции в появившемся диалоге.
3. Получите ссылку на удалённую сессию из терминала. На телефоне откройте приложение Claude и вкладку Code либо зайдите через браузер на claude.ai/code под тем же аккаунтом. Найдите сессию в списке по имени или откройте ссылку.
4. Напишите короткое проверочное сообщение, например «Покажи статус тестов, ничего пока не меняй». Убедитесь, что оно появилось в той же локальной беседе. Только после этого отходите от компьютера.
5. Когда закончите, вернитесь к локальной сессии. Документация также описывает выключение подключения повторной командой /remote-control в расширении VS Code; для терминала проверьте состояние своей текущей сессии, прежде чем закрывать процесс.

Есть и другой запуск: claude --remote-control создаёт интерактивную терминальную сессию сразу с удалённым доступом. Команда claude remote-control запускает серверный режим: терминал ждёт удалённых подключений, показывает ссылку на сессию, а клавишей пробела можно вывести QR-код. Если работа уже идёт в конкретной беседе, мне проще /remote-control: не создаёшь новую сессию и не теряешь текущий контекст.

Серверный режим, обычный терминал и QR-код

Три способа запуска отличаются тем, как вы продолжаете работу на основной машине. /remote-control прикрепляет удалённый доступ к разговору, который уже открыт. claude --remote-control запускает интерактивный диалог сразу с ним: можно писать и в терминале, и с телефона. claude remote-control запускает сервер, который ждёт подключения; привычного ввода сообщений в этот терминал нет. Документация Anthropic называет это server mode.

QR-код относится к серверному режиму claude remote-control: документация предлагает нажать пробел. Во всех вариантах можно открыть ссылку либо найти сессию по названию в списке Code на телефоне. Не путайте /remote-control со slash-командами другого клиента, если у вас несколько AI-агентов на машине. Тут всё касается только официального Claude Code.

У server mode есть возможность нескольких одновременных сессий; конфигурация --spawn и число подключений описаны в документации. Если вы только пробуете удалённое управление, не начинайте с параллельного редактирования одного каталога. В режиме общего каталога несколько сессий могут писать в одни и те же файлы, поэтому для независимых изменений лучше отдельные рабочие деревья Git. Это уже вопрос организации разработки, а не подключения телефона.

Что происходит с доступом и данными

Локальная программа устанавливает исходящие HTTPS-соединения с Anthropic. По официальному описанию Remote Control не открывает входящие порты на вашем компьютере. Это хорошая новость для тех, кто привык поднимать собственный веб-сервер с публичным адресом ради доступа с телефона: здесь порт наружу открывать не нужно. Но запросы и журнал разговора идут через сервис провайдера, поэтому «никакие данные не покидают ноутбук» говорить нельзя.

Удалённое устройство видит беседу и активность инструментов. Из него можно отправлять новые запросы, прикреплять файлы и изображения; прочие файлы Claude Code скачивает на локальную машину для работы. Права агента и доверие к рабочему каталогу остаются критичными. Если вы впервые запускаете серверный режим в незнакомой папке, CLI попросит подтвердить доверие к каталогу. Не соглашайтесь автоматически с доступом к чужому проекту.

У этой функции своя граница применимости: если организации нужен режим без хранения данных на стороне провайдера, Anthropic указывает, что Remote Control нельзя включить. Для бизнес-кода сначала спросите админа про политику сессий. А если вы просто хотите с телефона читать результат долгой локальной задачи, не давайте агенту шире доступов, чем ему были нужны за рабочим столом.

Почему соединение не появляется

Если видите сообщение про подписку, сначала проверьте, чем CLI реально авторизован. Установленная переменная ANTHROPIC_API_KEY или ANTHROPIC_AUTH_TOKEN может иметь приоритет над входом через claude.ai. В документации советуют войти под аккаунтом подписки через claude auth login и убрать конфликтующее значение там, где оно задано. Делайте это осознанно и только для нужного процесса: другие автоматизации могут зависеть от ключа.

Если пишет про недоступность Remote Control, проверьте версию Claude Code, состояние подписки и настройку организации. Официальная диагностика claude doctor показывает, какая проверка не прошла. Отдельный случай - переменные, отключающие проверку доступности функций: CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC и DISABLE_GROWTHBOOK мешают Remote Control. Не меняйте их без понимания, зачем они были установлены. Если машина потеряла сеть, сначала восстановите соединение, а потом повторите проверку.

В России не обещаю работу сервиса или какой-то специальный способ обойти ограничения: наличие команды в CLI само по себе не подтверждает доступность аккаунта и подписки в вашем регионе. Для общего маршрута установки и вариантов авторизации есть отдельный разбор Claude Code в России. Здесь правило проще: проверяйте вход и удалённую сессию на двух устройствах до того, как уйдёте.

Когда Remote Control действительно полезен

Я бы включал его для долгих локальных задач, где агенту может понадобиться ответ человека: тесты, разбор большой ошибки, проверка правок. Вышел за кофе - увидел уточнение на телефоне - вернулся к тому же проекту. Для круглосуточного автономного агента одного Remote Control мало: требуется постоянно работающая машина, контроль прав, наблюдение за сбоями и отдельные правила безопасности. Подробнее про такую схему есть в статье агент 24/7 на своём сервере.

Мой практический тест перед использованием - одну минуту поработать с другого устройства, посмотреть, синхронизировался ли ответ, и открыть файлы проекта после команды с телефона. Если оба шага прошли, удалённое окно делает ровно то, ради чего его включали. Если нет, чините авторизацию или связь локальной машины, а не начинайте новый чат и не теряйте прежнюю беседу.

Источник: официальная документация Claude Code Remote Control.