SpyBara
Go Premium

remote-control.md 2026-09-28 22:59 UTC to 2026-09-29 11:01 UTC

This page contains 157 additions and 165 deletions.

2026
Thu 10 23:00 Sat 12 03:02 Mon 14 22:58 Fri 18 23:58 Tue 22 23:59 Fri 25 23:58 Mon 28 22:59 Tue 29 11:57

Продолжайте локальные сеансы с любого устройства с помощью Remote Control

Продолжайте локальный сеанс Claude Code со своего телефона, планшета или любого браузера, используя Remote Control. Работает с claude.ai/code и мобильным приложением Claude.

Remote Control подключает claude.ai/code или приложение Claude для iOS и Android к сеансу Claude Code, работающему на вашем компьютере. Начните задачу за столом, а затем продолжите её со своего телефона на диване или в браузере на другом компьютере.

Когда вы запускаете сеанс Remote Control на своем компьютере, Claude продолжает работать локально всё время, поэтому выполнение кода и доступ к файловой системе остаются на вашем компьютере. С помощью Remote Control вы можете:

  • Использовать полную локальную среду удалённо: ваша файловая система, MCP servers, инструменты и конфигурация проекта остаются доступными, и ввод @ автоматически дополняет пути файлов из вашего локального проекта.
  • Работать с обеих поверхностей одновременно: беседа и прогресс subagents и dynamic workflows остаются синхронизированными на всех подключённых устройствах, поэтому вы можете отправлять сообщения из терминала, браузера и телефона взаимозаменяемо.
  • Отправлять изображения и файлы со своего телефона или браузера: прикрепляйте фотографию или файл в приложение Claude или на claude.ai/code с подписью или без неё. Claude видит прикреплённые фотографии непосредственно как часть вашего сообщения. Claude Code загружает другие файлы на ваш компьютер и передаёт их Claude как ссылки на файлы @.
  • Пережить перебои: если ваш ноутбук перейдёт в режим сна или сетевое соединение разорвётся, Claude Code автоматически переподключится, когда ваш компьютер вернётся в сеть.

В отличие от cloud sessions, которые работают на облачной инфраструктуре, сеансы Remote Control работают непосредственно на вашем компьютере и взаимодействуют с вашей локальной файловой системой. Веб- и мобильные интерфейсы — это просто окно в этот локальный сеанс, поэтому ваш компьютер должен оставаться включённым и процесс claude должен продолжать работать.

Требования

Перед использованием Remote Control убедитесь, что ваша среда соответствует этим условиям:

  • Подписка: доступна на планах Pro, Max, Team и Enterprise. API ключи не поддерживаются. На планах Team и Enterprise владелец должен сначала включить переключатель Remote Control в параметрах администратора Claude Code.
  • Аутентификация: запустите claude и используйте /login для входа через claude.ai, если вы ещё этого не сделали. Без подходящей учётной записи claude remote-control завершится с ошибкой, в то время как claude --remote-control всё ещё запустит интерактивный сеанс и покажет уведомление об ошибке Remote Control вскоре после запуска.
  • Конечная точка API: недоступна в любой из этих конфигураций:
    • Вы используете Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry.
    • Вы указываете ANTHROPIC_BASE_URL на хост, отличный от api.anthropic.com, например на LLM gateway или прокси. Отключите переменную, чтобы использовать Remote Control.
    • Вы входите через корпоративный Claude apps gateway.
  • Оценка флага функции: если вы установили переменную окружения, которая отключает оценку флага функции, доступность Remote Control зависит от того, какую именно:
    • Если вы установили CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC или DISABLE_GROWTHBOOK, Remote Control недоступен. Отключите переменную везде, где она установлена, в переменных окружения вашей оболочки или в блоке env файла settings.json, чтобы использовать Remote Control.
    • Если вы установили только DISABLE_TELEMETRY или DO_NOT_TRACK, Remote Control остаётся доступным, если только ваша организация не требует Trusted Devices. Если требует, отключите переменную, чтобы использовать Remote Control. Использование Remote Control с любой из этих переменных требует Claude Code версии 2.1.283 или позже.
  • Доверие рабочей области: в каталоге, который вы ещё не доверили, claude remote-control выводит информацию о том, что включает доверие, и спрашивает Trust <directory>? [y/N] перед запуском. Ответ y сохраняет выбор, за исключением вашего домашнего каталога, где доверие никогда не сохраняется и вопрос повторяется при каждом запуске. Когда стандартный ввод или вывод команды не является терминалом, команда не может спросить и завершается с ошибкой Workspace not trusted.

Запуск сеанса Remote Control

Вы можете запустить сеанс Remote Control из CLI, приложения Claude Desktop или расширения VS Code. CLI предлагает три режима вызова; приложение Desktop и VS Code используют команду /remote-control.

В каталоге вашего проекта выполните:

claude remote-control

До тех пор, пока вы не примете одноразовое подтверждение Remote Control, claude remote-control объясняет, что он делает, и спрашивает Enable Remote Control? (y/n) перед запуском сервера. Ответьте y, чтобы принять и запустить сервер. Если вы откажетесь, Claude Code завершит работу без запуска сервера и снова спросит при следующем запуске команды.

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

Доступные флаги:

