Claude Code avec GitHub Enterprise Server
Connectez Claude Code à votre instance GitHub Enterprise Server auto-hébergée pour les sessions web, la révision de code et les marketplaces de plugins.
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 web 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 sur le web 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.
| Fonctionnalité | Support GHES | Notes |
|---|---|---|
| Claude Code sur le web | ✅ Supporté | Un propriétaire connecte l'instance GHES une fois ; les développeurs utilisent claude --cloud ou claude.ai/code comme d'habitude |
| Révision de code | ✅ Supporté | Mêmes révisions de PR automatisées que github.com |
| Claude Security | ✅ Supporté | Disponible en bêta publique pour les plans Enterprise à claude.ai/security |
| Sessions Teleport | ✅ Supporté | Déplacez les sessions entre le web et le terminal avec --teleport |
| Marketplaces de plugins | ✅ Supporté | Les exigences en matière d'identifiants varient selon la surface. Voir Marketplaces de plugins sur GHES |
| Métriques de contribution | ✅ Supporté | Livrées via webhooks au tableau de bord d'analyse |
| GitHub Actions | ✅ Supporté | Nécessite une configuration manuelle du workflow ; /install-github-app est github.com uniquement |
| Serveur GitHub MCP | ❌ Non supporté | Le serveur GitHub MCP ne fonctionne pas avec les instances GHES |
Configuration administrateur
Un propriétaire connecte votre instance GHES à Claude Code une seule fois. Après cela, les développeurs de votre organisation peuvent utiliser les dépôts GHES sans aucune configuration supplémentaire. 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.
Ouvrir les paramètres administrateur de Claude Code
Allez à claude.ai/admin-settings/claude-code et trouvez la section GitHub Enterprise Server.
Démarrer la configuration guidée
Cliquez sur Connecter. Entrez un nom d'affichage 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.
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.
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.
Activer les fonctionnalités
Retournez à claude.ai/admin-settings/claude-code et activez Révision de code, Claude Security et métriques de contribution 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 dont Claude a besoin pour les sessions web, la révision de code, Claude Security et les métriques de contribution :
| Permission | Accès | Utilisé pour |
|---|---|---|
| Contents | Lecture et écriture | Clonage de dépôts et envoi de branches |
| Pull requests | Lecture et écriture | Création de PR et publication de commentaires de révision |
| Issues | Lecture et écriture | Réponse aux mentions de problèmes |
| Checks | Lecture et écriture | Publication des exécutions de vérification de révision de code |
| Actions | Lecture | Lecture du statut CI pour la correction automatique |
| Repository hooks | Lecture et écriture | Réception des webhooks pour les métriques de contribution |
| Metadata | Lecture | Requis par GitHub pour toutes les applications |
L'application s'abonne aux événements pull_request, issue_comment, pull_request_review_comment, pull_request_review et check_run.
Configuration manuelle
Si le flux de redirection guidé est bloqué par votre configuration réseau, cliquez sur Ajouter manuellement au lieu de Connecter. Créez une GitHub App sur votre instance GHES avec les permissions et événements ci-dessus, puis entrez les identifiants de l'application dans le formulaire : nom d'hôte, ID client OAuth et secret, ID de GitHub App, ID client, secret client, secret webhook et clé privée.
Exigences réseau
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 révision. Si votre instance GHES est derrière un pare-feu, mettez en liste blanche les adresses IP de l'API Anthropic.
Flux de travail des développeurs
Une fois que votre administrateur a connecté l'instance GHES, aucune configuration côté développeur n'est nécessaire. Claude Code détecte automatiquement le nom d'hôte de votre GHES à partir de la télécommande git dans votre répertoire de travail.
Clonez un dépôt à partir de votre instance GHES comme vous le feriez normalement :
git clone git@github.example.com:platform/api-service.git
cd api-service
Ensuite, démarrez une session web. 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 :
claude --cloud "Add retry logic to the payment webhook handler"
La session s'exécute sur l'infrastructure Anthropic, clone votre dépôt à partir de GHES et repousse les modifications vers une branche. Surveillez la progression avec /tasks ou à claude.ai/code. Consultez Claude Code sur le web pour le flux de travail complet de la session distante, y compris la révision des différences, la correction automatique et les routines.
Téléporter les sessions vers votre terminal
Tirez une session web 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 :
| Surface | Fonctionnement de l'installation | Ce dont chaque utilisateur a besoin |
|---|---|---|
| Claude Code CLI et bureau | Claude Code clone le dépôt de la marketplace en utilisant les identifiants git existants de la machine | Accès Git à votre hôte GHES depuis leur machine |
Paramètres gérés (extraKnownMarketplaces) |
Claude Code enregistre l'entrée et clone le dépôt en utilisant les identifiants git existants de la machine | Accès Git à votre hôte GHES depuis leur machine |
| Paramètres de plugin de l'organisation claude.ai | Un propriétaire sélectionne l'instance GHES comme source ; le backend d'Anthropic récupère et synchronise le dépôt en utilisant l'application GitHub de la configuration d'administration | Rien par utilisateur une fois ajouté. Le propriétaire qui l'ajoute doit avoir son propre compte GitHub Enterprise connecté comme vérification d'accès, et l'application GitHub doit être installée sur le dépôt de la marketplace |
| Paramètres utilisateur claude.ai | Le backend d'Anthropic récupère le dépôt en utilisant la connexion GitHub Enterprise de l'utilisateur qui le soumet | Son propre compte GitHub Enterprise connecté à Claude |
| Claude Code sur le web | Les sessions cloud clonent les marketplaces à l'intérieur du sandbox de la session. Le sandbox ne peut atteindre votre instance GHES que lorsque le dépôt de la session se trouve sur cette même instance, et ses identifiants git sont limités aux dépôts de la session | Non fiable pour les marketplaces hébergées sur GHES : un hôte différent du dépôt de la session n'est pas accessible, et même les installations sur la même instance peuvent échouer. Utilisez plutôt la CLI, les paramètres gérés ou claude.ai |
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. Les URL HTTPS sont recommandées :
/plugin marketplace add https://github.example.com/platform/claude-plugins.git
Les URL SSH fonctionnent si la machine fait déjà confiance à votre hôte GHES :
/plugin marketplace add git@github.example.com:platform/claude-plugins.git
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 :
{
"extraKnownMarketplaces": {
"internal-tools": {
"source": {
"source": "git",
"url": "https://github.example.com/platform/claude-plugins.git"
}
}
}
}
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/repose 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 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 :
{
"strictKnownMarketplaces": [
{
"source": "hostPattern",
"hostPattern": "^github\\.example\\.com$"
}
]
}
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 : utilisez plutôt la CLI
ghconfigurée pour votre hôte GHES. Exécutezgh auth login --hostname github.example.compour vous authentifier, puis Claude peut utiliser les commandesghdans les sessions.
Dépannage
La session web échoue à cloner le dépôt
Si claude --cloud échoue avec une erreur de clonage, vérifiez qu'un propriétaire a terminé la configuration de votre instance GHES et que la GitHub App est installée sur le dépôt sur lequel vous travaillez. Demandez au propriétaire qui a connecté l'instance de confirmer que le nom d'hôte enregistré dans les paramètres Claude correspond au nom d'hôte de votre télécommande git.
L'ajout de 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 le nom d'hôte de votre GHES dans les paramètres gérés.
L'ajout de marketplace sur claude.ai échoue avec une erreur d'accès GitHub
Si l'ajout d'un marketplace GHES à partir de vos paramètres utilisateur échoue avec une erreur générique comme « Marketplace n'a pas pu être ajouté », 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 pointe pas vers le flux de connexion GitHub Enterprise, et l'option « Se connecter à GitHub » sur l'onglet Parcourir se connecte à github.com, ce qui n'accorde pas l'accès aux dépôts GHES.
Pour connecter votre compte GitHub Enterprise : le sélecteur de dépôt sur claude.ai/code offre une option de connexion pour chaque instance GHES configurée, et les propriétaires peuvent également se connecter à partir de la section GitHub Enterprise des paramètres d'administration Claude Code. Ensuite, ajoutez le marketplace à nouveau. Vous pouvez également demander à un propriétaire d'ajouter le marketplace dans les paramètres de plugin de l'organisation, ce qui supprime l'exigence de connexion par utilisateur.
Sur d'autres surfaces claude.ai, une erreur « Dépôt non trouvé. S'il est privé, l'accès GitHub est requis » sur un marketplace GHES indique généralement la même connexion manquante. Connectez votre compte GitHub Enterprise via l'un des chemins ci-dessus, puis réessayez.
Instance GHES non accessible
Si les révisions ou les sessions web expirent, votre instance GHES peut ne pas être accessible à partir de l'infrastructure Anthropic. Confirmez que votre pare-feu autorise les connexions entrantes à partir des adresses IP de l'API Anthropic.
Ressources connexes
Ces pages couvrent les fonctionnalités référencées dans ce guide en plus de détails :
- Claude Code sur le web : exécutez les sessions Claude Code sur l'infrastructure cloud
- Révision de code : révisions de PR automatisées
- Marketplaces de plugins : créer et distribuer des catalogues de plugins
- Analyse : suivre l'utilisation et les métriques de contribution
- Paramètres gérés : configuration de politique à l'échelle de l'organisation
- Configuration réseau : exigences de pare-feu et de liste blanche IP