34Хост runner требует:34Хост runner требует:

35 35 

36* Хост или контейнер Linux или macOS с исходящим HTTPS к `api.anthropic.com`, к `claude.ai` и хостам загрузки, на которые он перенаправляет для шага установки ниже, и к вашему git-хосту для клонирования; [таблица требований к сети](/docs/ru/self-hosted-environments-deploy#network-requirements) содержит полный список. Windows не поддерживается в качестве хоста runner; запустите runner в контейнере Linux вместо этого. Рабочие станции разработчиков не затронуты, так как сеансы запускаются из claude.ai в браузере.36* Хост или контейнер Linux или macOS с исходящим HTTPS к `api.anthropic.com`, к `claude.ai` и хостам загрузки, на которые он перенаправляет для шага установки ниже, и к вашему git-хосту для клонирования; [таблица требований к сети](/docs/ru/self-hosted-environments-deploy#network-requirements) содержит полный список. Windows не поддерживается в качестве хоста runner; запустите runner в контейнере Linux вместо этого. Рабочие станции разработчиков не затронуты, так как сеансы запускаются из claude.ai в браузере.

37* Репозиторий для тестовой сессии: публичный или такой, который этот хост уже может клонировать по его HTTPS URL без запроса учётных данных.

37* Часы, синхронизированные с реальным временем, например с помощью NTP. Аутентификация не удаётся, когда часы отстают или спешат более чем на пять минут; см. [Troubleshooting](/docs/ru/self-hosted-environments-deploy#troubleshooting).38* Часы, синхронизированные с реальным временем, например с помощью NTP. Аутентификация не удаётся, когда часы отстают или спешат более чем на пять минут; см. [Troubleshooting](/docs/ru/self-hosted-environments-deploy#troubleshooting).

38 39 

39<h3 id="software-on-the-runner-host">40<h3 id="software-on-the-runner-host">

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

58</h2>59</h2>

59 60 

60Claude Code включает управляемую установку: интерактивный сеанс Claude Code, который проведёт вас через создание окружения в админ-интерфейсе, запустит локальный runner с файлом секрета, который вы сохраняете, подтвердит, что runner регистрируется, и напишет шпаргалку в `./runner-setup/CHEAT-SHEET.md`. Запустите его на машине, где вы вошли с помощью `claude auth login`, используя учётную запись, которая имеет роль Owner; это недоступно с API ключами или поставщиками моделей третьих сторон. На хостах, где интерактивный сеанс невозможен, используйте вместо этого ручные шаги ниже. Сначала подтвердите, что [проверка версии](#software-on-the-runner-host) прошла: на версиях старше 2.1.224 эта команда запускает обычный сеанс Claude со словами в качестве подсказки вместо управляемой установки. Чтобы запустить управляемую установку, запустите подкоманду setup и следуйте подсказкам:61Используйте либо [пошаговую настройку](#run-the-guided-setup), либо [ручные шаги](#set-up-manually). Пошаговая настройка — это одна команда, которая запускает интерактивную сессию Claude Code и проводит вас через остальные действия. Используйте вместо неё ручные шаги на хосте, где интерактивная сессия невозможна. Также используйте их, если окружение создал пользователь с ролью Owner и передал вам его секрет, поскольку для пошаговой настройки требуется вход с ролью Owner.

62 

63<h3 id="run-the-guided-setup">

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

65</h3>

66 

67Пошаговая настройка проводит вас через создание окружения в админ-интерфейсе, запускает локальный runner с файлом секрета, который вы сохраняете, подтверждает, что runner регистрируется, и записывает шпаргалку в `./runner-setup/CHEAT-SHEET.md`. Перед запуском проверьте вход и версию:

68 

69* **Вход**: запускайте её на машине, где вы вошли с помощью `claude auth login`, используя учётную запись с ролью Owner. Если используется только API-ключ или сторонний поставщик моделей, сессия запустится, но проверки организации завершатся неудачей.

70* **Версия**: убедитесь, что [проверка версии](#software-on-the-runner-host) пройдена. На версиях старше 2.1.224 команда setup запускает сессию Claude с этими словами в качестве промпта вместо пошаговой настройки.

71 

72Чтобы запустить пошаговую настройку, выполните подкоманду setup в оболочке и следуйте инструкциям:

61 73 

62```bash theme={null}74```bash theme={null}

63claude self-hosted-runner setup75claude self-hosted-runner setup

64```76```

65 77 

66Для ручной настройки вместо этого:78Пошаговая настройка сама не запускает тестовую сессию: она предлагает вам запустить её на claude.ai/code. Последний шаг настройки останавливает запущенный ею runner. Если вы выйдете из настройки до этого шага, runner продолжит работать. Чтобы продолжить после последнего шага, снова запустите runner в оболочке с помощью команды из `./runner-setup/CHEAT-SHEET.md`, затем [направьте сессию в окружение](#route-a-session).

79 

80<h3 id="set-up-manually">

81 Ручная настройка

82</h3>

83 

84Создайте окружение на claude.ai, запустите runner из терминала на хосте, затем вернитесь на claude.ai, чтобы убедиться, что runner появился, и направить на него сессию. Если пользователь с ролью Owner уже создал окружение и передал вам его секрет, начните с шага 2.

67 85 

68<Steps>86<Steps>

69 <Step title="Создайте окружение">87 <Step title="Создайте окружение">

70 Перейдите на [страницу **Cloud environments**](https://claude.ai/admin-settings/cloud-environments) в параметрах администратора. В разделе **Self-hosted environments** выберите **New**, назовите окружение и выберите **Create**. На втором шаге мастера выберите **Copy environment key**, чтобы скопировать секрет окружения, который админ-интерфейс обозначает как ключ окружения. claude.ai показывает секрет один раз, и вы не можете получить его позже; он истекает через 365 дней после создания. ID окружения `ccpool_...` остаётся видимым в его диалоговом окне деталей; вам понадобится он для проверки `aud` в [проверке токена](/docs/ru/self-hosted-environments-identity) и для отправки [тестовых сеансов из CI](/docs/ru/self-hosted-environments-testing#run-the-test-loop).88 Перейдите на [страницу **Cloud environments**](https://claude.ai/admin-settings/cloud-environments) в параметрах администратора. В разделе **Self-hosted environments** выберите **New**, назовите окружение и выберите **Create**. На втором шаге мастера выберите **Copy environment key**, чтобы скопировать секрет окружения, который админ-интерфейс обозначает как ключ окружения. claude.ai показывает секрет один раз, и вы не можете получить его позже; он истекает через 365 дней после создания. ID окружения `ccpool_...` остаётся видимым в его диалоговом окне деталей; вам понадобится он для проверки `aud` в [проверке токена](/docs/ru/self-hosted-environments-identity) и для отправки [тестовых сеансов из CI](/docs/ru/self-hosted-environments-testing#run-the-test-loop).

71 89 

72 Если вы потеряли секрет или вам нужно его ротировать, создайте новый секрет на вкладке **Configuration** окружения, разверните новый секрет на ваших runners, затем отозовите старый. Runners, держащие отозванный секрет, не пройдут свой следующий аутентифицированный опрос и выйдут, логируя `poll auth failed`, и ваш оркестратор перезапустит их с новым секретом.90 Если вы потеряли секрет или вам нужно его ротировать, создайте новый секрет на вкладке **Configuration** окружения, разверните новый секрет на ваших runners, затем отзовите старый. Runners с отозванным секретом не пройдут следующий аутентифицированный опрос и завершатся, записав в лог `poll auth failed`, а ваш оркестратор перезапустит их с новым секретом.

73 </Step>91 </Step>

74 92 

75 <Step title="Запустите runner">93 <Step title="Запустите runner">

76 Создайте директорию секрета. Этот шаг и следующий требуют root для пути `/etc/claude`; любой путь, который процесс runner может читать, работает, поэтому отрегулируйте обе команды и значение `--environment-secret-file` вместе, если вы используете другой.94 Создайте директорию для секрета. Эта и следующая команды используют `/etc/claude`, что требует root, а создаваемый ими файл секрета доступен для чтения только пользователю, который их выполнил. Если runner будет работать от имени другого пользователя, он завершится с ошибкой `error: Failed to read environment secret file <path> (EACCES: permission denied, open '<path>')`. В этом случае выполните обе команды от имени пользователя runner, указав вместо `/etc/claude` директорию, в которую этот пользователь может записывать, и передайте тот же путь в `--environment-secret-file`. Подойдёт любой путь, который процесс runner может читать.

77 95 

78 ```bash theme={null}96 ```bash theme={null}

79 mkdir -p /etc/claude97 mkdir -p /etc/claude

89 107 

90 Если runner не может создать или писать в путь, он выходит при запуске с ошибкой, называющей директорию вместо регистрации. См. [Troubleshooting](/docs/ru/self-hosted-environments-deploy#troubleshooting).108 Если runner не может создать или писать в путь, он выходит при запуске с ошибкой, называющей директорию вместо регистрации. См. [Troubleshooting](/docs/ru/self-hosted-environments-deploy#troubleshooting).

91 109 

92 Затем запустите runner с `--environment-secret-file` и `--base-dir`. Runner регистрируется в вашем окружении и начинает опрашивать работу. Если runner выходит, перезапустите его вручную. Production развёртывания запускают runner под оркестратором, который перезапускает вышедшие runners, обычно со свежей файловой системой при каждом перезапуске; [Reuse a pre-warmed checkout](/docs/ru/self-hosted-environments-deploy#reuse-a-pre-warmed-checkout) охватывает поддерживаемую настройку постоянного диска.110 Затем запустите runner с `--environment-secret-file` и `--base-dir`:

93 111 

94 ```bash theme={null}112 ```bash theme={null}

95 claude self-hosted-runner --environment-secret-file '/etc/claude/environment-secret' --base-dir '<writable-dir>'113 claude self-hosted-runner --environment-secret-file '/etc/claude/environment-secret' --base-dir '<writable-dir>'

96 ```114 ```

115 

116 После регистрации в вашем окружении runner записывает в лог `Registered: runner_id=<runner-id>`, а затем начинает опрашивать наличие работы. Если runner позже завершится, перезапустите его вручную. О том, когда это происходит, см. [Если runner завершился](#if-the-runner-exits).

97 </Step>117 </Step>

98 118 

99 <Step title="Проверьте, что runner появился">119 <Step title="Проверьте, что runner появился">

100 Вернитесь на [страницу **Cloud environments**](https://claude.ai/admin-settings/cloud-environments). Статус вашего окружения изменяется с **No runners deployed** на **Healthy** в течение нескольких секунд после запуска runner; откройте окружение и выберите **Activity**, чтобы увидеть сам runner.120 Вернитесь на [страницу **Cloud environments**](https://claude.ai/admin-settings/cloud-environments). Статус вашего окружения изменится с **No runners deployed** на **Healthy** в течение нескольких секунд после запуска runner; откройте окружение и выберите **Activity**, чтобы увидеть сам runner. Если у вас нет доступа к странице администратора, тот же сигнал даёт строка `Registered: runner_id=<runner-id>` в логе runner из предыдущего шага.

101 </Step>121 </Step>

102 122 

103 <Step title="Маршрутизируйте сеанс на окружение">123 <Step title="Направьте сессию в окружение">

104 Запустите сеанс на claude.ai/code и выберите ваше окружение из средства выбора окружения, где самостоятельно размещаемые окружения появляются рядом с размещаемыми Anthropic. Runner клонирует с любыми учётными данными git, которые хост уже имеет, поэтому выберите репозиторий, который этот хост уже может клонировать, или публичный; опции учётных данных для приватных репозиториев в production находятся на [Configure git](/docs/ru/self-hosted-environments-deploy#configure-git). Следующий доступный runner подхватывает поставленный в очередь сеанс и логирует `Picked up session <session-id>` вместе с его активным счётом и ёмкостью, поэтому вы можете подтвердить из собственного вывода runner, какой хост взял сеанс. Смотрите, как работает сеанс, и читайте ответы Claude на [claude.ai/code](https://claude.ai/code). Если сеанс остаётся в очереди вместо этого, см. [Troubleshooting](/docs/ru/self-hosted-environments-deploy#troubleshooting).124 <span id="route-a-session" />Запустите сессию на claude.ai/code и выберите ваше окружение в средстве выбора окружения, где самостоятельно размещаемые окружения отображаются рядом с размещаемыми Anthropic. В качестве репозитория выберите указанный в [предварительных требованиях](#host-and-network): публичный репозиторий или тот, который этот хост уже может клонировать. Runner клонирует с теми учётными данными git, которые уже есть на хосте.

125 

126 Следующий доступный runner подхватывает поставленную в очередь сессию и записывает в лог `Picked up session <session-id>` вместе с числом активных сессий и ёмкостью, поэтому по собственному выводу runner можно определить, какой хост взял сессию. Наблюдайте за работой сессии и читайте ответы Claude на [claude.ai/code](https://claude.ai/code).

127 

128 Если сессия не начинает работу, сопоставьте то, что вы видите:

129 

130 * **Сессия остаётся в очереди**: см. [Устранение неполадок](/docs/ru/self-hosted-environments-deploy#troubleshooting).

131 * **Сессия не запускается из-за ошибки git**: ошибка отображается в сессии и в логе runner. Если она содержит `could not read Username for` из git, за которым следует URL вашего git-хоста, у runner не было учётных данных HTTPS для этого хоста. См. [Configure git](/docs/ru/self-hosted-environments-deploy#configure-git), где также описаны варианты учётных данных для приватных репозиториев в production.

105 </Step>132 </Step>

106</Steps>133</Steps>

107 134 

108Runner выходит по дизайну после завершения его активных сеансов; см. [Runner lifecycle](/docs/ru/self-hosted-environments#runner-lifecycle). Для production развёртывайте его под оркестратором, который перезапускает его при выходе и ждёт дольше между перезапусками, когда runner продолжает выходить сразу после запуска. См. [Deploy to production](/docs/ru/self-hosted-environments-deploy) и [When the runner exits](/docs/ru/self-hosted-environments-deploy#when-the-runner-exits).135<h3 id="if-the-runner-exits">

136 Если runner завершился

137</h3>

138 

139Если runner завершится во время этого быстрого старта, запустите его снова той же командой. Runner может завершиться самостоятельно:

140 

141* **Сессии завершены**: в логе отображается `[runner:exit] account workload drained — exiting`. Runner по задумке завершается после окончания его активных сессий. См. [Runner lifecycle](/docs/ru/self-hosted-environments#runner-lifecycle).

142* **Потеряна связь**: в логе отображается строка `[runner:fatal]` с `runner record gone server-side` или с `poll auth failed`. Если runner на некоторое время теряет связь с Anthropic, например потому что хост перешёл в спящий режим, он может завершиться при следующем обращении к Anthropic.

143 

144Завершённый ход не завершает вашу тестовую сессию. После первого хода сессия остаётся подключённой, а runner продолжает работать, поэтому вы можете [отправить сессии следующее сообщение](#send-a-follow-up-message-to-a-running-session), не перезапуская runner.

145 

146Для production развёртывайте runner под оркестратором, который перезапускает его при завершении и увеличивает паузу между перезапусками, если runner продолжает завершаться сразу после запуска. См. [Deploy to production](/docs/ru/self-hosted-environments-deploy) и [When the runner exits](/docs/ru/self-hosted-environments-deploy#when-the-runner-exits).

109 147 

110<h2 id="send-a-follow-up-message-to-a-running-session">148<h2 id="send-a-follow-up-message-to-a-running-session">

111 Отправьте follow-up сообщение работающему сеансу149 Отправьте follow-up сообщение работающему сеансу