Флаг Описание
--name "My Project" Установите пользовательское название сеанса, видимое в списке сеансов на claude.ai/code.
--remote-control-session-name-prefix <prefix> Префикс для автоматически генерируемых названий сеансов, когда явное имя не установлено. По умолчанию используется имя хоста вашей машины, создавая названия вроде myhost-graceful-unicorn. Установите CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX для того же эффекта.
-c, --continue Восстановите сеанс, который последний сервер в этом каталоге запустил, вместо создания нового. См. Возобновление сеансов после остановки сервера. Не может быть объединено с --session-id, --spawn, --capacity или --create-session-in-dir. Требуется Claude Code v2.1.200 или позже.
--session-id <id> Восстановите один сеанс по его ID. См. Возобновление сеансов после остановки сервера. Не может быть объединено с --continue, --spawn, --capacity или --create-session-in-dir. Требуется Claude Code v2.1.200 или позже.
--spawn <mode> Как сервер создает сеансы.
• same-dir (по умолчанию): все сеансы используют текущий рабочий каталог, поэтому они могут конфликтовать при редактировании одних и тех же файлов.
• worktree: каждый сеанс по требованию получает свой собственный git worktree. Требуется git репозиторий.
• session: режим одного сеанса. Обслуживает ровно один сеанс и отклоняет дополнительные подключения. Устанавливается только при запуске.
Нажмите w во время выполнения, чтобы переключаться между same-dir и worktree.
--capacity <N> Максимальное количество одновременных сеансов. По умолчанию 32. Не может использоваться с --spawn=session.
--[no-]create-session-in-dir Предварительно создайте один сеанс в текущем каталоге при запуске сервера, чтобы у вас было место для ввода сразу. В режиме worktree этот сеанс остается в текущем каталоге, а сеансы по требованию получают изолированные worktrees. Включено по умолчанию. Если вы передадите --no-create-session-in-dir для запуска без него, Claude Code архивирует сеансы сервера при его остановке, поэтому нечего возобновлять.
--permission-mode <mode> Установите начальный режим разрешений для сеансов сервера, например acceptEdits. Принимает manual как псевдоним для default; неузнанный режим останавливает сервер при запуске и выводит список допустимых режимов.
-d, --debug[=<filter>] Включите отладочное логирование для сервера, опционально отфильтрованное по категориям. Передайте фильтр только в форме =, например --debug=api,hooks. Требуется Claude Code v2.1.282 или позже; более ранние версии отклоняют флаг как неизвестный аргумент.
--debug-file <path> Запишите отладочные логи в указанный файл.
--verbose Показывайте подробные логи подключения и сеанса.
--sandbox / --no-sandbox Включите или отключите изоляцию для изоляции файловой системы и сети. По умолчанию отключено.

Передавайте эти флаги после remote-control.

Если вы передадите глобальный флаг claude перед remote-control, или скрипт-обертка добавит его, Claude Code не переносит флаг в сеансы, которые создает сервер. Claude Code пропускает флаг только когда известно, что его удаление не изменит то, что могут делать эти сеансы, например --verbose или --model. Для любого другого флага, например --settings, Claude Code отказывается запускаться и называет флаг для удаления.

Claude Code проверяет право на использование Remote Control перед выводом справки, поэтому claude remote-control --help возвращает ошибку вместо этого списка флагов, когда вы не вошли с подходящей учетной записью.

Проверка статуса подключения

В интерактивном сеансе, пока Remote Control подключен, терминал показывает индикатор /rc active, который ссылается на сеанс на claude.ai. Индикатор скрывается, когда терминал слишком узкий, чтобы его вместить. Чтобы увидеть URL сеанса и QR-код для подключения с другого устройства, запустите /remote-control снова, чтобы открыть панель статуса. Панель также позволяет вам отключить Remote Control, пока ваш локальный сеанс продолжает работать.

Если подключение не удается в интерактивном сеансе, индикатор изменяется, чтобы показать сбой, и Claude Code показывает причину в уведомлении и добавляет ее в разговор. Запустите /remote-control для переподключения, если только причина не говорит, что сеанс изменился где-то еще:

  • Another connection took over this session: другое устройство или сеанс Claude Code теперь его имеет. Запустите /remote-control только если вы хотите его вернуть.
  • This session was ended or archived from another device or app: запустите /remote-control только если вы хотите сеанс вернуть. Claude Code повторно открывает архивированный сеанс.
  • The server no longer reports this session: он может быть удален с другого устройства или приложения.

Подключение с другого устройства

После активации сеанса Remote Control у вас есть несколько способов подключиться с другого устройства:

  • Откройте URL сеанса в любом браузере, чтобы перейти непосредственно к сеансу на claude.ai/code.
  • Отсканируйте QR-код, показанный рядом с URL сеанса, чтобы открыть его непосредственно в приложении Claude. С claude remote-control нажмите пробел, чтобы переключить отображение QR-кода.
  • Откройте claude.ai/code или приложение Claude и найдите сеанс по имени в списке сеансов. В мобильном приложении Claude нажмите Code в навигации, чтобы достичь списка сеансов. Сеансы Remote Control показывают значок компьютера с зеленой точкой статуса при подключении.

Когда вы подключаетесь, устройство показывает любых подагентов и рабочие процессы, которые сеанс уже запустил в фоновом режиме. Остановите один из них с устройства, и Claude Code остановит эту задачу на вашей машине.

Название удаленного сеанса выбирается в этом порядке:

  1. Имя, которое вы передали в --name, --remote-control или /remote-control
  2. Название, которое вы установили с помощью /rename
  3. Последнее значимое сообщение в существующей истории разговора
  4. Автоматически сгенерированное имя вроде myhost-graceful-unicorn, где myhost — это имя хоста вашей машины или префикс, который вы установили с помощью --remote-control-session-name-prefix

