> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code с GitHub Enterprise Server

> Подключите Claude Code к вашему самостоятельно размещённому экземпляру GitHub Enterprise Server для веб-сессий, проверки кода и маркетплейсов плагинов.

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

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

Для репозиториев на github.com см. [Claude Code в веб-интерфейсе](/ru/claude-code-on-the-web) и [Проверка кода](/ru/code-review). Чтобы запустить Claude в вашей собственной инфраструктуре CI, см. [GitHub Actions](/ru/github-actions).

<h2 id="what-works-with-github-enterprise-server">
  Что работает с GitHub Enterprise Server
</h2>

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

| Функция                      | Поддержка GHES      | Примечания                                                                                                                                          |
| :--------------------------- | :------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------- |
| Claude Code в веб-интерфейсе | ✅ Поддерживается    | Администратор подключает экземпляр GHES один раз; разработчики используют `claude --remote` или [claude.ai/code](https://claude.ai/code) как обычно |
| Проверка кода                | ✅ Поддерживается    | Те же автоматизированные проверки PR, что и на github.com                                                                                           |
| Claude Security              | ✅ Поддерживается    | Доступно в открытой бета-версии для планов Enterprise на [claude.ai/security](https://claude.ai/security)                                           |
| Сессии Teleport              | ✅ Поддерживается    | Перемещайте сессии между веб-интерфейсом и терминалом с помощью `--teleport`                                                                        |
| Маркетплейсы плагинов        | ✅ Поддерживается    | Используйте полные URL-адреса git вместо сокращения `owner/repo`                                                                                    |
| Метрики вклада               | ✅ Поддерживается    | Доставляются через webhooks на [панель аналитики](/ru/analytics)                                                                                    |
| GitHub Actions               | ✅ Поддерживается    | Требует ручной настройки workflow; `/install-github-app` доступен только для github.com                                                             |
| GitHub MCP server            | ❌ Не поддерживается | GitHub MCP server не работает с экземплярами GHES                                                                                                   |

<h2 id="admin-setup">
  Настройка администратором
</h2>

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

Управляемая настройка генерирует манифест GitHub App и перенаправляет вас на ваш экземпляр GHES для создания приложения в один клик. Если ваша среда блокирует поток перенаправления, доступна [альтернативная ручная настройка](#manual-setup).

<Steps>
  <Step title="Откройте параметры администратора Claude Code">
    Перейдите на [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) и найдите раздел GitHub Enterprise Server.
  </Step>

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

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

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

  <Step title="Включите функции">
    Вернитесь на [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) и включите [Проверку кода](/ru/code-review#set-up-code-review), Claude Security и [метрики вклада](/ru/analytics#enable-contribution-metrics) для ваших репозиториев GHES, используя ту же конфигурацию, что и для github.com.
  </Step>
</Steps>

<h3 id="github-app-permissions">
  Разрешения GitHub App
</h3>

Манифест настраивает 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`.

<h3 id="manual-setup">
  Ручная настройка
</h3>

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

<h3 id="network-requirements">
  Требования к сети
</h3>

Ваш экземпляр GHES должен быть доступен из инфраструктуры Anthropic, чтобы Claude мог клонировать репозитории и публиковать комментарии проверки. Если ваш экземпляр GHES находится за брандмауэром, добавьте в список разрешений [IP-адреса Anthropic API](https://platform.claude.com/docs/en/api/ip-addresses).

<h2 id="developer-workflow">
  Рабочий процесс разработчика
</h2>

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

Клонируйте репозиторий из вашего экземпляра GHES как обычно:

```bash theme={null}
git clone git@github.example.com:platform/api-service.git
cd api-service
```

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

```bash theme={null}
claude --remote "Add retry logic to the payment webhook handler"
```

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

<h3 id="teleport-sessions-to-your-terminal">
  Телепортируйте сессии в ваш терминал
</h3>

Перенесите веб-сессию в ваш локальный терминал с помощью `claude --teleport`. Teleport проверяет, что вы находитесь в checkout того же репозитория GHES, прежде чем получить ветку и загрузить историю сессии. См. [требования teleport](/ru/claude-code-on-the-web#teleport-requirements) для получения подробной информации.

<h2 id="plugin-marketplaces-on-ghes">
  Маркетплейсы плагинов на GHES
</h2>

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

<h3 id="add-a-ghes-marketplace">
  Добавьте маркетплейс GHES
</h3>

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

```bash theme={null}
/plugin marketplace add git@github.example.com:platform/claude-plugins.git
```

HTTPS URL-адреса также работают:

```bash theme={null}
/plugin marketplace add https://github.example.com/platform/claude-plugins.git
```

См. [Создание и распределение маркетплейса плагинов](/ru/plugin-marketplaces) для полного руководства по созданию маркетплейсов.

<h3 id="allowlist-ghes-marketplaces-in-managed-settings">
  Добавьте маркетплейсы GHES в список разрешений в управляемых параметрах
</h3>

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

```json theme={null}
{
  "strictKnownMarketplaces": [
    {
      "source": "hostPattern",
      "hostPattern": "^github\\.example\\.com$"
    }
  ]
}
```

Вы также можете предварительно зарегистрировать маркетплейсы для разработчиков, чтобы они отображались без ручной настройки. Этот пример делает маркетплейс внутренних инструментов доступным для всей организации:

```json theme={null}
{
  "extraKnownMarketplaces": {
    "internal-tools": {
      "source": {
        "source": "git",
        "url": "git@github.example.com:platform/claude-plugins.git"
      }
    }
  }
}
```

См. справочник параметров [strictKnownMarketplaces](/ru/settings#strictknownmarketplaces) и [extraKnownMarketplaces](/ru/settings#extraknownmarketplaces) для полной схемы.

<h2 id="limitations">
  Ограничения
</h2>

Несколько функций работают по-другому на GHES, чем на github.com. [Таблица функций](#what-works-with-github-enterprise-server) суммирует поддержку; в этом разделе рассматриваются обходные пути.

* **Команда `/install-github-app`**: следуйте потоку [настройки администратором](#admin-setup) на claude.ai вместо этого. Если вы также хотите workflows GitHub Actions на GHES, адаптируйте [пример workflow](https://github.com/anthropics/claude-code-action/blob/main/examples/claude.yml) вручную.
* **GitHub MCP server**: используйте вместо этого CLI `gh`, настроенный для вашего хоста GHES. Запустите `gh auth login --hostname github.example.com` для аутентификации, затем Claude сможет использовать команды `gh` в сессиях.

<h2 id="troubleshooting">
  Troubleshooting
</h2>

<h3 id="web-session-fails-to-clone-repository">
  Веб-сессия не может клонировать репозиторий
</h3>

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

<h3 id="marketplace-add-fails-with-a-policy-error">
  Добавление маркетплейса не удаётся с ошибкой политики
</h3>

Если `/plugin marketplace add` заблокирован для вашего URL-адреса GHES, ваша организация ограничила источники маркетплейса. Попросите администратора добавить запись `hostPattern` для имени хоста GHES в [управляемые параметры](#allowlist-ghes-marketplaces-in-managed-settings).

<h3 id="ghes-instance-not-reachable">
  Экземпляр GHES недоступен
</h3>

Если проверки или веб-сессии истекают по времени, ваш экземпляр GHES может быть недоступен из инфраструктуры Anthropic. Убедитесь, что ваш брандмауэр разрешает входящие соединения с [IP-адресов Anthropic API](https://platform.claude.com/docs/en/api/ip-addresses).

<h2 id="related-resources">
  Связанные ресурсы
</h2>

Эти страницы охватывают функции, упомянутые в этом руководстве, более подробно:

* [Claude Code в веб-интерфейсе](/ru/claude-code-on-the-web): запуск сессий Claude Code на облачной инфраструктуре
* [Проверка кода](/ru/code-review): автоматизированные проверки PR
* [Маркетплейсы плагинов](/ru/plugin-marketplaces): создание и распределение каталогов плагинов
* [Аналитика](/ru/analytics): отслеживание использования и метрик вклада
* [Управляемые параметры](/ru/settings): конфигурация политики на уровне организации
* [Конфигурация сети](/ru/network-config): требования к брандмауэру и списку разрешений IP
