Skip to main content
Самостоятельно размещаемые окружения находятся в публичной бета-версии на планах Team и Enterprise; Доступность и ограничения охватывает путь включения. На этой странице вы запустите свой первый сеанс; см. Самостоятельно размещаемые окружения для понимания того, что это такое, и Развёртывание в production для укрепления и рецептов флота.
Самостоятельно размещаемое окружение запускает облачные сеансы Claude Code на инфраструктуре, которой управляет ваша организация, выполняемые процессами runner, которые вы развёртываете. Этот быстрый старт настраивает ваше первое окружение, самое маленькое из работающих: один runner на одном хосте, запускающий один тестовый сеанс. Есть два шага: создайте окружение, запустите runner и маршрутизируйте сеанс на него, затем отправьте сообщение этому сеансу из вашего терминала. Вы будете переключаться между двумя интерфейсами: claude.ai для создания окружения, проверки его статуса и маршрутизации сеанса, и терминалом на хосте для всего, что делает runner. К концу у вас будет окружение на странице администратора Cloud environments, runner, опрашивающий работу, и сеанс, работающий на вашем хосте. Прежде чем подключать реальные репозитории или внутренние системы, пройдите Развёртывание в production, которое охватывает позицию безопасности, контроль исходящего трафика, учётные данные git и оркестрацию.

​
Предварительные требования

​
Организация и роли

Для claude.ai требуется:
  • Allow self-hosted environments включено Владельцем на странице администратора Cloud environments; кнопка New не появляется, пока это не будет сделано. Если у вас нет этой роли, кто-то, кто её имеет, может создать окружение и передать вам его секрет; шаги runner и terminal на этой странице не требуют роли claude.ai, и там, где шаг проверяет статус в интерфейсе администратора, собственные строки логов runner дают вам тот же сигнал.
  • Коннектор GitHub, включённый пользователем с ролью Owner, и собственное подключение GitHub каждого разработчика, чтобы они могли выбирать репозитории github.com при запуске сессий.

​
Хост и сеть

Хост runner требует:
  • Хост или контейнер Linux или macOS с исходящим HTTPS к api.anthropic.com, к claude.ai и хостам загрузки, на которые он перенаправляет для шага установки ниже, и к вашему git-хосту для клонирования; таблица требований к сети содержит полный список. Windows не поддерживается в качестве хоста runner; запустите runner в контейнере Linux вместо этого. Рабочие станции разработчиков не затронуты, так как сеансы запускаются из claude.ai в браузере.
  • Репозиторий для тестовой сессии: публичный или такой, который этот хост уже может клонировать по его HTTPS URL без запроса учётных данных. Одного SSH-ключа недостаточно, поскольку runner клонирует https:// URL репозитория. Чтобы вместо этого клонировать по SSH, см. Rewrite git URLs for private networks.
  • Часы, синхронизированные с реальным временем, например с помощью NTP. Аутентификация не удаётся, когда часы отстают или спешат более чем на пять минут; см. Troubleshooting.

​
Программное обеспечение на хосте runner

Установите на хост перед началом:
  • Claude Code v2.1.224 или позже, с любым из стандартных методов установки. Runner является частью стандартного бинарного файла claude, и более ранние версии не распознают подкоманду self-hosted-runner. Канал latest встроенного установщика содержит каждый выпуск сразу после его публикации; канал stable, cask Homebrew claude-code и стабильные репозитории apt, dnf и apk отстают примерно на неделю. Чтобы зафиксировать точную версию, которую запускает ваш парк, см. Install a specific version. Для образов контейнеров см. Dockerfile в Deploy to production.
  • Git 2.24 или новее. Некоторые опции git на странице развёртывания требуют более новых версий; Configure git указывает каждый минимум.
Подтвердите, что хост готов:
Готовый хост выводит текст использования runner, перечисляя флаги такие как --environment-secret-file. На версиях старше 2.1.224 команда выводит вместо этого общий вывод claude --help; обновитесь с помощью claude update или переустановите из канала latest.

​
Настройка окружения и runner

Используйте либо пошаговую настройку, либо ручные шаги. Пошаговая настройка — это одна команда, которая запускает интерактивную сессию Claude Code и проводит вас через остальные действия. Используйте вместо неё ручные шаги на хосте, где интерактивная сессия невозможна. Также используйте их, если окружение создал пользователь с ролью Owner и передал вам его секрет, поскольку для пошаговой настройки требуется вход с ролью Owner.

​
Запуск пошаговой настройки

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