Как управлять сессиями Claude Code удаленно: гайд по команде remote-control и флагу --settings в релизе 2.1.321
Параметр задает единую конфигурацию для всех удаленных сессий и блокирует их запуск при изменении файла без перезапуска.
9 ноября 2026 года Anthropic выпустила релиз Claude Code 2.1.321. Главным нововведением для серверной инфраструктуры стал флаг --settings для встроенной команды claude remote-control. До этого обновления удаленные сессии, запущенные на виртуальных машинах или рабочих станциях, требовали ручного контроля локальных конфигов или полагались на глобальные переменные среды окружения.
Что делает команда remote-control
- Команда claude remote-control переводит терминальный агент Claude Code в режим удаленного сервера. Агент регистрирует защищенную сессию в облачной инфраструктуре Anthropic и ожидает входящих команд.
- Управление сессией происходит через веб-интерфейс claude.ai или официальное мобильное приложение Claude. Разработчик отправляет промпты и задачи через графический клиент, а сам код, тесты и сборка выполняются на удаленной машине, где запущен процесс.
- Для работы удаленного режима требуется активная платная подписка Pro, Max, Team или Enterprise. Предварительная авторизация на сервере выполняется стандартной командой claude auth login.
Как устроен новый флаг --settings
- Параметр --settings задает фиксированный путь к файлу настроек JSON, который принудительно применяется к каждой новой сессии, создаваемой демоном remote-control.
- В конфигурационном файле фиксируются разрешения: запрет опасных команд вне песочницы, правила подтверждения действий, списки разрешенных и запрещенных доменов, а также подключаемые серверы Model Context Protocol (MCP).
- Ключевое свойство нового механизма — строгая валидация неизменности конфигурации. Если файл на диске модифицируется во время работы демона, Claude Code блокирует запуск любых новых сессий до ручного перезапуска процесса claude remote-control. Это исключает тихую подмену политик безопасности на работающем сервере.
Подготовка единого конфигурационного файла
Перед запуском демона создается файл конфигурации с перечнем обязательных политик. Пример строгого файла settings.json с отключением выполнения команд без песочницы:
{
"permissions": {
"allowUnsandboxedCommands": false
}
}
Такой файл исключает выполнение команд с прямым доступом к хостовой системе мимо изолированного окружения.
Список изменений релиза Claude Code 2.1.321. Источник: anthropics/claude-code на GitHub
Запуск постоянного агента и связывание сессий
- Запуск демона выполняется командой с указанием пути к подготовленной конфигурации:
claude remote-control --settings /etc/claude/agent-settings.json
- При первом старте процесс выводит инструкции в консоль и формирует идентификатор подключения. В версии 2.1.321 разработчики обновили подсказки первого запуска: теперь агент подробно выводит список дальнейших действий при отсутствии ответа на стартовый вопрос.
- После подтверждения сессия отображается в списке активных устройств на портале claude.ai. Все сессии, открытые через веб-интерфейс, наследуют параметры из указанного файла agent-settings.json.
- Если файл настроек обновляется (например, централизованно через Ansible или Puppet), демон фиксирует изменение и прекращает прием новых задач с ошибкой. Для вступления изменений в силу фоновый процесс перезапускается системным менеджером вроде systemd или supervisord.
Безопасность удаленного агента в версии 2.1.321
- Вместе с флагом настроек в релизе 2.1.321 закрыли сразу несколько уязвимостей и ограничений удаленного режима.
- Фиксация рабочей папки: подключенный удаленный клиент больше не может переключить сессию в произвольную директорию на хосте. Сессия строго изолирована внутри того каталога, в котором был запущен процесс claude remote-control.
- Защита OAuth-токенов MCP: исправлена ошибка, из-за которой refresh-токены и секреты могли утекать на сторонние узлы при HTTP-редиректах серверов MCP.
- Устойчивость к сбоям: процесс, аварийно завершивший работу, быстрее восстанавливает сессию и подхватывает новые входящие сообщения из очереди.
- Корректная обработка очереди: сообщения, отправленные с пометкой «Queue for later», больше не вклиниваются в ответы модели посреди текущего хода.
Другие изменения релиза 2.1.321
- Параллельно с инструментами удаленного управления Anthropic добавила модель Claude Fable 5.2 (claude-fable-5-2). Она стала стандартной моделью линейки Fable с контекстным окном в 1 млн токенов.
- Тарифы Fable 5.2 составляют $8 за миллион входных токенов и $40 за миллион выходных токенов при стоимости чтения кэша $0.20 за миллион токенов.
- В интерфейсе Claude Code также доработали меню /model: список устаревших моделей теперь свернут в отдельный пункт «More models» под основными позициями.
Всё самое интересное — в нашем Telegram-канале «Claude без воды».