Dépannage de base et mises à jour

Cette leçon est encore en test : elle s'améliore avec les retours des apprenants. Si quelque chose n'est pas clair, c'est la leçon qu'il faut corriger, pas toi.

À la fin de cette leçon, tu sauras

appliquer 4 réflexes dans l’ordre quand quelque chose bloque ;
reconnaître les blocages les plus courants et leur solution ;
trouver la version de ton appli et de Claude Code, et mettre à jour ;
demander de l’aide avec les bonnes informations.

Pourquoi ça t’intéresse

Un blocage technique décourage plus vite qu’une difficulté d’apprentissage. Pourtant, la plupart se règlent en deux minutes : un mauvais dossier, un mode qui n’est pas le bon, une session à rouvrir, une limite d’usage. Cette leçon te rend autonome sur ces cas, et te dit quand demander de l’aide.

Avant de commencer


Il te faut	L’appli Claude avec l’onglet Code, ton dossier mon-espace-ia et ton dossier d’essais mon-espace-ia-essais (leçon 4)
Coût	Abonnement Claude Pro au minimum : 18 € par mois hors taxes, prix affiché en France au 24/10/2026
Durée	35 minutes
Rappel	Ne montre jamais un mot de passe, ni dans un message ni dans une capture

Comprendre en 3 minutes

Les 4 réflexes, dans l’ordre :

Lire le message en entier, et le copier tel quel.
Vérifier les 3 réglages : le dossier ouvert, le mode, le compte connecté.
Redémarrer : quitter complètement l’appli, la rouvrir, ouvrir une nouvelle session.
Mettre à jour l’appli, puis ouvrir une nouvelle session.

Les blocages les plus courants, d’après la documentation de Claude Code (24/10/2026) et l’expérience des leçons précédentes :

Ce que tu vois	Ce que tu fais
Erreur 403 ou problème d’authentification dans l’onglet Code	Te déconnecter puis te reconnecter depuis le menu de l’appli (la solution la plus courante) ; vérifier que ton abonnement payant est actif ; si le problème reste, et surtout si le terminal fonctionne mais pas l’appli, quitter complètement l’appli, la rouvrir et te reconnecter
« Authentication required · Sign in again to continue »	Te reconnecter depuis l’appli
Écran blanc ou bloqué au démarrage	Redémarrer l’appli ; sur Mac et Windows, elle se met à jour au lancement
« Failed to load session »	Le dossier choisi n’existe peut-être plus (déplacé, renommé) : choisis à nouveau ton dossier, ou redémarre l’appli
« You’ve hit your session limit · resets… » ou « …weekly limit… »	Ta limite d’usage est atteinte : attends l’heure indiquée, ou change d’offre. Tes usages de claude.ai, de Claude Code et de l’appli comptent dans la même limite
« API Error: 500 » ou « Repeated 529 Overloaded errors »	Un problème temporaire chez Anthropic, pas chez toi : attends une minute, puis renvoie ton message ; l’état du service est sur status.claude.com. Une erreur 529 ne compte pas dans ta limite
Claude ne trouve pas `CLAUDE.md` ou le parcours	Le mauvais dossier est ouvert : ouvre une nouvelle session sur mon-espace-ia
Claude modifie des fichiers sans te demander	Le mode n’est pas Manuel : change-le dans le sélecteur, sous la zone de texte
Tu as refusé une autorisation par erreur	Rien n’est cassé : dis-le, Claude te repropose

Faire ensemble

1Étape 1 : Relever tes versions

Version de l’appli : sur Mac, menu Claude, puis À propos de Claude ; sur Windows, menu Aide, puis À propos de Claude (en anglais : Help, About Claude ; libellés français relevés dans les fichiers de traduction de l’appli pour Mac, sans capture).
Version de Claude Code dans l’onglet Code : dans une session, tape /status et lis la ligne « Claude Code ».

Note les deux dans ta fiche dépannage (ressource ci-dessous).

2Étape 2 : Vérifier les mises à jour

Sur Mac : menu Claude, puis Check for Updates… ; sur Windows : Help, puis Check for Updates…. Ensuite, ouvre une nouvelle session : d’après la documentation, l’onglet Code utilise sa propre copie de Claude Code, que l’appli télécharge et met à jour, et une nouvelle session prend la nouvelle version.

