Claude Code с GitHub Enterprise Server

Поддержка GitHub Enterprise Server доступна для планов Team и Enterprise.

Поддержка GitHub Enterprise Server (GHES) позволяет вашей организации использовать Claude Code с репозиториями, размещёнными на вашем самоуправляемом экземпляре GitHub вместо github.com. После того как администратор подключит ваш экземпляр GHES, разработчики смогут запускать веб-сессии и получать автоматизированные проверки кода без какой-либо конфигурации для каждого репозитория. Маркетплейсы плагинов, размещённые на вашем экземпляре, также поддерживаются; требования к учётным данным различаются в зависимости от поверхности, как описано в Plugin marketplaces on GHES. Для репозиториев на github.com см. Claude Code в веб-интерфейсе и Проверка кода. Чтобы запустить Claude в вашей собственной инфраструктуре CI, см. GitHub Actions.

Что работает с GitHub Enterprise Server

В таблице ниже показано, какие функции Claude Code поддерживают GHES и какие различия есть по сравнению с поведением github.com.

Функция	Поддержка GHES	Примечания
Claude Code в веб-интерфейсе	✅ Поддерживается	Администратор подключает экземпляр GHES один раз; разработчики используют `claude --cloud` или claude.ai/code как обычно
Проверка кода	✅ Поддерживается	Те же автоматизированные проверки PR, что и на github.com
Claude Security	✅ Поддерживается	Доступно в открытой бета-версии для планов Enterprise на claude.ai/security
Сессии Teleport	✅ Поддерживается	Перемещайте сессии между веб-интерфейсом и терминалом с помощью `--teleport`
Маркетплейсы плагинов	✅ Поддерживается	Требования к учётным данным различаются в зависимости от поверхности. См. Маркетплейсы плагинов на GHES
Метрики вклада	✅ Поддерживается	Доставляются через webhooks на панель аналитики
GitHub Actions	✅ Поддерживается	Требует ручной настройки workflow; `/install-github-app` доступен только для github.com
GitHub MCP server	❌ Не поддерживается	GitHub MCP server не работает с экземплярами GHES

Настройка администратором

Администратор подключает ваш экземпляр GHES к Claude Code один раз. После этого разработчики в вашей организации смогут использовать репозитории GHES без какой-либо дополнительной конфигурации. Вам нужна роль Owner или Primary Owner в вашей организации Claude и разрешение на создание GitHub Apps на вашем экземпляре GHES. Управляемая настройка генерирует манифест GitHub App и перенаправляет вас на ваш экземпляр GHES для создания приложения в один клик. Если ваша среда блокирует поток перенаправления, доступна альтернативная ручная настройка.

Откройте параметры администратора Claude Code

Перейдите на claude.ai/admin-settings/claude-code и найдите раздел GitHub Enterprise Server.

Начните управляемую настройку

Нажмите Connect. Введите отображаемое имя для подключения и имя хоста вашего GHES, например github.example.com. Если ваш экземпляр GHES использует самоподписанный сертификат или центр сертификации частного центра, вставьте сертификат CA в дополнительное поле.

Создайте GitHub App

Нажмите Continue to GitHub Enterprise. Ваш браузер перенаправляется на ваш экземпляр GHES с предварительно заполненным манифестом приложения. Проверьте конфигурацию и нажмите Create GitHub App. GHES перенаправляет вас обратно в Claude с автоматически сохранёнными учётными данными приложения.

Установите приложение на ваши репозитории

На странице GitHub App на вашем экземпляре GHES установите приложение на репозитории или организации, к которым вы хотите предоставить Claude доступ. Вы можете начать с подмножества и добавить больше позже.

Включите функции

Вернитесь на claude.ai/admin-settings/claude-code и включите Проверку кода, Claude Security и метрики вклада для ваших репозиториев GHES, используя ту же конфигурацию, что и для github.com.

Разрешения GitHub App

Манифест настраивает GitHub App с разрешениями и событиями webhook, которые Claude требует для веб-сессий, проверки кода, Claude Security и метрик вклада:

Разрешение	Доступ	Используется для
Contents	Чтение и запись	Клонирование репозиториев и отправка веток
Pull requests	Чтение и запись	Создание PR и публикация комментариев проверки
Issues	Чтение и запись	Ответ на упоминания в проблемах
Checks	Чтение и запись	Публикация проверочных запусков Code Review
Actions	Чтение	Чтение статуса CI для автоисправления
Repository hooks	Чтение и запись	Получение webhooks для метрик вклада
Metadata	Чтение	Требуется GitHub для всех приложений