Если вы не установили явное имя, Claude Code обновляет название, чтобы отразить вашу подсказку после того, как вы отправите одну. Когда вы переименовываете сеанс с claude.ai или приложения Claude, Claude Code также обновляет локальное название, показанное в claude --resume.

Если у вас еще нет приложения Claude, запустите /mobile внутри Claude Code, чтобы показать QR-код для claude.ai/mobile, который открывает правильный магазин приложений для вашего телефона.

Что видят подключенные устройства

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

  • Компактирование и /clear: пока Claude Code компактирует разговор, подключенные устройства показывают прогресс, а затем где был компактирован разговор. Когда вы запускаете /clear, разговор также сбрасывается на подключенных устройствах.
  • Переключение разговоров с помощью /resume: подключенное устройство не получает название переключенного разговора или более раннюю историю, но новые сообщения в обе стороны идут к и от того разговора, который открыт в вашем терминале. Чтобы снова работать с исходным разговором с устройства, запустите /resume в вашем терминале и переключитесь обратно на него.
  • Извлечение сеанса с помощью /teleport: когда вы извлекаете облачный сеанс в ваш терминал с помощью /teleport, подключенное устройство не получает более раннюю историю извлеченного разговора. Новые сообщения в обе стороны идут к и от извлеченного разговора, который теперь открыт в вашем терминале.
  • Сообщения из ваших других сеансов: с кросс-сеансовой передачей сообщений одно и то же подключение переносит сообщения между вашими собственными сеансами на разных машинах и из ваших облачных сеансов.
  • Diff ваших изменений: когда каталог сеанса находится в git репозитории, панель diff подключенного устройства показывает ваши изменения. На ветке, которая имеет коммиты впереди ветки по умолчанию репозитория, панель показывает изменения с момента разделения ветки, включая ваши незафиксированные правки. На самой ветке по умолчанию или на ветке, которая не впереди, панель показывает только ваши незафиксированные изменения.
  • Модель: когда вы выбираете модель с подключенного устройства, Claude Code запускает сеанс на этой модели. Требуется Claude Code v2.1.238 или позже. Модель, которую вы выбираете с элемента управления моделью устройства, применяется только к текущему сеансу. Когда вы отправляете /model <name> с устройства в интерактивный сеанс, Claude Code также устанавливает ваше значение по умолчанию для новых сеансов.
  • Уровень усилий: когда вы устанавливаете уровень усилий с подключенного устройства, с помощью /effort или элемента управления усилиями устройства, Claude Code применяет его к сеансу на вашей машине. Если вы закрепили уровень с помощью CLAUDE_CODE_EFFORT_LEVEL, сеанс сохраняет этот уровень, и Claude Code отказывает в другом выборе из элемента управления усилиями. Выбор уровня из элемента управления усилиями требует Claude Code v2.1.234 или позже на вашей машине.
  • Переподключение после сбоя подключения: запустите /remote-control для переподключения. Если компактирование переписало разговор или вы переключили разговоры с помощью /resume в то же время, Claude Code архивирует сеанс сервера, который он использовал, вместо того чтобы оставить его в списке сеансов. Вы все еще можете найти его, фильтруя архивированные сеансы. Переключение разговоров, пока устройство все еще подключено, не архивирует сеанс.

Включение Remote Control для всех сеансов

Remote Control активируется только при явном запуске claude remote-control, claude --remote-control или /remote-control, если не включено автоподключение. Чтобы включить автоподключение для каждого интерактивного сеанса, запустите /config внутри Claude Code и установите Enable Remote Control for all sessions. Переключатель принимает три значения:

  • true: автоматически подключаться при запуске интерактивного сеанса.
  • false: отключить автоподключение, хотя true из управляемых параметров имеет приоритет, потому что Claude Code сохраняет выбор в ваши пользовательские параметры. false в параметрах проекта или локальных параметрах (.claude/settings.json, .claude/settings.local.json) отключает автоподключение даже над управляемым true.
  • default: очистить ваш выбор и следовать администраторскому значению по умолчанию вашей организации, если оно установлено, иначе текущему значению по умолчанию Claude Code.

Тот же переключатель появляется вне CLI:

  • Приложение Desktop: Settings > Claude Code > Enable remote control by default.
  • Расширение VS Code: Enable Remote Control for all sessions в разделе Settings меню команд.

Чтобы вместо этого включить автоподключение из файла параметров, установите remoteControlAtStartup на true в ваш пользовательский файл ~/.claude/settings.json или в управляемые параметры. В параметрах проекта или локальных параметрах (.claude/settings.json, .claude/settings.local.json), Claude Code соблюдает false и отключает автоподключение для этого репозитория, но игнорирует true, поэтому проверенный файл не может включить Remote Control для всех, кто открывает репозиторий.

Автоподключение входит с вашей собственной учетной записью claude.ai, поэтому сеанс, который оно запускает, появляется только в приложениях Claude вашей собственной учетной записи и не предоставляет доступ никому другому.

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

Возобновление сеансов после остановки сервера

