Claude Code bloqué ou figé ? Le guide de secours complet
Des correctifs au mot près pour chaque blocage : Compacting conversation…, Almost done thinking…, Not responding — try stopping, Resuming container…, figeages au démarrage et dans le terminal — chacun sourcé depuis la doc officielle, le changelog ou un issue GitHub avec réponse d'un mainteneur.
En bref — le tri en 60 secondes
- Appuyez une fois sur Esc, puis Ctrl+C si le spinner ignore tout. La plupart des blocages mous se relâchent, et la session est déjà sauvegardée sur disque.
- Bloqué sur « Compacting conversation… » ? Annulez, puis lancez /compact avec un focus du type « keep only the plan and the diff » pour que la passe suivante ait moins à résumer.
- La barre orange « Not responding — try stopping » est visible ? La commande tourne peut-être encore — regardez sa sortie avant de tuer quoi que ce soit.
- Après un arrêt forcé, lancez claude --resume dans le même répertoire — la transcription vit sur le disque, pas dans le processus mort.
Chaque correctif de cette page remonte à la doc officielle de dépannage, au changelog ou à un issue avec réponse de mainteneur sur anthropics/claude-code. Les contournements communautaires sans réponse officielle sont signalés comme tels.
Chaque section ci-dessous correspond à la chaîne exacte qu'affiche Claude Code pendant un blocage. Comparez avec le texte à votre écran, puis exécutez les étapes numérotées de haut en bas — chaque correctif est sourcé depuis la doc officielle de dépannage, le changelog ou un issue d'anthropics/claude-code avec réponse de l'équipe.
Bloqué sur « Compacting conversation… »
L'auto-compact se déclenche quand la fenêtre de contexte se remplit : Claude Code résume la conversation jusqu'ici et la remplace. Sur une session vraiment énorme, cette passe de résumé peut prendre des minutes — et les versions v2.1.282 et v2.1.284 ont corrigé de vraies pannes : compaction qui échouait sur une requête de résumé refusée, ou erreur « Prompt is too long » persistant après compactage. Si une session de taille normale rame plus de deux ou trois minutes, elle est bloquée, pas en train de travailler.
- 1Si la session est légitimement gigantesque, accordez-lui d'abord quelques minutes — la v2.1.283 a retravaillé le spinner de compaction : son minuteur ne démarre que quand la compaction commence vraiment.
- 2Au-delà, appuyez sur Esc puis Ctrl+C pour annuler le compactage. La doc officielle confirme que Ctrl+C annule l'opération en cours sans jeter votre session.
- 3Compactez ensuite à la main avec un focus pour que le résumé abandonne les sorties d'outils volumineuses, par exemple : /compact keep only the plan and the diff.
- 4Si l'ancienne histoire est jetable, faites /clear et repartez à neuf — et mettez à jour vers la v2.1.284 ou plus pour bénéficier des nouvelles tentatives de compaction corrigées.
Commandes de secours à copier-coller
/compact keep only the plan and the diff/clearBloqué sur « Almost done thinking… »
Contre-intuitivement, ce libellé de spinner n'est pas un indicateur de progression : les mainteneurs l'ont confirmé dans l'issue #63387, les phrases tournantes ne correspondent pas à l'état réel du raisonnement du modèle. « almost done » peut donc rester à l'écran de longues minutes, et l'issue #55328 documente des tours où Esc et Ctrl+C ne faisaient rien pendant qu'un extended thinking s'éternisait.
- 1Appuyez une fois sur Esc et laissez quelques secondes ; si le spinner continue, appuyez sur Ctrl+C.
- 2Si la saisie reste morte, fermez l'onglet du terminal, ouvrez-en un nouveau et lancez claude --resume dans le même répertoire pour récupérer la session.
- 3Si chaque tour long bloque de la même façon, mettez Claude Code à jour, puis soupçonnez un serveur MCP ou un hook à l'arrêt — indiscernable d'une réflexion bloquée, et /mcp montre quel serveur déraille.
Commandes de secours à copier-coller
claude --resume« Not responding — try stopping »
Cette bannière orange est le chien de garde de Claude Code : un appel d'outil — généralement une longue commande bash — est resté assez silencieux pour que l'UI propose un bouton d'arrêt. C'est un avertissement, pas un verdict : dans les démos d'Anthropic elles-mêmes, le processus tournait encore normalement dessous, et Boris Cherny, responsable de Claude Code, a demandé publiquement des enregistrements de cet état — l'équipe est au courant et enquête.
- 1Vérifiez si la commande sous-jacente produit encore de la sortie — une compilation qui tourne tranquillement n'a pas besoin d'être interrompue.
- 2Si c'est vraiment calé, appuyez sur Esc ou sur le bouton orange d'arrêt pour interrompre le tour.
- 3Dites à Claude que vous l'avez arrêté manuellement — après un arrêt manuel, le modèle peut croire à tort que l'outil a été refusé et s'excuser au lieu de continuer.
- 4Relancez la longue opération en arrière-plan ou par petits morceaux pour que le chien de garde ne se déclenche plus.
Commandes de secours à copier-coller
claude --resumeUn coin rugueux connu : dans une démo d'Anthropic avec cette même bannière, le bouton d'arrêt est apparu alors que la commande était encore saine — vérifiez avant d'arrêter.
Bloqué sur « Resuming container… » (sessions cloud)
Les sessions web et mobiles de Claude Code tournent dans un conteneur cloud. Rouvrir une ancienne session signifie redémarrer ce conteneur et streamer la transcription — honnêtement lent pour les grandes histories. La v2.1.286 a corrigé un bug où les sessions aux très grandes histories ne se réveillaient jamais : le conteneur s'était arrêté pendant que la transcription chargeait encore.
- 1Attendez d'abord quelques minutes — la reprise à froid d'un conteneur est plus lente qu'une session neuve, et aucune barre de progression ne dit que ça avance.
- 2Mettez le CLI à jour vers la v2.1.286 ou plus — claude update, ou npm install -g @anthropic-ai/claude-code — cette version corrige le bug du « ne se réveille jamais » pour les très grandes histories cloud.
- 3Toujours figé après la mise à jour ? Rechargez la session web ; si ça persiste, ouvrez une nouvelle session et continuez le travail là.
Commandes de secours à copier-coller
claude updatenpm install -g @anthropic-ai/claude-codeContournement communautaire, réponse officielle en attente : plusieurs utilisateurs rapportent un conteneur réveillé en cinq minutes environ — ne le déclarez mort qu'après.
Figé au démarrage
Un figeage avant l'invite est presque toujours local : un serveur MCP, un plugin ou un hook qui plante, un état corrompu ou un problème d'extension. La v2.1.284 a corrigé les onglets VS Code qui ne répondaient plus après Restart Extensions, et la v2.1.286 le spinner infini « Teleporting session… » quand l'extension cesse de répondre. Comme le /doctor intégré exige une session vivante, on part du shell.
- 1Lancez claude doctor depuis votre terminal — c'est exactement ce que recommande la doc quand claude ne démarre pas ; il vérifie l'installation et propose des correctifs.
- 2Lancez avec claude --safe-mode, qui désactive pour la session tous les plugins, serveurs MCP et hooks — si le démarrage réussit, le coupable est l'une de ces personnalisations.
- 3Réactivez vos personnalisations une par une — ou, une fois entré, faites tourner /mcp — pour identifier le fautif, puis mettez-le à jour ou retirez-le.
- 4Sur VS Code, mettez aussi l'extension à jour — les deux correctifs 2.1.28x ci-dessus n'existent que dans les versions actuelles.
Commandes de secours à copier-coller
claude doctorclaude --safe-modeFigé dans le terminal
Le grand classique du figeage complet — saisie morte, spinner bloqué, Ctrl+C ignoré — a une procédure documentée. Celle du guide officiel : tenter d'annuler, redémarrer le terminal si besoin, reprendre ; dans tous les cas rien n'est perdu. Une sortie baveuse ou à moitié dessinée dans le terminal intégré d'un éditeur est un autre problème — l'accélération GPU — avec son correctif d'une commande.
- 1Appuyez sur Ctrl+C pour tenter d'annuler l'opération en cours.
- 2Si la fenêtre reste sans réponse, fermez complètement le terminal et ouvrez-en un nouveau.
- 3Dans le terminal frais, lancez claude --resume dans le même répertoire projet — la doc promet que la conversation n'est pas perdue.
- 4Sortie baveuse dans le terminal intégré de VS Code ? Lancez /terminal-setup — il coupe l'accélération GPU du terminal et nettoie la corruption.
Commandes de secours à copier-coller
claude --resume/terminal-setupDifférences par plateforme : VS Code, Windows, WSL et macOS
Le même blocage change de visage selon la plateforme — ces notes propres à chaque environnement méritent un passage avant d'accuser le modèle.
Extension VS Code
Deux correctifs récents comptent ici : la v2.1.284 a réparé les onglets sans réponse après Restart Extensions, et la v2.1.286 a tué le spinner infini « Teleporting session… » qui survenait quand l'extension cessait de répondre. Si votre panneau se fige, mettez d'abord l'extension à jour — et gardez /terminal-setup en réserve pour une sortie baveuse du terminal intégré.
Windows
Les bugs de démarrage et de mise à jour propres à Windows ont leur propre train de rustines : la v2.1.281 a corrigé une course où des mises à jour simultanées supprimaient mutuellement la sauvegarde de claude.exe, et la v2.1.286 un refus de claude --bg sur un dossier de confiance à cause de la casse de la lettre de lecteur. Gardez le CLI à jour et laissez une mise à jour finir avant d'en lancer une autre.
WSL
La doc épingne WSL pour des recherches lentes ou incomplètes — la pénalité inter-systèmes de fichiers quand le projet vit sous /mnt/c. Leur remède : déplacer le projet dans le système de fichiers Linux (un chemin sous /home) ou faire tourner Claude Code nativement sous Windows. La régression de blocage la plus signalée, l'issue #26224, a été remplie depuis WSL2 avec Windows Terminal — un simple wsl --update vaut donc aussi la minute.
macOS
Les figeages de Terminal.app sont rares ; les petits maux propres à macOS sont des commandes de presse-papiers comme pbcopy qui échouent dans la sandbox, et le texte copié qui n'arrive pas localement par-dessus SSH. Ni l'un ni l'autre ne fige la session — mais si votre figeage coïncide avec une copie, la section /copy de la doc est l'endroit à regarder.
Bloqué en local ou Claude vraiment en panne
Un spinner figé signifie presque toujours que votre processus est bloqué, pas qu'Anthropic a un incident — les blocages sont locaux, reproductibles et cèdent généralement à Esc. Avant de reconstruire votre configuration, vérifiez status.claude.com : si un incident est en cours, aucun correctif local n'aidera, et attendre est le bon mouvement.
Vous voulez plutôt le playbook d'état de service — symptômes de panne, historique des incidents, ce qui casse en premier ? C'est un autre sujet, couvert par son propre guide sur ce site.
Un piège de formulation : les recherches sur claude code hanging font aussi remonter des résultats suspended account. La suspension de compte est une mesure de facturation — vérifiez votre boîte mail pour un avis d'Anthropic — et n'a rien à voir avec un terminal figé.