Cours Vibe coding avec Claude Code · Module 5: Clone de Reddit

Long voyage : le contexte et les sessions dans Claude Code

8 min de lecture ·
Dans cette leçon7

Crew Council est né au fil de plusieurs soirées : le vote, les fils, les guildes, le Markdown et la recherche. Si tout ce travail était passé dans une seule conversation, Claude aurait encore sous les yeux, pour la recherche, les disputes sur les votes, de vieux résultats de tests et deux versions abandonnées de l'arbre de commentaires. Et quand tu fermes le terminal le soir, une seconde question se pose : faudra-t-il tout réexpliquer demain ? Cette leçon rassemble en un lieu ce que tu as fait par réflexe dans ce lieu : quand vider la conversation, quand la résumer et quand y revenir.

La fenêtre de contexte : ce que Claude a sous les yeux

La fenêtre de contexte est tout ce que Claude voit dans une session donnée : CLAUDE.md et la mémoire automatique chargés au démarrage, tes demandes, les fichiers lus, les résultats des commandes et ses propres réponses. La mémoire automatique, ce sont des notes que Claude écrit lui-même d'après tes corrections et tes préférences ; elle est activée par défaut, et tu la consultes avec /memory. Chaque nouvelle demande envoie au modèle toute la conversation. La documentation donne un exemple : une session qui a réuni trois tâches sans rapport relit les trois à chaque tour pendant la quatrième. Les sessions sont par ailleurs indépendantes les unes des autres : chaque nouvelle démarre avec une fenêtre vide, sans l'historique des conversations précédentes, et seuls CLAUDE.md, la mémoire automatique et les fichiers du projet les relient.

La place manque rarement. La plupart des modèles actuels ont une fenêtre d'un million de tokens, et Claude Code résume lui-même la conversation quand elle approche de la limite (état de novembre 2026). Le problème n'est donc pas une cale qui éclate, mais deux autres choses : chaque tour coûte d'autant plus de limite que la conversation est longue, et les vieilles décisions périmées se mélangent aux nouvelles.

/context : jette un œil dans la cale

Avant de vider quoi que ce soit, tu peux vérifier ce qui prend de la place :

/context

La commande dessine une grille colorée de l'occupation de la fenêtre, répartie par type de contenu, et suggère ce qui en prend trop. Elle montre aussi quels fichiers CLAUDE.md et quelles mémoires ont été chargés. Quand tu cherches la réponse à "Claude voit-il seulement mes règles ?", c'est le premier endroit à regarder.

/clear : nouvelle fonctionnalité, nouvelle conversation

/clear commence une nouvelle conversation avec un contexte vide. La précédente ne disparaît pas, elle reste enregistrée pour être reprise. Tu peux lui donner tout de suite un nom :

/clear communautes

Le nom va à la conversation que tu quittes, tu la retrouveras donc dans la liste des sessions sous le mot communautes. Les bonnes pratiques de Claude Code disent deux choses de /clear. D'abord, entre des tâches sans rapport il ne coûte rien, et la tâche suivante ne paie pas l'historique de la précédente. Ensuite, quand tu as corrigé deux fois la même chose et que ça va toujours mal, une troisième correction ne fait qu'ajouter un essai raté à la conversation. Mieux vaut /clear et une seule nouvelle demande, où tu rassembles ce que tu as appris. Et si tu tapes /clear trop tôt, dans la même exécution de Claude Code le menu /rewind a en haut une entrée avec la conversation précédente et la rétablit d'un seul choix.

Ce qui compte, c'est ce que /clear laisse survivre et ce qu'il ne laisse pas. Survit tout ce qui est sur le disque : CLAUDE.md et la mémoire automatique se chargent au début de chaque conversation, les fichiers du projet et les commits de Git restent, et l'ancienne conversation attend dans l'enregistrement de la session. Ne survit pas la conversation dans le contexte, c'est-à-dire les décisions prises dans le chat, les résultats de tests montrés plus tôt et toute décision que personne n'a écrite. C'est pourquoi le piège de la leçon 4_1, "tu ne modifies pas les valeurs attendues dans les tests sans mon accord", se trouve dans CLAUDE.md et non dans l'une des demandes. Je te recommande une habitude simple : avant /clear, un commit, et ce que chaque future conversation doit retenir, ajoute-le à CLAUDE.md.

/compact : la même tâche, un historique plus court

Parfois la tâche dure et la conversation enfle, par exemple après une heure à corriger la même recherche. Tu ne veux pas vider, parce que les décisions sont nécessaires. /compact remplace alors l'historique par un résumé, et toi tu dis ce qui doit y rester :

/compact garde les règles de recherche, la liste des tests et la commande des tests