Когда вы останавливаете claude remote-control с помощью Ctrl+C, сеансы, которые он обслуживал, перестают отвечать с вашего телефона или браузера. Пока вы не запускали другой claude remote-control в том же каталоге и не запустили этот с --no-create-session-in-dir, Claude Code их не архивирует. Чтобы их вернуть, запустите одну из этих команд в том же каталоге:

  • claude remote-control: возвращает каждый сеанс, который обслуживал сервер.
  • claude remote-control --continue: возвращает только сеанс, с которого сервер начал, и выходит, когда этот сеанс заканчивается. Если в этом каталоге нет записи, Claude Code использует самый новый из других git worktrees этого репозитория.
  • claude remote-control --session-id <id>: возвращает только сеанс, чей ID вы передали, и выходит, когда этот сеанс заканчивается. ID — это часть URL сеанса на claude.ai/code между /code/ и любым ?.

Эти команды работают примерно четыре часа после остановки сервера. После этого запустите claude remote-control для запуска нового сеанса. Если вы архивировали сеанс в то же время, --continue и --session-id разархивируют его на Claude Code v2.1.228 или позже.

Чтобы вернуть сеанс, который вы запустили с помощью claude --remote-control или /remote-control, возобновите разговор с помощью claude --continue или claude --resume. Если Remote Control не переподключится, см. Не удалось переподключиться к вашему сеансу Remote Control.

Если вы возобновляете разговор во втором терминале, пока первый все еще имеет Remote Control включенным, Claude Code выводит уведомление Remote Control not started here во втором терминале и оставляет Remote Control отключенным там вместо того, чтобы забирать сеанс у первого. Запустите /remote-control во втором терминале, чтобы переместить Remote Control на него.

Когда вы возобновляете разговор в Claude Desktop или расширении IDE, которое имело Remote Control включенным, Claude Code переподключает его к существующему сеансу claude.ai вместо добавления нового в список сеансов.

Подключение и безопасность

Ваш локальный сеанс Claude Code выполняет только исходящие HTTPS запросы и никогда не открывает входящие порты на вашем компьютере. Когда вы запускаете Remote Control, он регистрируется в API Anthropic и опрашивает работу. Когда вы подключаетесь с другого устройства, сервер маршрутизирует сообщения между веб-клиентом или мобильным клиентом и вашим локальным сеансом через потоковое соединение.

Весь трафик проходит через API Anthropic через TLS, тот же транспортный протокол безопасности, что и любой сеанс Claude Code. Соединение использует несколько краткосрочных учётных данных, каждое из которых ограничено одной целью и истекает независимо.

Пока Remote Control подключен, стенограмма сеанса, включая ваши сообщения, ответы Claude и активность инструментов, хранится на серверах Anthropic. Сохраненная стенограмма синхронизирует беседу на всех ваших устройствах и позволяет сеансу переподключиться после разрыва сети. Выполнение и доступ к файловой системе остаются на вашем компьютере, а сохраненные стенограммы хранятся в соответствии с политикой Использование данных.

Чтобы полностью отключить Remote Control, используйте параметр disableRemoteControl. Организации с требованиями соответствия, такими как Zero Data Retention, не могут включить Remote Control.

Доверенные устройства

Доверенные устройства требуют от каждого члена вашей организации или только от вас на плане Pro или Max проверить своё устройство перед тем, как они смогут просматривать или управлять сеансами Remote Control из claude.ai, мобильных приложений Claude или Claude Desktop. Это связывает доступ Remote Control с известным устройством и недавней аутентификацией, а не просто с подписанной учётной записью.

Когда параметр включен, взаимодействие с сеансом Remote Control требует обоих следующих условий:

  • Зарегистрированное устройство: каждый браузер, телефон или приложение для рабочего стола, которое член использует для Remote Control, регистрирует свои собственные учётные данные. Регистрация предлагается только вскоре после полного входа, поэтому устройство присоединяется к списку доверенных как часть реальной аутентификации, а не молча в фоновом режиме.
  • Недавний вход: вход члена должен быть не старше 18 часов. Вместо входа каждый день члены подтверждают присутствие с помощью Face ID, Touch ID, Windows Hello или passkey. Этот биометрический шаг повышения уровня немедленно обновляет сеанс.

Биометрические проверки выполняются на устройстве через операционную систему или браузер, тот же механизм, что и вход с passkey. Anthropic никогда не получает и не хранит отпечатки пальцев, данные лица или любую другую биометрическую информацию. Хранятся только открытый ключ устройства и основные метаданные, такие как отображаемое имя, платформа и время регистрации.

Параметр применяется только к Remote Control. Обычный чат Claude, Claude Code в терминале и использование API не затронуты.

Включение доверенных устройств для организации Team или Enterprise

Владелец включает параметр из параметров организации claude.ai.

1

Перейдите на страницу Capabilities

Перейдите на Organization settings > Capabilities > Remote sessions. Переключатель Require trusted devices появляется в этом разделе.

2

Включите Require trusted devices

Параметр применяется к каждому члену организации и к сеансам Remote Control, запущенным после включения переключателя. Сеансы, которые уже работали до включения переключателя, не защищены задним числом и продолжают работать без требования устройства до их завершения. Область действия для каждой команды или проекта недоступна.

3

Сообщите членам, чего ожидать

В первый раз, когда член просматривает или управляет новым сеансом Remote Control из браузера, телефона или приложения для рабочего стола после включения параметра, ему предлагается зарегистрировать это устройство. Предварительное уведомление избегает путаницы.

Что видят члены

