Claude Code mit GitHub Enterprise Server

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 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 --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. 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

Erste Schritte

Kernkonzepte

Claude Code verwenden

Plattformen und Integrationen

Claude Code mit GitHub Enterprise Server

Was mit GitHub Enterprise Server funktioniert

Admin-Einrichtung

GitHub App-Berechtigungen

Manuelle Einrichtung

Netzwerkanforderungen

Entwickler-Workflow

Teleport-Sitzungen zu Ihrem Terminal

Plugin-Marktplätze auf GHES

Fügen Sie einen GHES-Marktplatz hinzu

Registrieren Sie GHES-Marktplätze vorab mit verwalteten Einstellungen

Whitelist GHES-Marktplätze in verwalteten Einstellungen

Einschränkungen

Fehlerbehebung

Web-Sitzung kann Repository nicht klonen

Marktplatz-Hinzufügen schlägt mit Richtlinienfehler fehl

Marktplatz-Hinzufügen auf claude.ai schlägt mit GitHub-Zugriffsfehler fehl

GHES-Instanz nicht erreichbar

​Was mit GitHub Enterprise Server funktioniert

​Admin-Einrichtung

​GitHub App-Berechtigungen

​Manuelle Einrichtung

​Netzwerkanforderungen

​Entwickler-Workflow

​Teleport-Sitzungen zu Ihrem Terminal

​Plugin-Marktplätze auf GHES

​Fügen Sie einen GHES-Marktplatz hinzu

​Registrieren Sie GHES-Marktplätze vorab mit verwalteten Einstellungen

​Whitelist GHES-Marktplätze in verwalteten Einstellungen

​Einschränkungen

​Fehlerbehebung

​Web-Sitzung kann Repository nicht klonen

​Marktplatz-Hinzufügen schlägt mit Richtlinienfehler fehl

​Marktplatz-Hinzufügen auf claude.ai schlägt mit GitHub-Zugriffsfehler fehl

​GHES-Instanz nicht erreichbar

​Verwandte Ressourcen

Was mit GitHub Enterprise Server funktioniert

Admin-Einrichtung

GitHub App-Berechtigungen

Manuelle Einrichtung

Netzwerkanforderungen

Entwickler-Workflow

Teleport-Sitzungen zu Ihrem Terminal

Plugin-Marktplätze auf GHES

Fügen Sie einen GHES-Marktplatz hinzu

Registrieren Sie GHES-Marktplätze vorab mit verwalteten Einstellungen

Whitelist GHES-Marktplätze in verwalteten Einstellungen

Einschränkungen

Fehlerbehebung

Web-Sitzung kann Repository nicht klonen

Marktplatz-Hinzufügen schlägt mit Richtlinienfehler fehl

Marktplatz-Hinzufügen auf claude.ai schlägt mit GitHub-Zugriffsfehler fehl

GHES-Instanz nicht erreichbar

Verwandte Ressourcen