Si tu utilises aussi Claude Code dans le terminal (leçon 2) : l’installation recommandée se met à jour toute seule en arrière-plan. Ce sont deux copies séparées : mettre à jour l’une ne met pas à jour l’autre.

3Étape 3 : Reconnaître une panne sans risque

Ouvre une nouvelle session sur ton dossier d’essais mon-espace-ia-essais, en mode Manuel, et écris :

Lis le fichier DEMARRER-ICI.md et guide-moi.

Claude ne le trouve pas : c’est le symptôme du mauvais dossier. Il peut aussi proposer de chercher ailleurs sur ton ordinateur : si une demande d’autorisation apparaît pour ça, refuse. Ferme cette session, puis rouvre une nouvelle session sur mon-espace-ia. Tu sauras maintenant reconnaître ce cas en une seconde.

4Étape 4 : Préparer une demande d’aide

Dans ta fiche dépannage, remplis le modèle « Pour demander de l’aide » avec une panne imaginaire, par exemple l’erreur 403. Vérifie qu’il n’y a ni mot de passe, ni adresse mail complète.

Faire toi-même

Ta fiche dépannage, remplie et rangée :

tes versions et ton offre ;
les 4 réflexes ;
le modèle de demande d’aide ;
à chaque nouvelle panne résolue, une ligne dans « Mes pannes déjà résolues ».

Ressources à télécharger

Ma fiche dépannage : ta configuration, les 4 réflexes, le modèle de demande d’aide et le suivi de tes pannes.

Vérifier

C’est réussi si :

ta fiche indique la version de ton appli et celle de Claude Code, avec la date ;
tu sais où vérifier les mises à jour, sur ton système ;
tu as reconnu le symptôme du mauvais dossier, puis rouvert le bon ;
ton modèle de demande d’aide est prêt, sans aucune information secrète.

Erreurs fréquentes :

réinstaller tout au premier problème : commence par les 4 réflexes ;
fermer la fenêtre sans quitter l’appli : sur Windows, l’icône peut rester près de l’horloge ;
décrire une erreur de mémoire au lieu de copier le message exact ;
prendre une erreur 500 ou 529 pour une faute de ta part : c’est temporaire, côté serveur.

Conserver et reprendre

Garde ta fiche dans mon-espace-ia ou près de ton ordinateur.
Relève ta version après chaque grosse mise à jour.

Pour aller plus loin

facultatif

La documentation officielle, en anglais : la partie « Troubleshooting » de code.claude.com/docs/en/desktop pour l’appli, et code.claude.com/docs/en/errors pour chaque message d’erreur.
Dans le terminal : /doctor vérifie ton installation et propose des corrections ; si claude ne démarre plus du tout, lance claude doctor depuis le terminal.

Mots nouveaux

4 mots expliqués

Mot	Ce que ça veut dire
Version	Le numéro qui dit quelle édition d’un logiciel tu utilises
Mise à jour	Le passage à une version plus récente, qui corrige des problèmes
Limite d’usage	La quantité de travail que ton offre permet, renouvelée par périodes de 5 heures et chaque semaine
Message d’erreur	Le texte qui dit ce qui a échoué ; on le copie tel quel pour chercher la solution

À vérifier : les libellés français des menus « About Claude » et « Check for Updates… » (capture à faire) ; le comportement de l’icône près de l’horloge sous Windows n’a pas été testé.

Date, version, sources Rédigée le 24/10/2026. Vérifications du 24/10/2026 :

dépannage de l’appli (erreur 403, écran blanc, « Failed to load session », versions, mises à jour, copie de Claude Code propre à l’onglet Code) : code.claude.com/docs/en/desktop, partie « Troubleshooting » ;
messages d’erreur (500, 529, limites d’usage, reconnexion) : code.claude.com/docs/en/errors ;
/doctor et claude doctor : code.claude.com/docs/en/troubleshooting ;
mises à jour automatiques de l’installation recommandée : code.claude.com/docs/en/setup ;
limites d’usage communes à claude.ai, Claude Code et l’appli : support.claude.com, « How do usage and length limits work? » ;
prix de Claude Pro : claude.com/pricing (page affichée en France).