Claude Code bloqué ou figé ? Le guide de secours complet

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.

1. 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.
2. 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.
3. 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.
4. 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.

/compact keep only the plan and the diff/clear

Bloqué 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.

1. 1Appuyez une fois sur Esc et laissez quelques secondes ; si le spinner continue, appuyez sur Ctrl+C.
2. 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.
3. 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.

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.

1. 1Vérifiez si la commande sous-jacente produit encore de la sortie — une compilation qui tourne tranquillement n'a pas besoin d'être interrompue.
2. 2Si c'est vraiment calé, appuyez sur Esc ou sur le bouton orange d'arrêt pour interrompre le tour.
3. 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.
4. 4Relancez la longue opération en arrière-plan ou par petits morceaux pour que le chien de garde ne se déclenche plus.

claude --resume

Un 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.

1. 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.
2. 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.
3. 3Toujours figé après la mise à jour ? Rechargez la session web ; si ça persiste, ouvrez une nouvelle session et continuez le travail là.

claude updatenpm install -g @anthropic-ai/claude-code

Contournement 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.

1. 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.
2. 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.
3. 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.
4. 4Sur VS Code, mettez aussi l'extension à jour — les deux correctifs 2.1.28x ci-dessus n'existent que dans les versions actuelles.

claude doctorclaude --safe-mode

Figé 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.

1. 1Appuyez sur Ctrl+C pour tenter d'annuler l'opération en cours.
2. 2Si la fenêtre reste sans réponse, fermez complètement le terminal et ouvrez-en un nouveau.
3. 3Dans le terminal frais, lancez claude --resume dans le même répertoire projet — la doc promet que la conversation n'est pas perdue.
4. 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.

claude --resume/terminal-setup

« Model overloaded » et la boucle « Retrying… »

Cette fois, le coupable n'est pas votre terminal mais la capacité d'Anthropic. Quand le trafic grimpe chez tous les utilisateurs en même temps, l'API répond par une erreur HTTP 529 (overloaded_error, « The API is temporarily overloaded »), et Claude Code n'affiche « API Error: Repeated 529 Overloaded errors » qu'après avoir déjà réessayé tout seul — jusqu'à 10 fois par défaut, avec backoff exponentiel. Cette attente, c'est le spinner « Retrying in Ns · attempt x/y » à l'écran. Une variante plus douce désigne carrément le modèle saturé : « Opus is experiencing high load, please use /model to switch to Sonnet ». La capacité est suivie modèle par modèle : celui que vous utilisez change donc vos options.

1. 1Laissez d'abord passer la vague. La consigne officielle est de réessayer après quelques minutes : un 529 signale seulement que la capacité partagée est brièvement saturée, la plupart des pics retombent d'eux-mêmes, et la boucle de relance continue de travailler pour vous pendant ce temps.
2. 2Avant de toucher au moindre réglage local, vérifiez status.claude.com — si un incident est en cours, attendre est toute la réparation. Si vous passez par une passerelle ou un fournisseur cloud, le message d'erreur pointe vers la page de statut de ce fournisseur.
3. 3Lancez /model et basculez vers un modèle moins sollicité — le message d'erreur de Claude Code le suggère lui-même. La capacité est suivie par modèle, donc quitter un modèle saturé pour un plus calme peut rétablir l'accès immédiatement.
4. 4Exécution sans supervision ou en CI ? Définissez CLAUDE_CODE_RETRY_WATCHDOG=1 pour que Claude Code continue de relancer les erreurs 529 au lieu de faire échouer la tâche, et ajustez CLAUDE_CODE_MAX_RETRIES (défaut 10, plafond 15) si vous avez besoin d'un autre budget de relance.

/modelCLAUDE_CODE_RETRY_WATCHDOG=1 claude

Ne confondez pas avec les limites de votre offre : la documentation officielle précise qu'un 529 « is not your usage limit and doesn't count against your quota » — ce n'est pas votre limite d'usage et ne consomme pas votre quota. La bannière voisine « Server is temporarily limiting requests (not your usage limit) » est un bridage serveur de courte durée, automatiquement relancé depuis la v2.1.199.