Zum Hauptinhalt springen
Die Unterstützung für GitHub Enterprise Server ist für Team- und Enterprise-Pläne verfügbar.
Die Unterstützung für GitHub Enterprise Server (GHES) ermöglicht es Ihrer Organisation, Claude Code mit Repositories zu verwenden, die auf Ihrer selbstverwalteten GitHub-Instanz gehostet werden, anstatt auf github.com. Sobald ein Administrator Ihre GHES-Instanz verbindet, können Entwickler Web-Sitzungen ausführen, automatisierte Code-Reviews erhalten und Plugins aus internen Marktplätzen installieren, ohne dass eine Konfiguration pro Repository erforderlich ist. Für Repositories auf github.com siehe Claude Code im Web und Code Review. Um Claude in Ihrer eigenen CI-Infrastruktur auszuführen, siehe GitHub Actions.

Was mit GitHub Enterprise Server funktioniert

Die folgende Tabelle zeigt, welche Claude Code-Funktionen GHES unterstützen und welche Unterschiede zum Verhalten von github.com bestehen.
FunktionGHES-UnterstützungHinweise
Claude Code im Web✅ UnterstütztEin Owner verbindet die GHES-Instanz einmalig; Entwickler verwenden claude --remote oder claude.ai/code wie gewohnt
Code Review✅ UnterstütztGleiche automatisierte PR-Reviews wie github.com
Claude Security✅ UnterstütztVerfügbar in öffentlicher Beta für Enterprise-Pläne unter claude.ai/security
Teleport-Sitzungen✅ UnterstütztVerschieben Sie Sitzungen zwischen Web und Terminal mit --teleport
Plugin-Marktplätze✅ UnterstütztVerwenden Sie vollständige Git-URLs anstelle der owner/repo-Kurzform
Beitragskennzahlen✅ UnterstütztBereitgestellt über Webhooks zum Analytics-Dashboard
GitHub Actions✅ UnterstütztErfordert manuelle Workflow-Einrichtung; /install-github-app ist nur für github.com
GitHub MCP-Server❌ Nicht unterstütztDer GitHub MCP-Server funktioniert nicht mit GHES-Instanzen

Admin-Einrichtung

Ein Administrator verbindet Ihre GHES-Instanz einmalig mit Claude Code. Danach können Entwickler in Ihrer Organisation GHES-Repositories ohne zusätzliche Konfiguration verwenden. Sie benötigen die Rolle „Administrator” oder „Primärer Administrator” in Ihrer Claude-Organisation und die Berechtigung, GitHub Apps auf Ihrer GHES-Instanz zu erstellen. Die geführte Einrichtung generiert ein GitHub App-Manifest und leitet Sie zu Ihrer GHES-Instanz weiter, um die App in einem Klick zu erstellen. Wenn Ihre Umgebung den Umleitungsfluss blockiert, ist eine alternative manuelle Einrichtung verfügbar.
1

Öffnen Sie die Claude Code-Admin-Einstellungen

Gehen Sie zu claude.ai/admin-settings/claude-code und suchen Sie den Abschnitt GitHub Enterprise Server.
2

Starten Sie die geführte Einrichtung

Klicken Sie auf Verbinden. Geben Sie einen Anzeigenamen für die Verbindung und Ihren GHES-Hostnamen ein, z. B. github.example.com. Wenn Ihre GHES-Instanz ein selbstsigniertes oder privates Zertifikat einer Zertifizierungsstelle verwendet, fügen Sie das CA-Zertifikat in das optionale Feld ein.
3

Erstellen Sie die GitHub App

Klicken Sie auf Weiter zu GitHub Enterprise. Ihr Browser wird zu Ihrer GHES-Instanz mit einem vorausgefüllten App-Manifest weitergeleitet. Überprüfen Sie die Konfiguration und klicken Sie auf GitHub App erstellen. GHES leitet Sie mit den automatisch gespeicherten App-Anmeldedaten zurück zu Claude.
4

Installieren Sie die App auf Ihren Repositories

