Облачные сессии Claude Code запускаются на ваших хостах

Anthropic описала self-hosted environments для Claude Code: облачные сессии выполняются на инфраструктуре организации, а забирают их раннер-процессы, которые команда разворачивает сама. Быстрый старт в документации Claude разбирает минимальную рабочую схему: один раннер на одном хосте и одна тестовая сессия, которую на этот хост направляют.

Коротко

• Раннер входит в стандартный бинарник claude, но подкоманду self-hosted-runner распознают только сборки 2.1.224 и новее; на более старых версиях команда выводит обычную справку claude --help.
• Хосту нужны Linux или macOS, git 2.24 или новее, исходящий HTTPS до api.anthropic.com, claude.ai и git-сервера, а также часы по NTP: расхождение больше пяти минут ломает аутентификацию.
• Доступ открывает Owner переключателем Allow self-hosted environments на админ-странице Cloud environments: пока он выключен, кнопка New для создания среды в интерфейсе claude.ai просто не появляется.

Self-hosted-раннеры закрывают разрыв между удобством облачных сессий и требованиями команд, которым нельзя выпускать код и доступы за периметр: выполнение переезжает на собственные хосты, а claude.ai остаётся управляющей плоскостью. Судя по набору требований, Anthropic рассчитывает на инфраструктурные команды, а не на отдельных разработчиков: настройка предполагает права Owner, контроль исходящего трафика и оркестратор, который поднимает раннер после каждого завершения. Порог входа при этом низкий: одна машина и один процесс.

Гид по настройке поднимает раннер и пишет шпаргалку в ./runner-setup/CHEAT-SHEET.md

В Claude Code встроен гид: интерактивная сессия проводит через создание среды в админ-интерфейсе, запускает локальный раннер с сохранённым файлом секрета, подтверждает его регистрацию и пишет шпаргалку в ./runner-setup/CHEAT-SHEET.md. Запускать гид нужно там, где выполнен вход через claude auth login под учётной записью с ролью Owner. Если роли нет, среду создаёт тот, у кого она есть, и передаёт секрет: шагам с раннером и терминалом роль в claude.ai не нужна.

Гид недоступен с API-ключами и сторонними провайдерами моделей, а на версиях старше 2.1.224 setup-команда вместо него запускает обычную сессию Claude, подставляя её слова как промпт. Для хостов, где интерактивная сессия невозможна, описан ручной путь. Готовность хоста проверяют вызовом раннера: исправная установка печатает справку с флагами, в том числе --environment-secret-file.

Канал latest получает релизы сразу, stable и Homebrew отстают примерно на неделю

Раннер входит в стандартный бинарник claude, поэтому отдельной установки нет, но версия должна быть 2.1.224 или новее. Канал latest у нативного установщика получает каждый релиз в момент публикации; канал stable, cask claude-code в Homebrew и стабильные репозитории apt, dnf и apk отстают примерно на неделю. Для фиксации одной версии по всему парку документация отсылает к установке конкретного релиза, а для образов контейнеров к Dockerfile со страницы про production.

Windows в роли хоста раннера не поддерживается: вместо него предлагают запускать раннер в Linux-контейнере. Рабочие станции разработчиков менять не нужно, поскольку сессии стартуют из браузера на claude.ai. Организации при этом требуется подключение GitHub, чтобы разработчики могли выбирать репозитории при запуске сессий.

Раннер завершается по замыслу, а follow-up в сессию отправляется из CLI

Работа делится между двумя поверхностями: claude.ai для создания среды, проверки статуса и маршрутизации сессии, и терминал на хосте для всего, что делает раннер. Сам раннер по замыслу выходит, когда его активные сессии завершены, поэтому для эксплуатации его держат под оркестратором, перезапускающим процесс.

Отправить дополнительное сообщение в идущую сессию можно из CLI claude на любой машине с выполненным claude auth login; запускать команду с того же хоста, где сессия стартовала, не требуется. Команда отправляет одно сообщение и принимает идентификатор вида session_ или cse_ либо ссылку claude.ai/code.

Успешная отправка выводит строку Sent to cloud session. с идентификатором сессии и ссылкой на просмотр. Форматы идентификаторов, вывод в JSON, требования к учётной записи и политике, а также справочник ошибок вынесены на отдельную страницу, поскольку команда одинаково работает и с сессиями, размещёнными у Anthropic.

Что описано на странице про production Перед подключением реальных репозиториев и внутренних систем документация отправляет к разделу Deploy to production: там разобраны модель безопасности, контроль исходящего трафика, git-учётные данные и запуск парка раннеров под Kubernetes или Compose. Отдельные страницы описывают кастомизацию сессий: скрипты-обёртки, хуки жизненного цикла, раннеры по требованию, MCP-серверы и права, а также сквозной smoke-тест в CI. Ограничений по числу раннеров и сред быстрый старт не называет.