Sans ajout, le résumé choisit lui-même ce qui est important. Après le résumé, CLAUDE.md est rechargé depuis le disque, et Claude relit quelques fichiers récemment modifiés. Les instructions détaillées du début de la conversation peuvent toutefois se perdre, donc les règles durables appartiennent de nouveau à CLAUDE.md. Tu peux aussi y ajouter une section "Compact Instructions" avec ce que chaque résumé doit conserver. Sur une longue session, /compact est lui-même une grosse demande, car il lit toute la conversation pour la résumer. La distinction est simple : nouveau sujet, /clear ; même sujet avec un long historique, /compact.

Tu fermes le terminal, la session attend

Claude Code enregistre la conversation au fur et à mesure dans un fichier sur ton ordinateur, donc quitter par /exit n'efface rien. Tu reviens avec l'une de ces commandes, lancée dans le dossier du projet :

claude -c                  # dernière conversation de ce dossier
claude -r                  # liste de sessions à choisir
claude -r recherche        # la session de ce nom
claude -n surlignage       # nouvelle session avec un nom dès le départ

-c est l'abréviation de --continue, et -r de --resume. -c prend toujours la dernière conversation du dossier ; quand tu mènes deux fils en alternance, nomme donc les sessions et reviens par -r avec le nom, pour ne pas tomber sur la mauvaise. Dans une session ouverte, la même liste vient de /resume, et /rename change le nom de la session en cours et l'affiche dans la barre de saisie. La conversation reprise revient avec son historique, son modèle et son mode de permissions, mais sans ce qu'elle n'avait pas enregistré, par exemple les commandes qui tournaient plus tôt en arrière-plan. Les enregistrements de sessions disparaissent par défaut au bout de 30 jours, ce n'est donc pas une archive pour toujours.

Deux choses peuvent t'accueillir après une pause. Quand tu reviens au terminal après un moment, Claude Code montre un résumé de la session en une phrase, et /recap te le donne à la demande. Sur les offres Pro, Max et Ultra (état de novembre 2026), après une longue pause peut aussi surgir la question "Resume this conversation?" avec une estimation de la part de la limite de cinq heures que consommerait la seule conversation enregistrée. Tu choisis Resume quand la suite du travail en a besoin, ou Start a new conversation quand elle n'en a pas besoin.

Ton journal de ce lieu

Voici à quoi ressemblait la traversée de Crew Council si tu as suivi les leçons :

jour 1   4_3 guildes      commit, puis /clear
         4_4 Markdown     commit, test rouge du texte barré, /exit
jour 2   claude -c        remark-gfm au vert, commit, puis /clear
         4_5 recherche    commit

/clear se tenait entre les fonctionnalités, parce que le Markdown n'avait pas besoin de la conversation sur les guildes. claude -c a rouvert la conversation le lendemain, parce que la tâche du texte barré était à moitié faite et que Claude y avait la demande et le résultat rouge. Quand la tâche a été close par un commit, de nouveau /clear, car la recherche est un nouveau sujet.

Exerce-toi maintenant. Dans une session, tape /context et trouve ton CLAUDE.md dans la liste. Puis /clear recherche, et juste après /resume : dans la liste, la conversation sur la recherche attend sous le nom donné. Ferme la liste avec Esc, quitte par /exit et reviens à cette conversation par claude -r recherche. Un avertissement de la documentation : ne reprends pas la même session dans deux terminaux à la fois, car une partie des messages pourrait disparaître de l'enregistrement.

La revue du capitaine

  1. Avant /clear : tout ce qui est important est-il sur le disque, dans un commit ou dans CLAUDE.md ?
  2. Après claude -c : commence par /recap ou par la question "où en étions-nous ?" et compare la réponse à git log, au lieu de supposer que Claude se souvient de chaque détail.
  3. Après /compact : vérifie que le résumé a gardé ce que tu avais demandé, par exemple que Claude connaît toujours la commande des tests.

À retenir : le livre de bord, c'est-à-dire CLAUDE.md et les commits, survit à chaque changement de quart, tandis que la conversation est la rumeur du pont : /clear la fait taire, /compact la résume, et claude -c la rappelle.

Code de cette leçon : App.jsx
// Long voyage : quelle commande pour quelle situation, et ce que /clear laisse survivre
import { useState } from 'react';