Приложение подписывается на события pull_request, issue_comment, pull_request_review_comment, pull_request_review и check_run.

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

Если управляемый поток перенаправления заблокирован конфигурацией вашей сети, нажмите Add manually вместо Connect. Создайте GitHub App на вашем экземпляре GHES с разрешениями и событиями выше, затем введите учётные данные приложения в форму: имя хоста, OAuth client ID и secret, GitHub App ID, client ID, client secret, webhook secret и private key.

Требования к сети

Ваш экземпляр GHES должен быть доступен из инфраструктуры Anthropic, чтобы Claude мог клонировать репозитории и публиковать комментарии проверки. Если ваш экземпляр GHES находится за брандмауэром, добавьте в список разрешений IP-адреса Anthropic API.

Рабочий процесс разработчика

После того как ваш администратор подключит экземпляр GHES, конфигурация на стороне разработчика не требуется. Claude Code автоматически обнаруживает имя хоста GHES из git remote в вашем рабочем каталоге. Клонируйте репозиторий из вашего экземпляра GHES как обычно:

git clone git@github.example.com:platform/api-service.git
cd api-service

Затем запустите веб-сессию. Claude обнаруживает хост GHES из вашего git remote и маршрутизирует сессию через настроенный экземпляр вашей организации:

claude --cloud "Add retry logic to the payment webhook handler"

Сессия запускается на инфраструктуре Anthropic, клонирует ваш репозиторий из GHES и отправляет изменения обратно в ветку. Отслеживайте прогресс с помощью /tasks или на claude.ai/code. См. Claude Code в веб-интерфейсе для полного рабочего процесса удалённой сессии, включая проверку diff, автоисправление и процедуры.

Телепортируйте сессии в ваш терминал

Перенесите веб-сессию в ваш локальный терминал с помощью claude --teleport. Teleport проверяет, что вы находитесь в checkout того же репозитория GHES, прежде чем получить ветку и загрузить историю сессии. См. требования teleport для получения подробной информации.

Маркетплейсы плагинов на GHES

Размещайте маркетплейсы плагинов на вашем экземпляре GHES для распределения внутренних инструментов по всей вашей организации. Структура маркетплейса идентична маркетплейсам, размещённым на github.com, но установка работает по-разному в зависимости от того, где вы добавляете маркетплейс, и учётные данные различаются на разных поверхностях:

Поверхность	Как работает установка	Что нужно каждому пользователю
Claude Code CLI и десктоп	Claude Code клонирует репозиторий маркетплейса, используя существующие учётные данные git машины	Доступ Git к вашему хосту GHES с их машины
Управляемые параметры (`extraKnownMarketplaces`)	Claude Code регистрирует запись и клонирует репозиторий, используя существующие учётные данные git машины	Доступ Git к вашему хосту GHES с их машины
Параметры плагина организации claude.ai	Владелец выбирает экземпляр GHES в качестве источника; серверная часть Anthropic получает и синхронизирует репозиторий, используя GitHub App из настройки администратора	Ничего для каждого пользователя после добавления. Владельцу, добавляющему его, нужна собственная подключённая учётная запись GitHub Enterprise в качестве проверки доступа, и GitHub App должно быть установлено на репозиторий маркетплейса
Параметры пользователя claude.ai	Серверная часть Anthropic получает репозиторий, используя подключение GitHub Enterprise отправляющего пользователя	Собственная учётная запись GitHub Enterprise, подключённая к Claude
Claude Code в веб-версии	Облачные сеансы клонируют маркетплейсы внутри песочницы сеанса. Песочница может достичь вашего экземпляра GHES только когда репозиторий сеанса находится на том же экземпляре, и его учётные данные git ограничены репозиториями сеанса	Ненадёжно для маркетплейсов, размещённых на GHES: другой хост, чем репозиторий сеанса, недостижим, и даже установки на одном экземпляре могут не пройти. Используйте вместо этого CLI, управляемые параметры или claude.ai

Подключения GitHub Enterprise на claude.ai являются пользовательскими, когда маркетплейс добавляется из параметров пользователя. Настройка администратора подключает ваш экземпляр GHES к вашей организации, но она не подключает отдельные учётные записи пользователей: каждый пользователь, который добавляет маркетплейс GHES из своих собственных параметров, должен сначала подключить собственную учётную запись GitHub Enterprise, и подключение одного пользователя, включая подключение Владельца, не охватывает никого другого. Маркетплейсы, добавленные Владельцем в параметры плагина организации, не накладывают это требование на пользователей, потому что текущие получения используют GitHub App организации. Владельцу, добавляющему маркетплейс, всё ещё нужна собственная подключённая учётная запись GitHub Enterprise во время добавления.

