AI for Designers12 min read

Claude Code /clear vs /compact : ce que fait chaque commande et quand l'utiliser

Ce que font /clear et /compact dans Claude Code, ce que chacune garde et perd, comment fonctionne l'auto-compact et comment le désactiver, quelle est la taille de la fenêtre de contexte, et quand utiliser laquelle. Vérifié avec la doc et testé sur Claude Code 2.1.319.

By Boone
XLinkedIn
Claude Code /clear vs /compact: What Each Does and When to Use It

La fenêtre de contexte, c'est tout ce que Claude Code peut voir en même temps : votre conversation, les fichiers qu'il a lus et les instructions qu'il charge. /clear la vide et démarre une nouvelle conversation, et /compact la réduit en résumé et poursuit la même conversation. Nous avons vérifié chaque commande et réglage ci-dessous dans la doc d'Anthropic, puis testé la compaction et les principaux réglages sur Claude Code 2.1.319.

/clear vs /compact en un coup d'œil

/clear/compact
Ce que ça faitDémarre une nouvelle conversation avec une fenêtre videRemplace le chat jusque-là par un résumé et continue
Ce qui resteLe CLAUDE.md de votre projet et la mémoire automatique, rechargés depuis le disqueLe résumé, le CLAUDE.md de votre projet, la mémoire automatique, les skills et jusqu'à cinq fichiers récents
Ce qui partChaque message et chaque fichier lu par ClaudeLa formulation exacte, les sorties d'outils et les détails du début
Votre ancien chatSauvegardé, de retour avec /resumeRemplacé par le résumé
CoûtAucunUn appel au modèle qui relit tout le chat
À utiliser quandVous passez à un travail sans rapportUne longue tâche a encore besoin de son historique

Ce que fait /clear

/clear démarre une nouvelle conversation avec un contexte vide. L'ancienne conversation n'est pas supprimée : elle est sauvegardée et /resume la ramène. /reset et /new font la même chose. Passez un nom et il étiquette le chat que vous quittez, pas le nouveau, donc /clear oauth-migration sauvegarde l'ancienne session sous ce nom.

Le CLAUDE.md de votre projet et la mémoire automatique, les notes que Claude garde pour lui, se rechargent, car une nouvelle conversation démarre comme n'importe quelle nouvelle session. Dans notre test, une nouvelle session ne connaissait aucun des dix faits de l'ancien chat et suivait tout de même la règle du CLAUDE.md.

Nettoyez souvent, car chaque requête renvoie toute la conversation. Un chat contenant trois tâches sans rapport relit les trois à chaque tour de la quatrième, avec une remise tant que le cache de prompt (un stockage temporaire qui rend le texte répété moins cher) est chaud, et plein tarif après son expiration. La doc API d'Anthropic ajoute une raison de qualité : la précision et le rappel se dégradent quand le nombre de tokens grandit, ce qu'ils appellent le context rot. Après deux corrections ratées, le conseil d'Anthropic est de faire /clear et d'écrire un meilleur prompt, pas une troisième correction.

Ce que fait /compact

/compact résume la conversation jusque-là et continue dans la même session. Claude garde le plan et les décisions, avec les mots du résumé plutôt que les vôtres. Lancez-le tel quel et Claude décide de ce qui compte, ou ajoutez un focus et le résumé protège ce que vous nommez : /compact keep the API changes and the test commands. Pour un focus permanent, ajoutez une section Compact instructions au CLAUDE.md de votre projet.

La réserve d'Anthropic elle-même : le résumé garde vos demandes et les extraits de code clés, mais les instructions détaillées du début de la conversation peuvent être perdues. Tout ce que Claude ne doit jamais oublier va dans CLAUDE.md, pas dans le chat.

Le résumé coûte un appel au modèle qui relit toute la conversation. C'est bon marché tant que le cache de prompt est chaud et plein tarif une fois expiré, d'où le fait qu'un compact coûte le plus sur une vieille session reprise. Le cache dure environ une heure avec un abonnement et cinq minutes avec une clé API. Compactez à une coupure naturelle, comme entre deux tâches, pas en pleine tâche.

Ce qui survit à un /compact

La doc liste ce qui arrive à chaque type de contenu :

QuoiAprès un compact
CLAUDE.md à la racine du projet, règles sans portée, mémoire automatiqueRéinjectés depuis le disque
SkillsDescriptions reconstruites ; corps des skills invoqués réinjectés, jusqu'à 5 000 tokens chacun et 25 000 au total
Fichiers lus ou modifiés par ClaudeJusqu'à cinq relus, les plus récents d'abord ; un fichier de plus de 5 000 tokens revient sous forme de simple chemin
Règles à portée de chemin (limitées à certains fichiers) et fichiers CLAUDE.md imbriquésRésumés et disparus, rechargés quand Claude touche un fichier correspondant
Vos messages, les réponses de Claude et les sorties d'outilsRemplacés par le résumé

