Les gestes, en une page

Tu es devant ton terminal. Quelque chose se passe, ou ne se passe pas — et tu sais qu’il existe un geste pour ça, sans te rappeler lequel ni où il était expliqué.

Cette page ne t’apprend rien. Elle sert à retrouver.

Comment s’en servir

Cherche dans la colonne de gauche ce que tu constates, pas ce que tu veux obtenir. Si tu savais déjà nommer ce que tu veux, tu ne serais pas ici. Les titres de section donnent la grande famille ; la recherche de ton navigateur fait le reste.

Ce n’est pas le rangement qui fait la valeur de cette page — la documentation officielle range elle aussi ses commandes par moment, dans sa section « Commands across a typical workflow », et elle est plus complète que celle-ci. C’est la troisième colonne. Chacun de ces gestes cache un arbitrage : ce qu’il ne couvre pas, ce qu’il enregistre au passage, le mode où il se comporte autrement. Ces arbitrages ne sont écrits nulle part ailleurs, et ce sont eux qui décident si tu dois t’en servir.

Où ça se tape, parce que la page mélange trois endroits :

• ce qui commence par / se tape dans la session, une fois Claude Code lancé ;
• ce qui commence par claude se tape dans ton terminal, session fermée ;
• ce qui commence par git s’adresse à git, pas à Claude Code.

Deux marques dans la colonne du milieu, et ce sont celles qui coûtent cher si on les rate : (écrit) signale un geste qui modifie tes fichiers, (réglage durable) un geste qui enregistre quelque chose valable pour tes prochaines sessions et tous tes projets.

À retenir — une commande sans son arbitrage n’est pas un raccourci, c’est un pari. Quand une ligne te surprend, la colonne de droite n’est pas une politesse : c’est là qu’est écrit ce que le geste ne fait pas.

Avant tout le reste

Ce que tu constates	Le geste	Où c’est expliqué
Une commande de cette page n’existe pas chez toi	/help liste ce que ton installation propose	leçon 2
Une explication ne correspond pas à ton écran	claude --version	leçon 2
Rien ne marche depuis l’installation	claude doctor, qui ne fait que diagnostiquer	leçon 2

Si une commande manque à /help, ce n’est ni ta faute ni une erreur ici : c’est ta plateforme, ta version ou ton offre. Deux gestes de cette page en dépendent nommément — la messagerie entre sessions n’existe pas sur Windows natif, et l’isolation par le système pas partout non plus.

Tu ne sais pas où tu en es

Ce que tu constates	Le geste	Où c’est expliqué
Tu ne sais pas sur quel modèle tu travailles	/model (réglage durable) — depuis la version 2.1.153, changer de modèle écrit ton choix dans tes réglages personnels et en fait le défaut de tes nouvelles sessions ; dans le sélecteur, s ne change que la session courante	leçon 3
Tu ne sais pas s’il va te demander avant d’agir	la barre d’état ; Shift+Tab pour changer (Alt+M sur certains Windows)	leçon 8
Tu as posé une règle et tu ne sais pas si elle est prise en compte	/status, puis claude doctor pour le détail	leçon 8
Tu ne sais plus ce que tu as installé ni ce que ça te coûte	/doctor (écrit) — il propose des corrections avant de les appliquer	leçon 5
Tu te demandes s’il te reste de quoi travailler ce soir	/usage (alias /cost, /stats)	leçon 15

Il répond à côté, ou il a oublié

Ce que tu constates	Le geste	Où c’est expliqué
Il répond à côté et tu ne comprends pas pourquoi	/context — il dit aussi ce qui pèse le plus lourd	leçon 3
Tu veux voir le remplissage sans avoir à le demander	/statusline (écrit) — demande-lui le pourcentage de contexte ; sans argument, il recopie l’invite de ton shell	leçon 3
Il ignore une convention que tu croyais écrite quelque part	/context d’abord ; /memory ouvre les fichiers de mémoire, mais il en liste les emplacements — il ne dit pas ce qui est chargé	leçon 3
La conversation est longue et il perd le fil	/compact	leçon 3
Tu changes complètement de sujet	/clear	leçon 3
Le ménage se déclenche trop tard, ou trop tôt	/autocompact (réglage durable) — il vaudra pour tous tes projets	leçon 3

Tu veux revenir en arrière