Добавьте маркетплейс GHES

Сокращение owner/repo всегда разрешается на github.com. Для маркетплейсов, размещённых на GHES, используйте полный URL-адрес git. Рекомендуются HTTPS URL-адреса:

/plugin marketplace add https://github.example.com/platform/claude-plugins.git

SSH URL-адреса работают, если машина уже доверяет вашему хосту GHES:

/plugin marketplace add git@github.example.com:platform/claude-plugins.git

Claude Code запускает git неинтерактивно и отклоняет SSH-подключения к хостам, которые отсутствуют в файле known_hosts машины. HTTPS URL-адрес с помощником учётных данных git избегает требования known_hosts. См. Создание и распределение маркетплейса плагинов для полного руководства по созданию маркетплейсов.

Предварительно зарегистрируйте маркетплейсы GHES с управляемыми параметрами

Параметр extraKnownMarketplaces предварительно регистрирует маркетплейс, чтобы разработчики получили его без ручной настройки. Это работает из любого файла параметров, включая .claude/settings.json репозитория; управляемые параметры доставляют его по всей организации:

{
  "extraKnownMarketplaces": {
    "internal-tools": {
      "source": {
        "source": "git",
        "url": "https://github.example.com/platform/claude-plugins.git"
      }
    }
  }
}

Claude Code устанавливает эти маркетплейсы локально: он регистрирует каждую запись и клонирует репозиторий с существующими учётными данными git машины. Этот путь не проходит через claude.ai, поэтому подключение GitHub Enterprise для каждого пользователя не требуется. Для успешного развёртывания:

Используйте полный URL-адрес git. Сокращение owner/repo всегда разрешается на github.com и не может ссылаться на хост GHES.
Предпочитайте HTTPS URL-адреса. SSH-клоны не работают на машинах, которые уже не доверяют ключу хоста GHES. HTTPS URL-адрес с помощником учётных данных git вашей организации работает на любой машине с настроенными учётными данными.
Подтвердите, что каждая машина может клонировать с вашего хоста GHES. Если машине не хватает учётных данных, маркетплейс регистрируется, но никогда не устанавливается, и его плагины сообщают об отсутствии вместо запроса учётных данных.
Подтвердите, что параметр достигает каждой машины. Файл управляемых параметров вступает в силу только на машинах, на которые он развёрнут, например через вашу систему управления устройствами. См. управляемые параметры для расположения файлов.

Добавьте маркетплейсы GHES в список разрешений в управляемых параметрах

Если ваша организация использует управляемые параметры для ограничения того, какие маркетплейсы разработчики могут добавлять, используйте тип источника hostPattern для разрешения всех маркетплейсов из вашего экземпляра GHES без перечисления каждого репозитория:

{
  "strictKnownMarketplaces": [
    {
      "source": "hostPattern",
      "hostPattern": "^github\\.example\\.com$"
    }
  ]
}

См. справочник параметров strictKnownMarketplaces и extraKnownMarketplaces для полной схемы.

Ограничения

Несколько функций работают по-другому на GHES, чем на github.com. Таблица функций суммирует поддержку; в этом разделе рассматриваются обходные пути.

Команда /install-github-app: следуйте потоку настройки администратором на claude.ai вместо этого. Если вы также хотите workflows GitHub Actions на GHES, адаптируйте пример workflow вручную.
GitHub MCP server: используйте вместо этого CLI gh, настроенный для вашего хоста GHES. Запустите gh auth login --hostname github.example.com для аутентификации, затем Claude сможет использовать команды gh в сессиях.

Troubleshooting

Веб-сессия не может клонировать репозиторий

Если claude --cloud завершается с ошибкой клонирования, убедитесь, что владелец завершил настройку для вашего экземпляра GHES и что GitHub App установлено на репозитории, над которым вы работаете. Попросите владельца, который подключил экземпляр, подтвердить, что имя хоста, зарегистрированное в параметрах Claude, совпадает с именем хоста в вашем git remote.

Добавление маркетплейса не удаётся с ошибкой политики

Если /plugin marketplace add заблокирован для вашего URL-адреса GHES, ваша организация ограничила источники маркетплейса. Попросите администратора добавить запись hostPattern для имени хоста GHES в управляемые параметры.

