Neuf blocages sur dix se règlent en deux minutes quand on sait où regarder. Cherchez votre symptôme, la cause est presque toujours plus bête qu'elle en a l'air.
Et gardez ce réflexe : quand un message d'erreur apparaît, copiez-le et donnez-le à Claude. C'est son métier, pas le vôtre.
Mon dépôt n'apparaît pas dans la liste de Claude
Vous avez probablement choisi Only select repositories au moment d'autoriser GitHub, et oublié celui-ci.
Sur github.com : Settings → Applications → Claude → Configure, vérifiez que projet figure sous Repository access.
Astuce au passage : le sélecteur de dépôt dans Claude a un champ de recherche. Tapez les premières lettres plutôt que de faire défiler.
Claude dit que le dépôt est vide, ou qu'il ne trouve pas de branche
Le fameux README oublié à l'étape 1.
Sur GitHub, ouvrez votre dépôt. S'il affiche un écran d'instructions avec des lignes de commande au lieu d'une liste de fichiers, il est vide.
La réparation prend dix secondes : cliquez Add file → Create new file, nommez-le README.md, écrivez une ligne dedans, puis Commit changes. Votre dépôt a maintenant une branche main, et Claude peut y travailler.
Claude a fini mais je ne vois rien sur GitHub
C'est le comportement normal, pas une panne. Claude travaille sur une branche, pas sur main.
Il vous manque l'étape 4 : ouvrir la vue des modifications, Créer une PR, puis Merge pull request sur GitHub.
Pour vérifier : sur la page de votre dépôt, le menu déroulant des branches, en haut à gauche. Vous devriez y voir une branche dont le nom commence par claude/. Votre travail est là.
J'ai fusionné, mais mon site affiche encore l'ancienne version
Trois vérifications, dans cet ordre.
Le déploiement est-il terminé ? Sur Vercel, l'onglet Deployments. Attendez le statut Ready.
Regardez-vous la bonne adresse ? L'adresse de production est celle affichée sous Domains sur la page du projet. Les adresses plus longues, avec une suite de lettres, correspondent à d'autres versions.
Votre navigateur triche. Il garde l'ancienne page en mémoire. Rechargez en forçant : Cmd + Maj + R sur Mac, Ctrl + F5 sur Windows.
Le déploiement Vercel échoue (Build failed)
Le cas le plus courant, et le plus simple à traiter.
Ouvrez le déploiement en échec, descendez le journal jusqu'aux lignes rouges, copiez-les. Retournez dans Claude : « Le déploiement Vercel a échoué avec cette erreur : [collez]. Corrige et pousse. »
Puis Créer une PR, Merge, et Vercel repart tout seul.
N'essayez pas de déchiffrer l'erreur vous-même. Ces messages sont écrits par des développeurs pour des développeurs — et Claude les lit couramment.
Mon site s'affiche mais le design est cassé
Presque toujours un souci de feuille de style, et ça se répare par une phrase :
« Sur le site déployé, [décrivez ce que vous voyez : les styles ne s'appliquent pas / la mise en page est décalée sur téléphone / les polices ne se chargent pas]. Vérifie et corrige. »
Soyez descriptif plutôt que technique. Claude n'a pas vos yeux : dites-lui ce que vous voyez, pas ce que vous croyez être la cause.
Je ne retrouve plus ma session Claude
Les sessions restent dans la colonne de gauche de Claude Code, sous Nouveau. Elles ne se ferment pas quand vous fermez l'onglet.
Si vous ne la retrouvez vraiment pas, ce n'est pas grave : votre travail est sur GitHub, pas dans la conversation. Ouvrez une nouvelle session sur le même dépôt et reprenez — Claude relira votre CLAUDE.md et saura où vous en étiez.
On me parle de limites ou on me demande de payer
Côté Claude : vous avez atteint la limite d'utilisation de votre abonnement sur la période. Elle se réinitialise après quelques heures.
Côté GitHub : ça ne devrait pas arriver. Les dépôts publics et privés sont illimités sur le plan gratuit.
Côté Vercel : le plan Hobby est très large pour un projet personnel. Si vous voyez un avertissement, c'est souvent le rappel que l'usage commercial demande le plan payant.
Votre problème n'est pas dans cette liste ? Décrivez-le à Claude en une phrase, avec ce que vous voyez à l'écran. Vous serez surpris de la fréquence à laquelle ça suffit.