GitHub Copilot App ne fonctionne pas ? Ne réinstallez pas immédiatement : cette semaine, identifiez d’abord le niveau de panne — démarrage, connexion, dépôt, politique d’organisation, exécution de l’agent ou limite d’utilisation — puis appliquez uniquement le correctif correspondant. Cette méthode est valable si vous ne parvenez pas à vous connecter, si vos dépôts privés sont invisibles ou si une première Agent Session ne peut pas lancer une commande.
Cette page s’adresse à trois profils :
- aux développeurs qui viennent d’installer l’application et ne peuvent pas créer leur première session ;
- aux membres d’une équipe qui ne voient pas un dépôt privé ou ne peuvent pas pousser une branche ;
- aux administrateurs GitHub qui doivent déterminer si le blocage vient du poste ou d’une politique d’entreprise.
Commencez par classer le symptôme
Un même message général peut masquer des causes très différentes. Le premier contrôle consiste donc à noter ce qui fonctionne encore.
Si l’application ne s’ouvre pas du tout, commencez par le téléchargement, le système d’exploitation, la mise à jour et les protections locales. Si la fenêtre s’ouvre mais que l’authentification échoue, concentrez-vous sur le compte GitHub, le navigateur, le réseau et l’authentification unique. Si vous êtes connecté mais que le dépôt manque, le problème se situe généralement dans l’autorisation, l’organisation ou l’adresse Git.
Enfin, si le dépôt est chargé mais que l’agent ne lance aucun test, il faut examiner l’espace de travail, les dépendances, les droits de fichiers, le réseau sortant et les limites de crédits.
GitHub indique que l’application prend en charge macOS, Windows et Linux. Elle nécessite également un compte GitHub, Git installé localement et soit un accès Copilot, soit un fournisseur de modèle configuré avec vos propres identifiants. (documentation GitHub sur la prise en main)
Une note importante pour les environnements d’entreprise : le 27 juillet 2026, GitHub a séparé la politique d’accès de GitHub Copilot App de celle de Copilot CLI. Vérifier uniquement l’ancienne politique Copilot CLI peut donc conduire à un faux diagnostic. (annonce GitHub sur la politique dédiée)
Vérifiez l’installation avant de toucher au compte
Lorsque GitHub Copilot App ne fonctionne pas dès son lancement, procédez dans cet ordre.
1. Confirmez la source et l’intégrité du téléchargement
Téléchargez l’application depuis la page officielle référencée dans la documentation GitHub. Évitez une copie récupérée dans un dépôt, une archive de forum ou un ancien lien partagé par un collègue. Une version ancienne peut ouvrir l’interface tout en échouant lors de l’authentification ou de la création d’une session.
Si votre système affiche un avertissement de sécurité, ne le contournez pas immédiatement. Vérifiez d’abord que le fichier provient bien de la source officielle, puis consultez les réglages de sécurité de votre système. Une quarantaine antivirus, une politique MDM ou une restriction d’exécution peut empêcher le démarrage sans que l’application soit réellement défectueuse.
2. Notez le moment exact et le texte de l’erreur
Ne vous contentez pas de noter « l’application ne marche pas ». Relevez :
- l’heure locale ;
- l’étape exacte : lancement, connexion, sélection du dépôt ou démarrage de l’agent ;
- le texte complet affiché ;
- le système utilisé et sa version ;
- la version de GitHub Copilot App ;
- la présence éventuelle d’un VPN, d’un proxy ou d’une politique de sécurité.
Ne publiez jamais dans une capture un jeton, une clé API, une adresse de dépôt privé, un nom complet ou une adresse électronique. Un journal utile est un journal dépersonnalisé.
3. Testez un démarrage avec un dossier local simple
Créez ou sélectionnez un dossier de test ne contenant aucun secret et aucun dépôt professionnel. L’objectif n’est pas encore de faire travailler l’agent, mais de vérifier si l’interface peut créer un espace de travail local.
Si l’application s’ouvre et accepte ce dossier, le problème est probablement lié au compte GitHub, au dépôt ou à l’organisation. Si elle échoue avant même cette étape, concentrez-vous sur l’installation, le système, le réseau local ou les restrictions de sécurité.
Ne partez pas du principe qu’un problème de lancement vient d’un manque de puissance. La documentation officielle ne fournit pas de configuration matérielle minimale universelle à utiliser comme diagnostic. Attribuer automatiquement l’échec aux performances du Mac ou du PC vous ferait perdre du temps.
Réinitialisez l’authentification sans mélanger les comptes
Que faire lorsque la connexion à GitHub Copilot App échoue ?
La procédure la plus fiable consiste à séparer trois tests : le compte, le navigateur et l’environnement réseau.
- Ouvrez GitHub dans votre navigateur habituel.
- Vérifiez que vous êtes connecté au bon compte.
- Ouvrez manuellement le dépôt que vous souhaitez utiliser.
- Confirmez que vous pouvez consulter ses fichiers et ses branches.
- Relancez ensuite la connexion depuis GitHub Copilot App.
Cette vérification est décisive. Si le dépôt n’est déjà pas accessible dans le navigateur, l’application ne peut pas créer une autorisation qu’il vous manque sur GitHub.
Si l’authentification tourne en boucle, essayez une fenêtre privée uniquement pour distinguer un problème de session navigateur d’un problème de compte. Les cookies obsolètes, plusieurs comptes ouverts simultanément ou une extension de confidentialité peuvent interrompre le retour vers l’application. Après le test, reconnectez-vous avec le compte réellement associé à votre licence Copilot ou à votre fournisseur BYOK.
Un proxy d’entreprise peut également laisser passer GitHub dans le navigateur tout en bloquant le retour vers l’application de bureau. Dans ce cas, comparez le comportement sur un réseau différent, par exemple un partage de connexion temporaire autorisé par votre politique interne. Si la connexion fonctionne alors, vous avez isolé un problème réseau plutôt qu’un problème de compte.
Pour une organisation protégée par SAML SSO, une session SSO active peut être nécessaire avant d’autoriser une application à accéder aux ressources de l’organisation. GitHub recommande de créer cette session, puis de relancer l’autorisation. (documentation GitHub sur l’autorisation OAuth)
Rétablissez l’accès aux dépôts et aux branches
Pourquoi Copilot App ne voit-il pas un dépôt privé ?
L’application ne voit pas nécessairement tous les dépôts auxquels votre compte a un accès général. Plusieurs conditions doivent être réunies : le compte utilisé dans l’application, l’accès réel au dépôt, l’autorisation de l’organisation et la méthode de connexion choisie.
Commencez par vérifier les points suivants :
- le dépôt privé est bien visible depuis votre navigateur ;
- vous êtes membre de l’organisation ou collaborateur autorisé ;
- l’accès n’est pas limité par une restriction OAuth ou une approbation administrateur ;
- l’organisation n’utilise pas un SSO dont la session est expirée ;
- le dépôt n’a pas été renommé, déplacé ou archivé ;
- vous n’avez pas ouvert l’application avec un autre compte GitHub.
L’autorisation d’une application et son installation dans une organisation ne sont pas exactement la même opération. Une application peut être autorisée pour votre compte personnel tout en restant bloquée pour les ressources privées d’une organisation. GitHub précise aussi qu’une organisation peut exiger l’approbation d’un propriétaire avant qu’une application OAuth accède à ses données. (documentation GitHub sur l’autorisation des applications)
Si le dépôt n’apparaît toujours pas, utilisez l’option de connexion par dossier local. Clonez d’abord le dépôt avec Git, puis ajoutez ce dossier dans l’application. Cette méthode permet de distinguer un problème de navigation GitHub d’un problème de droits Git locaux.
Clonage, poussée et dépôt externe
Le fait de pouvoir lire un dépôt ne garantit pas que vous pouvez pousser une branche. Contrôlez le dépôt distant et l’identité Git utilisée :
git remote -v
git status
git branch --show-current
git fetch
Ces commandes ne contiennent normalement aucun secret. En revanche, ne copiez pas dans un ticket public la sortie complète d’une configuration contenant une URL avec jeton.
Si vous utilisez une URL Git vers un hébergeur qui n’est pas GitHub, GitHub Copilot App peut connecter le projet via une URL Git, mais les identifiants de cet hébergeur restent indépendants. L’authentification GitHub ne donne pas automatiquement accès à un dépôt externe. Les dépôts hébergés ailleurs ou les dépôts privés sans accès direct à l’application peuvent être ajoutés par URL Git.
Pour un échec de poussée, vérifiez également :
- la branche protégée ;
- l’obligation de passer par une demande de fusion ;
- les contrôles CI obligatoires ;
- les droits d’écriture du compte ;
- la présence d’un gestionnaire d’identifiants obsolète ;
- l’utilisation d’une clé SSH différente de celle attendue.
Ne demandez pas à l’agent de contourner une règle de branche. Corrigez d’abord le droit ou ouvrez une branche de test.
Contrôlez la politique d’organisation du 27 juillet 2026
Comment débloquer un compte d’organisation ?
Depuis le 27 juillet 2026, GitHub Copilot App possède une politique client distincte. Dans les paramètres d’entreprise ou d’organisation, l’administrateur doit vérifier la section des contrôles IA, puis la politique dédiée à l’application. Les choix annoncés sont l’activation partout, la désactivation partout ou la délégation aux organisations.
L’administrateur doit donc examiner quatre niveaux :
- l’utilisateur dispose-t-il d’une licence Copilot ou d’un fournisseur BYOK correctement configuré ?
- l’organisation autorise-t-elle GitHub Copilot App ?
- l’entreprise impose-t-elle une décision plus restrictive ?
- un fichier de paramètres gérés limite-t-il les commandes, extensions, modèles ou contournements d’approbation ?
Les paramètres gérés au niveau entreprise peuvent désormais s’appliquer à GitHub Copilot App. GitHub précise que des réglages comme les extensions autorisées, les places de marché utilisables ou l’obligation d’approuver certaines actions peuvent être imposés aux clients. Après une modification, un redémarrage ou une nouvelle connexion peut être nécessaire avant que l’application récupère les nouveaux paramètres. (documentation GitHub sur les politiques Copilot)
Attention : ne demandez pas à un membre de désactiver durablement les contrôles de sécurité pour confirmer un diagnostic. Faites un test limité, sur un dépôt non sensible, avec une fenêtre d’autorisation connue et documentée.
Pour une organisation utilisant plusieurs licences ou plusieurs entreprises, les politiques peuvent aussi se combiner de manière inattendue. Certaines situations appliquent la politique la plus restrictive, tandis que la disponibilité de l’application peut dépendre de l’organisation qui fournit la licence.
Réduisez l’Agent Session à une tâche minimale
Pourquoi une session d’agent ne peut-elle pas exécuter une commande ?
Une Agent Session peut être correctement authentifiée et tout de même échouer dans l’exécution. L’application peut fonctionner dans un espace isolé, un nouvel arbre de travail ou un environnement d’exécution distant. Le résultat dépend alors de l’emplacement choisi, des dépendances installées, des droits de fichiers et des restrictions réseau. (documentation GitHub sur les sessions d’agent)
Utilisez cette séquence :
- ouvrez un petit dépôt de test ;
- choisissez le mode interactif plutôt que l’autonomie complète ;
- demandez à l’agent de lister les fichiers, sans les modifier ;
- demandez ensuite d’expliquer la commande de test à exécuter ;
- lancez une seule commande non destructive ;
- vérifiez le code de retour ;
- seulement après, autorisez une modification limitée.
Évitez comme premier test une installation complète, une migration de base de données, une suppression de fichiers ou une commande nécessitant des privilèges élevés. Ces actions peuvent être bloquées par une demande d’approbation, un environnement isolé ou des permissions du système.
Contrôlez ensuite :
- le fichier de dépendances existe-t-il réellement ;
- le gestionnaire de paquets est-il installé ;
- les variables d’environnement nécessaires sont-elles présentes ;
- le dossier de travail est-il accessible en lecture et écriture ;
- le test a-t-il besoin d’Internet ;
- le certificat réseau ou le proxy bloque-t-il le téléchargement ;
- la commande attend-elle un service externe non démarré ?
Pour un projet audio, vidéo ou design, le diagnostic doit aussi tenir compte des fichiers lourds, des outils natifs et des chemins locaux. Un agent peut modifier correctement le code d’un pipeline, mais échouer parce que le codec, le logiciel de rendu ou le volume de médias n’est pas disponible dans l’environnement sélectionné.
Séparez modèle, BYOK et crédits IA
Un agent qui répond mais s’arrête rapidement peut être limité par le modèle sélectionné, un fournisseur BYOK mal configuré, une limite de débit ou l’épuisement des crédits IA.
GitHub Copilot App prend en charge les modèles hébergés par GitHub ainsi que des fournisseurs configurés par l’utilisateur. En mode BYOK, vous devez fournir les paramètres du fournisseur et les identifiants nécessaires ; ces identifiants sont conservés dans le coffre de secrets du système et ne sont pas affichés dans l’interface. (documentation GitHub sur les modèles BYOK)
Vérifiez donc :
- le modèle sélectionné est-il encore disponible pour votre compte ;
- le fournisseur BYOK répond-il depuis votre réseau ;
- l’URL de base est-elle correcte ;
- la clé n’est-elle pas expirée ou limitée ;
- le budget du fournisseur autorise-t-il la requête ;
- votre compte GitHub a-t-il atteint sa limite de crédits ou de débit ?
Les crédits IA sont l’unité de suivi de la consommation des interactions Copilot. La documentation GitHub indique qu’un crédit correspond à 0,01 USD et que la consommation dépend notamment du modèle et du nombre de jetons utilisés. (documentation GitHub sur les limites de session)
Une limite ne signifie donc pas forcément que l’application est cassée. Il faut attendre en cas de limitation temporaire, examiner l’usage et vérifier les options de budget ou d’abonnement disponibles. Le suivi se trouve dans les paramètres d’utilisation Copilot, avec une vue différente selon que vous utilisez un compte individuel ou une licence d’organisation. (documentation GitHub sur les limites d’utilisation)
Utilisez cette grille avant de contacter le support
Attribuez un point à chaque test réussi. Le but n’est pas d’obtenir une note parfaite, mais d’identifier le prochain niveau à inspecter.
| Test | Résultat | Diagnostic probable | Action suivante |
|---|---|---|---|
| L’application s’ouvre | Oui / non | Installation ou sécurité locale si non | Vérifier la source, la version et les blocages système |
| Le compte GitHub ouvre le dépôt dans le navigateur | Oui / non | Compte ou autorisation si non | Reconnecter le bon compte et contrôler SSO |
| Le dépôt apparaît dans l’application | Oui / non | Accès organisationnel ou autorisation si non | Examiner les droits du dépôt et la politique d’organisation |
git fetch fonctionne localement |
Oui / non | Identifiants ou URL distante si non | Corriger Git, SSH, HTTPS ou le gestionnaire d’identifiants |
| Une tâche de lecture fonctionne | Oui / non | Espace de travail ou agent si non | Tester un dossier minimal et le mode interactif |
| Une commande sans risque fonctionne | Oui / non | Dépendances, environnement isolé ou approbation si non | Vérifier l’environnement et les permissions |
| Le modèle répond sans erreur de limite | Oui / non | Modèle, BYOK, crédits ou débit si non | Vérifier fournisseur, usage et budget |
Un score faible sur les deux premières lignes ne se corrige pas avec une modification du projet. Un score élevé jusqu’à la ligne Git mais un échec sur l’agent indique plutôt un problème d’environnement d’exécution. Cette distinction évite de supprimer et recréer inutilement le dépôt local.
Préparez un dossier de support exploitable
Si le blocage persiste, envoyez une reproduction minimale. Décrivez une seule action qui échoue, sur un dépôt de test ou un dossier sans données sensibles.
Incluez :
- la version exacte de GitHub Copilot App ;
- le système d’exploitation ;
- la date et l’heure avec fuseau ;
- le type de compte : individuel, organisation ou entreprise ;
- le dépôt utilisé, remplacé par un identifiant neutre ;
- le mode de session ;
- le modèle ou le fournisseur BYOK, sans révéler la clé ;
- le texte exact de l’erreur ;
- les étapes permettant de reproduire ;
- les tests déjà réalisés ;
- un journal expurgé des jetons, URL privées, courriels et chemins personnels.
Ne fabriquez pas de code d’erreur à partir d’un message approximatif. Si aucun code officiel ou aucune reproduction réelle n’existe, citez le texte affiché et indiquez précisément à quelle étape l’échec survient.
Si votre poste local reste instable malgré une installation saine, un réseau fiable et des droits corrects, comparez alors le coût opérationnel de votre environnement actuel avec un Mac distant : votre poste local ajoute les mises à jour, la veille, les interruptions réseau, les restrictions de sécurité et la nécessité de rester connecté pendant les tâches longues. Un environnement loué auprès de VPSSpark peut être plus cohérent pour des tests temporaires, des sessions Agent Sessions prolongées ou des projets audio, vidéo et design, à condition de vérifier la compatibilité réelle du logiciel, les interfaces physiques nécessaires et la politique de conservation des données. Consultez la présentation de VPSSpark et de ses environnements, puis demandez une validation technique via le contact VPSSpark avant de déplacer un dépôt professionnel.
La bonne décision n’est donc pas « réinstaller ou abandonner ». C’est de conserver la preuve du premier échec, réussir une reproduction minimale, puis choisir entre correction locale, intervention de l’administrateur ou environnement distant.
Un environnement Mac distant pour travailler sans interruption
Avec VPSSpark, vous disposez d’un Mac distant prêt à l’emploi pour développer, tester et exécuter vos outils depuis n’importe où.
Accédez à une session Mac dédiée afin de distinguer rapidement les problèmes liés à votre appareil local de ceux liés à votre environnement de travail.