Dépannage Claude Code

Vous êtes bloqué avec Claude Code

Claude qui part de travers, un projet cassé, une session qui rame, un hook muet, une consommation qui grimpe : les blocages sont presque toujours les mêmes. Voici les 12 situations qui reviennent le plus souvent, ce qui les provoque, et la manipulation exacte pour s'en sortir.

Page en accès libre, tirée du module SOS de Koneetiv Academy.

Ce n'est pas vous, c'est un réflexe qui manque

Quand Claude Code part de travers, la cause est rarement mystérieuse : une consigne qui s'est diluée, un contexte saturé, un réglage modifié sans redémarrer la session. Chaque situation ci-dessous se règle en une manipulation. Et chacune se prévient par un réflexe simple, indiqué à la fin de la fiche.

Urgence

Reprendre le contrôle

1Claude part dans la mauvaise direction et continue : comment l'arrêter ?

PourquoiVotre demande laissait plusieurs interprétations possibles et Claude a choisi la sienne. Plus il avance, plus il s'enfonce dans cette piste.
La solutionAppuyez sur Échap pour l'interrompre immédiatement : la session reste intacte. Réorientez ensuite avec un message précis, qui dit ce que vous attendiez et ce qu'il ne fallait pas faire. Si le mal est déjà fait dans vos fichiers, /rewind restaure le code et/ou la conversation.
Interrompez au premier doute plutôt qu'à la fin : il y a moins à corriger.

2J'ai cassé mon projet : comment annuler ce que Claude a fait ?

PourquoiUne série de modifications s'est empilée sans point de sauvegarde intermédiaire. L'effet cumulé devient difficile à démêler à l'œil.
La solutionPas de panique, rien n'est définitif. /rewind, ou un double appui sur Échap, restaure un état antérieur. Si vous aviez demandé un commit avant de commencer, dites simplement « reviens au dernier commit ».
Prenez l'habitude de demander « fais un commit » avant tout gros changement.
Qualité

Garder Claude au niveau

3Claude ne respecte pas mes consignes, il les oublie en cours de route

PourquoiUne consigne donnée au fil de la conversation se dilue à mesure que l'échange s'allonge. Elle n'a pas de statut particulier par rapport au reste de la conversation.
La solutionLes consignes durables vont dans CLAUDE.md, que vous ouvrez avec /memory : elles sont relues à chaque session. Pour un automatisme garanti à 100 %, passez par un hook plutôt que par une consigne écrite.
Dès qu'une consigne doit encore valoir demain, écrivez-la dans CLAUDE.md au lieu de la répéter.

4La session rame, Claude se répète ou ne répond plus

PourquoiLe contexte est probablement saturé : la conversation traîne trop d'historique, et ce qui compte se noie dans le reste.
La solutionDans Claude Code, /compact résume l'échange et l'allège tout en gardant le fil. Si vous attaquez un sujet nouveau, /clear, et repartez propre.
Règle simple : une conversation = une tâche.

12Je ne sais pas comment formuler ma demande à Claude

PourquoiUne demande vague laisse Claude arbitrer à votre place. Le résultat est alors cohérent en soi, mais à côté de votre besoin réel.
La solutionStructure gagnante : le contexte (où vous êtes, sur quoi vous travaillez), la tâche précise, les contraintes, le format attendu.
Le raccourci le plus efficace : demandez à Claude ce dont il a besoin pour bien faire.
Outils

Brancher et automatiser

5Mon hook ne marche pas, il ne se déclenche jamais

PourquoiUn hook ne part que si l'événement, le matcher et l'état de la session concordent. Un seul des trois qui cloche suffit à ce qu'il reste muet.
La solutionUn hook qui reste muet se diagnostique en trois vérifications, dans cet ordre : 1) l'événement est le bon, PreToolUse n'est pas PostToolUse ; 2) le matcher cible bien l'outil concerné, par exemple Write ; 3) la session a été redémarrée après modification des réglages.
Redémarrez systématiquement la session après avoir touché aux réglages.

6Un connecteur MCP ne répond plus

PourquoiUn connecteur s'appuie le plus souvent sur une autorisation accordée à un service externe, et une autorisation expire ou peut être retirée côté service.
La solutionOuvrez /mcp pour voir l'état du connecteur. Le plus souvent, l'authentification a expiré : reconnectez-vous. Vérifiez aussi que l'accès n'a pas été révoqué côté service.
Quand un connecteur se comporte bizarrement, regardez /mcp avant de chercher ailleurs.

7Claude me demande une permission à chaque action

PourquoiC'est le mode prudent, normal au début : tant que vous n'avez pas précisé ce que vous autorisez, Claude vous demande votre accord avant chaque action qui touche à vos fichiers ou à votre environnement.
La solutionPour ne plus valider chaque action une par une, ajoutez des règles allow ciblées sur celles que vous comprenez et jugez sûres. Tout le reste continue de passer par une demande d'autorisation.
Autorisez au fur et à mesure, action par action, plutôt que d'ouvrir large d'un coup.

11Mon artifact ne se lance pas, rien ne s'affiche