Ce que tu constates	Le geste	Où c’est expliqué
Il vient de faire quelque chose que tu ne veux pas garder	/rewind (alias /checkpoint, /undo)	leçon 7
Tu veux reprendre le travail d’hier	/resume	leçon 7
Tu ne reconnais aucune session dans la liste	/rename la prochaine fois, pendant que tu sais encore de quoi il s’agit	leçon 7
Tu veux savoir si le retour arrière est seulement actif chez toi	/config, ligne « Rewind code »	leçon 7
Tu veux savoir quels fichiers une restauration saute	/debug avant de restaurer, ou claude --debug au lancement — le journal ne couvre que ce qui suit son activation	leçon 7

Tu veux poser des limites

Ce que tu constates	Le geste	Où c’est expliqué
Tu as cliqué « oui » vingt fois ce matin sans lire	/permissions	leçon 8
Il te demande d’accéder à un dossier hors du projet	/add-dir	leçon 8
Tu veux une barrière qui tienne même si son jugement est retourné	/sandbox — le bac à sable (sandboxing), l’isolation posée par le système d’exploitation sur les commandes shell et leurs processus fils	leçon 8
Tu ne sais pas ce que le second modèle laisse passer	claude auto-mode config	leçon 8

Tu répètes le même geste

Ce que tu constates	Le geste	Où c’est expliqué
Tu réexpliques les mêmes conventions à chaque session	/init écrit le fichier de règles s’il n’existe pas	leçon 6
Tu recolles la même procédure pour la troisième fois	un skill — une fiche réutilisable, du savoir ou une procédure	leçon 9
Tu viens d’écrire un skill et il n’apparaît pas	/reload-skills	leçon 9
Tu ne sais plus quels skills tu as	/skills	leçon 9
Tu viens d’installer un plugin et il n’apparaît pas	/reload-plugins	leçon 5
Tu voudrais savoir où tu perds du temps sans t’en rendre compte	/insights (écrit) — un rapport sur tes sessions passées, déposé en HTML sur ta machine ; l’analyse passe par ton compte et compte dans ton usage comme une session	leçon 5

Tu ne sais pas si ça marche

Ce que tu constates	Le geste	Où c’est expliqué
Il annonce « c’est fait » et tu n’as pas ouvert l’application	/run	leçon 10
Tu veux qu’il confirme contre l’application qui tourne, pas contre les tests	/verify	leçon 10
Tu retapes la même façon de lancer ton projet	/run-skill-generator	leçon 10
Tu veux qu’un but soit réévalué à chaque réponse, pas seulement à la fin	/goal	leçon 10
Un contrôle automatique n’a rien signalé depuis des semaines	/hooks pour voir ce qui est armé ; claude --debug, qui écrit dans un fichier au lieu d’afficher	leçon 13
Tu crois un fichier exclu de git sans en être sûr	git check-ignore -v <fichier>	leçon 13

Tu veux un deuxième regard

Ce que tu constates	Le geste	Où c’est expliqué
Tu viens d’écrire beaucoup et tu ne le reliras pas	/code-review	leçon 12
Tu veux une relecture orientée sécurité	/security-review — il compare à la branche par défaut du dépôt distant, donc il lui faut un dépôt distant	leçon 12
Le code marche mais tu le trouves lourd	/simplify (écrit) — il corrige au lieu de rapporter, et ne cherche pas les bugs ; à lancer sur du travail déjà enregistré	leçon 12

Tu as plusieurs choses en cours

Ce que tu constates	Le geste	Où c’est expliqué
Tu veux essayer une idée sans toucher à ton travail en cours	git worktree add ../projet-essai -b essai-cache, puis git worktree list et remove	leçon 14
Tu as quatre tâches ce soir et tu veux pouvoir entrer dans chacune	claude agents — la réponse la plus fréquente, mais en research preview : livrée pour essai, elle peut changer	leçon 15
Tu as un gros changement à découper en morceaux indépendants	/batch (écrit) — il ouvre une demande de fusion par morceau, et il lui faut un dépôt git	leçon 15
Tu veux suivre ce qui tourne pendant que ça tourne	/tasks pour ce qui tourne en fond dans ta session, subagents terminés compris ; /workflows pour une exécution de workflow, avec sa phase et son compte d’agents ; claude agents pour les sessions d’arrière-plan	leçon 15
Tu ne sais plus quelles sessions la tienne peut joindre	/list-agents (alias /peers) — absent sur Windows natif	leçon 15
Tu as une question de fond, pas une tâche	/deep-research	leçon 15
Tu veux relancer la même chose à intervalle régulier	/loop	leçon 9

