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 administrateur connecte votre instance GHES, les développeurs peuvent exécuter des sessions web, obtenir des révisions de code automatisées et installer des plugins à partir de marketplaces internes sans aucune configuration par dépôt.
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é | L'administrateur connecte l'instance GHES une fois ; les développeurs utilisent claude --remote 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é | Utilisez les URL git complètes au lieu du raccourci owner/repo |
| 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 administrateur 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 d'un accès administrateur à 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 --remote "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 ; la seule différence est la façon dont vous les référencez.
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 :
/plugin marketplace add git@github.example.com:platform/claude-plugins.git
Les URL HTTPS fonctionnent également :
/plugin marketplace add https://github.example.com/platform/claude-plugins.git
Consultez Créer et distribuer une marketplace de plugins pour le guide complet de la création de marketplaces.
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$"
}
]
}
Vous pouvez également pré-enregistrer les marketplaces pour les développeurs afin qu'elles apparaissent sans configuration manuelle. Cet exemple rend une marketplace d'outils internes disponible à l'échelle de l'organisation :
{
"extraKnownMarketplaces": {
"internal-tools": {
"source": {
"source": "git",
"url": "git@github.example.com:platform/claude-plugins.git"
}
}
}
}
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 --remote échoue avec une erreur de clonage, vérifiez que votre administrateur 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. Vérifiez auprès de votre administrateur que le nom d'hôte de l'instance 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.
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