Регистрация — это одноразовый шаг для каждого устройства. После этого единственное видимое изменение — это случайный биометрический запрос.

  • Первое использование на каждом устройстве: члену предлагается зарегистрировать устройство. Если его вход не свежий, он сначала входит через ваш обычный процесс, включая SSO, если настроен, а затем подтверждает регистрацию.
  • День за днём: члены с зарегистрированным устройством и свежим входом не видят никаких запросов. Когда вход становится старше 18 часов, следующее взаимодействие Remote Control показывает один запрос Face ID, Touch ID, Windows Hello или passkey.
  • Незарегистрированные устройства: сеансы Remote Control не могут быть просмотрены или управляться до регистрации устройства. Обычный чат Claude на этом устройстве не затронут.
  • Без аутентификатора платформы: члены на машине без Face ID, Touch ID или Windows Hello могут использовать аппаратный ключ безопасности или войти снова вместо повышения уровня.
  • В терминале: машина, на которой работает Claude Code, получает свои собственные учётные данные автоматически, когда разработчик входит в CLI. В терминале нет отдельного шага регистрации.

Управление зарегистрированными устройствами

Члены могут просматривать и отзывать свои собственные устройства из параметров учётной записи.

Откройте claude.ai/settings/account и найдите раздел Trusted devices, чтобы увидеть каждое зарегистрированное устройство с его именем, платформой и датой регистрации. Удаление устройства немедленно отзывает его учётные данные, и устройство может повторно зарегистрироваться позже после свежего входа. Учётные данные также истекают самостоятельно, если не обновляются, поэтому неиспользуемое устройство автоматически исчезает из списка доверенных.

Для потерянного или украденного устройства член удаляет его с этой страницы. Если член не может войти, администратор может использовать Sign out everywhere в консоли администратора, чтобы отозвать каждый сеанс и зарегистрированное устройство для этого члена, после чего член повторно регистрирует устройства, которые он всё ещё держит.

Remote Control и облачные сеансы

Remote Control и облачные сеансы используют интерфейс claude.ai/code. Ключевое различие заключается в том, где выполняется сеанс: Remote Control выполняется на вашем компьютере, поэтому ваши локальные MCP серверы, инструменты и конфигурация проекта остаются доступными. Облачный сеанс выполняется на облачной инфраструктуре, управляемой Anthropic по умолчанию.

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

Claude Code предлагает несколько способов работы, когда вы находитесь не у терминала. Они отличаются тем, что запускает работу, где работает Claude, и сколько настроек вам нужно выполнить.

Триггер Claude работает на Настройка Лучше всего для
Dispatch Отправьте задачу из мобильного приложения Claude Ваша машина (Desktop) Свяжите мобильное приложение с Desktop Делегирование работы, когда вас нет, минимальная настройка
Remote Control Управляйте запущенной сессией из claude.ai/code или мобильного приложения Claude Ваша машина (CLI, Desktop или VS Code) Запустите claude remote-control или /remote-control Управление текущей работой с другого устройства
Channels Отправляйте события из приложения чата, такого как Telegram или Discord, или с вашего собственного сервера Ваша машина (CLI) Установите плагин канала или создайте свой Реагирование на внешние события, такие как сбои CI или сообщения в чате
Slack Упомяните @Claude в канале команды Облако Anthropic Установите приложение Slack с включенным Claude Code в веб-версии PR и рецензии из чата команды
Self-hosted environments Запустите облачную сессию и выберите окружение вашей организации Инфраструктура вашей организации Разверните runners, в планах Team и Enterprise Облачные сессии, которые должны работать внутри вашей сети
Scheduled tasks Установите расписание CLI, Desktop или облако Выберите частоту Повторяющаяся автоматизация, такая как ежедневные проверки

Мобильные push-уведомления

Когда Remote Control активен, Claude может отправлять push-уведомления на ваш телефон.

Claude решает, когда отправить уведомление. Обычно он отправляет его, когда завершается долгоживущая задача или когда ему нужно ваше решение для продолжения. Вы также можете запросить push-уведомление в своем запросе, например notify me when the tests finish. Помимо двух переключателей включения/выключения ниже, нет конфигурации для отдельных событий.

Чтобы настроить мобильные push-уведомления:

1

Установите мобильное приложение Claude

Загрузите приложение Claude для iOS или Android.

2

Войдите с помощью своей учетной записи Claude Code

Используйте ту же учетную запись и организацию, которые вы используете для Claude Code в терминале.

3

Разрешите уведомления

Примите запрос разрешения на уведомления от операционной системы.

4

Включите push в Claude Code

В вашем терминале запустите /config и включите Push when Claude decides для проактивных уведомлений, Push when actions required для запросов разрешений и вопросов, или оба варианта.

Если уведомления не приходят:

  • Если /config показывает No mobile registered, откройте приложение Claude на вашем телефоне, чтобы оно могло обновить свой push-токен. Предупреждение исчезает при следующем подключении Remote Control.
  • На iOS режимы Focus и сводки уведомлений могут подавлять или задерживать push-уведомления. Проверьте Settings → Notifications → Claude.
  • На Android агрессивная оптимизация батареи может задержать доставку. Исключите приложение Claude из оптимизации батареи в системных параметрах.

Claude Code пропускает мобильные push-уведомления, пока вы печатаете или сосредоточены на подключенном терминале. Чтобы расширить это на любое время, когда вы находитесь у машины, даже в другом окне, установите CLAUDE_CLIENT_PRESENCE_FILE на путь файла-маркера: уведомления пропускаются, пока файл существует. Настройте прослушиватель блокировки экрана или аналогичный инструмент для создания файла при разблокировке экрана и удаления его при блокировке экрана.

