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

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

В таблице ниже показано, какие функции Claude Code поддерживают GHES и какие различия есть по сравнению с поведением github.com.
ФункцияПоддержка GHESПримечания
Claude Code в веб-интерфейсе✅ ПоддерживаетсяАдминистратор подключает экземпляр GHES один раз; разработчики используют claude --remote или claude.ai/code как обычно
Проверка кода✅ ПоддерживаетсяТе же автоматизированные проверки PR, что и на github.com
Claude Security✅ ПоддерживаетсяДоступно в открытой бета-версии для планов Enterprise на claude.ai/security
Сессии Teleport✅ ПоддерживаетсяПеремещайте сессии между веб-интерфейсом и терминалом с помощью --teleport
Маркетплейсы плагинов✅ ПоддерживаетсяИспользуйте полные URL-адреса git вместо сокращения owner/repo
Метрики вклада✅ ПоддерживаетсяДоставляются через 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 для создания приложения в один клик. Если ваша среда блокирует поток перенаправления, доступна альтернативная ручная настройка.
1

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

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

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

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

Создайте GitHub App

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

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

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

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

Вернитесь на 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 --remote "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; единственное различие заключается в том, как вы на них ссылаетесь.

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

Сокращение owner/repo всегда разрешается на github.com. Для маркетплейсов, размещённых на GHES, используйте полный URL-адрес git: 
/plugin marketplace add git@github.example.com:platform/claude-plugins.git
HTTPS URL-адреса также работают: 
/plugin marketplace add https://github.example.com/platform/claude-plugins.git
См. Создание и распределение маркетплейса плагинов для полного руководства по созданию маркетплейсов.

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

Если ваша организация использует управляемые параметры для ограничения того, какие маркетплейсы разработчики могут добавлять, используйте тип источника hostPattern для разрешения всех маркетплейсов из вашего экземпляра GHES без перечисления каждого репозитория: 
{
  "strictKnownMarketplaces": [
    {
      "source": "hostPattern",
      "hostPattern": "^github\\.example\\.com$"
    }
  ]
}
Вы также можете предварительно зарегистрировать маркетплейсы для разработчиков, чтобы они отображались без ручной настройки. Этот пример делает маркетплейс внутренних инструментов доступным для всей организации: 
{
  "extraKnownMarketplaces": {
    "internal-tools": {
      "source": {
        "source": "git",
        "url": "git@github.example.com:platform/claude-plugins.git"
      }
    }
  }
}
См. справочник параметров 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 --remote завершается с ошибкой клонирования, убедитесь, что владелец завершил настройку для вашего экземпляра GHES и что GitHub App установлено на репозитории, над которым вы работаете. Попросите владельца, который подключил экземпляр, подтвердить, что имя хоста, зарегистрированное в параметрах Claude, совпадает с именем хоста в вашем git remote.

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

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

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

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