Passer au contenu principal
Le support de GitHub Enterprise Server est disponible pour les plans Team et Enterprise.
Le support de GitHub Enterprise Server (GHES) permet à votre organisation d’utiliser Claude Code avec des dépôts hébergés sur votre instance GitHub auto-gérée au lieu de github.com. Une fois qu’un propriétaire connecte votre instance GHES, les développeurs peuvent exécuter des sessions cloud et obtenir des révisions de code automatisées sans aucune configuration par dépôt. Les marketplaces de plugins hébergées sur votre instance sont également pris en charge ; les exigences en matière d’identifiants varient selon la surface, comme décrit dans Plugin marketplaces on GHES. Pour les dépôts sur github.com, consultez Claude Code dans le cloud et Révision de code. Pour exécuter Claude dans votre propre infrastructure CI, consultez GitHub Actions.

Ce qui fonctionne avec GitHub Enterprise Server

Le tableau ci-dessous montre quelles fonctionnalités de Claude Code supportent GHES et les différences éventuelles par rapport au comportement de github.com.

Configuration administrateur

Un propriétaire connecte votre instance GHES à Claude Code une seule fois. Vous avez besoin du rôle Propriétaire ou Propriétaire principal dans votre organisation Claude et de la permission de créer des GitHub Apps sur votre instance GHES. La configuration guidée génère un manifeste GitHub App et vous redirige vers votre instance GHES pour créer l’application en un clic. Si votre environnement bloque le flux de redirection, une configuration manuelle alternative est disponible.
1

Ouvrir les paramètres des fournisseurs Git

Allez à Paramètres de l’organisation > Fournisseurs Git et trouvez la section GitHub Enterprise.
2

Démarrer la configuration guidée

Cliquez sur Connecter, ou sur Ajouter une instance si une instance est déjà connectée, puis sélectionnez Configurer automatiquement. Entrez un nom d’affichage de jusqu’à 20 caractères pour la connexion et le nom d’hôte de votre GHES, par exemple github.example.com. Si votre instance GHES utilise un certificat auto-signé ou une autorité de certification privée, collez le certificat CA dans le champ optionnel.
3

Créer la GitHub App

Cliquez sur Continuer vers GitHub Enterprise. Votre navigateur vous redirige vers votre instance GHES avec un manifeste d’application pré-rempli. Vérifiez la configuration et cliquez sur Créer une GitHub App. GHES vous redirige vers Claude avec les identifiants de l’application stockés automatiquement.
4

Installer l'application sur vos dépôts

À partir de la page GitHub App sur votre instance GHES, installez l’application sur les dépôts ou organisations auxquels vous souhaitez que Claude accède. Vous pouvez commencer par un sous-ensemble et en ajouter d’autres plus tard.
5

Activer Code Review

Allez à claude.ai/admin-settings/claude-code et activez Code Review pour vos dépôts GHES en utilisant la même configuration que github.com.

Permissions de la GitHub App

Le manifeste configure la GitHub App avec les permissions et les événements webhook ci-dessous, qui couvrent ensemble les sessions cloud, Code Review, Claude Security et les marketplaces de plugins : L’application s’abonne aux événements pull_request, issue_comment, pull_request_review_comment, pull_request_review, check_run et status. GitHub applique un manifeste uniquement lors de la création de l’application, donc une application créée à partir d’une version antérieure du manifeste conserve les permissions et les événements avec lesquels elle a été créée. Si votre application manque l’une des permissions ou des événements ci-dessus, ajoutez-les dans les paramètres de l’application sur votre instance GHES. GitHub demande alors à un propriétaire de chaque installation d’approuver les nouvelles permissions, et l’installation conserve ses anciennes permissions jusqu’à ce qu’il le fasse.

Configuration manuelle

