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

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

По умолчанию облачная сессия запускается в изолированной виртуальной машине под управлением Anthropic. В self-hosted варианте сессию тоже запускают с claude.ai в браузере, но маршрутизируют на ваш хост, поэтому рабочие станции разработчиков настройка не затрагивает. Работа идёт в двух местах. На claude.ai окружение создают, проверяют его статус и направляют в него сессию. Всё, что делает раннер, происходит в терминале на хосте. В итоге окружение появляется на админ-странице Cloud environments, раннер опрашивает сервер в ожидании задач, а сессия выполняется на вашей машине.

Начинать нужно с прав. Переключатель Allow self-hosted environments на странице Cloud environments включает Owner, и пока он выключен, кнопки New там нет. Если роли Owner у вас нет, окружение может создать тот, у кого она есть, и передать вам его секрет. Шагам с раннером и терминалом роль на claude.ai не нужна, а там, где документ предлагает проверить статус в админке, тот же сигнал дают строки лога самого раннера. Ещё организации нужно подключение к GitHub, иначе разработчики не смогут выбирать репозитории при старте сессии.

Хостом может быть машина или контейнер на Linux или macOS. От него нужен исходящий HTTPS до api.anthropic.com, до claude.ai и хостов загрузки, на которые тот перенаправляет при установке, и до вашего git-сервера для клонирования. Полный список адресов вынесен в отдельную таблицу сетевых требований. Windows в роли хоста раннера не поддерживается, вместо этого раннер запускают в Linux-контейнере. Часы хоста синхронизируют с реальным временем, например через NTP: если они уходят больше чем на пять минут, аутентификация не проходит.

Отдельно ставить раннер не нужно, он входит в обычный бинарник claude. Однако подкоманду self-hosted-runner знает только Claude Code v2.1.224 и новее. Канал latest нативного установщика получает каждый релиз сразу после публикации. Канал stable, Homebrew-cask claude-code и стабильные репозитории apt, dnf и apk отстают примерно на неделю, так что нужная версия могла дойти туда позже. Для фиксации версии на всём парке машин есть отдельная инструкция, а Dockerfile для контейнерных образов лежит в разделе Deploy to production. Git нужен версии 2.24 или новее, а некоторым опциям из production-раздела нужны версии свежее.

Готовность хоста проверяют вызовом подкоманды раннера. Если всё в порядке, она выводит справку по своим флагам, среди которых --environment-secret-file. Версии старше 2.1.224 вместо неё печатают общий claude --help. В таком случае поможет claude update или переустановка из канала latest.

Дальше два пути. Пошаговая настройка запускает интерактивную сессию Claude Code: она проводит через создание окружения в админке, поднимает локальный раннер с сохранённым вами файлом секрета, проверяет, что раннер зарегистрировался, и записывает шпаргалку в ./runner-setup/CHEAT-SHEET.md. Запускать её нужно на машине, где выполнен claude auth login под аккаунтом с ролью Owner. С API-ключами и сторонними провайдерами моделей она не работает. На старых версиях та же команда запустит обычную сессию Claude и отдаст ей слова команды как промпт, поэтому сначала стоит пройти проверку версии. Где интерактивная сессия невозможна, есть ручные шаги.

Раннер завершает работу, когда заканчиваются его активные сессии, и так задумано. В продакшене его ставят под оркестратор, который перезапускает процесс после выхода. Документация разбирает развёртывание под Kubernetes и Compose.

Когда сессия уже работает в окружении, дописать ей можно из CLI claude на любой машине, где выполнен вход через claude auth login. Это не обязательно та машина, с которой сессию запускали. Команда отправляет одно сообщение. Сессию указывают голым ID вида session_... или cse_... либо её адресом на claude.ai/code. При успехе CLI печатает «Sent to cloud session.» с ID сессии и ссылкой для просмотра. С сессиями на серверах Anthropic команда работает так же.

Следующие разделы описывают настройку сессий (обёртки, lifecycle hooks, раннеры по запросу, MCP-серверы, права) и CI-смоук-тест, который отправляет сессию и читает ответы Claude. Но прежде чем подключать настоящие репозитории и внутренние системы, Anthropic советует пройти Deploy to production: модель безопасности, контроль исходящего трафика, git-учётные данные и оркестрацию.