Ce que cette page ne fait pas

Elle ne te dispense pas de la leçon, et la colonne de droite n’est pas décorative. Presque chaque ligne cache un arbitrage qui ne tient pas dans une case. Les deux marques signalent les gestes dont la conséquence est la plus lourde, mais leur absence ne veut pas dire « ça ne fait que regarder » : plusieurs lignes non marquées laissent une trace au passage.

• /sandbox enregistre le mode choisi dans les réglages locaux de ton projet : durable, mais pour ce projet-là seulement, donc en dehors de ce que la marque annonce ;
• /init écrit ton fichier de règles, /run-skill-generator écrit un skill dans le projet.

Le raccourci honnête est donc celui-ci : avant de taper une commande de cette page pour la première fois, va lire dans sa leçon ce qu’elle laisse derrière elle.

Elle n’est pas exhaustive, et elle ne cherche pas à l’être : elle liste ce que ce parcours enseigne, pas ce que l’outil propose. La liste complète, plus longue et à jour, est dans la référence des commandes.

Elle vieillira. Des commandes s’ajoutent, changent de nom, gagnent des alias. L’ensemble a été contrôlé le 20 août 2026 contre l’instantané de la documentation officielle du même jour. C’est la date du dernier contrôle, pas une promesse de fraîcheur : claude --version et /help répondent pour ta machine, aujourd’hui.

Elle ne remplace pas l’ordre de lecture. Si les numéros de leçon ne te disent rien parce que tu arrives ici par une recherche, commence par la leçon 1 : cette page suppose acquis à peu près tout ce que le parcours pose, et une commande prise isolément est exactement ce qu’il apprend à ne pas faire.

Où c’est écrit

• Les commandes — la liste officielle, avec ce que chacune fait, ses conditions de version et de plateforme ; sa section « Commands across a typical workflow » range les principales par moment, comme cette page ;
• La référence de ligne de commande — les options qu’on passe au lancement, que cette page ne couvre pas.

Les liens pointent vers les pages anglaises. La version française existe — /fr/ à la place de /en/. Mais elle traduit une partie des mots que tu verras sur ton écran, et elle peut être en retard sur le fond ; la leçon 4 explique pourquoi ce parcours garde l’anglais.

Vérifier que c’est passé

Tu cherches à alléger un fichier trop lourd. Tu trouves la ligne qui va bien dans cette page, tu tapes la commande. Suffisant ?

Non. La ligne porte la marque (écrit) : cette commande-là ne rapporte pas, elle corrige — elle modifie ton arbre de travail sans te le demander, et elle ne cherche pas les bugs au passage. Si ton travail n’était pas enregistré avant, tu n’as rien pour revenir en arrière. C’est le sens de la marque ; son absence, elle, ne garantit rien — d’autres lignes de la page enregistrent un réglage ou écrivent un fichier sans la porter.

Tu tapes une commande listée ici et ton terminal répond qu'il ne la connaît pas. Qu'est-ce que tu en conclus ?

D’abord, où tu l’as tapée : ce qui commence par / ne se tape que dans la session, une fois Claude Code lancé ; ce qui commence par claude se tape dans le terminal, session fermée. Si l’endroit était le bon, ce n’est toujours pas ta faute : /help liste ce dont ton installation dispose, et claude --version te donne ton numéro. Une commande absente est presque toujours une question de version, de plateforme ou d’offre — pas une faute de frappe, et pas une erreur de cette page.

Tu veux savoir ce que te coûte un service extérieur que tu as branché. Tu ouvres la commande qui porte son nom. Bonne idée ?

Non — et c’est une erreur que ce parcours a lui-même publiée avant de la corriger. La commande qui porte le nom du mécanisme gère les connexions et l’authentification ; elle affiche un nombre d’outils, jamais un coût. Ce que ces services occupent en place se lit dans /context, qui signale les plus lourds ; ce qu’ils ont consommé se lit dans /usage, ventilé service par service. Un nom qui ressemble au sujet n’est pas une réponse à la question.