Si le flux de redirection guidé est bloqué par votre configuration réseau, cliquez sur Connecter ou Ajouter une instance, puis sélectionnez Ajouter manuellement au lieu de Configurer automatiquement. Créez une GitHub App sur votre instance GHES avec les permissions et événements ci-dessus, puis entrez les détails de la connexion dans le formulaire : un nom d’affichage, le nom d’hôte de votre GHES et le port optionnel, ainsi que l’ID de l’application, l’ID client, le secret client, le secret webhook et la clé privée de l’application. Le formulaire accepte également un certificat CA personnalisé optionnel et les noms d’hôte des répliques de lecture. Claude génère l’URL du webhook de l’application lorsque vous enregistrez la connexion. Après avoir cliqué sur Ajouter la configuration, ouvrez le menu Plus d’options de la connexion, sélectionnez Copier l’URL du webhook et collez l’URL dans les paramètres du webhook de l’application sur votre instance GHES. Utilisez le même secret webhook que celui que vous avez entré dans le formulaire.

Exigences réseau

Pour les sessions hébergées par Anthropic, votre instance GHES doit être accessible à partir de l’infrastructure Anthropic pour que Claude puisse cloner les dépôts et publier des commentaires de revue. Si votre instance GHES est derrière un pare-feu, ajoutez à la liste d’autorisation les adresses IP sortantes d’Anthropic. Les sessions dans un environnement auto-hébergé clonent depuis l’intérieur de votre réseau à la place, sauf si le runner opte pour le proxy git Anthropic, qui récupère du côté d’Anthropic et nécessite la même accessibilité. Les flux de pré-session hébergés, tels que le sélecteur de dépôt, s’exécutent du côté d’Anthropic avant le démarrage d’une session. Ils nécessitent que votre instance GHES soit accessible à partir de l’infrastructure Anthropic même lorsque la session s’exécute dans un environnement auto-hébergé. Le connecteur SCM n’est pas disponible, donc ces flux ne peuvent pas atteindre un hôte GHES qui n’est routable qu’en interne.

Flux de travail des développeurs

Claude Code détecte automatiquement le nom d’hôte de votre GHES à partir du remote git dans votre répertoire de travail. Clonez un dépôt à partir de votre instance GHES comme vous le feriez normalement, en remplaçant github.example.com et le chemin du dépôt par le nom d’hôte de votre GHES et le dépôt :
Ensuite, démarrez une session cloud. Claude détecte l’hôte GHES à partir de votre télécommande git et achemine la session via votre instance configurée de l’organisation :
La session clone votre dépôt à partir de GHES et repousse les modifications vers une branche. Surveillez la progression à claude.ai/code. Consultez Utiliser Claude Code dans le cloud pour le workflow complet des sessions cloud, y compris la révision des diffs, la correction automatique et les tâches planifiées cloud.

Téléporter les sessions vers votre terminal

Tirez une session cloud dans votre terminal local avec claude --teleport. Teleport vérifie que vous êtes dans une extraction du même dépôt GHES avant de récupérer la branche et de charger l’historique de la session. Consultez les exigences de téléportation pour plus de détails.

Marketplaces de plugins sur GHES

Hébergez des marketplaces de plugins sur votre instance GHES pour distribuer les outils internes dans votre organisation. La structure de la marketplace est identique aux marketplaces hébergées sur github.com, mais l’installation fonctionne différemment selon l’endroit où vous ajoutez la marketplace, et les identifiants varient selon les surfaces :
Les connexions GitHub Enterprise sur claude.ai sont par utilisateur lorsqu’une marketplace est ajoutée à partir des paramètres utilisateur. La configuration d’administration connecte votre instance GHES à votre organisation, mais elle ne connecte pas les comptes utilisateur individuels : chaque utilisateur qui ajoute une marketplace GHES à partir de ses propres paramètres doit d’abord connecter son propre compte GitHub Enterprise, et la connexion d’un utilisateur, y compris celle du propriétaire, ne couvre personne d’autre. Les marketplaces ajoutées par un propriétaire dans les paramètres de plugin de l’organisation ne mettent pas cette exigence sur les utilisateurs, car les récupérations continues utilisent l’application GitHub de l’organisation. Le propriétaire qui ajoute la marketplace doit toujours avoir son propre compte GitHub Enterprise connecté au moment de l’ajout.

Ajouter une marketplace GHES

