Où est-il bloqué ? Examinez l’écran, puis le processus
# in the session
Esc # cancel the current tool or turn
Ctrl+C (twice) # abort the turn / exit
# from another terminal
ps aux | grep -E "claude|node" | grep -v grep # child processes still running?
top -o cpu # is claude spinning or idle?
claude --debug # next time: timestamps for every request and tool call
claude -c # resume the last session after a killUn CPU au repos avec un prompt figé signifie qu’il attend un élément externe : un flux réseau, un serveur MCP, un processus enfant ou une demande que vous ne voyez pas. Un CPU constamment au maximum signifie qu’il traite un élément interne : l’analyse d’un résultat d’outil énorme, le retour arrière d’une expression régulière ou le chargement d’une session volumineuse. Une consommation de mémoire qui augmente régulièrement signifie qu’un résultat d’outil ou un fichier de session est chargé intégralement.
Causes connues dans le suivi des tickets
- `/rewind` se bloque, `Ctrl+C` est ignoré, `kill -9` est nécessaire (#53011, 21 réactions, sur des sessions de toute taille dans les versions 2.1.1xx). Un ingénieur d’Anthropic n’a pas pu reproduire le problème sur 2.1.233, alors commencez par mettre à jour ; sur une ancienne version, terminez le processus et reprenez avec
claude -cau lieu de revenir en arrière. - Les sessions Remote Control se figent en cours d’exécution et seul un `Esc` local les débloque (#51267, ouvert). Tout outil ou sous-processus qui se bloque fige l’ensemble de la session distante, sans possibilité d’annulation à distance ; gardez ces sessions courtes et évitez les outils susceptibles de demander une saisie.
- L’invite d’authentification MCP se bloque sur `Enter` (#42707, ouvert). Authentifiez-vous auprès du serveur à l’aide d’une commande
claude mcpdistincte ou du navigateur, puis redémarrez la session. - `grep` via le moteur de recherche intégré consomme toute la mémoire (#54394) : dans les versions natives, chaque commande shell
greps’exécute dans unclaudeprocessus doté de son propre tas V8 ; une expression régulière avec retour arrière appliquée à une longue ligne minifiée fait grimper la consommation à plusieurs gigaoctets, et le mécanisme d’arrêt en cas de manque de mémoire emporte la session avec lui, aussi bien sur WSL2 que sur Linux. Évitez les expressions régulières non bornées sur les fichiers minifiés, excluez les fichiers générés par la compilation etnode_modules, ou installez la version système deripgrepet appelez-la explicitement. - Boucle de nouvelles tentatives bloquée sur `400 thinking blocks cannot be modified` (#63231) — l’historique de conversation est invalide et chaque nouvelle tentative échoue de la même manière.
/rewindpour revenir avant le tour, ou/clear; consultez le guide 400. - **Exécutions cloud / planifiées bloquées sur *Configuration d’un conteneur cloud*** (#53691, #54528) — côté service ; rien à corriger en local, annulez et consultez status.claude.com.
- La reprise d’une session volumineuse prend plusieurs minutes — la transcription est rejouée au démarrage. Reprenez la session précise dont vous avez besoin (
claude -r) plutôt que la plus volumineuse, et laissez la compaction réduire les sessions démesurées.
Blocages au démarrage
Un écran vide juste après claude sans invite signifie généralement que le premier appel API ne renvoie rien : une variable de proxy pointant vers un proxy hors service, un VPN, le DNS ou un ANTHROPIC_BASE_URLinaccessible. Exécutez la vérification avec curl décrite dans le guide des erreurs de connexion, puis claude doctor. Les démarrages lents où une invite finit par apparaître correspondent au lancement des serveurs MCP ; claude mcp list et supprimez ceux qui dépassent le délai d’attente.
Processus enfants qui ne se terminent jamais
Un outil shell qui ouvre un éditeur, attend un mot de passe, suit un journal en continu ou démarre un serveur de développement ne se termine jamais, et le tour attend sa fin. Demandez à l’agent d’exécuter les serveurs en arrière-plan et d’ajouter --no-pager, -y ou < /dev/null lorsqu’une commande risque de demander une saisie. Si cela s’est déjà produit, Esc annule l’outil ; si le processus enfant ignore cette annulation, terminez-le à l’aide de son PID depuis un autre terminal, et le tour se poursuit avec l’erreur.
Consommation élevée de mémoire et de CPU
- Les résultats des outils sont conservés en mémoire et sur disque pendant la session ; lire un fichier de 200 Mo crée une session de 200 Mo. Ne lisez que les parties nécessaires.
- De nombreux sous-agents en parallèle multiplient toutes les ressources utilisées ;
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY=2sur les machines peu puissantes. - Les émulateurs de terminal dont le rendu est lent (certaines consoles Windows, tmux à distance sur une connexion à faible débit) donnent l’impression que la sortie en continu est figée ;
claude --debugindique si des tokens continuent d’arriver. - Si la consommation de mémoire augmente au repos, recherchez les processus
clauderestants issus de sessions d’IDE ayant planté et terminez-les (le processus s’est terminé avec le code 1 traite le cas des processus orphelins sous Windows).
Quand le problème vient de l’API, pas du client
Une session qui se bloque à chaque tour au même endroit, avec un petit indicateur de chargement puis une ligne de nouvelle tentative, indique un chemin d’accès à l’API lent ou sujet aux coupures plutôt qu’un bug du client : 529 de surcharge, limitation côté serveur ou connexion réinitialisée. Via une passerelle (ANTHROPIC_BASE_URL=https://aiprimetech.io), le trafic d’un compte amont saturé est basculé vers un autre, ce qui raccourcit précisément ces blocages.
Vous en avez assez de lutter contre ce problème ?
Exécutez plutôt Claude Code via la passerelle AI Prime Tech : les mêmes modèles Claude sur les propres comptes en amont de la passerelle, deux variables d’environnement à modifier pour basculer, et les nouveaux comptes reçoivent 5 $ de crédit API offert avec le code FIXIT — sans carte bancaire.
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_keyQuestions fréquentes
Pourquoi Claude Code est-il bloqué et ne répond-il pas ?
Il attend quelque chose : un flux API, un outil qu’il a lancé, un serveur MCP ou une demande d’approbation hors écran. Appuyez sur Échap pour annuler l’outil, puis deux fois sur Ctrl+C pour interrompre ; si rien ne réagit, terminez le processus et reprenez avec claude -c.
Comment résoudre un blocage de Claude Code sur /rewind ?
Passez à une version récente ; le blocage a été signalé sur 2.1.1xx et Anthropic n’a pas pu le reproduire sur 2.1.233. Sur une ancienne version, terminez le processus et utilisez claude -c au lieu de /rewind.
Pourquoi Claude Code utilise-t-il autant de mémoire ?
Les résultats volumineux des outils et les transcriptions des sessions sont conservés intégralement, les sous-agents les multiplient et, dans les versions natives, une expression régulière grep avec retour arrière s’exécute dans un processus claude doté d’un grand tas V8. Lisez moins de données, excluez les fichiers générés par la compilation et réduisez le nombre d’opérations simultanées.
Claude Code se bloque au démarrage sans afficher d’invite. Que vérifier ?
La première requête API ne renvoie rien : variables de proxy, VPN, DNS ou ANTHROPIC_BASE_URL inaccessible. Lancez une requête curl vers le point de terminaison, puis claude doctor, et supprimez les serveurs MCP qui dépassent le délai d’attente.
Utilisez Claude Code sur la passerelle
Les mêmes modèles, deux variables d’environnement, des crédits valant 7.69231× leur valeur nominale — ou une offre illimitée à tarif forfaitaire. Nouveaux comptes : 5 $ de crédit API offert avec le code FIXIT.
Obtenir une clé API Voir les offres illimitéesAI Prime Tech est une passerelle API indépendante et n’est ni affiliée à Anthropic, ni approuvée ou parrainée par Anthropic. « Claude » et « Claude Code » sont des marques commerciales d’Anthropic. Les fonctionnalités de Claude Code décrites ici correspondent à la documentation publique d’Anthropic au moment de la rédaction et évoluent fréquemment ; les prix et les listes de modèles de cette page proviennent des paramètres en temps réel de cette passerelle.