La ligne discrète est celle des règles à portée de chemin. Si une règle doit survivre à un compact, retirez son filtre paths: ou déplacez-la dans le CLAUDE.md à la racine du projet.

Nous avons testé ce qu'un compact garde

Nous avons lancé Claude Code depuis un script, sans fenêtre de chat, sur Sonnet 5.5, avec les outils et MCP (les connecteurs vers d'autres applis) désactivés. Claude a reçu deux documents de projet inventés d'environ 6 600 mots chacun, avec six détails enfouis dedans : un numéro de facture, un numéro de suivi, un photographe, un poste téléphonique, une heure d'embargo presse et un préfixe de code-barres. Nous avons ensuite tapé quatre décisions dans le chat (une couleur hexadécimale, une police abandonnée, un rayon d'angle et un nom de fichier), environ 25 000 tokens au total. Nous avons lancé /compact, démarré une nouvelle session dans le même dossier pour simuler /clear, et demandé à chacune les dix faits de mémoire.

25k

Avant, tokens de chat

0

Après /clear, nouvelle session

2,5k

Après /compact, un résumé

Taille du chat dans la session de test, lue avec /context. Le chiffre de /compact est le milieu de sept essais, qui allaient de 2,4k à 2,8k.
Ce que nous avons lancéTaille du chat aprèsFaits connus de Claude, sur 10
Rien25k tokens10, dans les deux essais
Une nouvelle session, comme après /clear00, et la règle du CLAUDE.md s'appliquait toujours
L'ancienne session, reprise25k tokens10, dans les deux essais
/compact2,4k à 2,8k10 dans 5 essais sur 7, 4 dans les 2 autres
/compact avec un focus sur les détails2,6k à 3,0k10 dans 7 essais sur 7

Ce que le test a montré

  • C'était rapide et petit. Dans ce chat de 25k tokens, un compact a pris 13 à 20 secondes et réduit le chat d'environ 90 pour cent.
  • Un compact simple marche en général et perd parfois ce que vous avez collé. Dans les deux ratés, il a gardé les quatre décisions tapées et perdu les six détails des documents.
  • Un focus qui nomme les détails les protège. Le nôtre listait les types de détails sur lesquels nous interrogions ensuite, et les dix faits ont survécu dans sept essais sur sept. Il ne sauvera pas un détail que vous avez oublié de nommer.
  • La partie brouillonne. Les deux ratés venaient de notre premier lot, où la mémoire automatique était activée et où les deux résumés mentionnaient le système de mémoire. Avec la mémoire automatique désactivée, quatre compacts simples sur quatre ont tout gardé. Nous ne pouvons pas dire que c'était la cause, et c'est un petit test : un modèle, des documents inventés, sept essais chacun.

Considérez un /compact simple comme probablement correct et possiblement avec perte. Quand un détail compte, nommez-le dans le focus ou mettez-le dans CLAUDE.md.

Quand l'auto-compact se déclenche

Claude Code compacte pour vous quand la fenêtre se remplit, avec le même genre de résumé que /compact. C'est activé par défaut, donc une fenêtre pleine ne met pas fin à votre session. Il démarre vers 967K tokens sur les modèles 1M et à la limite sur une fenêtre de 200K.

Deux autres choses se produisent toutes seules :

  • Compaction en veille. Après environ une heure d'absence, une conversation de plus de 200 000 tokens sur le cache d'une heure est compactée avant l'expiration du cache, de sorte que votre prochain message envoie un résumé. Désactivez-la avec idleCompaction à false.
  • Un arrêt pour thrashing. Si un énorme fichier ou une sortie d'outil remplit à nouveau la fenêtre après chaque résumé, Claude Code abandonne après quelques essais et affiche Autocompact is thrashing. Lisez le fichier par morceaux, lancez /compact avec un focus qui écarte la sortie, confiez-le à un subagent (un assistant avec sa propre fenêtre), ou faites /clear.

Comment modifier l'auto-compact ou le désactiver