Le raccourci owner/repo se résout toujours en github.com. Pour les marketplaces hébergées sur GHES, utilisez l’URL git complète, en remplaçant github.example.com et le chemin du dépôt par les vôtres. Les URL HTTPS sont recommandées :
Les URL SSH fonctionnent si la machine fait déjà confiance à votre hôte GHES :
Claude Code exécute git de manière non-interactive et rejette les connexions SSH aux hôtes qui ne figurent pas dans le fichier known_hosts de la machine. Une URL HTTPS avec un assistant d’identifiants git évite l’exigence known_hosts. Consultez Créer et distribuer une marketplace de plugins pour le guide complet de la création de marketplaces.

Pré-enregistrer les marketplaces GHES avec les paramètres gérés

Le paramètre extraKnownMarketplaces pré-enregistre une marketplace afin que les développeurs l’obtiennent sans configuration manuelle. Il fonctionne à partir de n’importe quel fichier de paramètres, y compris le .claude/settings.json d’un dépôt ; les paramètres gérés le livrent à l’échelle de l’organisation :
Claude Code installe ces marketplaces localement : il enregistre chaque entrée et clone le dépôt avec les identifiants git existants de la machine. Ce chemin ne passe pas par claude.ai, donc la connexion GitHub Enterprise par utilisateur n’est pas requise. Pour un déploiement réussi :
  • Utilisez une URL git complète. Le raccourci owner/repo se résout toujours en github.com et ne peut pas référencer un hôte GHES.
  • Préférez les URL HTTPS. Les clones SSH échouent sur les machines qui ne font pas déjà confiance à votre clé d’hôte GHES. Une URL HTTPS avec l’assistant d’identifiants git standard de votre organisation fonctionne sur n’importe quelle machine avec des identifiants configurés.
  • Confirmez que chaque machine peut cloner à partir de votre hôte GHES. Si une machine manque d’identifiants, la marketplace est enregistrée mais jamais installée, et ses plugins signalent qu’ils ne sont pas trouvés au lieu de demander des identifiants.
  • Confirmez que le paramètre atteint chaque machine. Un fichier de paramètres gérés ne prend effet que sur les machines sur lesquelles il est déployé, par exemple via votre système de gestion des appareils. Consultez Déployer les paramètres gérés pour les emplacements des fichiers.

Mettre en liste blanche les marketplaces GHES dans les paramètres gérés

Si votre organisation utilise les paramètres gérés pour restreindre les marketplaces que les développeurs peuvent ajouter, utilisez le type de source hostPattern pour autoriser toutes les marketplaces de votre instance GHES sans énumérer chaque dépôt. Consultez Mécanismes de livraison pour les emplacements des fichiers sur chaque plateforme. Ajoutez le JSON à votre fichier managed-settings.json ou à la politique MDM équivalente :
Consultez la référence des paramètres strictKnownMarketplaces et extraKnownMarketplaces pour le schéma complet.

Limitations

Quelques fonctionnalités se comportent différemment sur GHES que sur github.com. Le tableau des fonctionnalités résume le support ; cette section couvre les solutions de contournement.
  • Commande /install-github-app : suivez le flux de configuration administrateur sur claude.ai à la place. Si vous souhaitez également des workflows GitHub Actions sur GHES, adaptez manuellement l’exemple de workflow.
  • Serveur GitHub MCP : dans une session sur votre propre machine, utilisez plutôt la CLI gh configurée pour votre hôte GHES. Exécutez gh auth login --hostname github.example.com pour vous authentifier, puis Claude peut y utiliser les commandes gh.

Dépannage

La session cloud ne parvient pas à cloner le dépôt

Si claude --cloud échoue avec une erreur de clonage, vérifiez qu’un Owner a terminé la configuration de votre instance GHES et que la GitHub App est installée sur le dépôt dans lequel vous travaillez. Demandez à l’Owner qui a connecté l’instance de confirmer que le nom d’hôte enregistré dans les paramètres de Claude correspond au nom d’hôte de votre remote git. Si la session s’arrête avec « Authentication failed while accessing the repository », il se peut que vous n’ayez pas connecté votre propre compte GitHub Enterprise. Connectez-le depuis le sélecteur de dépôt sur claude.ai/code, puis démarrez une nouvelle session.

