Cours Vibe coding avec Claude Code · Module 6: Clone de YouTube
La note du voyage : /usage, effort et ce que coûtent les sous-agents
Dans cette leçon5
Dans la leçon 5_4, les éclaireurs ont parcouru le projet et la documentation, et dans la leçon 5_5, Claude a écrit un parseur avec des tests et une nouvelle section de page. Chacune de ces étapes a coûté quelque chose même si aucune n'est arrivée avec une facture. Sur un plan, tu paies un montant fixe : Pro coûte 20 USD par mois avec paiement mensuel, et Max 100 USD (état de novembre 2026). Le travail consomme en revanche la limite du plan, commune à tout ton travail avec Claude Code : la conversation principale, les sous-agents et la recherche. Quand la limite s'épuise au milieu du chantier, Claude Code affiche un message de limite de session ou hebdomadaire. La documentation de Claude Code dit qu'une telle limite couvre tous les modèles à la fois, donc changer de modèle avec /model ne la renouvelle pas. Cette leçon t'apprend à lire le livre de bord des coûts avant que la réserve de poudre ne soit vide.
Ce que montre /usage
/usage est une seule commande qui, selon la documentation, montre le coût de la session, les limites du plan et des statistiques d'activité ; /cost et /stats sont ses autres noms. À l'écran, il y a trois parties qu'il vaut la peine de distinguer :
- Le bloc Session en haut : les tokens et le montant en dollars de la session en cours. La documentation précise que, pour les abonnés Pro, Max et Ultra, ce montant n'a pas de valeur de facturation, parce que la consommation est comprise dans le plan. Les chiffres repartent à zéro après
/clear. - Les barres du plan : quelle part de la limite tu as déjà consommée.
- La répartition sur les plans Pro, Max, Ultra, Team et Enterprise : quelle part de la consommation récente revient aux skills, aux sous-agents, aux plugins et aux serveurs MCP, et en dessous les recommandations. Les touches
detwbasculent entre les dernières 24 heures et les 7 derniers jours.
Chaque recommandation commence par une part de la consommation, d'au moins 10 %. Voici des lignes d'exemple tirées de la documentation :
25% Trim ~/code/api/CLAUDE.md · 49k tokens per request
30% Compact before you step away · run /compact
40% Switch from max to high effort · /effort highLa part dit quelle fraction de la consommation concerne la ligne, et non combien tu économiseras, et une même requête peut compter dans plusieurs lignes. Quand le pied de page affiche un indice du genre f to fix 2 of 3, la touche f lance les commandes /effort des lignes, et pour une partie des autres Claude montre le changement avant de l'appliquer. Une ligne qui se termine par run, tu l'exécutes toi-même. La répartition ne compte que l'historique de cet ordinateur, donc le travail d'autres appareils ou de claude.ai n'y apparaît pas. C'est une approximation et non une facture, et c'est ainsi qu'il faut la lire.
Ce qui mange la limite
La page sur les coûts énumère plusieurs raisons pour lesquelles une longue session consomme plus que ne le laisserait penser ton activité. Trois concernent directement ce module :
- Un long contexte. À chaque requête, Claude Code envoie toute la conversation, et chaque usage d'un outil est une requête de plus avec ses résultats. Une courte question dans une session ouverte depuis le matin paie encore tout l'historique, même si la relecture coûte moins cher grâce au cache. C'est pourquoi tu utilises
/clearentre des tâches sans lien : la documentation souligne que ça ne coûte rien, alors que/compactlit lui-même toute la conversation pour la résumer. - Les sous-agents. Chaque sous-agent envoie ses propres requêtes, qui comptent dans les mêmes limites que la conversation principale. La répartition de
/usagemontre leur part. - La recherche sur le web. La documentation cite la récupération de documentation à côté du lancement de tests et de la lecture de journaux parmi les opérations qui occupent beaucoup de contexte. Chaque page de WebFetch laisse un extrait dans la conversation, et le rapport de la leçon 5_4 reposait sur plusieurs pages à la fois.
L'économie la moins chère est la plus simple : une demande précise. La page sur les coûts donne un exemple : un général « améliore ce code » déclenche une large recherche, alors qu'une demande de validation dans une fonction d'un fichier permet à Claude de lire peu de fichiers. La demande de recherche de la leçon 5_4 était justement de ce genre : deux sites, quatre choses à vérifier dans le projet et un « n'écris pas de code » net.
Effort : combien Claude réfléchit
L'effort est un réglage qui dit combien de temps Claude réfléchit et combien il vérifie avant de répondre. Les niveaux sont low, medium, high, xhigh et max, et les modèles actuels démarrent dans Claude Code à medium. Un niveau plus haut coûte plus de temps et de tokens, un niveau plus bas donne plus vite un point de départ. Tu le changes en session avec une commande :
/effort highLe niveau écrit après /effort reste le défaut aussi pour les sessions suivantes. Dans le curseur qu'ouvre /effort seul, la touche s fixe le niveau seulement pour la session en cours, et max ne fonctionne que dans la session en cours. Les best practices de Claude Code disent quand toucher au curseur :
- Plus haut, c'est-à-dire
highouxhigh, quand un résultat correct dépend de cas faciles à rater : un bug dans du code que tu n'as pas écrit, un test instable, un changement de forme des données où Claude doit trouver chaque endroit qui lit l'ancienne forme. Un nouveau champ obligatoire dans le typeVideode la leçon 5_1 est justement ce cas. - Plus bas, c'est-à-dire
low, quand tu échanges vite avec Claude et que tu regardes de toute façon chaque résultat : remue-méninges, premier brouillon, renommage dans quelques fichiers. max, tu le gardes pour un problème difficile sur lequel Claude doit travailler sans toi, par exemple la recherche d'une faille de sécurité. Sur des tâches ordinaires, il tend à trop réfléchir, donc tu paies plus pour une réponse qui n'est pas meilleure que celle dehigh.- Quand un seul message est difficile, écris-y le mot
ultrathinkau lieu de changer le réglage.
Les commentaires de la leçon 5_5 sont une fonction de tous les jours au périmètre clair, donc medium. Je te conseille de laisser le niveau par défaut et de le relever consciemment, tâche après tâche.
Le second levier est le modèle. D'après les best practices, l'Opus par défaut vient à bout de la plupart des codages, et Sonnet coûte moins pour le travail courant. Tu le changes avec /model, qui enregistre le choix aussi pour les nouvelles sessions ; dans la liste des modèles, la touche s change le modèle seulement dans la session en cours.
Sous-agent : du parallèle, pas de l'intelligence
Dans la leçon 5_4, Explore a parcouru le projet dans son propre contexte. Les best practices énumèrent quand un sous-agent vaut la peine : des parties indépendantes du travail faites en même temps, un long résultat (déroulé complet des tests, large recherche) gardé hors de la conversation principale, un relecteur qui n'a pas vu comment le code est né, et une tâche avec un ensemble d'outils plus petit. Le coût, ce sont des tokens, et parfois du temps : un sous-agent tout neuf commence par rassembler un contexte que la conversation principale avait déjà, donc il est parfois plus lent.
La phrase la plus importante de cette section : par défaut, un sous-agent est le même modèle ou un plus petit, sur la même tâche. Tu obtiens du parallélisme ou un regard neuf, pas une réponse plus intelligente. Quand la réponse de Claude ne suffit pas, c'est une meilleure demande ou un effort plus haut qui aide, pas « fais-le avec un sous-agent ». Pour que les sous-agents coûtent moins, demande de courts résumés au lieu de vingt résultats complets et regarde leur part dans /usage. À un sous-agent maison simple, la documentation conseille de donner un modèle plus petit, Haiku, et tu construiras tes propres sous-agents plus loin dans le cours.
Pratique : la note de la reconnaissance de la leçon 5_4
Ouvre Claude Code dans le dossier du cinéma et tape :
/usageAppuie sur d pour voir les dernières 24 heures et réponds à trois questions. Quelle part de la consommation revient aux sous-agents, donc entre autres à Explore pour la recherche ? Y a-t-il une recommandation, par exemple sur un long contexte ? Le bloc Session concerne-t-il cette conversation, ou est-il reparti à zéro après le dernier /clear ? Pour finir, demande à Claude d'ajouter à CLAUDE.md une règle, par exemple : enregistre le rapport de recherche dans un fichier de docs/. La règle vaut pour chaque session, et le reste est ton habitude : tu commences la construction après /clear en désignant ce fichier avec @. La fonctionnalité suivante ne paiera plus alors toute l'histoire de la reconnaissance.
Dans l'éditeur ci-dessous, tu choisis l'effort pour six tâches et tu décides si tu confies cinq autres à un sous-agent. Chaque réponse a sa justification tirée de la documentation de Claude Code.
Retiens : le capitaine ne regrette pas la poudre pour la bataille, mais il compte les barils avant la traversée, et il envoie un éclaireur pour regarder des deux côtés à la fois, pas pour obtenir des ordres plus malins.
Code de cette leçon : App.jsx
// La note du voyage : choisis l'effort et décide quand confier la tâche à un sous-agent.
// Les justifications viennent des best practices et de la documentation des sous-agents de Claude Code.
import { useState } from 'react';
const LEVELS = ['low', 'medium', 'high', 'xhigh', 'max', 'ultrathink'];
const effortTasks = [
{ id: 'e1', task: 'Renommer un composant dans trois fichiers', answer: ['low'], why: 'Échange rapide, et tu regardes chaque résultat de toute façon : low donne plus vite un point de départ.' },
{ id: 'e2', task: 'Commentaires sous le film : une nouvelle fonction au périmètre clair', answer: ['medium'], why: 'Travail de tous les jours au périmètre clair : le medium par défaut suffit.' },
{ id: 'e3', task: "Le lecteur ne démarre parfois pas, et le code a été écrit par quelqu'un d'autre", answer: ['high', 'xhigh'], why: "Un bug dans le code d'un autre se rate facilement, donc high ou xhigh : Claude vérifie plus de cas." },
{ id: 'e4', task: 'Nouveau champ obligatoire dans le type Video, lu par cinq composants', answer: ['high', 'xhigh'], why: "Changement de forme des données : Claude doit trouver chaque endroit qui lit l'ancienne forme." },
{ id: 'e5', task: "Chercher une faille dans l'envoi de fichiers, pendant que tu n'es pas au clavier", answer: ['max'], why: 'Problème difficile sur lequel Claude travaille sans toi. Sur des tâches ordinaires, max réfléchit trop.' },
{ id: 'e6', task: 'Une seule question difficile au milieu du travail courant', answer: ['ultrathink'], why: "Seul ce message est difficile : le mot ultrathink dans la demande plutôt qu'un changement de réglage." },
];
const subagentTasks = [
{ id: 's1', task: 'Lance tous les tests et ne donne que ceux qui ont échoué', answer: 'subagent', why: 'Le long résultat reste dans le contexte du sous-agent, et seul le résumé revient dans la conversation.' },
{ id: 's2', task: "Corrige la couleur du bouton que nous regardons à l'instant", answer: 'main', why: "Changement rapide et ciblé : un sous-agent tout neuf devrait d'abord rassembler le contexte." },
{ id: 's3', task: 'Étudie en même temps trois parties indépendantes du projet', answer: 'subagent', why: 'Des pistes de recherche indépendantes peuvent avancer en parallèle.' },
{ id: 's4', task: "Tu peaufines avec Claude l'aspect du formulaire, pas à pas", answer: 'main', why: 'Corrections fréquentes et contexte partagé : reste dans la conversation principale.' },
{ id: 's5', task: "Relecture d'un diff par quelqu'un qui n'a pas vu cette conversation", answer: 'subagent', why: "Un relecteur neuf ne connaît pas le raisonnement qui a produit le code ; c'est ainsi que fonctionne /code-review." },
];
const choiceLabels = { main: 'Conversation principale', subagent: 'Sous-agent' };
function Feedback({ ok, why }) {
return (
<p className={ok ? 'mt-2 text-sm text-green-700' : 'mt-2 text-sm text-red-600'}>
{ok ? 'Bien vu. ' : 'Pas cette fois. '}
{why}
</p>
);
}
export default function App() {
const [picked, setPicked] = useState({});
const pick = (id, value) => setPicked((prev) => ({ ...prev, [id]: value }));
const score = effortTasks.filter((t) => t.answer.includes(picked[t.id])).length
+ subagentTasks.filter((t) => picked[t.id] === t.answer).length;
return (
<div className="min-h-screen bg-white p-4 text-gray-900">
<div className="mx-auto max-w-2xl space-y-6">
<header className="border-b border-gray-200 pb-3">
<h1 className="text-xl font-bold text-red-600">La note du voyage</h1>
<p className="text-sm text-gray-600">Réussites : {score} / {effortTasks.length + subagentTasks.length}</p>
</header>
<section>
<h2 className="mb-2 font-semibold">Quel effort ?</h2>
<ul className="space-y-3">
{effortTasks.map((t) => (
<li key={t.id} className="rounded-lg border border-gray-200 p-3">
<p className="text-sm">{t.task}</p>
<div className="mt-2 flex flex-wrap gap-1">
{LEVELS.map((level) => (
<button
key={level}
type="button"
onClick={() => pick(t.id, level)}
className={picked[t.id] === level ? 'rounded-full bg-gray-900 px-3 py-1 font-mono text-xs text-white' : 'rounded-full bg-gray-100 px-3 py-1 font-mono text-xs hover:bg-gray-200'}
>
{level}
</button>
))}
</div>
{picked[t.id] && <Feedback ok={t.answer.includes(picked[t.id])} why={t.why} />}
</li>
))}
</ul>
</section>
<section>
<h2 className="mb-2 font-semibold">Sous-agent ou conversation principale ?</h2>
<ul className="space-y-3">
{subagentTasks.map((t) => (
<li key={t.id} className="rounded-lg border border-gray-200 p-3">
<p className="text-sm">{t.task}</p>
<div className="mt-2 flex gap-2">
{Object.entries(choiceLabels).map(([value, label]) => (
<button
key={value}
type="button"
onClick={() => pick(t.id, value)}
className={picked[t.id] === value ? 'rounded bg-gray-900 px-3 py-1 text-xs text-white' : 'rounded bg-gray-100 px-3 py-1 text-xs hover:bg-gray-200'}
>
{label}
</button>
))}
</div>
{picked[t.id] && <Feedback ok={picked[t.id] === t.answer} why={t.why} />}
</li>
))}
</ul>
</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. Où vois-tu dans Claude Code la consommation de la limite du plan et la part qui revient aux sous-agents ?
2. Qu'apporte la délégation d'une tâche à un sous-agent ?
Voici 2 des 3 questions de cette leçon. Réponds aux autres dans le jeu.