Добавление маркетплейса на claude.ai не удаётся с ошибкой доступа GitHub

Если добавление маркетплейса GHES из параметров пользователя завершается с общей ошибкой типа “Marketplace couldn’t be added”, сначала проверьте подключение GitHub Enterprise. Это происходит, когда ваша собственная учётная запись GitHub Enterprise не подключена к Claude, даже если экземпляр GHES вашей организации настроен и другие пользователи подключены. Диалог не указывает на процесс подключения GitHub Enterprise, а опция “Connect to GitHub” на вкладке Browse выполняет вход в github.com, что не предоставляет доступ к репозиториям GHES. Чтобы подключить вашу учётную запись GitHub Enterprise: средство выбора репозитория на claude.ai/code предлагает опцию подключения для каждого настроенного экземпляра GHES, и владельцы также могут подключиться из раздела GitHub Enterprise параметров администратора Claude Code. Затем добавьте маркетплейс снова. Кроме того, попросите владельца добавить маркетплейс в параметры плагина организации, что устраняет требование подключения для каждого пользователя. На других поверхностях claude.ai ошибка “Repository not found. If it’s private, GitHub access is required” на маркетплейсе GHES обычно указывает на то же отсутствующее подключение. Подключите вашу учётную запись GitHub Enterprise через один из указанных выше путей, затем повторите попытку.

Экземпляр GHES недоступен

Если проверки или веб-сессии истекают по времени, ваш экземпляр GHES может быть недоступен из инфраструктуры Anthropic. Убедитесь, что ваш брандмауэр разрешает входящие соединения с IP-адресов Anthropic API. Эти страницы охватывают функции, упомянутые в этом руководстве, более подробно:

Claude Code в веб-интерфейсе: запуск сессий Claude Code на облачной инфраструктуре
Проверка кода: автоматизированные проверки PR
Маркетплейсы плагинов: создание и распределение каталогов плагинов
Аналитика: отслеживание использования и метрик вклада
Управляемые параметры: конфигурация политики на уровне организации
Конфигурация сети: требования к брандмауэру и списку разрешений IP

Начало работы

Основные концепции

Использовать Claude Code

Платформы и интеграции

Claude Code с GitHub Enterprise Server

Что работает с GitHub Enterprise Server

Настройка администратором

Разрешения GitHub App

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

Требования к сети

Рабочий процесс разработчика

Телепортируйте сессии в ваш терминал

Маркетплейсы плагинов на GHES

Добавьте маркетплейс GHES

Предварительно зарегистрируйте маркетплейсы GHES с управляемыми параметрами

Добавьте маркетплейсы GHES в список разрешений в управляемых параметрах

Ограничения

Troubleshooting

Веб-сессия не может клонировать репозиторий

Добавление маркетплейса не удаётся с ошибкой политики

Добавление маркетплейса на claude.ai не удаётся с ошибкой доступа GitHub

Экземпляр GHES недоступен

​Что работает с GitHub Enterprise Server

​Настройка администратором

​Разрешения GitHub App

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

​Требования к сети

​Рабочий процесс разработчика

​Телепортируйте сессии в ваш терминал

​Маркетплейсы плагинов на GHES

​Добавьте маркетплейс GHES

​Предварительно зарегистрируйте маркетплейсы GHES с управляемыми параметрами

​Добавьте маркетплейсы GHES в список разрешений в управляемых параметрах

​Ограничения

​Troubleshooting

​Веб-сессия не может клонировать репозиторий

​Добавление маркетплейса не удаётся с ошибкой политики

​Добавление маркетплейса на claude.ai не удаётся с ошибкой доступа GitHub

​Экземпляр GHES недоступен

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

Что работает с GitHub Enterprise Server

Настройка администратором

Разрешения GitHub App

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

Требования к сети

Рабочий процесс разработчика

Телепортируйте сессии в ваш терминал

Маркетплейсы плагинов на GHES

Добавьте маркетплейс GHES

Предварительно зарегистрируйте маркетплейсы GHES с управляемыми параметрами

Добавьте маркетплейсы GHES в список разрешений в управляемых параметрах

Ограничения

Troubleshooting

Веб-сессия не может клонировать репозиторий

Добавление маркетплейса не удаётся с ошибкой политики

Добавление маркетплейса на claude.ai не удаётся с ошибкой доступа GitHub

Экземпляр GHES недоступен

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