Les principaux interrupteurs listés par la doc, et lequel l'emporte :

  • /autocompact 500k (dans une session, Claude Code 2.1.221 ou plus récent) : enregistre une fenêtre pour le modèle actuel et l'applique tout de suite. /autocompact auto la réinitialise.
  • --autocompact 500k (option de lancement) : change la fenêtre pour ce lancement seulement.
  • autoCompactWindow (settings.json) : une fenêtre pour tous les modèles, de 100000 à 1000000.
  • CLAUDE_CODE_AUTO_COMPACT_WINDOW (environnement) : l'emporte sur les trois précédents. Conçu pour les scripts et les exécutions cloud.
  • autoCompactEnabled (settings.json ou /config) : false désactive l'auto-compact. La valeur par défaut est true.
  • DISABLE_AUTO_COMPACT=1 (environnement) : le désactive pour une session et l'emporte sur le réglage.
  • DISABLE_COMPACT=1 (environnement) : désactive toute compaction, /compact compris.
  • CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=50 (environnement) : compacte à 50 pour cent de la fenêtre. Il peut abaisser le seuil mais pas le relever, et ne s'applique qu'aux sessions qui compactent avant la limite du modèle.

Une fenêtre peut s'écrire 200000, 200k ou 1M. Pour désactiver l'auto-compact, mettez ceci dans ~/.claude/settings.json :

json
{ "autoCompactEnabled": false }

Avec cela désactivé, /compact fonctionne toujours, et une fenêtre pleine se termine par Context limit reached · /compact or /clear to continue, avec une note indiquant que l'auto-compact est désactivé.

Nous avons vérifié la plupart de ces noms sur Claude Code 2.1.319 en lisant /context. L'option, CLAUDE_CODE_AUTO_COMPACT_WINDOW, autoCompactWindow et CLAUDE_CODE_DISABLE_1M_CONTEXT=1 ont chacun changé la fenêtre affichée, et désactiver l'auto-compact a remplacé le buffer Autocompact de 33k par un buffer Compact de 3k. La commande /autocompact et CLAUDE_AUTOCOMPACT_PCT_OVERRIDE viennent de la doc seulement : nous n'avons pas lancé la commande, et la variable n'a rien changé de ce que montre /context.

Quelle est la taille de la fenêtre de contexte ?

Les modèles Claude actuels ont une fenêtre de 1M tokens. Un token est un morceau de texte un peu supérieur à un demi-mot avec le tokenizer actuel, soit environ 555 000 mots. Dans Claude Code, la fenêtre dont vous disposez dépend du modèle :

ModèleFenêtre dans Claude CodeL'auto-compact démarre
Opus 4.7 et suivants, dont Opus 5.51M tokensEnviron 967K
Sonnet 5 et suivants, dont Sonnet 5.51M tokensEnviron 967K
Haiku 5.5, Fable 5 et Fable 5.11M tokensEnviron 967K
Opus 4.6 et Sonnet 4.6200K, ou 1M avec la variante [1m] sur les forfaits qui l'autorisentÀ la limite

Définissez CLAUDE_CODE_DISABLE_1M_CONTEXT=1 pour limiter chaque modèle à 200K.

Voir ce qui remplit la fenêtre avec /context

Lancez /context pour voir ce qui utilise la fenêtre : une grille colorée avec des conseils sur les outils lourds, l'embonpoint de la mémoire et les alertes de capacité. Voici une session neuve sur Opus 5.5, telle que claude -p "/context" l'a affichée sur Claude Code 2.1.319 :

CatégorieTokensPart de 1M
Prompt système1,8k0,2%
Outils système6,6k0,7%
Skills2,3k0,2%
Messages100,0%
Espace libre956,3k95,6%
Buffer Autocompact33k3,3%

Une session neuve contient déjà environ 10,7k tokens, presque tous venant du prompt, des outils et des skills de Claude Code lui-même. /context réserve un buffer Autocompact de 33k sur chaque fenêtre que nous avons lue, et sur une fenêtre de 1M, 1M moins 33k donne les 967K où la doc dit que l'auto-compact démarre. Avec l'auto-compact désactivé, cette ligne se réduit à un buffer Compact de 3k.

Les définitions d'outils MCP sont différées par défaut et ne se chargent que lorsque Claude utilise un outil, donc une longue liste de serveurs coûte peu au départ. Dans deux essais sur notre propre machine, /context a listé 259,6k puis 544,1k tokens d'outils MCP comme différés, alors que MCP comptait moins de 5k au démarrage : noms d'outils et instructions de serveur.

Une session lente n'est pas toujours une fenêtre pleine : un niveau d'effort élevé réfléchit plus longtemps. /usage montre le coût et l'usage du forfait, et /export sauvegarde le chat en texte brut avant de nettoyer.

Quelle commande pour quel moment