const situations = [
  {
    text: "La recherche est faite et commitée. Maintenant tu commences le profil du pirate.",
    answer: '/clear recherche',
    why: "Un nouveau sujet est une nouvelle conversation. Le nom reste sur la conversation que tu quittes, tu y reviendras donc par /resume.",
  },
  {
    text: "Depuis une heure tu corriges la même recherche, la conversation est très longue, et les décisions sont toujours nécessaires.",
    answer: '/compact garde les règles de recherche et la commande des tests',
    why: "Même tâche, long historique : un résumé ciblé garde ce que tu indiques.",
  },
  {
    text: "Hier tu t'es arrêté sur un test rouge et tu as fermé le terminal. Aujourd'hui tu veux terminer.",
    answer: 'claude -c',
    why: "Rouvre la dernière conversation de ce dossier, avec la demande et le résultat du test.",
  },
  {
    text: "Tu mènes deux fils en alternance : le surlignage et le profil. Tu veux revenir au surlignage.",
    answer: 'claude -r surlignage',
    why: "Reprend la session par son nom. -c prendrait la dernière conversation, peut-être la mauvaise.",
  },
  {
    text: "Tu as corrigé deux fois la même erreur et ça va toujours mal.",
    answer: '/clear et une seule meilleure demande',
    why: "Une troisième correction ajoute un essai raté de plus à la conversation. La nouvelle demande rassemble ce que tu as appris.",
  },
  {
    text: "Tu ne sais pas si Claude a bien chargé ton CLAUDE.md.",
    answer: '/context',
    why: "Montre l'occupation de la fenêtre et la liste des fichiers CLAUDE.md et des mémoires chargés.",
  },
];

const things = [
  { name: 'CLAUDE.md', survives: true, note: "se charge au début de chaque conversation" },
  { name: 'Mémoire automatique', survives: true, note: "se charge au début de chaque conversation" },
  { name: 'Fichiers du projet et commits', survives: true, note: "sont sur le disque et dans Git" },
  { name: 'Décisions prises dans le chat', survives: false, note: "ne restent que dans l'ancienne conversation, à reprendre par /resume" },
  { name: "Résultat de test montré il y a une heure", survives: false, note: "la nouvelle conversation ne le connaît pas, relance les tests" },
];

export default function App() {
  const [open, setOpen] = useState(null);
  const [revealed, setRevealed] = useState(false);

  return (
    <div className="min-h-screen bg-gray-100 p-4 text-gray-900">
      <div className="mx-auto max-w-2xl space-y-4">
        <h1 className="text-2xl font-bold">Long voyage : que taper ?</h1>
        <p className="text-sm text-gray-600">Clique sur une situation, pense à ta réponse, puis compare-la.</p>
        {situations.map((situation, i) => (
          <button
            key={situation.answer}
            type="button"
            onClick={() => setOpen(open === i ? null : i)}
            aria-expanded={open === i}
            className="block w-full rounded-lg border border-gray-200 bg-white p-3 text-left hover:border-orange-400"
          >
            <span className="block">{situation.text}</span>
            {open === i && (
              <span className="mt-2 block text-sm">
                <code className="rounded bg-gray-900 px-2 py-0.5 text-white">{situation.answer}</code>
                <span className="mt-1 block text-gray-700">{situation.why}</span>
              </span>
            )}
          </button>
        ))}
        <section className="rounded-lg bg-white p-3">
          <h2 className="mb-2 font-bold">Que laisse survivre /clear ?</h2>
          <ul className="space-y-1 text-sm">
            {things.map((thing) => (
              <li key={thing.name}>
                <span className="font-semibold">{thing.name}</span>
                {revealed && (
                  <span className={thing.survives ? 'text-green-700' : 'text-red-700'}>
                    {thing.survives ? ' : reste, ' : ' : disparaît du contexte, '}
                    {thing.note}
                  </span>
                )}
              </li>
            ))}
          </ul>
          <button
            type="button"
            onClick={() => setRevealed((prev) => !prev)}
            className="mt-3 rounded bg-orange-600 px-3 py-1 text-white hover:bg-orange-700"
          >
            {revealed ? 'Cacher les réponses' : 'Montrer les réponses'}
          </button>
        </section>
      </div>
    </div>
  );
}

Tu as repéré une erreur dans cette leçon ?

Teste tes connaissances

Réponds aux questions de cette leçon. Choisis une réponse pour voir tout de suite si elle est correcte.

  1. 1. Depuis une heure tu corriges avec Claude la même recherche. La conversation est très longue, et ses décisions sont toujours nécessaires. Que tapes-tu ?

  2. 2. Tu tapes /clear. Que connaît encore Claude dans la nouvelle conversation ?

Voici 2 des 3 questions de cette leçon. Réponds aux autres dans le jeu.

Tâches pratiques dans le jeu

  • Tri horizontal

    Ordonne la commande qui reprend la session nommée recherche (une seule ligne, de gauche à droite) :

  1. QuestionQuiz : /clear ou /compact
  2. Remets dans l'ordreTri : Reprendre une session par son nom
  3. QuestionQuiz : Ce que laisse survivre /clear
  4. QuestionQuiz : Revenir à la conversation d'hier
  5. Projet à envoyerEnvoie le dépôt Crew Council au mentor
  6. VidéoRésumé du module

Articles utiles