Claude Code mit GitHub Enterprise Server
Verbinden Sie Claude Code mit Ihrer selbstgehosteten GitHub Enterprise Server-Instanz für Web-Sitzungen, Code-Review und Plugin-Marktplätze.
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.
| Funktion | GHES-Unterstützung | Hinweise |
|---|---|---|
| Claude Code im Web | ✅ Unterstützt | Admin verbindet die GHES-Instanz einmalig; Entwickler verwenden claude --remote oder claude.ai/code wie gewohnt |
| Code Review | ✅ Unterstützt | Gleiche automatisierte PR-Reviews wie github.com |
| Claude Security | ✅ Unterstützt | Verfügbar in öffentlicher Beta für Enterprise-Pläne unter claude.ai/security |
| Teleport-Sitzungen | ✅ Unterstützt | Verschieben Sie Sitzungen zwischen Web und Terminal mit --teleport |
| Plugin-Marktplätze | ✅ Unterstützt | Verwenden Sie vollständige Git-URLs anstelle der owner/repo-Kurzform |
| Beitragskennzahlen | ✅ Unterstützt | Bereitgestellt über Webhooks zum Analytics-Dashboard |
| GitHub Actions | ✅ Unterstützt | Erfordert manuelle Workflow-Einrichtung; /install-github-app ist nur für github.com |
| GitHub MCP-Server | ❌ Nicht unterstützt | Der 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 Administratorzugriff auf Ihre 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.
Öffnen Sie die Claude Code-Admin-Einstellungen
Gehen Sie zu claude.ai/admin-settings/claude-code und suchen Sie den Abschnitt GitHub Enterprise Server.
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.
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.
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.
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:
| Berechtigung | Zugriff | Verwendet für |
|---|---|---|
| Contents | Lesen und Schreiben | Klonen von Repositories und Pushen von Branches |
| Pull requests | Lesen und Schreiben | Erstellen von PRs und Posten von Review-Kommentaren |
| Issues | Lesen und Schreiben | Antworten auf Issue-Erwähnungen |
| Checks | Lesen und Schreiben | Posten von Code Review-Check-Läufen |
| Actions | Lesen | Lesen des CI-Status für Auto-Fix |
| Repository hooks | Lesen und Schreiben | Empfangen von Webhooks für Beitragskennzahlen |
| Metadata | Lesen | Von 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 Ihr Administrator 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 Remote-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
ghCLI, die für Ihren GHES-Host konfiguriert ist. Führen Siegh auth login --hostname github.example.comaus, um sich zu authentifizieren, dann kann Claudegh-Befehle in Sitzungen verwenden.
Fehlerbehebung
Web-Sitzung kann Repository nicht klonen
Wenn claude --remote mit einem Klonfehler fehlschlägt, überprüfen Sie, ob Ihr Administrator die Einrichtung für Ihre GHES-Instanz abgeschlossen hat und ob die GitHub App auf dem Repository installiert ist, an dem Sie arbeiten. Überprüfen Sie bei Ihrem Administrator, ob der in den Claude-Einstellungen registrierte Instanz-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.
Verwandte Ressourcen
Diese Seiten behandeln die in diesem Leitfaden referenzierten Funktionen ausführlicher:
- Claude Code im Web: Führen Sie Claude Code-Sitzungen auf Cloud-Infrastruktur aus
- Code Review: Automatisierte PR-Reviews
- Plugin-Marktplätze: Erstellen und Verteilen von Plugin-Katalogen
- Analytics: Verfolgen Sie Nutzung und Beitragskennzahlen
- Verwaltete Einstellungen: Organisationsweite Richtlinienkonfiguration
- Netzwerkkonfiguration: Firewall- und IP-Whitelist-Anforderungen