Ограничения

  • Один удалённый сеанс на интерактивный процесс: вне режима сервера каждый экземпляр Claude Code поддерживает один удалённый сеанс одновременно. Используйте режим сервера для запуска нескольких одновременных сеансов из одного процесса.
  • Локальный процесс должен продолжать работу: Remote Control работает как локальный процесс. Если вы закроете терминал, выйдете из Desktop-приложения или VS Code или иным образом остановите процесс claude, сеанс перейдёт в автономный режим до тех пор, пока вы не восстановите его. Чтобы сеанс продолжал работать на удалённой машине после отключения от SSH, запустите его внутри tmux или screen.
  • Сбойные сеансы в режиме сервера: если сеанс, обслуживаемый claude remote-control, дает сбой, отправьте ему сообщение с подключённого устройства. Claude Code обслуживает его снова. Вам не нужно перезапускать сервер. Требуется Claude Code v2.1.238 или позже.
  • HTTP 403 отказы в подключённом сеансе: после подключения интерактивного сеанса Claude Code продолжает повторять попытки в течение трёх минут, когда что-то между вашей машиной и серверами Anthropic отвечает с HTTP 403, что может произойти после изменения VPN или сети. Если отказы продолжаются дольше, Claude Code отключается, и причина указывает, что отказало: сетевой край или прокси, VPN или брандмауэр в вашей собственной сети.
  • Продолжительный сбой сети: если ваша машина включена, но не может подключиться к сети, то, что вы делаете дальше, зависит от режима:
    • Режим сервера: Claude Code сдаётся примерно через 10 минут и процесс claude remote-control завершается. Запустите claude remote-control снова, чтобы начать новый сеанс.
    • Интерактивный сеанс: продолжайте работать локально. Claude Code повторяет попытки столько, сколько длится сбой, и автоматически переподключается, когда сеть восстанавливается.
  • Сбой пульса присутствия: если интерактивный сеанс отключается с сообщением could not reach the Remote Control server for about 30 minutes, запустите /remote-control для переподключения.
  • Переадресованные диалоги истекают: Claude Code держит подсказки разрешений и вопросы AskUserQuestion открытыми до тех пор, пока вы на них не ответите. Когда Claude Code переадресует другой вид диалога на удалённый сеанс, например подсказку выбора модели, показываемую после отказа по соображениям безопасности, он ждёт пять минут по умолчанию, затем закрывает диалог и продолжает с действием по умолчанию диалога без действия. Установите dialogExpiry для настройки или отключения крайнего срока. Требуется Claude Code v2.1.224 или позже.
  • Подсказка согласия на использование кредитов Fable не переадресуется: Claude Code показывает подсказку согласия на использование кредитов Fable в середине сеанса Fable usage-credits consent prompt только там, где работает сеанс, а не на вашем устройстве. Когда сеанс работает в терминале и никто там не отвечает до того, как Claude Code закроет подсказку, ход завершается без отправки запроса; см. The prompt to confirm went unanswered.
  • Некоторые команды только локальные: команды, которые работают только в интерфейсе терминала, такие как /plugin или /resume, работают только из локального CLI, независимо от того, передаёте ли вы аргумент или нет. Следующие работают с мобильных и веб-приложений:
    • Команды с текстовым выводом: /compact, /clear, /context, /usage, /exit, /usage-credits, /recap и /reload-plugins. /usage-credits выводит URL биллинга вместо открытия браузера. /reload-plugins работает только когда сеанс работает в интерактивном терминале; сеанс без него отклоняет его.
    • /model, /effort, /fast, /color и /rename: передайте значение как аргумент, например /model sonnet или /effort high. С мобильных и веб-приложений /model и /effort принимают аргумент вместо средства выбора терминала или ползунка.
    • /mcp: из мобильного приложения возвращает текстовое резюме статуса сервера вместо открытия средства выбора. В веб-приложении /mcp само по себе открывает каталог claude.ai connectors вместо возврата резюме. Подкоманды reconnect, enable и disable работают с обоих. В отличие от локального CLI, /mcp reconnect без имени сервера переподключает каждый сервер, который дал сбой или требует аутентификации.
    • /config: из мобильного приложения передайте key=value для установки параметра или запустите его без аргумента, чтобы вывести список ключей, которые вы можете установить. В веб-приложении /config вместо этого открывает раздел Claude Code ваших параметров и игнорирует текст после команды.
    • На Team и Enterprise /usage-credits с мобильных или веб-приложений не отправляет usage-credits request to your admin. Отправка требует подтверждения, которое появляется только в интерактивном CLI, поэтому команда говорит вам запустить его там.
    • /autocompact, начиная с v2.1.221: передайте размер окна как аргумент, например /autocompact 500k. Без аргумента он выводит текущий размер окна как текст вместо открытия диалога, который команда показывает в сеансе терминала.
    • /advisor, начиная с v2.1.260: передайте модель как аргумент, например /advisor opus, или передайте off для отключения советника. Обе формы применяются только к текущему сеансу и оставляют ваше сохранённое значение по умолчанию без изменений. Без аргумента он выводит текущего советника как текст вместо открытия средства выбора.
    • /output-style, начиная с v2.1.269: передайте имя стиля как аргумент, например /output-style concise, или запустите его без аргумента, чтобы вывести список стилей. С мобильных и веб-приложений вы можете выводить и выбирать только встроенные стили. Чтобы использовать пользовательский стиль, выберите его в самом сеансе.
    • /focus, начиная с v2.1.281: передайте on или off как аргумент, например /focus on, или запустите его без аргумента для переключения focus view. Обе формы применяются только к текущему сеансу и оставляют вашу сохранённую выборку без изменений.

