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 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 und automatisierte Code-Reviews erhalten, ohne dass eine Konfiguration pro Repository erforderlich ist. Plugin-Marktplätze, die auf Ihrer Instanz gehostet werden, werden ebenfalls unterstützt; die Anforderungen an Anmeldedaten variieren je nach Oberfläche, wie in Plugin-Marktplätze auf GHES beschrieben.
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 | Ein Owner verbindet die GHES-Instanz einmalig; Entwickler verwenden claude --cloud 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 | Anforderungen an Anmeldedaten unterscheiden sich je nach Oberfläche. Siehe Plugin-Marktplätze auf GHES |
| 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 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.
Ö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 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 --cloud "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, aber die Installation funktioniert unterschiedlich, je nachdem, wo Sie den Marktplatz hinzufügen, und die Anmeldedaten unterscheiden sich zwischen den Oberflächen:
| Oberfläche | Funktionsweise der Installation | Was jeder Benutzer benötigt |
|---|---|---|
| Claude Code CLI und Desktop | Claude Code klont das Marktplatz-Repository mit den vorhandenen Git-Anmeldedaten des Computers | Git-Zugriff auf Ihren GHES-Host von ihrem Computer |
Verwaltete Einstellungen (extraKnownMarketplaces) |
Claude Code registriert den Eintrag und klont das Repository mit den vorhandenen Git-Anmeldedaten des Computers | Git-Zugriff auf Ihren GHES-Host von ihrem Computer |
| claude.ai-Organisationseinstellungen für Plugins | Ein Eigentümer wählt die GHES-Instanz als Quelle aus; Anthropics Backend ruft das Repository ab und synchronisiert es mit der GitHub App aus Admin-Setup | Nichts pro Benutzer nach dem Hinzufügen. Der Eigentümer, der es hinzufügt, benötigt sein eigenes GitHub Enterprise-Konto als Zugriffsprüfung, und die GitHub App muss im Marktplatz-Repository installiert sein |
| claude.ai-Benutzereinstellungen | Anthropics Backend ruft das Repository mit der GitHub Enterprise-Verbindung des einreichenden Benutzers ab | Sein eigenes GitHub Enterprise-Konto, das mit Claude verbunden ist |
| Claude Code im Web | Cloud-Sitzungen klonen Marktplätze innerhalb der Sitzungs-Sandbox. Die Sandbox kann Ihre GHES-Instanz nur erreichen, wenn sich das Repository der Sitzung auf derselben Instanz befindet, und ihre Git-Anmeldedaten sind auf die Repositories der Sitzung beschränkt | Nicht zuverlässig für GHES-gehostete Marktplätze: Ein anderer Host als das Repository der Sitzung ist nicht erreichbar, und selbst Installationen auf derselben Instanz können fehlschlagen. Verwenden Sie stattdessen die CLI, verwaltete Einstellungen oder claude.ai |
GitHub Enterprise-Verbindungen auf claude.ai sind pro Benutzer, wenn ein Marktplatz aus den Benutzereinstellungen hinzugefügt wird. Das Admin-Setup verbindet Ihre GHES-Instanz mit Ihrer Organisation, verbindet aber keine einzelnen Benutzerkonten: Jeder Benutzer, der einen GHES-Marktplatz aus seinen eigenen Einstellungen hinzufügt, muss zunächst sein eigenes GitHub Enterprise-Konto verbinden, und die Verbindung eines Benutzers, einschließlich des Eigentümers, deckt niemand anderen ab. Marktplätze, die von einem Eigentümer in den Organisationseinstellungen für Plugins hinzugefügt werden, stellen diese Anforderung nicht an Benutzer, da laufende Abrufe die GitHub App der Organisation verwenden. Der Eigentümer, der den Marktplatz hinzufügt, benötigt zum Zeitpunkt des Hinzufügens immer noch sein eigenes GitHub Enterprise-Konto.
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. HTTPS-URLs werden empfohlen:
/plugin marketplace add https://github.example.com/platform/claude-plugins.git
SSH-URLs funktionieren, wenn der Computer Ihren GHES-Host bereits vertraut:
/plugin marketplace add git@github.example.com:platform/claude-plugins.git
Claude Code führt Git nicht interaktiv aus und lehnt SSH-Verbindungen zu Hosts ab, die sich nicht in der known_hosts-Datei des Computers befinden. Eine HTTPS-URL mit einem Git-Credential-Helper vermeidet die known_hosts-Anforderung.
Siehe Erstellen und Verteilen eines Plugin-Marktplatzes für die vollständige Anleitung zum Erstellen von Marktplätzen.
Registrieren Sie GHES-Marktplätze vorab mit verwalteten Einstellungen
Die extraKnownMarketplaces-Einstellung registriert einen Marktplatz vorab, damit Entwickler ihn ohne manuelle Einrichtung erhalten. Sie funktioniert aus jeder Einstellungsdatei, einschließlich der .claude/settings.json eines Repositories; verwaltete Einstellungen liefern sie organisationsweit:
{
"extraKnownMarketplaces": {
"internal-tools": {
"source": {
"source": "git",
"url": "https://github.example.com/platform/claude-plugins.git"
}
}
}
}
Claude Code installiert diese Marktplätze lokal: Es registriert jeden Eintrag und klont das Repository mit den vorhandenen Git-Anmeldedaten des Computers. Dieser Pfad verläuft nicht über claude.ai, daher ist die GitHub Enterprise-Verbindung pro Benutzer nicht erforderlich. Für einen erfolgreichen Rollout:
- Verwenden Sie eine vollständige Git-URL. Die
owner/repo-Kurzform wird immer zu github.com aufgelöst und kann nicht auf einen GHES-Host verweisen. - Bevorzugen Sie HTTPS-URLs. SSH-Klone schlagen auf Computern fehl, die Ihren GHES-Host-Schlüssel nicht bereits vertrauen. Eine HTTPS-URL mit dem Standard-Git-Credential-Helper Ihrer Organisation funktioniert auf jedem Computer mit konfigurierten Anmeldedaten.
- Bestätigen Sie, dass jeder Computer von Ihrem GHES-Host klonen kann. Wenn ein Computer keine Anmeldedaten hat, wird der Marktplatz registriert, aber nie installiert, und seine Plugins werden als nicht gefunden gemeldet, anstatt nach Anmeldedaten zu fragen.
- Bestätigen Sie, dass die Einstellung jeden Computer erreicht. Eine verwaltete Einstellungsdatei wird nur auf Computern wirksam, auf denen sie bereitgestellt wird, beispielsweise über Ihr Geräteverwaltungssystem. Siehe verwaltete Einstellungen für Dateispeicherorte.
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$"
}
]
}
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 --cloud 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.
Marktplatz-Hinzufügen auf claude.ai schlägt mit GitHub-Zugriffsfehler fehl
Wenn das Hinzufügen eines GHES-Marktplatzes aus Ihren Benutzereinstellungen mit einem generischen Fehler wie „Marktplatz konnte nicht hinzugefügt werden" fehlschlägt, überprüfen Sie zunächst Ihre GitHub Enterprise-Verbindung. Dies ist das, was angezeigt wird, wenn Ihr eigenes GitHub Enterprise-Konto nicht mit Claude verbunden ist, auch wenn Ihre GHES-Instanz der Organisation konfiguriert ist und andere Benutzer verbunden sind. Der Dialog verweist nicht auf den GitHub Enterprise-Verbindungsfluss, und die Option „Mit GitHub verbinden" auf der Registerkarte „Durchsuchen" meldet sich bei github.com an, was keinen Zugriff auf GHES-Repositories gewährt.
Um Ihr GitHub Enterprise-Konto zu verbinden: Die Repository-Auswahl auf claude.ai/code bietet eine Verbindungsoption für jede konfigurierte GHES-Instanz, und Owners können sich auch aus dem GitHub Enterprise-Bereich der Claude Code-Administratoreinstellungen verbinden. Fügen Sie dann den Marktplatz erneut hinzu. Alternativ können Sie einen Owner bitten, den Marktplatz in den Organisationsplug-in-Einstellungen hinzuzufügen, was die Anforderung der Benutzerverbindung pro Benutzer entfernt.
Auf anderen claude.ai-Oberflächen deutet ein Fehler „Repository nicht gefunden. Falls es privat ist, ist GitHub-Zugriff erforderlich" auf einem GHES-Marktplatz normalerweise auf dieselbe fehlende Verbindung hin. Verbinden Sie Ihr GitHub Enterprise-Konto über einen der oben genannten Pfade und versuchen Sie es dann erneut.
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