Source: https://aiprimetech.io/fr/claude-code/errors/claude-code-hangs/ [Accueil](/fr/) › [Claude Code](/fr/claude-code/) › [Erreurs](/fr/claude-code/errors/) › Blocages / figé [Vue d’ensemble](/fr/claude-code/)[Installation](/fr/claude-code/install/)[référence de la CLI](/fr/claude-code/cli/)[Tarifs et limites](/fr/claude-code/pricing/)[Agent SDK](/fr/claude-code/sdk/)[Compétences et plugins](/fr/claude-code/skills/)[GitHub](/fr/claude-code/github/)[Web, bureau et IDE](/fr/claude-code/web-and-desktop/)[Modèles](/fr/claude-code/models/)[Erreurs](/fr/claude-code/errors/)[Open source ?](/fr/claude-code/open-source/)[Tutoriel](/fr/claude-code/tutorial/)[Pour les étudiants](/fr/claude-code/for-students/)[Automatisation de l’assurance qualité](/fr/claude-code/qa-automation/)[Comparaison avec Cursor](/fr/claude-code/vs-cursor/)[Comparaison avec Codex et OpenCode](/fr/claude-code/vs-codex/)[Sous-agents](/fr/claude-code/subagents/)[Hooks](/fr/claude-code/hooks/)[MCP](/fr/claude-code/mcp/)[Écosystème](/fr/claude-code/ecosystem/)[VS Code](/fr/claude-code/vscode/)[OpenRouter](/fr/claude-code/openrouter/)[Limites de débit](/fr/claude-code/rate-limits/)[Guide en chinois](/claude-code/zh/) Dernière mise à jour : 11 octobre 2026 # Claude Code se fige, reste bloqué ou ne répond plus : comment trouver où il bloque et le débloquer Un blocage se situe quelque part : Claude Code attend l’API, un outil qu’il a lancé, un serveur MCP, votre terminal ou lui-même. La façon d’en sortir diffère dans chaque cas, et la ligne d’état indique généralement lequel est en cause avant que vous ne recouriez à kill. ## TLDR - En attente de l’API → un indicateur de chargement avec un nombre de tokens ou une ligne *En attente de la réponse de l’API* ; un [problème de connexion](/fr/claude-code/errors/connection-lost/), pas un blocage. - En attente d’un outil → la ligne de l’outil reste ouverte ; Esc l’annule. Une commande shell en attente d’une saisie ou un processus incontrôlé de grep en est généralement la cause. - En attente de votre intervention → une demande d’approbation ou une question est masquée hors écran ; appuyez sur Enter ou faites défiler l’écran. - Véritablement bloqué (aucune sortie, aucune réaction à Esc, Ctrl+C) → terminez le processus et reprenez avec claude -c; consultez les bugs connus ci-dessous. ## 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 kill ``` Un 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](https://github.com/anthropics/claude-code/issues/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 -c au 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](https://github.com/anthropics/claude-code/issues/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](https://github.com/anthropics/claude-code/issues/42707), ouvert). Authentifiez-vous auprès du serveur à l’aide d’une commande claude mcp distincte ou du navigateur, puis redémarrez la session. - `grep` via le moteur de recherche intégré consomme toute la mémoire ([#54394](https://github.com/anthropics/claude-code/issues/54394)) : dans les versions natives, chaque commande shell grep s’exécute dans un claude processus 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 et node_modules, ou installez la version système de ripgrep et appelez-la explicitement. - Boucle de nouvelles tentatives bloquée sur `400 thinking blocks cannot be modified` ([#63231](https://github.com/anthropics/claude-code/issues/63231)) — l’historique de conversation est invalide et chaque nouvelle tentative échoue de la même manière. /rewind pour revenir avant le tour, ou /clear ; consultez le [guide 400](/fr/claude-code/errors/api-error-400/). - **Exécutions cloud / planifiées bloquées sur *Configuration d’un conteneur cloud*** ([#53691](https://github.com/anthropics/claude-code/issues/53691), [#54528](https://github.com/anthropics/claude-code/issues/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](/fr/claude-code/errors/connection-lost/), 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=2 sur 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 --debug indique si des tokens continuent d’arriver. - Si la consommation de mémoire augmente au repos, recherchez les processus claude restants issus de sessions d’IDE ayant planté et terminez-les ([le processus s’est terminé avec le code 1](/fr/claude-code/errors/process-exited-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](/fr/claude-code/errors/overloaded-529/), [limitation côté serveur](/fr/claude-code/errors/usage-limit-reached/) 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_key ``` [Créer un compte avec le code FIXIT](/register?promo=FIXIT) ## Questions 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](/register?promo=FIXIT) [Voir les offres illimitées](/fr/plans/) AI 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. ## Autres guides Claude Code [Les erreurs de Claude Code et comment les résoudre](/fr/claude-code/errors/)[« Erreur API : 500 » de Claude Code : sa signification et les solutions qui fonctionnent](/fr/claude-code/errors/api-error-500/)[Erreur « Surchargé » de Claude (erreur API 529) : sa signification et la marche à suivre](/fr/claude-code/errors/overloaded-529/)[Erreur API 400 de Claude Code : prompt trop long, concurrence des appels d’outils et autres cas](/fr/claude-code/errors/api-error-400/)[Erreurs OAuth de Claude Code : délai de 15000 ms dépassé et code d’état 500](/fr/claude-code/errors/oauth-error/)[« Le processus Claude Code s’est terminé avec le code 1 » : comment trouver l’erreur réelle et la corriger](/fr/claude-code/errors/process-exited-code-1/)[Claude : « Prompt trop long », « Entrée trop longue pour le modèle demandé » et « Limite de contexte atteinte » — ce qui remplit la fenêtre et comment libérer de la place](/fr/claude-code/errors/prompt-too-long/)[Limite d’utilisation de Claude atteinte : limites de session, hebdomadaires et d’Opus, « limites d’utilisation de l’API spécifiées », « solde de crédits trop faible » — et la marche à suivre](/fr/claude-code/errors/usage-limit-reached/)[Claude Code 401 et 403 : identifiants d’authentification invalides, clé API invalide, « Non connecté », host_not_allowed](/fr/claude-code/errors/auth-401-403/)[Erreurs de connexion de Claude Code : ECONNRESET, connexion perdue en cours de réponse, « En attente de la réponse de l’API », « Impossible de se connecter à l’API », erreurs de certificat SSL](/fr/claude-code/errors/connection-lost/)[Claude.ai ne fonctionne pas : « Un problème est survenu », contraintes de capacité, « Limite de 5 heures atteinte », « Erreur lors de votre connexion » et autres cas](/fr/claude-code/errors/claude-ai-not-working/)