Troubleshooting

"Remote Control requires a claude.ai subscription"

Вы не вошли в учётную запись claude.ai, или другие учётные данные имеют приоритет над вашим входом. Сообщение принимает одну из этих форм:

  • Вышли из системы, из /remote-control или --remote-control: Remote Control requires a claude.ai subscription. или /remote-control requires a claude.ai subscription.
  • Вышли из системы, из claude remote-control: You must be logged in to use Remote Control. Remote Control is only available with claude.ai subscriptions.
  • Вошли в систему, но используется API ключ или токен: Remote Control requires claude.ai subscription auth. с последующим указанием используемых учётных данных, таких как ANTHROPIC_API_KEY is set, so this session is using API-key auth. Параметр apiKeyHelper и ANTHROPIC_AUTH_TOKEN называются одинаково.

Запустите claude auth login и выберите опцию claude.ai. Если сообщение указывает на ANTHROPIC_API_KEY или ANTHROPIC_AUTH_TOKEN, удалите его везде, где он установлен: в переменных окружения вашей оболочки или в блоке env файла параметров. Если оно указывает на apiKeyHelper, удалите этот параметр.

"Remote Control requires a full-scope login token"

Вы аутентифицированы с помощью долгоживущего токена из claude setup-token или переменной окружения CLAUDE_CODE_OAUTH_TOKEN. Эти токены могут только делать запросы к модели, поэтому они не могут установить сеансы Remote Control. Запустите claude auth login для аутентификации с помощью токена сеанса полного объёма вместо этого.

"Unable to determine your organization for Remote Control eligibility"

Ваша кэшированная информация об учётной записи устарела или неполна. Запустите claude auth login для её обновления.

"Remote Control isn't enabled for this account"

Claude Code проверил доступность Remote Control для учётной записи, в которую вы вошли, и проверка вернула отрицательный результат. Обычная причина — кэшированные права доступа, которые устарели после изменения плана. Запустите claude auth logout, а затем claude auth login для их обновления, и обновите Claude Code, если вы используете старую версию.

Запустите claude doctor для просмотра того, какая отдельная проверка прав доступа не прошла. Конфликты переменных окружения, недостижимые проверки и параметр Remote Control вашей организации каждый производят своё собственное сообщение, поэтому эта ошибка означает, что сама проверка на уровне учётной записи не прошла.

До версии 2.1.239 это сообщение читалось как "Remote Control is not yet enabled for your account".

"Couldn't verify Remote Control eligibility"

Claude Code не смог связаться со службой флагов функций для проверки того, включён ли Remote Control для вашей учётной записи, обычно потому, что вы находитесь в автономном режиме или прокси блокирует запрос. Повторите попытку, когда у вас будет доступ в сеть, или запустите claude doctor для получения подробной информации. Связанное сообщение "Couldn't verify your organization's Remote Control policy" означает, что Claude Code столкнулся с ошибкой при чтении этой политики и имеет то же решение.

"Remote Control requires feature-flag evaluation"

Переменная окружения, которая отключает оценку флагов функций, установлена, и полное сообщение указывает переменную, которую нашёл Claude Code. На версиях до 2.1.154 та же конфигурация производит "Remote Control is not yet enabled for your account" вместо этого. Что делать, зависит от переменной, которую указывает сообщение:

  • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC или DISABLE_GROWTHBOOK: отключите переменную везде, где она установлена, в переменных окружения вашей оболочки или в блоке env файла settings.json.
  • DISABLE_TELEMETRY или DO_NOT_TRACK: на плане Pro, Max, Team или Enterprise с отключённым DISABLE_GROWTHBOOK, эти переменные оставляют Remote Control доступным, если только ваша организация не требует Trusted Devices. Если требует, отключите переменную везде, где она установлена, для использования Remote Control. С версии 2.1.154 по версию 2.1.282 любая переменная производила это сообщение, поэтому обновите Claude Code до версии 2.1.283 или позже.

"Remote Control is only available when using Claude via api.anthropic.com"

Сеанс не разговаривает с API Anthropic напрямую, поэтому нет claude.ai бэкенда для сопряжения. Это происходит на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry. Это также происходит, когда ANTHROPIC_BASE_URL указывает на хост, отличный от api.anthropic.com, такой как LLM gateway или прокси, даже если вы входите с claude.ai. Смотрите справочник ошибок для полного списка причин.

Сообщение указывает, что направило сеанс в сторону от API Anthropic, такое как CLAUDE_CODE_USE_BEDROCK или пользовательский ANTHROPIC_BASE_URL. Если у вас есть подходящий вход claude.ai, отключите названную переменную, удалите её из ключа env в параметрах, если вы установили её там, и перезагрузите сеанс.

"Remote Control is disabled by your organization's policy"

