7 juillet 2026Johan Huynh5 min de lecture

Claude Code « prompt is too long » : d'où vient cette erreur et comment la résoudre

Cette erreur ressemble à un mur. En réalité, c'est juste un conteneur plein. Une fois que vous avez compris ce qui le remplit, la solution prend dix secondes.

Le robot kitstarter à côté d'un triangle de signalisation, symbolisant l'erreur prompt too long

Vous êtes en plein travail, vous envoyez un message tout à fait normal, et Claude Code vous répond Prompt is too long. Parfois, cela bloque toutes les requêtes suivantes tant que vous ne réglez pas le problème. Ce n'est pas un bug dans votre prompt. Votre fenêtre de contexte, c'est-à-dire la quantité de texte que le modèle peut traiter en une seule fois, est pleine. Un message de plus a suffi à la faire déborder.

Ce que signifie réellement « prompt is too long »

On confond souvent deux limites différentes. La limite d'utilisation concerne votre consommation sur une période donnée, le budget de votre forfait. L'erreur prompt is too long concerne la taille instantanée : une seule requête a dépassé la fenêtre de contexte. Cet article traite de cette deuxième limite. Elle signifie que la conversation, plus ce que vous venez d'ajouter, ne rentre plus. La solution est toujours la même : retirer des éléments de la fenêtre.

Ce qui remplit votre contexte

Trois coupables, classés du plus fréquent au plus rare :

Serveurs MCP inutiliséschaque serveur connecté charge des définitions d'outils dans la fenêtre, qu'il soit actif ou non. Déconnecter ceux qui sont inutiles pour la tâche en cours libère immédiatement cet espace.
Fichiers volumineuxcoller ou importer un gros fichier d'un coup peut saturer la fenêtre instantanément. Pointer vers lui avec @path/to/file permet de ne charger que la partie nécessaire au lieu de la totalité.
Une longue conversationdes heures d'échanges s'accumulent discrètement jusqu'à ce qu'il n'y ait plus de place. /compact résume la discussion pour ne garder que l'essentiel, tandis que /clear l'efface tout en gardant votre projet chargé.
La taille de la fenêtre est fixe. Ce sont généralement ces trois éléments qui la saturent, et chacun a sa propre solution pour libérer de l'espace.

Les solutions, dans l'ordre

  1. Lancez /compact. Cette commande résume la conversation pour ne garder que l'essentiel et vous permet de continuer. C'est la première chose à tenter : elle libère de la place sans vous faire perdre le fil.
  2. Ou lancez /clear. Cela efface complètement la conversation tout en gardant votre projet et CLAUDE.md chargés. Utilisez cette commande entre deux tâches distinctes. Une fenêtre neuve, le même projet.
  3. Désactivez les serveurs MCP inutilisés. Chaque serveur connecté consomme de l'espace dans la fenêtre. Ne gardez que ceux dont vous avez réellement besoin pour la tâche en cours.
  4. Arrêtez de lui envoyer des fichiers géants. Ne collez pas de fichier énorme et ne lancez pas /context sur tout votre dépôt. Pointez vers ce dont vous avez besoin avec @path/to/file, ou découpez le fichier.
  5. Divisez la tâche. Si une seule requête nécessite vraiment plus d'espace que la fenêtre n'en contient, c'est qu'elle est trop volumineuse. Procédez par étapes plus simples.
Le robot kitstarter en équilibre avec une pile de feuilles volantes sur le point de s'effondrer, à côté d'un dossier fermé bien rangé
Transporter toute la conversation, ou seulement ce qui est nécessaire pour cette tâche.

Comment éviter que cela ne se reproduise

Les personnes qui ne voient jamais cette erreur n'ont pas seulement de la chance. Elles veillent activement à garder leur contexte léger : un coup de /clear entre deux tâches distinctes, un /compact avant de commencer un gros chantier, uniquement les serveurs MCP nécessaires, et des fichiers référencés plutôt que collés en entier. En bonus, un contexte léger évite les erreurs, mais il est aussi plus rapide et plus économique, car vous ne payez pas pour retraiter une fenêtre surchargée à chaque message.

Cette habitude de garder un contexte restreint et ciblé est l'un des comportements intégrés par kitstarter. Les commandes du kit sauvegardent et réinitialisent votre travail par étapes propres pour que la fenêtre ne se remplisse jamais en douce jusqu'à saturation, tandis qu'un CLAUDE.md léger maintient la base à un niveau minimal. La surcharge de contexte n'est pas qu'un simple message d'erreur : c'est aussi ce qui ralentit les longues sessions et rend l'IA amnésique.

Questions fréquentes

Que signifie « prompt is too long » dans Claude Code ? Cela signifie qu'une seule requête a dépassé la fenêtre de contexte, c'est-à-dire la limite de tokens pour un message. C'est différent d'avoir atteint votre limite d'utilisation, qui concerne votre consommation globale dans le temps. L'erreur « prompt too long » concerne la taille instantanée. Elle est généralement causée par une conversation trop longue, des fichiers volumineux ou des serveurs MCP inutilisés qui saturent la fenêtre.

Comment corriger l'erreur « prompt is too long » dans Claude Code ? Lancez /compact pour résumer la conversation et continuer, ou /clear pour repartir de zéro tout en gardant votre projet chargé. Désactivez les serveurs MCP inutilisés, évitez d'importer des fichiers géants ou de lancer /context sur tout votre dépôt, et divisez les tâches volumineuses en plusieurs étapes.

Comment éviter que cela ne se reproduise ? Prenez l'habitude de garder votre contexte léger : utilisez /clear entre deux tâches distinctes, /compact avant un gros chantier, ne connectez que les serveurs MCP indispensables et référencez les fichiers avec @ plutôt que de les coller en entier. Un contexte léger est non seulement sans erreur, mais aussi plus rapide et plus économique.

Gardez un contexte léger par défaut

kitstarter intègre les habitudes qui bloquent la surcharge de contexte avant qu'elle ne pose problème, pour Claude Code, Codex et Antigravity.

Get the kit · $20 $29Lire la documentation