SituationLancezPourquoi
Vous avez fini une tâche et en commencez une sans rapport/clearL'ancien chat évince ce dont vous avez besoin ensuite et coûte des tokens à chaque message
Vous avez corrigé Claude deux fois et c'est toujours faux/clear, puis un meilleur promptUne troisième correction s'empile sur deux tentatives ratées
Une longue tâche a encore besoin de son historique/compact avec un focusLe résumé garde ce que vous nommez
Vous avez pris un mauvais virage/rewindRamène le chat, le code ou les deux à un prompt antérieur
Une longue séquence de débogage a noyé le chat/rewind, puis Summarize from hereCompresse tout ce qui suit le message choisi et garde vos instructions du début
Vous voulez récupérer un ancien chat/resumeRamène n'importe quel chat sauvegardé, y compris un que vous venez de nettoyer
Vous retapez la même règle à chaque sessionLe CLAUDE.md de votre projet, édité avec /memoryLes deux commandes n'y touchent pas
Une grosse lecture inonderait le chatUn subagentIl lit dans sa propre fenêtre et seul le résumé revient

Par défaut, /clear entre les tâches. Sortez /compact quand la continuité au sein d'une tâche est le but, et donnez-lui un focus. Si vous voulez d'abord les bases, voici ce qu'est vraiment une fenêtre de contexte.

FAQ

Que fait /clear dans Claude Code ?

Il démarre une nouvelle conversation avec une fenêtre de contexte vide. L'ancienne conversation est sauvegardée, donc /resume la ramène, et CLAUDE.md et la mémoire automatique se rechargent. /reset et /new font la même chose.

À quoi sert /compact dans Claude Code ?

Il libère du contexte en remplaçant la conversation jusque-là par un résumé, ce qui vous permet de continuer dans la même session. Ajoutez des instructions, comme /compact keep the API changes, pour orienter ce que le résumé protège.

Dois-je utiliser /clear ou /compact ?

Utilisez /clear quand vous passez à un travail sans rapport ou qu'une correction a échoué deux fois. Utilisez /compact, avec un focus, quand une longue tâche a encore besoin de son historique.

Puis-je annuler /clear dans Claude Code ?

Oui. Lancez /resume et choisissez l'ancienne conversation, qui reste sauvegardée 30 jours par défaut. Dans la même fenêtre Claude Code, le menu /rewind liste aussi la session précédente en haut.

Comment désactiver l'auto-compact dans Claude Code (autoCompactEnabled) ?

Mettez autoCompactEnabled à false dans settings.json, désactivez Auto-compact dans /config, ou définissez DISABLE_AUTO_COMPACT=1 pour une session. La variable d'environnement l'emporte sur le réglage, et /compact fonctionne dans tous les cas.

Comment changer le moment où Claude Code auto-compacte ?

Lancez /autocompact 500k pour définir la fenêtre du modèle actuel, ou utilisez --autocompact, autoCompactWindow ou CLAUDE_CODE_AUTO_COMPACT_WINDOW. Toute valeur de 100K à 1M tokens convient, dans la limite de la fenêtre du modèle, et /autocompact auto la réinitialise.

Quelle est la taille de la fenêtre de contexte dans Claude Code ?

1M tokens sur Opus 4.7 et suivants, Sonnet 5 et suivants, Haiku 5.5 et Fable 5 et suivants. Opus 4.6 et Sonnet 4.6 tournent à 200K sauf si vous choisissez la variante [1m].

Que signifie « Context limit reached » dans Claude Code ?

La conversation plus les fichiers joints ne tient plus dans la fenêtre du modèle. Lancez /compact pour un résumé ou /clear pour repartir de zéro. Si la ligne indique que l'auto-compact est désactivé, /config le réactive.

Sources

  • Doc Claude Code, Commands : chaque commande et alias ci-dessus.
  • Doc Claude Code, Explore the context window : ce qui survit à la compaction, ce qui s'exécute quand le contexte se remplit.
  • Doc Claude Code, Model configuration : tailles de fenêtre, fenêtre d'auto-compact, seuils par défaut.
  • Doc Claude Code, Settings et Environment variables : autoCompactEnabled, autoCompactWindow, idleCompaction et les variables ci-dessus.
  • Doc Claude Code, Checkpointing et Sessions : le menu rewind, comment /clear nomme et sauvegarde une session.
  • Doc Claude Code, Best practices, Reduce token usage et Prompt caching : quand nettoyer, ce que coûte un compact, Compact instructions.
  • Doc Claude Code, Error reference et Troubleshooting : la ligne Context limit reached et l'arrêt pour thrashing.
  • Doc API Claude, Context windows et Models overview : tailles de fenêtre par modèle, context rot.
  • Nos essais : Claude Code 2.1.319, en headless avec claude -p, Sonnet 5.5 pour le test de compaction et Opus 5.5 pour les lectures de /context, réalisés le 6 novembre 2026. Quatorze essais de compaction, quatre contrôles, et /context lu sous chaque réglage nommé ci-dessus.

Brainy helps designers put AI to work without losing the craft. See what we are building for creators.

Get Started

More from Brainy Papers

Keep reading