Политика блокирует Remote Control. Проверьте эти причины по порядку:

  • Ошибка упоминает disableRemoteControl: ваш администратор IT отключил Remote Control на этом устройстве через управляемые параметры, независимо от переключателя на уровне организации и от того, как вы вошли.
  • Ваш план claude.ai — Pro или Max: Claude Code всё ещё вошёл в организацию Team или Enterprise с более раннего входа, поэтому он проверяет политику Remote Control этой организации. Запустите /status для просмотра того, какой план и организацию использует ваш вход. Запустите claude auth logout, а затем claude auth login для повторного входа под вашим текущим планом.
  • Сообщение не говорит обратиться к администратору вашей организации: ваша организация имеет конфигурацию HIPAA, которая несовместима с Remote Control, и /status указывает HIPAA в строке Compliance. В этом состоянии переключатель Remote Control в панели администратора неактивен, поэтому Owner не может изменить его там. Обратитесь в службу поддержки Anthropic для обсуждения вариантов. До версии 2.1.267 этот случай показывал "Remote Control isn't available for your organization due to its compliance policy" вместо этого.
  • В противном случае Owner не включил его для вашей организации: Remote Control отключён по умолчанию на планах Team и Enterprise. Owner может включить его на claude.ai/admin-settings/claude-code, включив переключатель Remote Control. Этот переключатель является параметром организации на стороне сервера.

До версии 2.1.281 это сообщение также появлялось, когда Claude Code не загрузил политику вашей организации на этой машине, например после запуска в автономном режиме. Более поздние версии сообщают об этом состоянии как Couldn't verify your organization's policy for remote control вместо этого.

"Couldn't verify your organization's policy for remote control"

Claude Code не смог получить политику вашей организации и не имеет сохранённой копии на этой машине для использования вместо этого, поэтому он держит Remote Control отключённым, пока не сможет подтвердить, что ваша организация это позволяет. Это обычно происходит, когда вы запускаете Claude Code в автономном режиме или до подключения VPN, или когда прокси мешает запросу. На медленном соединении это также может появиться, пока первый запрос всё ещё в пути.

Сообщение принимает одну из этих форм:

  • Из /remote-control, claude remote-control или claude --remote-control: Couldn't verify your organization's policy for remote control. Check your network connection and try again.
  • Из автоподключения при запуске сеанса: couldn't verify your organization's policy — check your network connection and try again, с префиксом Remote Control failed в уведомлении и Remote Control disconnected в разговоре. Сеанс затем оставляет Remote Control отключённым.

Восстановите подключение к сети, затем запустите /remote-control или запустите команду снова. Каждая попытка снова проверяет политику, поэтому вам не нужно перезагружать Claude Code. Если сообщение продолжает появляться, запустите claude doctor и прочитайте его строку Organization policy, которая говорит, почему политика не загрузилась.

До версии 2.1.281 это состояние показывало Remote Control is disabled by your organization's policy вместо этого.

"Remote credentials fetch failed"

Claude Code не смог получить краткосрочные учётные данные из API Anthropic для установления соединения. Запустите снова с --verbose для просмотра полной ошибки:

claude remote-control --verbose

Распространённые причины:

  • Не вошли в систему: запустите claude и используйте /login для аутентификации с помощью вашей учётной записи claude.ai. Аутентификация по API ключу не поддерживается для Remote Control.
  • Проблема с сетью или прокси: брандмауэр или прокси может блокировать исходящий HTTPS запрос. Remote Control требует доступа к API Anthropic на порту 443.
  • Ошибка создания сеанса: если вы также видите Session creation failed — see debug log, ошибка произошла ранее в процессе установки. Проверьте, что ваша подписка активна.

"Couldn't reconnect to your Remote Control session"

Когда вы возобновляете разговор с claude --resume или claude --continue, Claude Code переподключается к сеансу Remote Control, записанному в этом разговоре. Это сообщение означает, что переподключение не удалось по причине, которая может быть временной, такой как сетевой сбой или ошибка сервера, поэтому Claude Code не может подтвердить, существует ли удалённый сеанс.

Запустите /remote-control для повторной попытки подключения, или запустите новый сеанс с claude --remote-control для создания нового сеанса Remote Control. Ваш локальный сеанс продолжает работать без Remote Control в то же время.

"Previous session is unavailable — run /remote-control to start a new one"

Claude Code не смог восстановить предыдущий сеанс Remote Control и остановился вместо того, чтобы запустить новый самостоятельно. Вы можете увидеть это сообщение после возобновления разговора с claude --resume или claude --continue, или после того, как Claude Code переподключится самостоятельно после отключения.

Запустите /remote-control для запуска нового сеанса Remote Control под текущим входом; ваш локальный сеанс продолжает работать без Remote Control в то же время. Связанное сообщение Remote Control could not verify the signed-in account — run /remote-control to reconnect имеет то же решение. Если вы запустите /remote-control после Previous session is unavailable без перезагрузки Claude Code в первую очередь, Claude Code оставляет более ранние сообщения разговора вне нового сеанса.

"Remote Control got an unexpected server response"

Сервер Remote Control принял запрос, но ответил в форме, которую эта версия Claude Code не смогла прочитать, при создании удалённого сеанса или получении его учётных данных. Повторная попытка на той же версии не удаётся таким же образом. Запустите claude update, затем запустите /remote-control для переподключения.

"Your organization requires Trusted Devices for Remote Control, but this device is not enrolled"

Ваша организация имеет включённый Trusted Devices и эта машина ещё не зарегистрирована. Запустите /login в Claude Code. Регистрация происходит как часть входа, и нет отдельной команды регистрации.

"session expired for trusted-device check"

Ваш вход старше 18 часов. Запустите /login в Claude Code, или подтвердите с помощью Face ID, Touch ID, Windows Hello или passkey, когда claude.ai или мобильное приложение вас попросит. Смотрите Trusted Devices.