PourquoiLa création et l'exécution de code côté claude.ai dépendent d'une option qui n'est pas forcément activée sur votre compte.
La solutionDans les paramètres de claude.ai, section Settings puis Features, vérifiez que l'option « Code execution & file creation » est activée. Demandez ensuite explicitement de relancer.
Vérifiez ce réglage une fois pour toutes, avant de conclure que votre demande était mauvaise.
Consommation

Maîtriser sa consommation

8Ma réponse s'est coupée en plein milieu, ou j'ai atteint une limite

PourquoiVous avez atteint une limite : celle de votre plan, ou celle de la fenêtre de contexte de la conversation.
La solutionUne réponse coupée ou une limite atteinte laisse trois options : attendre la fenêtre suivante, /compact pour alléger la conversation, ou basculer les tâches simples sur un modèle plus léger.
Ne laissez pas une conversation grossir indéfiniment : /clear entre deux tâches.

9Quel modèle choisir entre Opus, Sonnet et Haiku ?

PourquoiLes modèles ne se valent pas sur toutes les tâches, et garder le plus puissant en permanence n'est pas toujours le bon calcul.
La solutionTâche complexe ou critique : Opus. Travail courant : Sonnet. Répétitif et simple, en volume : Haiku. Vous changez à tout moment avec /model.
Choisissez le modèle au moment de lancer la tâche, pas quand ça coince.

10Ça consomme trop, j'épuise ma limite trop vite

PourquoiUn contexte long est relu à chaque message. Une conversation qui s'éternise pèse donc de plus en plus lourd à chaque échange.
La solutionPour faire baisser la consommation dans Claude Code : /clear entre les tâches, des conversations ciblées sur un seul sujet, et le bon modèle pour la bonne tâche. /cost montre où part la consommation.
Ouvrez /cost de temps en temps : vous verrez vite quelles habitudes pèsent le plus.
Prévention

Cinq réflexes qui évitent la plupart des blocages

Aucun ne demande de compétence technique particulière. Ils s'installent vite et couvrent l'essentiel des situations ci-dessus.

Demandez « fais un commit » avant tout gros changement : vous avez toujours un point de retour.
Une conversation = une tâche. /clear quand vous changez de sujet, /compact quand la session s'alourdit.
Ce qui doit valoir demain va dans CLAUDE.md, pas dans un message. Ce qui doit être automatique va dans un hook.
Échap dès que la direction vous semble fausse : ne laissez jamais courir en espérant que ça retombe juste.
Donnez le contexte, la tâche, les contraintes et le format attendu. Dans le doute, demandez à Claude ce qui lui manque.
Module SOS

Ces 12 blocages sont un module de Koneetiv Academy

Koneetiv Academy est notre plateforme de formation, en accès gratuit. Elle embarque un module SOS qui reprend ces situations une par une : vous décrivez ce qui vous arrive, le module vous renvoie la manipulation et prépare une demande déjà formatée, que vous copiez dans votre propre compte Claude pour débloquer la situation dans votre contexte à vous.

Ouvrir Koneetiv Academy
Questions fréquentes

Ce qu'on nous demande le plus souvent

Claude Code, c'est quoi exactement ?

C'est l'une des surfaces de Claude, celle qui travaille dans votre terminal et directement sur les fichiers de votre projet. Elle existe à côté d'autres surfaces, comme l'application Claude ou la plateforme pour les développeurs. Ce n'est donc pas un produit séparé, mais une façon d'utiliser Claude au plus près de votre environnement de travail.

Faut-il savoir coder pour l'utiliser ?

Non. Vous écrivez vos demandes en langage courant et Claude s'occupe de la partie technique. Ce qui compte, c'est de savoir décrire précisément ce que vous voulez obtenir, et de connaître les quelques réflexes de sécurité de cette page : demander un commit avant un gros changement, interrompre avec Échap, revenir en arrière avec /rewind.

Est-ce que ça fonctionne en français ?

Oui. Vous pouvez formuler vos demandes en français et écrire vos consignes durables en français dans CLAUDE.md. Seuls les noms de commandes restent tels quels : /rewind, /compact, /clear, /mcp, /model, /cost, /memory.

Par où commencer quand on n'a jamais utilisé Claude Code ?

Commencez par un projet réel mais sans enjeu, et une seule tâche à la fois : c'est le moyen le plus rapide de voir ce que Claude fait vraiment de vos demandes. Demandez un commit avant de lancer quelque chose d'important, gardez la conversation courte et faites /clear dès que vous changez de sujet. Deux ou trois règles de travail écrites dans CLAUDE.md suffisent pour démarrer, vous les compléterez à l'usage. Koneetiv Academy déroule ce parcours pas à pas, gratuitement.

Koneetiv Academy
Vos équipes veulent apprendre à utiliser Claude ?

Notre plateforme de formation en ligne est gratuite : 4 formations, 18 modules, 54 leçons et une certification. La première leçon se suit sans créer de compte.

Découvrir Koneetiv Academy

Débloquez-vous, puis prenez de l'avance

Le module SOS règle l'urgence. Le reste de la formation vous évite d'y revenir. C'est gratuit et sans prérequis technique.

Parler à un expert Koneetiv