Запуск Claude Code через корпоративный launcher

​

Что охватывает launcher

• Фоновый сервис, который запускают claude agents и фоновые сеансы по требованию.
• Хост терминала и сеанс Claude Code внутри каждой строки agent view, включая теплые резервные сеансы, которые сервис держит в готовности.
• Сеансы, которые сервис перезапускает после обновления или сбоя.
• Перезапуск, который Claude Code выполняет сам по себе, чтобы завершить установку обновления, включая действие restart-for-update в agent view.

​

Процессы, которые запускаются вне launcher

• Установленный фоновый сервис: launchd или systemd запускает этот процесс из его файла unit. /status и claude daemon status предупреждают, когда это применяется, и сеансы, которые запускает сервис, все еще запускаются через launcher после перезагрузки сервиса с переменной в его параметрах.
• Сеанс, который вы запускаете сами в терминале, который работает так, как вы его вызвали. Чтобы охватить эти сеансы, поместите скрипт с именем claude в каталог, который находится раньше в PATH, который запускает ваш launcher с реальным бинарным файлом; не заменяйте управляемый symlink. Self-spawns не консультируют PATH, поэтому два launcher никогда не складываются.
• Первый процесс claude-cli:// deep link, который обработчик протокола операционной системы запускает напрямую. Все, что этот сеанс запускает в фоне после этого, работает через launcher. Чтобы полностью закрыть этот путь, предотвратите регистрацию обработчика с помощью параметра disableDeepLinkRegistration.

​

Имена вспомогательных процессов в мониторах процессов

​

Настройка launcher

#!/bin/sh
# Настройка вашей организации: введите sandbox, примените
# сетевые элементы управления или внедрите учетные данные.
exec "$@"

{
  "env": {
    "CLAUDE_CODE_PROCESS_WRAPPER": "/opt/corp/launcher"
  }
}

​

Контракт launcher

• Заканчивайте с exec "$@". Launcher, который разветвляет дочерний процесс и выходит, оставляет сиротский процесс Claude Code, который фоновый сервис не может отследить. Agent view отмечает такой сеанс как неудачный с сообщением, называющим launcher, и сервис собирает то, что launcher оставил позади.
• Не переупорядочивайте, не поглощайте и не добавляйте аргументы в начало. Первый аргумент — это бинарный файл Claude Code, и все после него — это его argv.
• Передайте каждую унаследованную переменную окружения через exec. Добавление переменных, таких как внедренные учетные данные, хорошо; отбрасывание унаследованных — нет.
  • Токены аутентификации для каждого сеанса, выбор модели и поставщика, и сам CLAUDE_CODE_PROCESS_WRAPPER все путешествуют в унаследованной среде, поэтому launcher, который перестраивает ее из списка разрешений, нарушает сеансы, которые он запускает, и /status сообщает о несоответствии launcher.
  • Если launcher должен войти в пространство имен или sandbox, который сбрасывает окружение, повторно экспортируйте унаследованное окружение внутри него дословно.
• Достигните exec примерно за три секунды каждый раз, когда запускается launcher. Холодная фоновая отправка запускает launcher дважды подряд перед первым байтом вывода, поэтому выполняйте медленную работу, такую как обмен единственным входом, лениво или из кэша.
  • Launcher, который работает далеко за пределами бюджета, рассматривается как застопоренный старт и перезагружается.
• Допускайте вызов изнутри себя. Claude Code применяет launcher к каждому вложенному self-spawn, поэтому launcher, который получает исключительный ресурс, должен обнаружить, что он его уже держит.
• Не пишите в терминал перед запуском Claude Code. Все, что напечатано перед exec, сообщается как причина сбоя, если сеанс умирает перед инициализацией.

​

Формат значения CLAUDE_CODE_PROCESS_WRAPPER

• Пробелы разделяют токены, а двойные кавычки группируют токен, содержащий пробелы.
• Значение, которое начинается с [, читается как массив строк JSON, например ["/opt/corp/launcher", "--profile", "cc"].
• Синтаксис shell не работает: нет расширения переменных или глобализации, и неквотированный оператор, такой как ;, |, & или $(, отклоняется как ошибка конфигурации, а не переинтерпретируется.

​

Отношение к CLAUDE_CODE_SHELL_PREFIX

​

Связанные ресурсы

• Agent view: фоновые сеансы и процесс supervisor, который охватывает launcher
• Environment variables: запись справки CLAUDE_CODE_PROCESS_WRAPPER
• Managed settings: доставьте блок env по всему парку
• Launcher error reference: сообщения об отказе и способы восстановления