Mode interactif
Référence complète des raccourcis clavier, modes d'entrée et fonctionnalités interactives dans les sessions Claude Code.
Raccourcis clavier
[!NOTE]
Les raccourcis clavier peuvent varier selon la plateforme et le terminal. En rendu plein écran, appuyez sur
?dans la visionneuse de transcription pour voir les raccourcis disponibles.Utilisateurs macOS : les raccourcis avec la touche Option/Alt (
Alt+B,Alt+F,Alt+D,Alt+Y,Alt+P) nécessitent de configurer Option comme Meta dans votre terminal. Consultez Activer les raccourcis de la touche Option sur macOS pour le paramètre de chaque terminal.
Contrôles généraux
| Raccourci | Description | Contexte |
|---|---|---|
Ctrl+C |
Interrompre ou effacer la saisie | Interrompt une opération en cours. Si rien n'est en cours, le premier appui efface la saisie du prompt et un second appui quitte Claude Code. Pour récupérer un brouillon effacé, consultez Récupérer un brouillon effacé |
Ctrl+X Ctrl+K |
Arrêter tous les sous-agents en arrière-plan en cours d'exécution dans cette session et désactiver les réponses automatiques des artefacts pour le reste de celle-ci. Appuyez deux fois en moins de 3 secondes pour confirmer. Vous pouvez appuyer dessus pendant qu'une demande de permission d'un sous-agent en arrière-plan est ouverte | Contrôle des sous-agents |
Ctrl+D |
Quitter la session Claude Code | Le premier appui affiche une indication de confirmation et un second appui dans les 800 ms quitte. Lorsque le prompt contient du texte, Ctrl+D supprime plutôt le caractère après le curseur |
Ctrl+G ou Ctrl+X Ctrl+E |
Ouvrir dans l'éditeur de texte par défaut | Modifiez votre prompt ou votre réponse personnalisée dans votre éditeur de texte par défaut. Ctrl+X Ctrl+E est le raccourci natif de readline. Activez Show last response in external editor dans /config pour ajouter la réponse précédente de Claude en contexte commenté avec # au-dessus de votre prompt ; Claude Code supprime le bloc de commentaires lorsque vous enregistrez |
Ctrl+L |
Redessiner l'écran | Force un rafraîchissement complet du terminal, en conservant la saisie et l'historique de la conversation. Utilisez-le pour rétablir l'affichage s'il devient illisible ou partiellement vide. Consultez Effacer la conversation pour le rendu plein écran |
Ctrl+O |
Afficher/masquer la visionneuse de transcription | Affiche l'utilisation détaillée des outils et leur exécution, avec un horodatage et le modèle utilisé pour chaque message de l'assistant. Développe également les lignes réduites par défaut, comme les appels MCP, affichés sur une seule ligne Called slack 3 times, et les messages de vos autres sessions, affichés sous forme d'aperçu sur une ligne Message from @<sender> |
Ctrl+R |
Recherche inversée dans l'historique des commandes | Recherchez de manière interactive dans les commandes précédentes |
Ctrl+V ou Cmd+V (iTerm2) ou Alt+V (Windows et WSL) |
Coller une image depuis le presse-papiers | Insère une puce [Image #N] au niveau du curseur pour que vous puissiez y faire référence à sa position dans votre prompt. Sur WSL, Ctrl+V et Alt+V sont tous deux associés ; utilisez Alt+V si votre terminal intercepte Ctrl+V |
Ctrl+B |
Mettre en arrière-plan les tâches en cours | Met en arrière-plan les commandes Bash et les agents. Les utilisateurs de Tmux appuient deux fois |
Ctrl+T |
Afficher/masquer la liste de tâches de Claude | Affichez ou masquez la liste de tâches à faire de Claude dans la zone d'état. Il ne s'agit pas de la vue des tâches en arrière-plan ; utilisez /tasks pour voir les shells et sous-agents en cours d'exécution |
Ctrl+S |
Mettre de côté ou restaurer le prompt | Avec du texte dans la saisie, le met de côté et efface le prompt. Un nouvel appui sur un prompt vide restaure le texte mis de côté, la position du curseur, le contenu collé et le mode de saisie, de sorte qu'une commande shell ! mise de côté revient en mode shell |
Ctrl+Z |
Suspendre Claude Code | Unix uniquement. Suspend le processus et revient à votre shell ; exécutez fg pour reprendre |
Flèches gauche/droite |
Parcourir les onglets des boîtes de dialogue | Naviguez entre les onglets dans les boîtes de dialogue de permission et les menus. Dans une boîte de dialogue à onglets, les touches changent d'onglet lorsque la rangée d'onglets a le focus. Consultez Actions des onglets pour savoir comment le focus se déplace |
Tab |
Accepter une suggestion d'autocomplétion ou ajouter un commentaire à une réponse de permission | Lorsque des suggestions d'autocomplétion s'affichent dans la saisie du prompt, accepte la suggestion sélectionnée. Sur la plupart des demandes de permission, avec Yes ou No sélectionné, ouvre un champ de commentaire sur cette option, et un nouvel appui ferme le champ. Consultez ajouter un commentaire lorsque vous répondez à une demande de permission |
Flèches haut/bas ou Ctrl+P/Ctrl+N |
Déplacer le curseur ou naviguer dans l'historique des commandes | Lorsque la saisie s'étend sur plus d'une ligne visuelle, qu'elle soit renvoyée à la ligne ou multiligne, déplace d'abord le curseur dans le prompt. Une fois le curseur sur la première ou la dernière ligne visuelle, un nouvel appui navigue dans l'historique des commandes. Lorsque vous avez des messages en file d'attente, Up depuis la première ligne permet plutôt de les reprendre |
Esc |
Interrompre Claude ou fermer une boîte de dialogue | Arrêtez la réponse ou l'appel d'outil en cours en plein tour afin de pouvoir réorienter Claude. Claude conserve le travail effectué jusque-là. Si vous avez des messages en file d'attente, Claude Code les envoie ensuite. Lorsqu'une boîte de dialogue est ouverte, Esc la ferme. Lorsqu'un élément du pied de page est sélectionné, comme une ligne du panneau des sous-agents sous le prompt, Esc le désélectionne au lieu d'interrompre. Sur une demande de permission, Esc refuse l'action, comme No sans commentaire |
Esc + Esc |
Effacer le brouillon de saisie ou revenir en arrière | Lorsque la saisie du prompt contient du texte, un double Esc l'efface et enregistre le brouillon dans l'historique pour que Up le rappelle. Lorsque la saisie est vide, un double Esc ouvre le menu de retour en arrière pour restaurer ou résumer le code et la conversation à partir d'un point antérieur |
Ctrl+Enter ou Ctrl+X Ctrl+S |
Envoyer immédiatement les messages en file d'attente | Envoie immédiatement vos messages en file d'attente, accompagnés de votre brouillon. Quand Claude Code envoie ce que vous avez mis en file d'attente explique ce qu'il advient du tour sur lequel Claude travaille. En mode shell, la touche met seulement votre commande en file d'attente. Dans les terminaux qui ne signalent pas les touches étendues, Ctrl+Enter arrive comme un simple Enter ; Ctrl+X Ctrl+S fonctionne dans n'importe quel terminal. Nécessite Claude Code v2.1.275 ou version ultérieure |
Shift+Tab, ou Alt+M sur Windows lorsque le runtime Node ou Bun n'active pas le mode de saisie VT |
Parcourir les modes de permission | Parcourez default (indiqué Manual dans l'indicateur de mode), acceptEdits, plan et, lorsqu'ils sont disponibles, bypassPermissions puis auto. Depuis auto, le premier appui passe à default. Consultez modes de permission. Sur une demande de permission de fichier, la même touche ferme un champ de commentaire ouvert. Si aucun champ n'est ouvert, elle sélectionne l'option qui autorise l'action pour le reste de la session, lorsque la demande propose cette option |
Option+P (macOS) ou Alt+P (Windows/Linux) |
Changer de modèle | Changez de modèle sans effacer votre prompt |
Option+T (macOS) ou Alt+T (Windows/Linux) |
Activer/désactiver la réflexion étendue | Activez ou désactivez le mode réflexion étendue. Sans effet sur Opus 5.5, Sonnet 5.5, Haiku 5.5 ou les modèles Fable, qui utilisent toujours la réflexion étendue. Fonctionne sur macOS sans configurer Option comme Meta |
Option+O (macOS) ou Alt+O (Windows/Linux) |
Activer/désactiver le mode rapide | Activez ou désactivez le mode rapide |
Édition de texte
| Raccourci | Description | Contexte |
|---|---|---|
Ctrl+A |
Déplacer le curseur au début de la ligne actuelle | Dans une saisie multiligne, se déplace au début de la ligne logique actuelle |
Ctrl+E |
Déplacer le curseur à la fin de la ligne actuelle | Dans une saisie multiligne, se déplace à la fin de la ligne logique actuelle |
Ctrl+K |
Supprimer jusqu'à la fin de la ligne | Stocke le texte supprimé pour pouvoir le coller |
Ctrl+U |
Supprimer du curseur jusqu'au début de la ligne | Stocke le texte supprimé pour pouvoir le coller. Répétez pour effacer sur plusieurs lignes dans une saisie multiligne. Sur macOS, les émulateurs de terminal, dont iTerm2 et Terminal.app, associent Cmd+Backspace à ce raccourci |
Ctrl+W |
Supprimer jusqu'à l'espace précédent | Stocke le texte supprimé pour pouvoir le coller. Un seul appui supprime un chemin entier ou un --flag=value. Pour supprimer uniquement le mot précédent, appuyez sur Option+Delete sur macOS ou Ctrl+Backspace sur Windows |
Ctrl+Y |
Coller le texte supprimé | Colle le dernier texte que vous avez supprimé avec l'un des raccourcis de suppression de mot ou de ligne, comme Ctrl+K, Ctrl+U ou Ctrl+W |
Alt+Y (après Ctrl+Y) |
Parcourir l'historique des collages | Après un collage, parcourez le texte précédemment supprimé. Nécessite Option comme Meta sur macOS |
Alt+B |
Reculer le curseur d'un mot | Navigation par mot. Nécessite Option comme Meta sur macOS |
Alt+F |
Avancer le curseur d'un mot | Se déplace à la fin du mot actuel, ou à la fin du mot suivant lorsque le curseur se trouve entre deux mots. Nécessite Option comme Meta sur macOS |
Alt+D |
Supprimer jusqu'à la fin du mot | Supprime jusqu'à la fin du mot actuel, ou jusqu'à la fin du mot suivant lorsque le curseur se trouve entre deux mots. Stocke le texte supprimé pour pouvoir le coller. Nécessite Option comme Meta sur macOS |
Ctrl+_ ou Ctrl+Shift+- |
Annuler la dernière modification de la saisie | Restaure le texte de saisie précédent et la position du curseur |
Limites de mots dans les raccourcis d'édition
Les raccourcis de mots Alt+B, Alt+F, Alt+D, Option+Delete et Ctrl+Backspace considèrent un mot comme une suite de lettres et de chiffres, de sorte que la ponctuation comme _, . et / sépare les mots. Avec src/utils/foo.ts dans le prompt, des appuis répétés sur Alt+B s'arrêtent au début de ts, foo, utils et src.
Ctrl+W est différent : il ignore la ponctuation et supprime jusqu'à l'espace précédent, de sorte qu'un seul appui supprime l'intégralité de src/utils/foo.ts.
Dans un texte écrit sans espaces, comme le chinois ou le japonais, les raccourcis de mots déplacent ou suppriment toujours un mot à la fois.
Ces conventions readline s'appliquent dans Claude Code v2.1.261 et versions ultérieures. Le paramètre keybindingFlavor qui les activait dans les versions antérieures est déprécié et n'a plus d'effet.
Vous ne pouvez pas réassigner ces raccourcis dans le fichier de configuration des raccourcis clavier, qui ne comporte aucune action pour eux.
Thème et affichage
| Raccourci | Description | Contexte |
|---|---|---|
Ctrl+T |
Activer/désactiver la coloration syntaxique des blocs de code | Fonctionne uniquement dans le menu de sélection /theme. Détermine si le code dans les réponses de Claude utilise la coloration syntaxique |
Saisie multiligne
| Méthode | Raccourci | Contexte |
|---|---|---|
| Échappement rapide | \ + Enter |
Fonctionne dans tous les terminaux |
| Touche Option | Option+Enter |
Après avoir activé Option comme Meta sur macOS |
| Shift+Enter | Shift+Enter |
Natif dans iTerm2, WezTerm, Ghostty, Kitty, Warp, Apple Terminal, Windows Terminal. Pour les autres terminaux, consultez Saisir des prompts multilignes |
| Séquence de contrôle | Ctrl+J |
Fonctionne dans n'importe quel terminal sans configuration |
| Mode collage | Coller directement | Pour les blocs de code, les logs |
Commandes rapides
| Raccourci | Description | Remarques |
|---|---|---|
/ au début |
Commande ou skill | Consultez commandes et skills |
! au début |
Mode shell | Exécutez une commande directement, ajoutez sa sortie à la session et demandez à Claude d'y répondre |
@ |
Mention de chemin de fichier | Déclenche l'autocomplétion des chemins de fichiers. Dans les sessions avec la messagerie entre sessions, lorsque vous tapez au moins une lettre après le @, Claude Code suggère également vos autres sessions actives sur cette machine, afin que vous puissiez demander à Claude d'envoyer un message à celle que vous choisissez. Nécessite Claude Code v2.1.232 ou version ultérieure |
: |
Shortcode d'emoji | Tapez un :name: complet pour insérer l'emoji, ou deux caractères ou plus pour obtenir des suggestions. Consultez Shortcodes d'emoji |
? sur une saisie vide |
Afficher/masquer le panneau d'aide des raccourcis | Taper ? lorsque la saisie contient déjà du texte insère le caractère |
Visionneuse de transcription
Lorsque la visionneuse de transcription est ouverte (activée avec Ctrl+O), ces raccourcis sont disponibles. Exécutez /tui sans argument pour vérifier quel moteur de rendu est actif. Ctrl+E peut être réassigné via transcript:toggleShowAll.
| Raccourci | Description |
|---|---|
? |
Afficher/masquer le panneau d'aide des raccourcis clavier. Nécessite le rendu plein écran |
{ / } |
Aller au prompt utilisateur précédent ou suivant, comme le déplacement par paragraphe de vim. Nécessite le rendu plein écran |
Ctrl+E |
Afficher/masquer tout le contenu. Disponible uniquement dans le moteur de rendu classique, pas en rendu plein écran |
[ |
Écrire la conversation complète dans le défilement natif de votre terminal afin que Cmd+F, le mode copie de tmux et d'autres outils natifs puissent y effectuer des recherches. Nécessite le rendu plein écran |
v |
Écrire la conversation dans un fichier temporaire et l'ouvrir dans $VISUAL ou $EDITOR. Nécessite le rendu plein écran |
q, Ctrl+C, Esc |
Quitter la vue de transcription. Les trois peuvent être réassignés via transcript:exit |
Saisie vocale
| Raccourci | Description | Remarques |
|---|---|---|
Maintenir ou appuyer sur Space |
Dictée vocale | Nécessite que la dictée vocale soit activée. Maintenez pour enregistrer, ou exécutez /voice tap pour basculer par simple appui. Réassignable |
Commandes
Tapez / dans Claude Code pour voir les commandes à votre disposition, ou tapez / suivi de quelques lettres pour filtrer. Le menu / répertorie les commandes intégrées, les skills fournis et créés par l'utilisateur, ainsi que les commandes apportées par les plugins et les serveurs MCP. Toutes les commandes intégrées ne sont pas visibles pour chaque utilisateur, car certaines dépendent de votre plateforme ou de votre forfait, et quelques commandes disponibles sont volontairement masquées du menu et s'exécutent lorsque vous tapez leur nom complet.
En rendu plein écran, les listes de suggestions de commandes / et de fichiers @ répondent également à la souris : le survol met une ligne en surbrillance et un clic la valide.
Consultez la référence des commandes pour la liste complète des commandes incluses dans Claude Code.
Compléter une commande en cours de prompt
La complétion des commandes fonctionne aussi au milieu d'un prompt : tapez / après une espace, puis les premières lettres d'un nom, comme dans run the tests, then /com. Seules les commandes dont le nom commence par ces lettres correspondent, de sorte qu'un chemin de fichier tel que /tmp/notes.md ne maintient pas une liste ouverte. Claude Code n'exécute lui-même une commande que lorsque celle-ci commence votre message.
- En rendu plein écran : les correspondances s'ouvrent sous forme de liste pendant la saisie, sans aucune ligne en surbrillance, de sorte que
Enterenvoie toujours votre prompt tel que vous l'avez tapé. Appuyez surTabpour insérer la première correspondance, ou choisissez une ligne avec les touches fléchées etEnter. - Hors plein écran : le reste de la première correspondance apparaît en texte fantôme au niveau de votre curseur, avec un compteur tel que
+2lorsque d'autres commandes correspondent. Appuyez surTabpour insérer l'unique correspondance, ou pour ouvrir la liste lorsque plusieurs correspondent, puis choisissez une ligne avec les touches fléchées etEnter.
Dans les deux modes de rendu, appuyez sur Tab sur un / seul en milieu de prompt pour lister toutes les commandes.
Un skill de plugin correspond aussi par son nom seul, ainsi /deploy trouve un skill nommé myplugin:deploy-app. Lorsque vous insérez la correspondance, Claude Code écrit le nom complet /myplugin:deploy-app.
Mode d'édition Vim
Activez l'édition de style vim via /config → Editor mode.
Claude Code conserve votre mode vim et la position du curseur lorsque vous basculez le lecteur de transcription avec Ctrl+O ou ouvrez et fermez un panneau tel que /config. Si vous quittez l'invite en mode NORMAL, elle est toujours en mode NORMAL lorsque vous revenez, avec le curseur où vous l'aviez laissé.
Changement de mode
| Commande | Action | Du mode |
|---|---|---|
Esc ou Ctrl+[ |
Entrer en mode NORMAL. Dans les terminaux qui utilisent le protocole clavier Kitty, Ctrl+[ nécessite v2.1.242 ou ultérieur |
INSERT, VISUAL |
i |
Insérer avant le curseur | NORMAL |
I |
Insérer au début de la ligne | NORMAL |
a |
Insérer après le curseur | NORMAL |
A |
Insérer à la fin de la ligne | NORMAL |
o |
Ouvrir une ligne en dessous | NORMAL |
O |
Ouvrir une ligne au-dessus | NORMAL |
v |
Démarrer la sélection visuelle par caractère | NORMAL |
V |
Démarrer la sélection visuelle par ligne | NORMAL |
Remapper les séquences de touches en mode INSERT
Le paramètre vimInsertModeRemaps mappe une séquence de deux touches en mode INSERT à Échap, donc un mappage comme jj vous ramène en mode NORMAL.
L'exemple ~/.claude/settings.json suivant active le mode vim et mappe jj à Échap :
{
"editorMode": "vim",
"vimInsertModeRemaps": { "jj": "<Esc>" }
}
Chaque clé est exactement deux caractères imprimables tapés en séquence, et "<Esc>" est la seule cible prise en charge. Les entrées avec une longueur ou une cible différente sont ignorées.
Taper le premier caractère d'une séquence l'insère normalement. Appuyer sur le deuxième caractère dans une seconde supprime ce caractère en attente et bascule en mode NORMAL, ne laissant aucun caractère dans votre entrée. Après la fenêtre d'une seconde, ou si une touche différente suit, les deux caractères restent comme du texte littéral, vous pouvez donc toujours taper un mot contenant la séquence en faisant une pause entre les deux touches.
Claude Code lit ce paramètre à partir de votre fichier de paramètres utilisateur, du drapeau --settings et des paramètres gérés uniquement. Les entrées dans le .claude/settings.json ou .claude/settings.local.json d'un projet sont ignorées, donc un référentiel extrait ne peut pas remapper vos frappes.
Navigation (mode NORMAL)
| Commande | Action |
|---|---|
h/j/k/l |
Déplacer à gauche/bas/haut/droite |
Space |
Déplacer à droite |
w |
Mot suivant |
e |
Fin du mot |
b |
Mot précédent |
0 |
Début de la ligne |
$ |
Fin de la ligne |
^ |
Premier caractère non vide |
gg |
Début de l'entrée |
G |
Début de la dernière ligne |
f{char} |
Sauter à la prochaine occurrence du caractère sur la ligne actuelle |
F{char} |
Sauter à l'occurrence précédente du caractère sur la ligne actuelle |
t{char} |
Sauter juste avant la prochaine occurrence du caractère sur la ligne actuelle |
T{char} |
Sauter juste après l'occurrence précédente du caractère sur la ligne actuelle |
; |
Répéter le dernier mouvement f/F/t/T |
, |
Répéter le dernier mouvement f/F/t/T en sens inverse |
% |
Sauter au délimiteur (), [] ou {} correspondant, en partant du délimiteur suivant sur la ligne actuelle lorsque le curseur n'est pas sur un délimiteur. Nécessite Claude Code v2.1.301 ou ultérieur |
/ |
Ouvrir la recherche d'historique inversée, identique à Ctrl+R. L'invite de recherche vide affiche un indice : appuyez sur Esc puis i puis / pour ouvrir le menu de commande à la place |
[!NOTE]
En mode NORMAL vim, si le curseur est au début ou à la fin de l'entrée et ne peut pas se déplacer davantage,
j/ket↑/↓naviguent dans l'historique des commandes à la place.←sur une invite vide ouvre la vue agent à partir du mode NORMAL ainsi que INSERT.
Édition (mode NORMAL)
| Commande | Action |
|---|---|
x |
Supprimer le caractère |
r{char} |
Remplacer le caractère sous le curseur par {char} |
dd |
Supprimer la ligne |
D |
Supprimer jusqu'à la fin de la ligne |
dw/de/db |
Supprimer le mot/jusqu'à la fin/en arrière |
df{char}/dt{char} |
Supprimer jusqu'à et y compris, ou jusqu'à, la prochaine occurrence d'un caractère sur la ligne actuelle |
dj/dk |
Supprimer la ligne actuelle et la ligne en dessous ou au-dessus |
dgg/dG |
Supprimer de la ligne actuelle à la première ou dernière ligne |
d0/c0/y0 |
Supprimer, changer ou copier du curseur jusqu'au début de la ligne. Nécessite Claude Code v2.1.281 ou ultérieur |
d%/c%/y% |
Supprimer, changer ou copier du curseur jusqu'au délimiteur vers lequel % saute, inclus. Nécessite Claude Code v2.1.301 ou ultérieur |
cc |
Changer la ligne |
C |
Changer jusqu'à la fin de la ligne |
cw/ce/cb |
Changer le mot/jusqu'à la fin/en arrière |
s |
Remplacer le caractère : supprimer le caractère sous le curseur et entrer en mode INSERT |
S |
Remplacer la ligne : effacer la ligne et entrer en mode INSERT |
yy/Y |
Copier la ligne |
yw/ye/yb |
Copier le mot/jusqu'à la fin/en arrière |
p |
Coller après le curseur |
P |
Coller avant le curseur |
>> |
Indenter la ligne |
<< |
Dédenter la ligne |
J |
Joindre les lignes |
u |
Annuler |
. |
Répéter la dernière modification |
Objets texte (mode NORMAL)
Les objets texte fonctionnent avec les opérateurs comme d, c et y :
| Commande | Action |
|---|---|
iw/aw |
Mot intérieur/autour |
iW/aW |
MOT intérieur/autour (délimité par des espaces) |
i"/a" |
Guillemets doubles intérieurs/autour |
i'/a' |
Guillemets simples intérieurs/autour |
i(/a( |
Parenthèses intérieures/autour |
i[/a[ |
Crochets intérieurs/autour |
i{/a{ |
Accolades intérieures/autour |
Mode visuel
Appuyez sur v pour la sélection par caractère ou V pour la sélection par ligne. Les mouvements étendent la sélection, et les opérateurs agissent directement sur elle.
| Commande | Action |
|---|---|
d/x |
Supprimer la sélection |
y |
Copier la sélection |
c/s |
Changer la sélection |
p |
Remplacer la sélection par le contenu du registre |
r{char} |
Remplacer chaque caractère sélectionné par {char} |
~/u/U |
Basculer, minuscules ou majuscules la sélection |
>/< |
Indenter ou dédenter les lignes sélectionnées |
J |
Joindre les lignes sélectionnées |
o |
Échanger le curseur et l'ancre |
iw/aw/i"/… |
Sélectionner un objet texte |
v/V |
Basculer entre caractère et ligne, ou quitter |
Le mode visuel par bloc avec Ctrl+V n'est pas pris en charge.
Annuler une question en mode vim
Lorsque vous saisissez votre propre réponse dans la ligne Other d'une question posée par Claude, appuyez deux fois sur Esc pour annuler la question.
Pour annuler plutôt avec une seule pression de touche, associez une autre touche à l'annulation de la question.
Historique des commandes
Claude Code conserve un historique des prompts que vous saisissez, et le rappel avec la flèche Haut permet d'atteindre les prompts des sessions précédentes du même projet :
- L'historique de saisie est stocké par répertoire de travail
- L'exécution de
/cleardémarre une nouvelle session : le rappel liste alors d'abord les prompts de la nouvelle session, puis ceux des sessions précédentes. La conversation de la session précédente est conservée et peut être reprise. - Soumettre le même prompt deux fois de suite n'enregistre qu'une seule entrée d'historique, de sorte qu'appuyer sur Haut passe au prompt distinct précédent
- Lorsque vous rappelez un prompt qui incluait du texte collé, Claude Code renvoie l'intégralité du contenu collé lorsque vous le soumettez à nouveau. Si le contenu a depuis été nettoyé, Claude Code n'envoie pas la chaîne littérale
[Pasted text #N]; consultez Coller du contenu volumineux pour savoir ce qu'il advient du prompt - L'expansion de l'historique avec
!est désactivée par défaut
Récupérer un brouillon effacé
Pour récupérer un brouillon que vous avez effacé avec Ctrl+C, appuyez sur Up, soit immédiatement, soit après avoir envoyé un message ou une commande :
- Juste après avoir effacé le brouillon : appuyez une fois sur
Uptant que le prompt est encore vide. Nécessite Claude Code v2.1.288 ou version ultérieure. - Après avoir envoyé un message ou une commande : appuyez sur
Uppour revenir au brouillon. Claude Code conserve les dix brouillons effacés les plus récents de la session en cours, avec leur texte collé et leurs images, et les supprime lorsque vous quittez. Nécessite Claude Code v2.1.292 ou version ultérieure.
Recherche inversée avec Ctrl+R
Appuyez sur Ctrl+R pour effectuer une recherche interactive dans votre historique de commandes. En rendu plein écran, Ctrl+R ouvre plutôt une boîte de dialogue de recherche : tapez pour filtrer, appuyez sur Up et Down pour parcourir les correspondances, et appuyez sur Ctrl+S pour faire défiler la portée entre cette session, ce projet et tous les projets. Appuyez sur Enter ou Tab pour placer une correspondance dans la saisie du prompt, ou sur Esc pour annuler. Les étapes ci-dessous décrivent la recherche en ligne du moteur de rendu classique :
- Démarrer la recherche : appuyez sur
Ctrl+Rpour activer la recherche inversée dans l'historique - Saisir la requête : entrez le texte à rechercher dans les commandes précédentes. Le terme recherché est mis en surbrillance dans les résultats correspondants
- Parcourir les correspondances : appuyez à nouveau sur
Ctrl+Rpour faire défiler les correspondances plus anciennes - Portée de la recherche : la recherche en ligne porte toujours sur les prompts de tous les projets
- Accepter une correspondance :
- Appuyez sur
TabouEscpour accepter la correspondance actuelle et continuer l'édition - Appuyez sur
Enterpour accepter et exécuter immédiatement la commande
- Appuyez sur
- Annuler la recherche :
- Appuyez sur
Ctrl+Cpour annuler et restaurer votre saisie d'origine - Appuyez sur
Backspacesur une recherche vide pour annuler
- Appuyez sur
La recherche en ligne parcourt l'intégralité de votre historique de prompts, du plus récent au plus ancien, les doublons étant regroupés sous leur occurrence la plus récente. La boîte de dialogue plein écran recherche dans l'ensemble de votre historique de prompts dans la portée sélectionnée, du plus récent au plus ancien, les doublons étant regroupés sous leur occurrence la plus récente : les prompts les plus récents apparaissent immédiatement, et les correspondances issues de prompts plus anciens s'ajoutent à mesure que Claude Code charge le reste. Les prompts correspondants s'affichent avec le terme recherché en surbrillance, ce qui vous permet de retrouver et de réutiliser des saisies précédentes.
Accepter une correspondance ou annuler la recherche prend effet immédiatement, même pendant que Claude Code charge encore l'historique.
Commandes Bash en arrière-plan
Claude Code prend en charge l'exécution de commandes Bash en arrière-plan, ce qui vous permet de continuer à travailler pendant que les processus de longue durée s'exécutent.
Fonctionnement de l'arrière-plan
Lorsque Claude Code exécute une commande en arrière-plan, il exécute la commande de manière asynchrone et retourne immédiatement un ID de tâche en arrière-plan. Claude Code peut répondre à de nouvelles invites pendant que la commande continue à s'exécuter en arrière-plan.
Pour exécuter des commandes en arrière-plan, vous pouvez soit :
- Inviter Claude Code à exécuter une commande en arrière-plan
- Appuyer sur
Ctrl+Bpour déplacer une invocation d'outil Bash régulière vers l'arrière-plan. Les utilisateurs de Tmux doivent appuyer surCtrl+Bdeux fois en raison de la touche de préfixe de tmux.
Lorsqu'une commande atteint son délai d'expiration avant de se terminer, Claude Code la déplace automatiquement vers l'arrière-plan au lieu de l'arrêter, sauf si la commande commence par sleep. Si vous avez désactivé les commandes en arrière-plan avec CLAUDE_CODE_DISABLE_BACKGROUND_TASKS ou en démarrant en mode bare, la commande s'arrête à son délai d'expiration. Pour modifier le délai d'expiration, définissez les variables d'environnement de délai d'expiration Bash.
Fonctionnalités clés :
- La sortie est écrite dans un fichier et Claude peut la récupérer à l'aide de l'outil Read
- Les tâches en arrière-plan ont des ID uniques pour le suivi et la récupération de la sortie
- Les tâches en arrière-plan sont automatiquement nettoyées lorsque Claude Code se ferme. Sur macOS et Linux, lorsque vous arrêtez une tâche en arrière-plan à partir de
/tasksou que Claude Code l'arrête à la fermeture, les processus qui se sont détachés du shell de la tâche, comme ceux démarrés soussetsidoutimeout, s'arrêtent également - Si vous mettez la session en arrière-plan au lieu de la fermer, vos tâches en arrière-plan continuent à s'exécuter dans la session en arrière-plan. Voir mettre une session en cours en arrière-plan
- Les tâches en arrière-plan sont automatiquement terminées si la sortie dépasse 5 Go, avec une note dans stderr expliquant pourquoi
- Sur macOS et Linux, Claude Code arrête vos tâches en arrière-plan en cours d'exécution lorsque le système d'exploitation signale une pression mémoire critique, à condition que la session soit inactive depuis au moins 30 minutes et qu'aucun tour ou sous-agent ne soit en cours d'exécution
- Le journal de débogage indique pourquoi les tâches ont été arrêtées, ou pourquoi un événement de pression les a laissées en cours d'exécution
- Définissez
CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAPsur1pour désactiver les arrêts dus à la pression mémoire
- Les commandes en arrière-plan d'une session locale dans laquelle vous travaillez depuis un terminal, l'application de bureau ou l'extension VS Code n'ont pas de limite de temps. Dans une session qui s'exécute sans surveillance, comme une exécution
-pou une session cloud, Claude Code arrête une commande en arrière-plan à sa limite de temps - Une commande en arrière-plan qu'un sous-agent au premier plan a démarrée se termine lorsque l'exécution de ce sous-agent se termine, qu'elle ait réussi, échoué ou ait été interrompue ; voir Quand une commande en arrière-plan s'arrête dans la référence des outils
Pour désactiver les commandes en arrière-plan, définissez la variable d'environnement CLAUDE_CODE_DISABLE_BACKGROUND_TASKS sur 1. Lorsqu'elle est définie, vous perdez également le raccourci Ctrl+B et d'autres fonctionnalités en arrière-plan, comme l'exécution de skills en arrière-plan. Démarrer en mode bare a le même effet.
Commandes couramment mises en arrière-plan :
- Outils de compilation (webpack, vite, make)
- Gestionnaires de paquets (npm, yarn, pnpm)
- Exécuteurs de tests (jest, pytest)
- Serveurs de développement
- Processus de longue durée (docker, terraform)
Mode shell avec préfixe !
Exécutez des commandes shell directement sans passer par Claude en préfixant votre entrée avec ! :
! npm test
! git status
! ls -la
Mode shell :
- Ajoute la commande et sa sortie au contexte de la conversation
- Affiche la progression et la sortie en temps réel
- Prend en charge le même backgrounding
Ctrl+Bpour les commandes de longue durée - Ne nécessite pas que Claude interprète ou approuve la commande
- Prend en charge l'autocomplétion basée sur l'historique : tapez une commande partielle et appuyez sur
Tabpour compléter à partir des commandes!précédentes du projet actuel - Prend en charge l'autocomplétion du chemin de fichier en direct : tapez un jeton contenant une barre oblique, comme
./src/ou~/, pour voir une liste déroulante des fichiers et répertoires correspondants, puis appuyez surTabpour accepter. Utilisez des barres obliques sur Windows également ; la liste déroulante est déclenchée par/, pas\ - Quittez avec
Escape,Backspace, ouCtrl+Usur une invite vide - Coller du texte commençant par
!dans une invite vide entre automatiquement en mode shell, correspondant au comportement du!tapé
À moins que votre session ne soit l'une de celles énumérées sous mode sandbox strict, les commandes que vous tapez en mode shell s'exécutent en dehors du sandbox même si vous avez activé le sandboxing, car le sandbox s'applique aux commandes que Claude exécute.
Claude répond automatiquement à la sortie de la commande une fois qu'elle arrive dans la transcription, vous pouvez donc exécuter ! npm test et obtenir une explication des défaillances sans un deuxième prompt. La réponse coûte la même chose que l'envoi d'un prompt normal. Pour plutôt ajouter la sortie au contexte sans réponse, définissez respondToBashCommands sur false dans settings.json.
Mettre des messages en file d'attente pendant que Claude travaille
Tapez un message et appuyez sur Enter pendant que Claude travaille. Claude Code met le message en file d'attente au lieu d'interrompre le tour, et affiche les entrées en attente dans la conversation jusqu'à leur envoi. Vous pouvez mettre en file d'attente des commandes shell ! et la plupart des commandes de la même manière, à l'exception des commandes, comme /status, que Claude Code exécute dès que vous les envoyez.
Les messages envoyés et en file d'attente s'affichent en gris jusqu'à ce que Claude commence à y répondre, ce qui vous permet de savoir quels messages Claude n'a pas encore commencé à traiter.
Si vous mettez en file d'attente un message accompagné d'une sélection provenant d'un IDE connecté, il conserve la sélection que vous aviez au moment où vous avez appuyé sur Enter, quelle que soit votre sélection ultérieure.
Quand Claude Code envoie ce que vous avez mis en file d'attente
Le moment où une entrée en file d'attente parvient à Claude dépend de ce que vous avez mis en file d'attente.
- Messages : si vous mettez un message en file d'attente pendant que Claude exécute des appels d'outils, Claude Code le transmet à Claude dès que ces appels d'outils se terminent, au sein du même tour. Lorsque le tour se termine alors que des messages sont encore en file d'attente, ils sont envoyés sans autre appui sur une touche, dans l'ordre où vous les avez tapés
- Commandes et commandes shell : Claude Code les retient jusqu'à la fin du tour, puis les exécute une par une, en respectant l'ordre dans lequel vous les avez mises en file d'attente
Pour envoyer ce que vous avez mis en file d'attente sans attendre, appuyez sur Ctrl+Enter. Vos messages en file d'attente partent immédiatement, suivis de votre brouillon mis en file d'attente si vous en aviez tapé un. Nécessite Claude Code v2.1.275 ou une version ultérieure.
Si vous avez mis en file d'attente une commande shell ! avant vos messages, la touche interrompt le tour. Sinon, ce qui arrive au tour dépend de ce que fait Claude lorsque vous appuyez sur la touche :
- Exécution de commandes shell, de sous-agents ou d'un autre travail pouvant passer en arrière-plan : ce travail passe en arrière-plan et continue de s'exécuter, et Claude lit vos messages dans le même tour
- Simple rédaction d'une réponse, ou exécution d'une tâche qui ne peut pas passer en arrière-plan : Claude Code interrompt le tour et envoie ensuite vos messages. Avant la v2.1.281, la touche interrompait le tour dans les deux cas
En mode shell, la touche met uniquement votre commande en file d'attente. Dans les terminaux qui ne signalent pas les touches étendues, Ctrl+Enter arrive comme un simple Enter et met le brouillon en file d'attente à la place ; Ctrl+X Ctrl+S fonctionne dans n'importe quel terminal. Les deux touches sont des raccourcis de l'action chat:sendNow.
Appuyez sur Esc pour interrompre le tour sans soumettre votre brouillon. Claude Code conserve ce que vous avez mis en file d'attente et l'envoie immédiatement.
Claude Code exécute certaines commandes dès que vous les envoyez au lieu de les mettre en file d'attente, parmi lesquelles /model, /effort et /fast. Chacune de ces trois commandes modifie un paramètre : le modèle, le niveau d'effort ou le mode rapide. Selon la commande, Claude Code applique le nouveau paramètre au tour sur lequel Claude travaille déjà, ou seulement à partir de votre prochain tour :
/model: une fois que vous avez confirmé l'avertissement concernant le cache, si Claude Code en affiche un, Claude Code applique votre modification à la prochaine requête qu'il effectue dans ce tour/effort: le prochain message que vous envoyez s'exécute au nouveau niveau. Pour le faire démarrer dans le tour sur lequel Claude travaille déjà, mettez un message en file d'attente pendant que Claude exécute des appels d'outils/fast: Claude Code conserve le paramètre de mode rapide qui était actif au début du tour, de sorte que votre changement de vitesse s'applique à partir de votre prochain tour. Si votre modèle actuel ne prend pas en charge le mode rapide, l'activer change également votre modèle, et Claude Code utilise le nouveau modèle à partir de sa prochaine requête dans ce tour
Passer une session en arrière-plan avec des messages en file d'attente
Lorsque la session passe en arrière-plan après que vous avez appuyé sur ←, les messages que vous aviez mis en file d'attente la suivent. Claude les y lit dans l'ordre où vous les avez envoyés.
Les commandes et les commandes shell ! ne peuvent pas être déplacées, pas plus que certains messages, comme ceux auxquels une sélection d'IDE est jointe. Si vous appuyez sur ← alors que l'un d'eux est en file d'attente, la session reste au premier plan et un avis commençant par Cannot open agents apparaît. Pour passer la session en arrière-plan, retirez l'entrée de la file d'attente, puis appuyez de nouveau sur ← :
- Commandes et commandes shell
!: attendez qu'elles s'exécutent à la fin du tour, ou récupérez-les et videz la zone de saisie. Tant qu'autre chose est en file d'attente, vous ne pouvez pas récupérer les commandes shell!; attendez donc qu'elles s'exécutent. - Messages qui ne peuvent pas être déplacés : attendez que Claude les ait lus
Récupérer ce que vous avez mis en file d'attente
Appuyez sur Up depuis la première ligne de la zone de saisie pour récupérer les messages et commandes en file d'attente. Claude Code les retire de la file d'attente et les place dans la zone de saisie, un par ligne, avant tout texte que vous aviez tapé. Modifiez le texte et appuyez sur Enter pour le remettre en file d'attente sous forme d'une seule entrée, ou videz la zone de saisie pour l'abandonner.
Claude Code ne récupère les commandes shell en file d'attente que lorsque la zone de saisie est vide et que rien d'autre n'est en file d'attente, et il bascule alors la zone de saisie en mode shell. Sinon, il les laisse dans la file d'attente, affichées avec leur préfixe !, et les exécute à la fin du tour.
Si vous récupérez du texte en file d'attente pendant que ← attend de passer la session en arrière-plan, le texte reste dans la zone de saisie et Claude Code annule le basculement. Si vous le récupérez au moment où la session se déplace, le texte disparaît avec l'écran de premier plan : il n'a pas été envoyé. Chaque message que vous avez récupéré est enregistré comme une entrée distincte dans l'historique des commandes. Pour en récupérer un, rouvrez la session et appuyez sur Up dans un prompt vide sans rien en file d'attente.
Suggestions de prompts
Lorsque vous ouvrez une session pour la première fois, Claude Code affiche un exemple de commande grisé dans la zone de saisie du prompt pour vous aider à démarrer. Il le sélectionne à partir de l'historique git de votre projet, de sorte que l'exemple reflète les fichiers sur lesquels vous avez travaillé récemment.
Après la réponse de Claude, Claude Code peut suggérer votre prochain prompt en fonction de l'historique de votre conversation, par exemple une étape de suivi d'une demande en plusieurs parties ou une continuation naturelle de votre workflow.
- Appuyez sur
TabouRight arrowpour placer la suggestion dans la zone de saisie du prompt, puis surEnterpour l'envoyer - Commencez à taper pour l'ignorer
Claude Code génère chacune de ces suggestions de prochain prompt au moyen d'une courte requête en arrière-plan envoyée au même modèle que celui utilisé par votre session. Cette requête est comptabilisée dans les limites d'utilisation de votre forfait ou dans vos coûts d'API. Comme elle réutilise le cache de prompt de la conversation, elle se compose principalement de lectures du cache et de quelques tokens de sortie, de sorte que le coût supplémentaire est faible.
Quand Claude Code ignore les suggestions
En mode interactif, Claude Code désactive les suggestions de prompts par défaut et masque l'option Prompt suggestions dans /config dans une session qui ne récupère pas les feature flags, comme une session sur un fournisseur tiers ou via une passerelle d'applications Claude, ainsi que dans une première session après une installation ou une mise à niveau dont les flags ne sont pas encore arrivés.
Claude Code ignore également certaines suggestions dans plusieurs situations, notamment :
- Le cache de prompt est froid, afin d'éviter des coûts inutiles
- Après le premier tour d'une conversation, dans certaines sessions
- La réponse précédente s'est terminée par une erreur
- Lorsque vous êtes en mode plan
- Votre compte est proche de sa limite d'utilisation ou l'a atteinte. Pour que cette exclusion ne s'applique qu'une fois la limite atteinte, définissez
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTIONsurtrue. Avant la v2.1.238, Claude Code ignorait les suggestions à l'approche de la limite même lorsque la variable était définie surtrue - Dans une équipe d'agents, dans les sessions des coéquipiers par défaut. La session du responsable affiche les suggestions
Le message Showing fewer prompt suggestions · use one to bring them back signifie que Claude Code affiche les suggestions moins souvent parce que vous en avez laissé plusieurs d'affilée inutilisées. Pour revenir à la fréquence habituelle, utilisez une suggestion ou définissez CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION sur true.
En mode print, Claude Code ne génère pas de suggestions par défaut. Passez --prompt-suggestions avec -p "<prompt>" --output-format stream-json --verbose pour que Claude Code émette un message prompt_suggestion après chaque tour qui en génère une. Là aussi, le générateur ignore les conversations très courtes et les caches de prompt froids, de sorte qu'une seule requête -p courte peut n'en émettre aucune.
Désactiver les suggestions de prompts
Pour désactiver entièrement les suggestions de prompts, utilisez l'une des méthodes suivantes :
- Désactivez Prompt suggestions dans
/config - Définissez
promptSuggestionEnabledsurfalsedans votre fichier de paramètres - Définissez la variable d'environnement
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTIONsurfalse, qui a priorité sur le paramètre :export CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false
Pour désactiver les suggestions de prompts dans toute une organisation, définissez promptSuggestionEnabled sur false dans les paramètres gérés. Définissez également CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION sur false sous la clé env gérée afin que les utilisateurs ne puissent pas les réactiver avec leur propre variable d'environnement.
Suggestions You should know
« You should know » recherche une chose que vous devriez savoir mais que vous avez peut-être manquée, comme un compromis que Claude a choisi sans le signaler ou un résultat qui pourrait être erroné. Lorsqu'il en trouve une, il affiche une courte note au-dessus de la zone de saisie du prompt :
✦ Heads up · There was a change to how folder sharing starts in June, which may have bumped usage metrics artificially.
1: Learn more 2: Knew this already 0: Dismiss
Il s'agit de l'un des mods intégrés de Claude Code, un plugin intégré à Claude Code qui est désactivé par défaut. Nécessite Claude Code v2.1.287 ou une version ultérieure.
Lorsqu'il est activé, un agent secondaire relit la conversation de temps en temps pendant que Claude travaille sur une tâche plus longue. L'agent secondaire est une requête distincte adressée au même modèle et ne dispose d'aucun outil : il ne peut donc pas lire de fichiers, exécuter de commandes ni modifier ce que fait Claude.
Si le mod est disponible pour votre organisation, /plugin le liste lorsque vous vous connectez directement à l'API Claude avec un compte claude.ai ou une clé API de la Console. Ce n'est pas le cas lorsque vous vous connectez via une passerelle LLM ou une passerelle Claude apps, ou lorsque vous obtenez votre clé à partir d'un apiKeyHelper. Même avec une connexion directe, ces sessions ne le listent pas :
- Une session qui ne récupère pas les feature flags dont dépend le mod, par exemple une session où
DISABLE_TELEMETRYest défini - Une première session après une installation ou une mise à niveau dont les flags ne sont pas encore arrivés
Pour l'activer, exécutez ceci dans le prompt de Claude Code :
/plugin enable cc-plugin-you-should-know@builtin
Lorsque /plugin ne liste pas le mod, la commande d'activation répond Plugin "cc-plugin-you-should-know@builtin" is not installed in this project.
Coût des vérifications
Lorsque le mod est activé, les vérifications sont des requêtes en arrière-plan adressées au même modèle que celui utilisé par votre session, et elles sont décomptées de vos limites d'utilisation de votre forfait ou de vos coûts d'API. Chaque vérification envoie ce qui se trouve déjà dans le contexte de Claude, c'est-à-dire la conversation jusqu'à présent avec ses résultats d'outils, suivie des propres instructions du mod et du texte de vos notes récentes. La partie conversation est lue depuis le prompt cache de la session dans les mêmes conditions que la prochaine requête de Claude. Les instructions, qui représentent plusieurs milliers de tokens, et la réponse de l'agent secondaire sont facturées intégralement à chaque vérification.
Pour observer les vérifications, définissez CLAUDE_CODE_YOU_SHOULD_KNOW_DEBUG=1 dans votre shell avant de démarrer Claude Code.
Répondre à une note
Saisissez uniquement le chiffre correspondant au choix dans une zone de saisie du prompt vide. Une note propose ces choix :
- Learn more : ouvre une courte explication sous la note, avec ses propres choix :
- Understood : la ferme et marque le sujet comme connu
- Chat in main session : cite la note dans votre zone de saisie du prompt afin que vous puissiez ajouter une question et l'envoyer à Claude
- Dismiss : la ferme sans marquer le sujet comme connu
- Knew this already : ferme la note et marque le sujet comme connu.
- Dismiss : ferme la note.
L'agent principal ne voit une note que si vous l'envoyez avec Chat in main session.
Claude Code conserve vos notes récentes et les sujets que vous avez marqués comme connus dans un fichier dont le nom commence par cc-plugin-you-should-know sous ~/.claude/plugins/store/. Chaque vérification, dans cette session et les suivantes, les liste à l'agent secondaire comme des éléments à ne pas répéter. Claude Code supprime le fichier une fois que cleanupPeriodDays s'est écoulé sans qu'une session ne le lise ou ne l'écrive. Pour les effacer plus tôt, supprimez ce fichier lorsqu'aucune session n'est en cours d'exécution.
Désactiver You should know
Pour désactiver You should know, utilisez l'une des méthodes suivantes :
- Dans le prompt de Claude Code, exécutez
/plugin disable cc-plugin-you-should-know@builtin, ou désactivez-le depuis l'onglet Installed de/plugin - Après avoir choisi Dismiss sur une note sans avoir d'abord ouvert Learn more, choisissez Turn off suggestions sur la ligne
Dismissed., qui disparaît au bout de 20 secondes
Codes courts d'emoji
Tapez un : suivi d'un code court d'emoji dans la zone de saisie du prompt pour insérer l'emoji.
- Tapez un code court complet tel que
:heart:et Claude Code le remplace par ❤️ dès que vous tapez le:de fermeture - Tapez
:suivi d'au moins deux caractères d'un nom, comme:hea, pour ouvrir une fenêtre de suggestions, puis appuyez surTabouEnterpour insérer l'emoji en surbrillance
Le code court doit se trouver au début de la saisie ou suivre une espace, de sorte qu'un : à l'intérieur d'un mot ou d'une URL n'ouvre pas les suggestions.
Pour désactiver cette fonctionnalité, définissez emojiCompletionEnabled sur false dans settings.json. Cela désactive à la fois la fenêtre de suggestions et le remplacement en ligne.
Vérifier l'orthographe au fur et à mesure de la saisie
Claude Code peut souligner les mots mal orthographiés dans l'entrée de l'invite pendant que vous tapez. Il vérifie uniquement le texte dans la zone de saisie, jamais les réponses de Claude ou vos fichiers. Il ne vérifie également rien lorsque la zone de saisie est en mode shell, recherche d'historique Ctrl+R, ou dictée vocale.
La vérification orthographique est désactivée par défaut, et Claude Code ne vérifie rien en mode lecteur d'écran. Nécessite Claude Code v2.1.235 ou version ultérieure.
Conditions préalables
- Installez aspell, hunspell, ou ispell et assurez-vous qu'il se trouve dans votre
PATH. Claude Code exécute le premier des trois qu'il trouve, dans cet ordre, sur toutes les plateformes, y compris un shim.cmdqu'un gestionnaire de paquets installe sur Windows. - Pour vérifier que le programme se trouve dans votre
PATH, exécutezaspell --version,hunspell --version, ouispell -vdans votre terminal. Une erreur « command not found » signifie qu'il ne se trouve pas encore dans votrePATH.
Activer ou désactiver la vérification orthographique
Claude Code lit le paramètre spellcheck à partir de trois emplacements, et l'ignore dans le .claude/settings.json et .claude/settings.local.json d'un projet. Activez-le à partir de celui que vous utilisez :
Paramètres utilisateur
Ajoutez spellcheck à ~/.claude/settings.json. Il s'applique dans chaque projet que vous ouvrez, comme le reste de vos paramètres utilisateur :
{
"spellcheck": { "enabled": true }
}
Ligne de commande
Enregistrez spellcheck dans un fichier JSON, tel que spellcheck.json :
{
"spellcheck": { "enabled": true }
}
Ensuite, transmettez le fichier à --settings. Il s'applique à cette session uniquement :
claude --settings spellcheck.json
Paramètres gérés
Ajoutez spellcheck à l'une des sources de paramètres gérés de votre organisation. Il s'applique à chaque utilisateur qui reçoit ces paramètres, et ils ne peuvent pas le désactiver :
{
"spellcheck": { "enabled": true }
}
Pour vérifier que la vérification orthographique est activée, tapez un mot mal orthographié et un espace. Claude Code souligne le mot. Si ce n'est pas le cas, consultez Quand Claude Code ne souligne rien. Pour désactiver à nouveau la vérification orthographique, définissez enabled sur false au même endroit, ou supprimez spellcheck.
Pour choisir lequel des trois programmes Claude Code exécute, quel dictionnaire il utilise, ou la couleur du soulignement, ajoutez l'un de ces champs à côté de enabled, au même endroit :
checker:aspell,hunspell, ouispell. Claude Code ne revient pas à un vérificateur que vous nommez, et traite toute autre valeur commeauto.language: un nom de dictionnaire dans la forme de votre vérificateur, tel queen_GB. Claude Code ignore toute valeur qui n'est pas un nom de dictionnaire simple, tel qu'un chemin ou un nom avec des espaces, et le vérificateur utilise son dictionnaire par défaut.color: un nom de couleur tel queyellow, ou une valeur#rrggbb,#rgb,rgb(r,g,b),ansi256(n), ouansi:<name>. Claude Code utilise la couleur d'erreur de votre thème par défaut et pour toute valeur qu'il ne reconnaît pas.
Par exemple, ce paramètre spellcheck exécute hunspell avec son dictionnaire en_GB et souligne les mots en jaune. Il fonctionne de la même manière dans ~/.claude/settings.json, dans le fichier que vous transmettez à --settings, et dans les paramètres gérés :
{
"spellcheck": {
"enabled": true,
"checker": "hunspell",
"language": "en_GB",
"color": "yellow"
}
}
Si plusieurs des trois emplacements ont un paramètre spellcheck, Claude Code n'en utilise qu'un seul : d'abord les paramètres gérés, puis --settings, puis les paramètres utilisateur. Il ne combine pas les champs de deux emplacements. Par exemple, lorsque --settings définit spellcheck, un language dans vos paramètres utilisateur n'a aucun effet.
Ce que Claude Code souligne
Peu de temps après que vous ayez arrêté de taper, Claude Code souligne les mots que le dictionnaire ne connaît pas. Il laisse le mot que vous tapez encore seul jusqu'à ce que vous le dépassiez, et il ne change jamais votre texte. Il ignore également le texte qui ressemble à du code :
- Les commandes telles que
/help, les mentions@, les URL, les chemins de fichiers, et les drapeaux tels que--verbose - Les mots avec des chiffres, des traits de soulignement, ou une lettre majuscule après la première, et le texte entre backticks
Claude Code ignore également le texte chinois, japonais, coréen, thaï, lao, khmer et birman.
Claude Code n'a pas sa propre liste de mots : un mot est mal orthographié lorsque votre vérificateur le dit. Pour empêcher Claude Code de souligner un mot, ajoutez le mot au dictionnaire personnel de votre vérificateur, en suivant la documentation du vérificateur. Claude Code récupère le nouveau mot après son redémarrage.
Quand Claude Code ne souligne rien
Claude Code ne souligne rien lorsqu'il ne peut pas maintenir un vérificateur en cours d'exécution :
- Aucun vérificateur n'est installé, ou celui que vous avez nommé dans
checkerest manquant - Le vérificateur échoue deux fois de suite, au démarrage ou plus tard dans la session. Claude Code le redémarre après le premier échec et arrête la vérification après le second, jusqu'à ce que vous redémarriez Claude Code
- Le vérificateur prend plus de 15 secondes pour répondre, trois fois. À chaque fois, Claude Code laisse les mots en attente non marqués ; après le troisième, il arrête la vérification jusqu'à ce que vous redémarriez Claude Code
Pour savoir lequel de ces cas s'est produit, démarrez claude --debug avec la vérification orthographique activée et tapez un mot. Ensuite, recherchez les lignes [spellcheck] dans le journal de débogage à ~/.claude/debug/<session-id>.txt. Une ligne nomme le programme que Claude Code a démarré, ou énumère ceux qu'il a recherchés et n'a pas trouvés. Les lignes ultérieures expliquent pourquoi il s'est arrêté. Une erreur de dictionnaire manquant là signifie que le vérificateur n'a pas de dictionnaire pour votre valeur language, ou pas de dictionnaire par défaut lorsque language n'est pas défini. Installez-en un, ou définissez language sur un dictionnaire que vous avez.
Caractères invisibles dans les prompts
Le texte collé peut contenir des caractères Unicode qu'un terminal n'affiche pas du tout, comme les caractères d'étiquette, les contrôles bidirectionnels et les espaces de largeur nulle, de sorte qu'un prompt peut contenir du texte que vous ne voyez jamais. Pour éviter que du texte copié ne transporte des instructions que votre terminal n'affiche pas, Claude Code supprime ces caractères lorsque vous appuyez sur Enter, avant d'envoyer quoi que ce soit. Il nettoie à la fois le prompt et le contenu de toute référence de texte collé réduite que le prompt inclut. Claude Code conserve les caractères de liaison qu'utilisent les écritures persanes et indiennes ainsi que les sélecteurs au sein des séquences d'emoji.
Si Claude Code a supprimé quelque chose, cet appui sur Enter n'envoie rien. Le prompt nettoyé revient dans la zone de saisie avec une notification telle que Removed 3 invisible characters · review and press Enter to send, et appuyer de nouveau sur Enter envoie le texte tel qu'il est affiché.
Lorsque vous transmettez un prompt sur la ligne de commande, comme dans claude "fix the login bug", Claude Code n'attend pas un second appui sur Enter. Il supprime les caractères, affiche une notification et envoie le prompt nettoyé. Si le prompt nettoyé devait commencer par /, Claude Code le place plutôt dans la zone de saisie pour que vous le vérifiiez et l'envoyiez.
Examiner les modifications avec /diff
Exécutez /diff pour parcourir les modifications de votre arbre de travail sans quitter Claude Code. Vous voyez les modifications que Claude a effectuées jusqu'à présent, ainsi que tout ce que vous n'avez pas encore commité. Ce que /diff ouvre dépend du moteur de rendu actif :
- Rendu plein écran : le panneau de diff s'ouvre à côté de la conversation. Il reste ouvert et se met à jour pendant que vous continuez à travailler.
- Moteur de rendu classique : la boîte de dialogue de diff s'ouvre au-dessus du prompt, et vous la fermez une fois votre lecture terminée.
Le panneau et la boîte de dialogue proviennent tous deux de cc-plugin-diff, l'un des mods intégrés à Claude Code. Si vous désactivez ce mod dans /plugin, /diff ouvre à la place l'ancien panneau et la visionneuse de diff de Claude Code.
Dans les modifications que /diff lit depuis git, un sous-module apparaît comme une seule entrée, et uniquement lorsque le commit vers lequel il pointe change ; les modifications apportées aux fichiers à l'intérieur du sous-module n'y apparaissent pas. Le panneau et la boîte de dialogue proposent également une vue des modifications de chaque tour dès que Claude a modifié des fichiers. Ces vues par tour proviennent des modifications de fichiers effectuées par Claude plutôt que de git : une modification que Claude effectue via une commande shell n'apparaît donc que sous Current, la vue de l'arbre de travail.
Panneau de diff
Le panneau de diff liste les fichiers modifiés avec leur nombre de lignes ajoutées et supprimées, et affiche le diff de chaque fichier sous la liste. Claude Code l'actualise chaque fois que Claude modifie un fichier ou exécute une commande shell. Pour fermer le panneau, exécutez à nouveau /diff ou cliquez sur le ✕ dans son en-tête.
Pour utiliser le panneau, vous avez besoin de :
- Rendu plein écran
- Un dépôt git
- Un terminal d'au moins 110 colonnes de large
- Claude Code v2.1.287 ou ultérieur
Le panneau s'ouvre également de lui-même dès que Claude commence à modifier des fichiers, si votre terminal fait au moins 144 colonnes de large. Une fois que vous l'avez ouvert vous-même avec /diff, les sessions suivantes l'ouvrent dès que Claude modifie un fichier, dans tout terminal suffisamment large pour l'afficher. Si vous fermez le panneau, il reste fermé, dans cette session comme dans les suivantes, jusqu'à ce que vous exécutiez à nouveau /diff.
Lorsque le panneau est ouvert, vous pouvez :
- Accéder à un fichier : cliquez sur sa ligne dans la liste. Faites défiler le panneau avec la molette de la souris. Lorsque la liste des fichiers elle-même est trop longue pour tenir, faites-la défiler avec
Alt+UpetAlt+Down, ouCtrl+UpetCtrl+Down. - Interroger Claude sur les modifications d'un fichier : cliquez sur
ask, à droite du nom du fichier au-dessus de son diff. Claude Code joint le diff de ce fichier à votre prochain prompt, et le bouton afficheasked ✓jusqu'à ce que vous envoyiez ce prompt. Interroger Claude sur un second fichier remplace le premier. - Afficher les modifications d'un tour : cliquez sur le sélecteur
sourcedans l'en-tête du panneau, puis choisissez un tour avecUpetDownet appuyez surEnter. Les tours sont libellésT1,T2, et ainsi de suite. Le sélecteur apparaît dès que Claude a modifié des fichiers, etCurrentvous ramène à l'arbre de travail. - Afficher les fichiers que le panneau omet : la liste ignore les fichiers de test et les fichiers générés, et regroupe les modifications antérieures à cette session en une seule ligne en bas. Cliquez sur l'une ou l'autre ligne de décompte pour la développer.
- Changer la référence de comparaison du panneau : appuyez sur
Ctrl+X Bpour passer des modifications de cette session à vos modifications non commitées sous forme d'une seule liste, puis à tout ce qui a changé depuis que votre branche s'est séparée de la branche par défaut. Claude Code mémorise ce choix pour chaque dépôt.
Pour réattribuer les touches qui font défiler la liste des fichiers ou changent la comparaison, consultez Actions du panneau de diff.
Pendant une fusion, un rebase, un cherry-pick ou un revert inachevé, le panneau continue d'afficher les modifications qu'il a lues en dernier depuis git, afin de ne pas se remplir des modifications entrantes de l'opération. Il se met à jour lors de sa première actualisation après la fin de l'opération, par exemple lorsque Claude modifie à nouveau un fichier.
Boîte de dialogue de diff
La boîte de dialogue de diff s'ouvre sous la forme d'un bloc encadré au-dessus du prompt et liste vos fichiers modifiés avec leur nombre de lignes ajoutées et supprimées. Elle les compare à HEAD, ou à ce que vous avez choisi en dernier dans le panneau de diff pour ce dépôt.
Dès que Claude a modifié des fichiers, un sélecteur source apparaît au-dessus de la liste. Il propose une vue par tour, libellée T1, T2, et ainsi de suite, pour chacun de vos prompts ayant conduit Claude à modifier des fichiers. Une vue par tour n'affiche que les modifications de ce tour, et Current vous ramène à l'arbre de travail.
Utilisez ces touches dans la boîte de dialogue :
- Up et Down : sélectionner un fichier.
- Enter : ouvrir le diff du fichier sélectionné. Faites-le défiler avec Up et Down, ou PageUp et PageDown.
- Esc : revenir du diff d'un fichier à la liste, ou fermer la boîte de dialogue depuis la liste.
- Tab : passer au sélecteur
source, puis choisirCurrentou une vue par tour avec Up et Down et appuyer sur Enter. Dans le diff d'un fichier, Tab passe au boutonask. Appuyez sur Enter pour joindre le diff de ce fichier à votre prochain prompt.
Questions annexes avec /btw
Utilisez /btw pour poser une question sur votre travail actuel sans l'ajouter à l'historique de la conversation.
/btw what was the name of that config file again?
Claude répond à une question annexe à partir de ce qui se trouve déjà dans la conversation : vos messages, ses réponses et les résultats des outils qu'il a rassemblés. Vous pouvez poser des questions sur le code que Claude a déjà lu, les décisions qu'il a prises plus tôt, ou n'importe quoi d'autre de la session. Une question annexe ultérieure voit également vos questions annexes antérieures : Claude Code rejoue les 20 échanges les plus récents à chaque demande, jusqu'à ce que vous les effaciez. La question et la réponse n'entrent jamais dans l'historique de la conversation. Dans le terminal, elles apparaissent dans une superposition pouvant être fermée. Le terminal conserve le fil en mémoire : appuyez sur x pour effacer les échanges antérieurs, et il disparaît quand vous quittez Claude Code.
Dans le panneau de chat de l'extension VS Code, /btw ouvre un panneau plutôt que la superposition décrite dans cette section, et vous posez des questions de suivi directement dans le panneau. Le fil du panneau survit aux rechargements de fenêtre, selon le calendrier de rétention que cette page décrit. Vous avez besoin de l'extension à la version 2.1.227 ou ultérieure. Les versions antérieures de l'extension n'offrent pas /btw.
- Disponible pendant que Claude travaille : vous pouvez exécuter
/btwmême pendant que Claude traite une réponse. La question annexe s'exécute indépendamment et n'interrompt pas le tour principal. Elle voit tout ce qui se trouve dans la conversation jusqu'à présent, sauf la réponse que Claude est encore en train d'écrire. - Pas d'accès aux outils : les questions annexes répondent uniquement à partir de ce qui se trouve déjà en contexte. Claude ne peut pas lire de fichiers, exécuter de commandes ou effectuer de recherches lors de la réponse à une question annexe. Si Claude écrit des appels d'outils sous forme de texte de toute façon, la réponse se termine par une note indiquant que rien n'a été exécuté.
- Réponse unique : il n'y a pas de tours de suivi dans la superposition. Pour continuer le fil, posez une autre question
/btw. Pour continuer avec un accès complet aux outils dans une session locale, appuyez surfpour créer un sous-agent en arrière-plan à partir de cette question et réponse. - Coût faible : tandis que le cache de prompt de la conversation est actif, une question annexe coûte peu au-delà de la réponse elle-même.
Vos cinq questions annexes antérieures les plus récentes apparaissent sous forme de liste estompée au-dessus de la réponse actuelle, avec un décompte de celles plus anciennes. Elles restent en dehors de l'historique de la conversation.
Pour revenir à la superposition après l'avoir fermée, exécutez /btw sans question. La superposition se rouvre sur votre échange le plus récent.
Une fois que la réponse apparaît, la superposition accepte ces touches.
| Touche | Action |
|---|---|
Space, Enter, Escape |
Fermer la réponse et revenir à l'invite |
Up / Down |
Faire défiler la réponse |
Shift+Left / Shift+Right |
Naviguer entre cette réponse et vos réponses /btw antérieures. Shift+Left se déplace vers les réponses plus anciennes et Shift+Right revient vers la réponse actuelle. [ et ] font la même chose, pour les terminaux qui ne signalent pas Shift avec les touches fléchées. Tab / Shift+Tab parcourent les mêmes réponses. Nécessite Claude Code v2.1.257 ou ultérieure. Entre v2.1.187 et v2.1.256, les touches étaient Left / Right simples |
c |
Copier la réponse dans votre presse-papiers en tant que Markdown brut. Utilisez ceci au lieu de la sélection à la souris, qui capture le rendu du terminal avec retour à la ligne plutôt que le texte source |
f |
Démarrer un sous-agent créé qui hérite de la conversation parent plus cette question et réponse, afin qu'il puisse continuer avec un accès complet aux outils. Vous restez dans la session actuelle et trouvez la création dans le panneau sous votre invite. Disponible uniquement dans les sessions locales |
x |
Effacer la liste des échanges /btw antérieurs affichés au-dessus de la réponse actuelle |
Dans une session en arrière-plan attachée, Left se détache et vous ramène à la vue agent, même pendant que la réponse arrive encore. La question annexe continue de s'exécuter pendant que vous êtes absent. La prochaine fois que vous vous attachez à la session, la superposition se rouvre avec la question annexe, ou avec sa réponse. Avant v2.1.257, Left ne se détachait pas là.
/btw voit votre conversation complète mais n'a pas d'outils. Un sous-agent a des outils et commence à partir de l'invite qu'il reçoit, ou, pour une création, à partir d'une copie de cette conversation. Utilisez /btw pour poser des questions sur ce que Claude connaît déjà de cette session ; utilisez un sous-agent pour aller découvrir quelque chose de nouveau.
Liste des tâches
La liste des tâches est la liste de contrôle de Claude : des éléments que Claude a créés pour planifier un travail multi-étapes, avec des indicateurs montrant ce qui est en attente, en cours ou terminé. Elle est distincte de la vue des tâches en arrière-plan. Pour voir les shells en cours d'exécution et les sous-agents, utilisez /tasks à la place.
La liste se remplit uniquement dans les sessions qui disposent des outils de suivi des tâches, que Claude Code fournit par défaut sur Opus 4.7, Sonnet 4.6, Haiku 4.5 et les modèles antérieurs. Sur tout autre modèle, y compris un identifiant de modèle que Claude Code ne reconnaît pas, la liste reste vide sauf si vous acceptez avec CLAUDE_CODE_ENABLE_TODO_TOOLS=1 ou l'une des autres méthodes sous Disponibilité de l'outil de tâche. Lorsque la session dispose des outils, la liste des tâches fonctionne comme suit :
- Appuyez sur
Ctrl+Tpour basculer l'affichage de la liste des tâches. L'affichage montre jusqu'à cinq tâches à la fois. Lorsque Claude n'a pas encore créé d'éléments de liste de contrôle, le basculement n'a aucun effet visible car il n'y a rien à afficher - Si vous laissez la liste développée, Claude Code restaure la vue développée la prochaine fois que vous lancez une session qui contient toujours des tâches, par exemple avec
--resumeou--continue. Lorsque la liste des tâches est vide, Claude Code la démarre en mode réduit - Pour voir toutes les tâches ou les effacer, demandez directement à Claude : « affiche-moi toutes les tâches » ou « efface toutes les tâches »
- Les tâches persistent lors des compactions de contexte, aidant Claude à rester organisé sur les projets plus importants
- Pour partager une liste de tâches entre les sessions, définissez
CLAUDE_CODE_TASK_LIST_IDpour utiliser un répertoire nommé dans~/.claude/tasks/:CLAUDE_CODE_TASK_LIST_ID=my-project claude
Récapitulatif de session
Lorsque vous revenez au terminal après vous être éloigné, Claude Code affiche un récapitulatif d'une ligne de ce qui s'est passé dans la session jusqu'à présent. Le récapitulatif se génère en arrière-plan une fois qu'au moins trois minutes se sont écoulées depuis le dernier tour complété et que le terminal n'est pas actif, de sorte qu'il soit prêt lorsque vous revenez. Les récapitulatifs n'apparaissent qu'une fois que la session compte au moins trois tours, et jamais deux fois de suite.
Exécutez /recap pour générer un résumé à la demande. Cette commande ne s'exécute que lorsque vous la demandez vous-même. Lorsqu'elle arrive dans un message relayé depuis un fil Slack, Teams ou de projet, vous recevez un avis au lieu d'un récapitulatif. Vous recevez également cet avis lorsque /recap arrive dans un prompt envoyé par une tâche planifiée dans le cloud.
Le récapitulatif de session est activé par défaut pour tous les plans et fournisseurs. Pour désactiver les récapitulatifs automatiques, ouvrez /config et désactivez Session recap. Le récapitulatif automatique n'apparaît jamais en mode non interactif. Claude Code limite à la fois les récapitulatifs automatiques et la sortie de /recap à 400 caractères.
Attendre la réinitialisation d'une limite d'utilisation
Lorsqu'une limite d'utilisation de claude.ai interrompt Claude en pleine tâche, Claude Code attend dans la session ouverte et reprend la tâche de lui-même après la réinitialisation de la limite. La reprise automatique est activée par défaut dans les sessions interactives connectées avec un abonnement claude.ai. Nécessite Claude Code v2.1.234 ou une version ultérieure.
Pendant que Claude Code attend, les lignes en bas de la session indiquent quand votre limite se réinitialise et quand Claude reprendra :
Usage limit reached · limit resets 3:45pm
Continuing automatically at 3:45pm · Esc to cancel
Chacune de ces lignes peut contenir davantage de texte après ces mots, comme un lien d'aide sur la première ou /usage-credits to continue now sur la seconde. Lorsque l'attente démarre d'elle-même, la conversation l'enregistre également avec une ligne indiquant Usage limit reached · continuing automatically at 3:45pm · esc to cancel.
Gardez la session ouverte. La suite dépend de la manière dont l'attente se termine :
- À la réinitialisation : la seconde ligne devient
Continuing shortly · Esc to cancel. Ensuite,Usage limit reset · Continuing automaticallyapparaît dans la conversation, et Claude Code demande à Claude de reprendre la tâche là où elle s'était arrêtée. Il ne renvoie pas votre dernier message. - Après la mise en veille de votre ordinateur : si celui-ci est resté en veille plus d'environ 30 minutes et que la limite s'est réinitialisée pendant la veille, la première ligne indique
Your usage limit has resetet la secondePress enter to continue. Appuyez surEnterpour continuer. Après une veille plus courte, ou une veille terminée avant la réinitialisation, Claude Code reprend de lui-même. - Plus tôt : lorsque vous terminez l'ajout de crédits d'utilisation avec
/usage-credits, que vous vous reconnectez après/upgradeou que vous changez de modèle avec/modelpendant l'attente, Claude Code vérifie si l'utilisation est de nouveau disponible et reprend immédiatement si c'est le cas. Il ne vérifie pas après une mise à niveau ou un achat que vous effectuez de votre côté dans un navigateur. Avecopusplanet les autres paramètres de modèle qui exécutent le mode plan sur un modèle différent, Claude Code attend plutôt la réinitialisation.
La tâche reprise s'exécute comme n'importe quel autre tour. Claude Code continue de demander les permissions comme d'habitude, la tâche peut donc s'arrêter sur une demande de permission pendant votre absence. Si elle atteint de nouveau la limite, Claude Code relance l'attente de lui-même au maximum deux fois de suite, puis s'arrête et affiche Automatic continue stopped after repeated usage-limit hits · /rate-limit-options to try again.
Annuler l'attente
Appuyez sur Esc à un prompt vide, ou sur Ctrl+C, pendant que les lignes sont affichées, ou exécutez /rate-limit-options et choisissez Don't continue automatically. Claude Code confirme avec une ligne commençant par Automatic continue cancelled.
Après une annulation, rien ne reprend tant que vous n'envoyez pas de prompt ou que vous ne choisissez pas de nouveau la ligne commençant par Wait here, then continue automatically dans /rate-limit-options. Claude Code ne redémarre pas d'attente de lui-même pour cette fenêtre de réinitialisation ; la fenêtre de réinitialisation suivante repart de zéro.
L'attente se termine également sans reprendre la tâche dans les cas suivants :
- Vous envoyez un prompt : Claude Code envoie votre prompt au lieu d'attendre. Si votre prompt atteint lui aussi la limite, il reste dans la conversation et Claude Code redémarre l'attente.
- Vous quittez Claude Code : l'attente ne redémarre pas lorsque vous reprenez la session.
- La conversation change de mains : vous changez de compte avec
/login, effacez ou rembobinez la conversation, exécutez/resumesur une autre session, en récupérez une avec/teleport, relancez avec/tui, ou transférez la session vers Claude Desktop, une session en arrière-plan ou le cloud. - Le paramètre est désactivé, ou la réinitialisation dépasse 24 heures : cela ne met fin qu'à une attente que Claude Code a démarrée de lui-même. Une attente que vous avez choisie dans
/rate-limit-optionspoursuit son décompte. - La reprise est bloquée : un hook
UserPromptSubmitqui bloque le prompt de reprise, ou un échec avant que celui-ci n'atteigne le modèle, met fin à l'attente. Claude Code vous indique que la reprise ne s'est pas exécutée. Envoyez un prompt pour continuer.
Démarrer une attente vous-même
Claude Code ne démarre pas l'attente de lui-même dans les cas suivants :
- Sessions Remote Control et sessions de coéquipiers d'une équipe d'agents : une personne devant ce terminal peut tout de même en démarrer une.
- Une réinitialisation dans plus de 24 heures : une limite hebdomadaire peut se réinitialiser plusieurs jours plus tard.
- Une limite Opus ou Sonnet alors que vous utilisez un modèle d'une autre famille : votre prochain tour risque de ne pas atteindre cette limite.
opusplanet les autres paramètres de modèle qui exécutent le mode plan sur la famille limitée ne bénéficient pas de cette exception.
Dans ces cas, et chaque fois que la reprise automatique est désactivée, Claude Code ouvre le menu des options de limite d'utilisation une fois par fenêtre de réinitialisation lorsque vous atteignez une limite depuis votre propre terminal. Choisissez la ligne commençant par Wait here, then continue automatically pour démarrer l'attente. Dans une session Remote Control ou une session de coéquipier d'une équipe d'agents, exécutez vous-même /rate-limit-options pour ouvrir le menu.
Claude Code ne propose pas du tout l'attente dans les cas suivants :
- Sessions en arrière-plan et exécutions
-p: la ligne du menu n'est pas disponible. - Clés API, fournisseurs cloud et facturation à l'usage : l'utilisation y est mesurée par requête, il n'y a donc aucune réinitialisation à attendre.
- Une passerelle LLM sans connexion claude.ai enregistrée : Claude Code ne propose l'attente que lorsqu'une connexion claude.ai enregistrée constitue les identifiants actifs.
Désactiver la reprise automatique
Dans /config, désactivez Continue automatically at usage limit, ou définissez autoContinueAtUsageLimit sur false dans vos paramètres utilisateur. /config autoContinueAtUsageLimit=false fonctionne également, y compris avec -p, mais la forme key=value ne permet pas de le réactiver, car ce paramètre autorise une exécution sans surveillance. Les fichiers de paramètres que Claude Code lit pour cette clé sont indiqués dans la référence des paramètres.
Statut de la revue de PR
Lorsque vous travaillez sur une branche avec une demande de fusion ouverte, Claude Code affiche un lien PR cliquable dans le pied de page, par exemple « PR #446 ». Le lien a un soulignement coloré indiquant l'état de la revue :
- Vert : approuvé
- Jaune : en attente de revue
- Rouge : modifications demandées
- Gris : brouillon
Le badge disparaît une fois que la demande de fusion est fusionnée ou fermée.
Cmd+clic (macOS) ou Ctrl+clic (Windows/Linux) sur le lien pour ouvrir la demande de fusion dans votre navigateur.
Le statut se rafraîchit dès qu'un git push, ou une commande gh pr qui modifie la demande de fusion, comme gh pr create ou gh pr merge, réussit dans la session.
Claude Code affiche le badge comme un lien hypertexte même lorsqu'il ne peut pas détecter la prise en charge des liens hypertextes dans votre terminal, ce qui se produit couramment via SSH ou dans tmux. Définissez FORCE_HYPERLINK=0 pour afficher le badge en tant que texte brut.
Lorsque vous définissez CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, Claude Code ne vérifie pas l'état de la demande de fusion ou de la demande de fusion.
[!NOTE]
Le statut de PR pour les référentiels GitHub nécessite un jeton GitHub. Claude Code en trouve un en fonction de l'hôte du distant :
- github.com :
GH_TOKENouGITHUB_TOKEN, ou le jeton enregistré pargh auth login. Sans celui-ci, le pied de page afficheinstall gh for PR statuslorsque la CLIghn'est pas installée, ough auth login for PR statuslorsqu'elle l'est- Un hôte GitHub Enterprise défini comme
GH_HOST:GH_ENTERPRISE_TOKENouGITHUB_ENTERPRISE_TOKEN, ou le jeton enregistré pargh auth login --hostname <host>. Sans celui-ci, le pied de page affiche les mêmes indices- Tout autre hôte GitHub : le jeton enregistré par
gh auth login --hostname <host>. Sans celui-ci, Claude Code n'affiche aucun badge et aucun indice
Demandes de fusion GitLab
Lorsque vous travaillez sur une branche avec une demande de fusion GitLab ouverte, Claude Code affiche un badge MR !N cliquable dans l'emplacement du pied de page qui contient autrement le lien GitHub PR. !N est la syntaxe de référence propre à GitLab pour le numéro de demande de fusion N. Le soulignement coloré affiche l'état de la demande de fusion :
- Vert : GitLab signale que la demande de fusion est fusionnable
- Jaune : tout autre état ouvert
- Gris : brouillon
Le badge disparaît une fois que la demande de fusion est fusionnée ou fermée.
Il se rafraîchit dès qu'un git push, ou une commande glab mr qui modifie la demande de fusion, comme glab mr create ou glab mr merge, réussit dans la session.
Pour obtenir le badge, vous avez besoin de :
- Claude Code v2.1.234 ou version ultérieure
- Un distant de référentiel qui pointe vers votre hôte GitLab, soit gitlab.com, soit une instance auto-gérée
- La CLI
glabsur votrePATH, authentifiée avecglab auth login
Claude Code ignore les variables d'environnement du jeton de glab, comme GITLAB_TOKEN, lorsqu'il vérifie le statut, donc vous n'obtenez aucun badge à partir d'un jeton exporté seul. Claude Code recherche également glab et sa connexion une fois par session, donc redémarrez Claude Code après avoir installé glab ou exécuté glab auth login.
Liens de référence aux problèmes
Lorsque Claude mentionne un problème sous la forme owner/repo#123, vous pouvez cliquer sur la référence pour l'ouvrir, à condition que votre terminal supporte les hyperliens. Si Claude Code ne détecte pas la prise en charge des hyperliens dans votre terminal, définissez FORCE_HYPERLINK sur 1 pour activer les liens, ou sur 0 pour conserver les références sous forme de texte brut.
Vous n'obtenez un lien que pour la forme à deux parties owner/repo#123. Ceux-ci restent du texte brut :
- Un
#123isolé - Un chemin GitLab imbriqué tel que
group/subgroup/project#123 - Toute référence à l'intérieur d'une portée de code ou d'un bloc de code
- Toute référence dans une réponse de plus d'environ 1 000 lignes ou 100 000 caractères
Claude Code construit le lien pour l'hôte du dépôt qu'il identifie à partir de votre git remote, et non pour le dépôt que la référence nomme :
| L'hôte de votre dépôt | Où owner/repo#123 crée des liens |
|---|---|
| github.com, un hôte GitHub Enterprise, ou tout hôte non listé ci-dessous | https://<host>/owner/repo/issues/123 |
| gitlab.com | https://gitlab.com/owner/repo/-/issues/123 |
| bitbucket.org, codeberg.org, ou gitea.com | Pas de lien ; la référence reste du texte brut |
Voir aussi
- Skills - Invites personnalisées et flux de travail
- Checkpointing - Rembobiner les modifications de Claude et restaurer les états précédents
- Référence CLI - Drapeaux et options de ligne de commande
- Paramètres - Options de configuration
- Gestion de la mémoire - Gestion des fichiers CLAUDE.md