Die Unterstützung für GitHub Enterprise Server ist für Team- und Enterprise-Pläne verfügbar.
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.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 von bis zu 20 Zeichen 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 unten, die zusammen Cloud-Sitzungen, Code Review, Claude Security, Plugin-Marktplätze und Beitragskennzahlen abdecken:
Die App abonniert
pull_request, issue_comment, pull_request_review_comment, pull_request_review, check_run und status-Ereignisse.
GitHub wendet ein Manifest nur an, wenn die App erstellt wird, daher behält eine App, die aus einer früheren Version des Manifests erstellt wurde, die Berechtigungen und Ereignisse, mit denen sie erstellt wurde. Wenn Ihrer App eine der oben genannten Berechtigungen oder Ereignisse fehlt, fügen Sie diese in den App-Einstellungen auf Ihrer GHES-Instanz hinzu. GitHub fordert dann einen Besitzer jeder Installation auf, die neuen Berechtigungen zu genehmigen, und die Installation behält ihre alten Berechtigungen, bis dies geschieht.
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 Verbindungsdetails in das Formular ein: einen Anzeigenamen, Ihren GHES-Hostnamen und optionalen Port sowie die App-ID, Client-ID, Client-Geheimnis, Webhook-Geheimnis und privaten Schlüssel der App. Das Formular akzeptiert auch ein optionales benutzerdefiniertes CA-Zertifikat und Read-Replica-Hostnamen. Claude generiert die Webhook-URL der App, wenn Sie die Verbindung speichern. Nachdem Sie auf Konfiguration hinzufügen geklickt haben, öffnen Sie das Menü Weitere Optionen der Verbindung, wählen Sie Webhook-URL kopieren und fügen Sie die URL in die Webhook-Einstellungen der App auf Ihrer GHES-Instanz ein. Verwenden Sie das gleiche Webhook-Geheimnis, das Sie in das Formular eingegeben haben.Netzwerkanforderungen
Für von Anthropic gehostete Sitzungen muss Ihre GHES-Instanz 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 ausgehenden IP-Adressen von Anthropic zur Whitelist hinzu. Sitzungen in einer selbst gehosteten Umgebung klonen von innerhalb Ihres Netzwerks, es sei denn, der Runner entscheidet sich für den Anthropic Git-Proxy, der von der Seite von Anthropic abruft und die gleiche Erreichbarkeit benötigt; der SCM-Connector deckt die gehosteten Pre-Session-Flows ab, wie z. B. die Repository-Auswahl, für einen GHES-Host, der nur intern routbar ist.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, und ersetzen Siegithub.example.com und den Repository-Pfad durch Ihren GHES-Hostnamen und das Repository:
Teleport-Sitzungen zu Ihrem Terminal
Ziehen Sie eine Cloud-Sitzung mitclaude --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:Fügen Sie einen GHES-Marktplatz hinzu
Dieowner/repo-Kurzform wird immer zu github.com aufgelöst. Für GHES-gehostete Marktplätze verwenden Sie die vollständige Git-URL und ersetzen Sie github.example.com und den Repository-Pfad durch Ihre eigenen. HTTPS-URLs werden empfohlen:
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
DieextraKnownMarketplaces-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:
- 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 bereitstellen 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 denhostPattern-Quellentyp, um alle Marktplätze von Ihrer GHES-Instanz zuzulassen, ohne jedes Repository aufzuzählen. Siehe Bereitstellungsmechanismen für Dateispeicherorte auf jeder Plattform. Fügen Sie das JSON zu Ihrer managed-settings.json-Datei oder einer entsprechenden MDM-Richtlinie hinzu:
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
Cloud-Sitzung kann Repository nicht klonen
Wennclaude --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 von Anthropic gehostete Cloud-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 Anthropics ausgehenden IP-Adressen zulässt. Sitzungen in einer selbstgehosteten Umgebung erreichen GHES von innerhalb Ihres Netzwerks, überprüfen Sie daher für diese den eigenen Netzwerkpfad des Runners und den SCM-Connector stattdessen.Sitzungsstart schlägt mit Unable to get organization UUID fehl
Melden Sie sich mit /login mit Ihrem Organisationskonto an. Wenn Sie sich stattdessen mit einem API-Schlüssel authentifizieren, schlagen Cloud-Sitzungen früher fehl mit einer Nachricht, die Sie auffordert, /login auszuführen.
Verwandte Ressourcen
Diese Seiten behandeln die in diesem Leitfaden referenzierten Funktionen ausführlicher:- Claude Code in der Cloud: 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