L’ajout d’une marketplace échoue avec une erreur de politique

Si /plugin marketplace add est bloqué pour votre URL GHES, votre organisation a restreint les sources de marketplace. Demandez à votre administrateur d’ajouter une entrée hostPattern pour votre nom d’hôte GHES dans les paramètres gérés.

L’ajout d’une marketplace sur claude.ai échoue avec une erreur d’accès GitHub

Si l’ajout d’une marketplace GHES depuis vos paramètres utilisateur échoue avec une erreur générique telle que « Marketplace couldn’t be added », vérifiez d’abord votre connexion GitHub Enterprise. C’est ce qui s’affiche lorsque votre propre compte GitHub Enterprise n’est pas connecté à Claude, même si l’instance GHES de votre organisation est configurée et que d’autres utilisateurs sont connectés. La boîte de dialogue ne renvoie pas vers le flux de connexion GitHub Enterprise, et l’option « Connect to GitHub » de l’onglet Browse vous connecte à github.com, ce qui n’accorde pas l’accès aux dépôts GHES. Connectez votre compte GitHub Enterprise à l’un de ces emplacements, puis ajoutez à nouveau la marketplace :
  • Sélecteur de dépôt : sur claude.ai/code, le sélecteur de dépôt propose une option de connexion pour chaque instance GHES configurée.
  • Page Git providers : si vous êtes Owner, accédez à la section GitHub de Organization settings > Git providers et cliquez sur Connect, ou sur Add organization une fois qu’un compte est connecté. Sélectionnez le nom d’hôte GHES sous GitHub instance, puis cliquez sur Connect.
Vous pouvez également demander à un Owner d’ajouter la marketplace dans les paramètres de plugins de l’organisation, ce qui supprime l’exigence de connexion par utilisateur. Sur les autres surfaces de claude.ai, une erreur « Repository not found. If it’s private, GitHub access is required » sur une marketplace GHES indique généralement la même connexion manquante. Connectez votre compte GitHub Enterprise par l’un des moyens ci-dessus, puis réessayez.

Instance GHES inaccessible

Si les revues ou les sessions cloud hébergées par Anthropic expirent, votre instance GHES n’est peut-être pas accessible depuis l’infrastructure d’Anthropic. Vérifiez que votre pare-feu autorise les connexions entrantes depuis les adresses IP sortantes d’Anthropic. Les sessions d’un environnement auto-hébergé atteignent GHES depuis l’intérieur de votre réseau ; lorsque l’une d’elles ne parvient pas à cloner, vérifiez plutôt le chemin réseau du runner lui-même. Pour le sélecteur de dépôt et les autres flux hébergés précédant la session, consultez Exigences réseau.

Le test de connexion réussit mais un second test échoue

Le second test se connecte à votre instance GHES de la même manière que les sessions cloud hébergées par Anthropic. Repérez votre message pour savoir s’il faut vérifier votre pare-feu ou réessayer :
  • Connection test passed, but a second test failed. : si votre instance se trouve derrière un pare-feu, autorisez toutes les adresses IP sortantes d’Anthropic, car un test de connexion peut réussir même lorsque votre pare-feu bloque certaines d’entre elles. Vous pouvez également réessayer dans quelques minutes.
  • Connection test passed, but a second test could not run. : réessayez dans quelques minutes.
Pour tester à nouveau, ouvrez le menu More options de la connexion dans Organization settings > Git providers et sélectionnez Test connection.

Le démarrage de la session échoue avec Unable to get organization UUID

Claude Code n’a pas pu lire d’organisation claude.ai à partir de vos identifiants. Connectez-vous avec /login en utilisant un compte de votre organisation Team ou Enterprise, car la prise en charge de GitHub Enterprise Server est limitée à ces forfaits. Consultez Unable to get organization UUID pour connaître les causes et les autres messages produits par cet état. Ces pages couvrent les fonctionnalités référencées dans ce guide en plus de détails :