Installieren Sie die App auf der GitHub App-Seite Ihrer GHES-Instanz auf den Repositories oder Organisationen, auf die Claude zugreifen soll. Sie können mit einer Teilmenge beginnen und später weitere hinzufügen.
5

Aktivieren Sie Funktionen

Kehren Sie zu claude.ai/admin-settings/claude-code zurück und aktivieren Sie Code Review, Claude Security und Beitragskennzahlen für Ihre GHES-Repositories mit der gleichen Konfiguration wie github.com.

GitHub App-Berechtigungen

Das Manifest konfiguriert die GitHub App mit den Berechtigungen und Webhook-Ereignissen, die Claude für Web-Sitzungen, Code Review, Claude Security und Beitragskennzahlen benötigt:
BerechtigungZugriffVerwendet für
ContentsLesen und SchreibenKlonen von Repositories und Pushen von Branches
Pull requestsLesen und SchreibenErstellen von PRs und Posten von Review-Kommentaren
IssuesLesen und SchreibenAntworten auf Issue-Erwähnungen
ChecksLesen und SchreibenPosten von Code Review-Check-Läufen
ActionsLesenLesen des CI-Status für Auto-Fix
Repository hooksLesen und SchreibenEmpfangen von Webhooks für Beitragskennzahlen
MetadataLesenVon GitHub für alle Apps erforderlich
Die App abonniert pull_request, issue_comment, pull_request_review_comment, pull_request_review und check_run-Ereignisse.

Manuelle Einrichtung

Wenn der geführte Umleitungsfluss durch Ihre Netzwerkkonfiguration blockiert wird, klicken Sie auf Manuell hinzufügen anstelle von Verbinden. Erstellen Sie eine GitHub App auf Ihrer GHES-Instanz mit den oben genannten Berechtigungen und Ereignissen und geben Sie dann die App-Anmeldedaten in das Formular ein: Hostname, OAuth-Client-ID und -Geheimnis, GitHub App-ID, Client-ID, Client-Geheimnis, Webhook-Geheimnis und privater Schlüssel.

Netzwerkanforderungen

Ihre GHES-Instanz muss von der Anthropic-Infrastruktur erreichbar sein, damit Claude Repositories klonen und Review-Kommentare posten kann. Wenn Ihre GHES-Instanz hinter einer Firewall liegt, fügen Sie die Anthropic API-IP-Adressen zur Whitelist hinzu.

Entwickler-Workflow

Sobald ein Inhaber die GHES-Instanz verbunden hat, ist keine Konfiguration auf der Entwicklerseite erforderlich. Claude Code erkennt Ihren GHES-Hostnamen automatisch aus dem Git-Remote in Ihrem Arbeitsverzeichnis. Klonen Sie ein Repository von Ihrer GHES-Instanz wie gewohnt:
git clone git@github.example.com:platform/api-service.git
cd api-service
Starten Sie dann eine Web-Sitzung. Claude erkennt den GHES-Host aus Ihrem Git-Remote und leitet die Sitzung durch Ihre konfigurierte Organisationsinstanz:
claude --remote "Add retry logic to the payment webhook handler"
Die Sitzung wird auf der Anthropic-Infrastruktur ausgeführt, klont Ihr Repository von GHES und pusht Änderungen zurück zu einem Branch. Überwachen Sie den Fortschritt mit /tasks oder unter claude.ai/code. Siehe Claude Code im Web für den vollständigen Cloud-Sitzungs-Workflow einschließlich Diff-Review, Auto-Fix und Routinen.

Teleport-Sitzungen zu Ihrem Terminal

Ziehen Sie eine Web-Sitzung mit claude --teleport in Ihr lokales Terminal. Teleport überprüft, ob Sie sich in einem Checkout des gleichen GHES-Repositories befinden, bevor der Branch abgerufen und die Sitzungshistorie geladen wird. Siehe Teleport-Anforderungen für Details.

Plugin-Marktplätze auf GHES

