Chapter 4 · Aller plus loin sans te perdre
Erreurs fréquentes, aide et check-list finale
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freeQuand ça coince : les bons réflexes
Tout le monde bloque un jour. Cette leçon réunit les erreurs fréquentes décrites par la documentation officielle, puis ta check-list finale.
Pourquoi garder cette page sous la main
Aurore est consultante. Un matin, claude n'est plus « reconnu ». Elle a cru devoir tout réinstaller : une fenêtre de terminal neuve a suffi.
Les erreurs d'installation
La page officielle de dépannage est https://code.claude.com/docs/en/troubleshoot-install. Voici les cas les plus courants qu'elle décrit.
claude introuvable ou non reconnu (command not found: claude ou 'claude' is not recognized) :
- Ouvre une nouvelle fenêtre de terminal (ou quitte et rouvre ton éditeur).
- Sur Mac, ajoute le dossier au PATH avec les deux commandes de la leçon 5.
- Sur Windows, la documentation donne ces deux lignes, à coller dans PowerShell, pour ajouter le dossier d'installation à ton PATH utilisateur :
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
Puis ferme et rouvre le terminal.
Mauvaise fenêtre sur Windows : The token '&&' is not a valid statement separator veut dire que tu es dans PowerShell ; 'irm' is not recognized veut dire que tu es dans CMD (leçon 4).
Erreur 403 ou syntax error pendant l'installation : la page de dépannage traite ces cas. Ouvre-la plutôt que de deviner.
Les erreurs de connexion
- Le navigateur ne s'ouvre pas : appuie sur
cpour copier l'adresse de connexion et colle-la dans ton navigateur. - La connexion échoue sans raison claire : la documentation conseille
/logout, puis fermer Claude Code, puis relancerclaudeet te reconnecter. API Error: 403 Request not allowed: si tu as un abonnement Pro ou Max, vérifie qu'il est actif sur https://claude.ai/settings.- Ton abonnement n'est pas utilisé : une variable
ANTHROPIC_API_KEYpeut prendre le dessus./statusmontre la méthode de connexion active.
Où chercher de l'aide
D'après la documentation officielle :
- Dans Claude Code : tape
/help, ou pose ta question directement (« comment je crée un skill ? »). - Diagnostic :
claude doctordans le terminal, pour un rapport sur ton installation. - Signaler un problème :
/feedbackdans une session, ou les problèmes connus sur https://github.com/anthropics/claude-code/issues - Documentation : https://code.claude.com/docs
- Cours gratuits : Claude Academy, https://academy.claude.com
- Compte ou abonnement : le support Anthropic, depuis claude.ai, menu de ton compte, « Get help ».
Un prompt pour comprendre n'importe quelle erreur
Contexte : voici le message d'erreur complet : [colle l'erreur]. Il apparaît quand je [action].
Objectif : corriger la cause réelle, pas seulement le symptôme.
Contraintes : mots simples. Si l'erreur contient une clé ou un mot de passe, signale-le sans le répéter. Si tu n'es pas sûr d'une commande, renvoie-moi vers la documentation officielle.
Format attendu : la cause en 3 lignes, puis la correction proposée.
Validation : après mon accord, corrige et dis-moi comment vérifier que l'erreur ne revient plus.
Les erreurs à éviter
- Réinstaller au premier souci. Lis le message, ouvre une nouvelle fenêtre, lance
claude doctor. - Coller une capture avec une clé, un e-mail client ou une facture. Recadre ou floute avant.
À toi de jouer
- Lance
claude doctoret lis le rapport. - Coche la check-list ci-dessous.
Ta check-list récapitulative
- ☐ Mon compte donne accès à Claude Code (Pro, Max, Team, Enterprise ou Console), vérifié sur la page officielle.
- ☐ Mon ordinateur respecte la configuration minimale de la documentation.
- ☐ J'ai choisi ma porte d'entrée : terminal, application de bureau ou extension.
- ☐
claude --versionaffiche un numéro de version dans une nouvelle fenêtre. - ☐ Je me suis connecté et
/statusaffiche le bon compte. - ☐ Je lance Claude Code dans un dossier de projet, jamais depuis le Bureau.
- ☐ J'ai fait une première demande et lu une demande de permission avant d'accepter.
- ☐ Je sais passer d'un mode de permission à l'autre avec
Shift+Tab. - ☐ Mon CLAUDE.md existe, tient en une page et contient mes deux règles de sécurité.
- ☐ Mon premier skill apparaît dans
/skills. - ☐ Je connais
claude doctor,/helpet la page de dépannage officielle.
Aller plus loin
Tu as maintenant Claude Code installé, un CLAUDE.md et un premier skill. Si tu veux gagner du temps sur la suite, le Pack Prompts IA de GoVincia contient 13 skills Claude Code prêts à l'emploi et 10 guides PDF.
Pour ce que tu viens d'apprendre, deux skills du pack prolongent directement cette formation :
- createur-claude-md : il regarde ton dossier sans rien modifier, te pose les questions qui manquent une par une, ajoute les deux règles de sécurité et n'écrit ton CLAUDE.md qu'après ton accord.
- prompt-precis : il transforme une demande floue en prompt structuré (contexte, objectif, contraintes, format attendu, validation) et attend ton « go » avant d'agir.
Le guide « Les bases de Claude Code » du pack va plus loin : conversations, mode plan, Git, connecteurs, clés API, et un prompt qui installe les 13 skills d'un coup. Les autres guides couvrent le site, les carrousels, la vidéo, les images, Instagram et la sécurité.
Le pack est sur govincia.fr (lien en bio). Il n'est pas obligatoire : tout ce que tu as vu ici marche sans lui. Il t'évite simplement d'écrire ces méthodes toi-même.