Hosten Sie Plugin-Marktplätze auf Ihrer GHES-Instanz, um interne Tools in Ihrer Organisation zu verteilen. Die Marktplatzstruktur ist identisch mit auf github.com gehosteten Marktplätzen; der einzige Unterschied ist, wie Sie auf sie verweisen.

Fügen Sie einen GHES-Marktplatz hinzu

Die owner/repo-Kurzform wird immer zu github.com aufgelöst. Für GHES-gehostete Marktplätze verwenden Sie die vollständige Git-URL:
/plugin marketplace add git@github.example.com:platform/claude-plugins.git
HTTPS-URLs funktionieren auch:
/plugin marketplace add https://github.example.com/platform/claude-plugins.git
Siehe Erstellen und Verteilen eines Plugin-Marktplatzes für die vollständige Anleitung zum Erstellen von Marktplätzen.

Whitelist GHES-Marktplätze in verwalteten Einstellungen

Wenn Ihre Organisation verwaltete Einstellungen verwendet, um einzuschränken, welche Marktplätze Entwickler hinzufügen können, verwenden Sie den hostPattern-Quellentyp, um alle Marktplätze von Ihrer GHES-Instanz zuzulassen, ohne jedes Repository aufzuzählen:
{
  "strictKnownMarketplaces": [
    {
      "source": "hostPattern",
      "hostPattern": "^github\\.example\\.com$"
    }
  ]
}
Sie können auch Marktplätze für Entwickler vorab registrieren, damit sie ohne manuelle Einrichtung angezeigt werden. Dieses Beispiel macht einen Marktplatz für interne Tools organisationsweit verfügbar:
{
  "extraKnownMarketplaces": {
    "internal-tools": {
      "source": {
        "source": "git",
        "url": "git@github.example.com:platform/claude-plugins.git"
      }
    }
  }
}
Siehe die Referenz zu den Einstellungen strictKnownMarketplaces und extraKnownMarketplaces für das vollständige Schema.

Einschränkungen

Einige Funktionen verhalten sich auf GHES anders als auf github.com. Die Funktionstabelle fasst die Unterstützung zusammen; dieser Abschnitt behandelt die Workarounds.
  • /install-github-app-Befehl: Folgen Sie stattdessen dem Admin-Einrichtungs-Fluss auf claude.ai. Wenn Sie auch GitHub Actions-Workflows auf GHES möchten, passen Sie den Beispiel-Workflow manuell an.
  • GitHub MCP-Server: Verwenden Sie stattdessen die gh CLI, die für Ihren GHES-Host konfiguriert ist. Führen Sie gh auth login --hostname github.example.com aus, um sich zu authentifizieren, dann kann Claude gh-Befehle in Sitzungen verwenden.

Fehlerbehebung

Web-Sitzung kann Repository nicht klonen

Wenn claude --remote mit einem Klonfehler fehlschlägt, überprüfen Sie, ob ein Owner die Einrichtung für Ihre GHES-Instanz abgeschlossen hat und ob die GitHub App auf dem Repository installiert ist, an dem Sie arbeiten. Bitten Sie den Owner, der die Instanz verbunden hat, zu bestätigen, dass der in den Claude-Einstellungen registrierte Hostname mit dem Hostnamen in Ihrem Git-Remote übereinstimmt.

Marktplatz-Hinzufügen schlägt mit Richtlinienfehler fehl

Wenn /plugin marketplace add für Ihre GHES-URL blockiert wird, hat Ihre Organisation Marktplatzquellen eingeschränkt. Bitten Sie Ihren Administrator, einen hostPattern-Eintrag für Ihren GHES-Hostnamen in verwalteten Einstellungen hinzuzufügen.

GHES-Instanz nicht erreichbar

Wenn Reviews oder Web-Sitzungen zeitüberschritten werden, ist Ihre GHES-Instanz möglicherweise nicht von der Anthropic-Infrastruktur erreichbar. Bestätigen Sie, dass Ihre Firewall eingehende Verbindungen von den Anthropic API-IP-Adressen zulässt. Diese Seiten behandeln die in diesem Leitfaden referenzierten Funktionen ausführlicher: