Raccourcis clavier
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 de la touche Option/Alt (Alt+B, Alt+F, Alt+D, Alt+Y, Alt+P) nécessitent de configurer Option en tant que Meta dans votre terminal. Consultez Activer les raccourcis de la touche Option sur macOS pour le paramètre dans chaque terminal.Contrôles généraux
Édition de texte
Limites de mots dans les raccourcis d’édition
Les raccourcis de motAlt+B, Alt+F, Alt+D, Option+Delete et Ctrl+Backspace traitent un mot comme une suite de lettres et de chiffres, donc la ponctuation telle que _, . et / sépare les mots. Avec src/utils/foo.ts dans le prompt, les appuis répétés de 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 blanc précédent, donc une pression supprime tout src/utils/foo.ts.
Dans le texte écrit sans espaces, comme le chinois ou le japonais, les raccourcis de mot se 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 obsolète et n’a aucun effet.
Vous ne pouvez pas remapper ces raccourcis dans le fichier de configuration des liaisons de clavier, qui n’a pas d’actions pour eux.
Thème et affichage
Entrée multiligne
Commandes rapides
Visionneuse de transcription
Lorsque la visionneuse de transcription est ouverte (basculée avecCtrl+O), ces raccourcis sont disponibles. Exécutez /tui sans argument pour vérifier quel rendu est actif. Ctrl+E peut être remappé via transcript:toggleShowAll.
Entrée vocale
Commandes
Tapez/ dans Claude Code pour voir les commandes disponibles, ou tapez / suivi de n’importe quelles lettres pour filtrer. Le menu / répertorie les commandes intégrées, les compétences créées par les utilisateurs et groupées, ainsi que les commandes contribué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 plan, et quelques commandes disponibles sont masquées du menu par conception et s’exécutent lorsque vous tapez leur nom complet.
Dans le rendu en plein écran, la liste des commandes / et des suggestions de fichiers @ répondent également à la souris : le survol met en évidence une ligne et le clic l’accepte.
Consultez la référence des commandes pour la liste complète des commandes incluses dans Claude Code.
Compléter une commande au milieu d’une invite
La complétion de commande fonctionne également au milieu d’une invite : tapez/ après un espace, puis les premières lettres d’un nom, comme dans exécuter les tests, puis /com. Seules les commandes dont les noms commencent par ces lettres correspondent, donc un chemin de fichier tel que /tmp/notes.md ne maintient pas une liste ouverte. Claude Code exécute une commande lui-même uniquement lorsque la commande commence votre message.
- Dans le rendu en plein écran : les correspondances s’ouvrent sous forme de liste pendant que vous tapez, sans ligne en surbrillance, donc
Entréeenvoie toujours votre invite telle que vous l’avez tapée. Appuyez surTabpour insérer la correspondance supérieure, ou choisissez une ligne avec les touches fléchées etEntrée. - En dehors du plein écran : le reste de la correspondance supérieure apparaît sous forme de texte fantôme à votre curseur, avec un décompte tel que
+2lorsque plusieurs commandes correspondent. Appuyez surTabpour insérer la seule correspondance, ou pour ouvrir la liste lorsque plusieurs correspondent, puis choisissez une ligne avec les touches fléchées etEntrée.
Tab sur un / nu au milieu d’une invite pour lister chaque commande.
Une compétence de plugin correspond également sur son nom nu, donc /deploy trouve une compétence nommée myplugin:deploy-app. Lorsque vous insérez la correspondance, Claude Code écrit le /myplugin:deploy-app complet.
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
Remapper les séquences de touches en mode INSERT
Le paramètrevimInsertModeRemaps mappe une séquence de deux touches en mode INSERT à Échap, donc un mappage comme jj vous ramène en mode NORMAL. Nécessite Claude Code v2.1.208 ou ultérieur.
L’exemple ~/.claude/settings.json suivant active le mode vim et mappe jj à Échap :
"<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)
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/k et ↑/↓ naviguent dans l’historique des commandes à la place. ← sur une invite vide ouvre la vue agent à partir du mode NORMAL ainsi que INSERT ; avant v2.1.219, ← sur une invite vide ne faisait rien en mode NORMAL.Édition (mode NORMAL)
Objets texte (mode NORMAL)
Les objets texte fonctionnent avec les opérateurs commed, c et y :
Mode visuel
Appuyez surv 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.
Le mode visuel par bloc avec
Ctrl+V n’est pas pris en charge.
Historique des commandes
Claude Code conserve un historique des invites que vous tapez, et le rappel avec la flèche vers le haut récupère les invites des sessions précédentes du même projet :- L’historique des entrées est stocké par répertoire de travail
- L’exécution de
/cleardémarre une nouvelle session : le rappel liste ensuite les invites de la nouvelle session en premier, avec les invites des sessions antérieures après. La conversation de la session précédente est conservée et peut être reprise. - Soumettre deux fois la même invite d’affilée enregistre une seule entrée d’historique, donc appuyer sur Haut accède à l’invite distincte précédente
- Lorsque vous rappelez une invite qui incluait du texte collé, Claude Code envoie à nouveau le contenu collé complet lors de la resoumission. 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 qui se passe avec l’invite - L’expansion d’historique avec
!est désactivée par défaut
Recherche inversée avec Ctrl+R
Appuyez surCtrl+R pour rechercher interactivement dans votre historique de commandes. En rendu plein écran, Ctrl+R ouvre une boîte de dialogue de recherche à la place : tapez pour filtrer, appuyez sur Haut et Bas pour vous déplacer dans les correspondances, et appuyez sur Ctrl+S pour faire défiler l’étendue entre cette session, ce projet et tous les projets. Appuyez sur Entrée ou Tab pour placer une correspondance dans l’entrée d’invite, ou Échap 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 d’historique inversée - Tapez la requête : entrez le texte à rechercher dans les commandes précédentes. Le terme de recherche est mis en évidence dans les résultats correspondants
- Naviguer dans les correspondances : appuyez à nouveau sur
Ctrl+Rpour parcourir les correspondances plus anciennes - Étendue de la recherche : la recherche en ligne recherche toujours les invites de tous les projets
- Accepter une correspondance :
- Appuyez sur
TabouÉchappour accepter la correspondance actuelle et continuer l’édition - Appuyez sur
Entréepour accepter et exécuter la commande immédiatement
- Appuyez sur
- Annuler la recherche :
- Appuyez sur
Ctrl+Cpour annuler et restaurer votre entrée d’origine - Appuyez sur
Retour arrièresur une recherche vide pour annuler
- Appuyez sur
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.
sleep. Pour modifier la durée pendant laquelle les commandes s’exécutent avant que cela ne se produise, 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 termine les 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. Nécessite Claude Code v2.1.193 ou version ultérieure
- 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 appartenant à un sous-agent n’ont pas de limite de temps, sauf qu’une commande appartenant à un sous-agent s’exécutant au premier plan se termine lorsque ce sous-agent donne sa réponse finale ; voir Commandes en arrière-plan dans la référence des outils. Avant v2.1.218, ni la récolte de pression mémoire ni la limite de 60 minutes ne couvraient les commandes déplacées vers l’arrière-plan avec
Ctrl+B
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS sur 1. Voir Variables d’environnement pour plus de détails.
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 ! :
- 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 à partir de v2.1.193 sur toutes les plates-formes : 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é
! npm test et obtenir une explication des défaillances sans une deuxième invite. La réponse coûte la même chose que l’envoi d’une invite normale. Pour restaurer le comportement antérieur où la sortie est ajoutée au contexte sans réponse, définissez respondToBashCommands sur false dans settings.json. Avant v2.1.186, le mode shell ajoutait toujours la sortie au contexte sans réponse.
Mettre en file d’attente les messages pendant que Claude travaille
Tapez un message et appuyez surEntrée 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’à ce qu’il les envoie. Vous pouvez mettre en file d’attente les commandes ! shell et la plupart des commandes de la même manière, à l’exception des commandes, telles que /status, que Claude Code exécute dès que vous les envoyez.
Les messages envoyés et mis en file d’attente s’affichent en gris jusqu’à ce que Claude commence à y répondre, vous pouvez donc voir quels messages Claude n’a pas encore commencé à traiter.
Si vous mettez en file d’attente un message avec une sélection attachée à partir d’un IDE connecté ou du panneau de diff, il conserve la sélection que vous aviez quand vous avez appuyé sur Entrée, 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 attente est envoyée par Claude Code 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, dans le même tour. Quand le tour se termine avec des messages toujours en attente, ils s’envoient sans une autre pression de touche, dans l’ordre où vous les avez tapés
- Commandes et commandes shell : Claude Code les conserve jusqu’à la fin du tour, puis les exécute une à une, en conservant l’ordre dans lequel vous les avez mises en file d’attente
Ctrl+Entrée. Vos messages en attente s’envoient immédiatement, avec votre brouillon mis en file d’attente derrière eux si vous en aviez tapé un. Nécessite Claude Code v2.1.275 ou ultérieur.
Si vous aviez mis en file d’attente une commande shell ! avant vos messages, la touche interrompt le tour. Sinon, ce qui se passe au tour dépend de ce que Claude fait quand vous appuyez sur la touche :
- Exécution de commandes shell, de sous-agents ou d’autres travaux qui peuvent passer à l’arrière-plan : ce travail passe à l’arrière-plan et continue de s’exécuter, et Claude lit vos messages dans le même tour
- Uniquement l’écriture d’une réponse, ou l’exécution de quelque chose qui ne peut pas passer à l’arrière-plan : Claude Code interrompt le tour et envoie vos messages ensuite. Avant v2.1.281, la touche interrompait le tour dans les deux cas
Ctrl+Entrée arrive comme un simple Entrée 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 liaisons de l’action chat:sendNow.
Appuyez sur Échap 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, notamment /model, /effort et /fast. Chacune de ces trois commandes modifie un paramètre : le modèle, le niveau d’effort ou le mode rapide. Le moment où Claude Code applique le nouveau paramètre au tour sur lequel Claude travaille déjà, ou uniquement à partir de votre tour suivant, diffère selon la commande :
/model: une fois que vous confirmez l’avertissement de cache, si Claude Code en affiche un, Claude Code applique votre modification à la prochaine requête qu’il effectue dans ce tour/effort: une fois que vous confirmez l’avertissement de cache, si Claude Code en affiche un, Claude Code applique votre modification à la prochaine requête qu’il effectue dans ce tour/fast: Claude Code conserve le paramètre de mode rapide qui était actif au début du tour, donc votre changement de vitesse s’applique à partir de votre tour suivant. Si votre modèle actuel ne supporte pas le mode rapide, l’activer bascule également votre modèle, et Claude Code utilise le nouveau modèle à partir de sa prochaine requête dans ce tour
Récupérer ce que vous avez mis en file d’attente
Appuyez surHaut à partir de la première ligne de la zone de saisie pour récupérer les messages et commandes en attente. Claude Code les supprime 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 Entrée pour le mettre à nouveau en file d’attente en tant qu’une seule entrée, ou videz la zone de saisie pour l’abandonner.
Claude Code récupère les commandes shell en attente uniquement quand la zone de saisie est vide et que vous n’avez rien d’autre en attente, et il bascule la zone de saisie en mode shell quand il le fait. Sinon, il les laisse dans la file d’attente, listées avec leur préfixe !, et les exécute après la fin du tour.
Suggestions de prompt
Lorsque vous ouvrez une session pour la première fois, Claude Code affiche une commande d’exemple grisée dans l’entrée de prompt pour vous aider à démarrer. Il la 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 que Claude réponde, Claude Code peut suggérer votre prochain prompt en fonction de votre historique de conversation, par exemple une étape de suivi d’une demande en plusieurs parties ou une continuation naturelle de votre flux de travail.- Appuyez sur
TabouFlèche droitepour placer la suggestion dans l’entrée de prompt, puisEntréepour soumettre - Commencez à taper pour la rejeter
Quand Claude Code ignore les suggestions
En mode interactif, Claude Code désactive les suggestions de prompt par défaut et masque le bouton bascule Prompt suggestions dans/config dans une session qui ne récupère pas les drapeaux de fonctionnalité, par exemple une session chez un fournisseur tiers ou via une passerelle d’applications Claude, et dans une première session après une installation ou une mise à jour dont les drapeaux ne sont pas encore arrivés.
Claude Code ignore également les suggestions individuelles dans plusieurs situations, notamment :
- Le cache de prompt est froid, pour éviter un coût inutile
- Après le premier tour d’une conversation, dans certaines sessions
- La réponse précédente s’est terminée par une erreur
- Pendant que vous êtes en plan mode
- Votre compte est proche ou à sa limite d’utilisation. Pour maintenir les suggestions activées jusqu’à ce que vous atteigniez la limite, définissez
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTIONsurtrue. Avant la v2.1.238, Claude Code les ignorait près de la limite même avec la variable définie surtrue - Dans une équipe d’agents, dans les sessions des coéquipiers par défaut. La session du responsable affiche les suggestions
--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 un. Le générateur ignore également les conversations très courtes et les caches de prompt froids ici, donc une seule requête -p courte peut n’en émettre aucune.
Désactiver les suggestions de prompt
Pour désactiver complètement les suggestions de prompt, utilisez l’une des options 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 la priorité sur le paramètre :
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.
Codes courts d’emoji
Tapez un: suivi d’un code court d’emoji dans l’entrée de l’invite pour insérer l’emoji. Nécessite Claude Code v2.1.217 ou version ultérieure.
- Tapez un code court complet tel que
:heart:et Claude Code le remplace par ❤️ dès que vous tapez le:de fermeture - Tapez
:plus au moins deux caractères d’un nom, tel que:hea, pour ouvrir une fenêtre contextuelle de suggestion, puis appuyez surTabouEntréepour insérer l’emoji en surbrillance
: à l’intérieur d’un mot ou d’une URL n’ouvre pas de suggestions.
Pour désactiver la fonctionnalité, définissez emojiCompletionEnabled sur false dans settings.json. Cela désactive à la fois la fenêtre contextuelle de suggestion 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’historiqueCtrl+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ètrespellcheck à 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
- Ligne de commande
- Paramètres gérés
Ajoutez
spellcheck à ~/.claude/settings.json. Il s’applique dans chaque projet que vous ouvrez, comme le reste de vos paramètres utilisateur :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.
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, 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
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
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 invites
Le texte collé peut contenir des caractères Unicode qu’un terminal n’affiche pas du tout, comme les caractères de balise, les contrôles bidirectionnels et les espaces de largeur nulle, de sorte qu’une invite peut contenir du texte que vous ne voyez jamais. Pour éviter que le texte copié ne contienne des instructions que votre terminal n’affiche pas, Claude Code supprime ces caractères lorsque vous appuyez sur Entrée, avant d’envoyer quoi que ce soit. Il nettoie à la fois l’invite et le contenu de toute référence de texte collé que l’invite inclut. Claude Code conserve les joineurs que les scripts persan et indique écrivent et les sélecteurs à l’intérieur des séquences emoji. Si Claude Code a supprimé quelque chose, cet Entrée n’envoie rien. L’invite nettoyée revient dans la zone de saisie avec un avis tel queRemoved 3 invisible characters · review and press Enter to send, et appuyer à nouveau sur Entrée envoie le texte tel qu’affiché.
Lorsque vous transmettez une invite sur la ligne de commande, comme dans claude "fix the login bug", ou que vous en canalisez une dans une session interactive, Claude Code n’attend pas un deuxième Entrée. Il supprime les caractères, affiche un avis et envoie l’invite nettoyée. Si l’invite nettoyée commençait par /, Claude Code la place dans la zone de saisie pour que vous la révisiez et l’envoyiez à la place.
Examinez les modifications avec /diff
Exécutez/diff pour examiner les modifications dans votre arborescence de travail sans quitter Claude Code. Vous voyez les modifications que Claude a apportées jusqu’à présent ainsi que tout ce que vous n’avez pas validé.
Dans les modifications que /diff lit à partir de 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.
Dans le rendu en plein écran, /diff ouvre le panneau de diff à côté de la conversation, qui reste ouvert et se met à jour pendant que vous continuez à travailler. Dans le rendu classique, /diff ouvre la visionneuse de diff à la place de l’invite, et vous la fermez une fois que vous avez fini de lire.
Panneau de diff
Le panneau de diff répertorie les fichiers modifiés avec leurs nombres 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 le fermer, exécutez/diff à nouveau ou cliquez sur le ✕ dans son en-tête.
Pour utiliser le panneau, vous avez besoin de :
- Rendu en plein écran
- Un référentiel git
- Un terminal d’au moins 110 colonnes de large
- Claude Code v2.1.260 ou version ultérieure
/diff ouvre la visionneuse de diff à la place ou vous indique pourquoi.
Le panneau s’ouvre également automatiquement une fois que Claude commence à modifier des fichiers, si votre terminal fait au moins 144 colonnes de large. Après l’avoir ouvert vous-même avec /diff, les sessions ultérieures l’ouvrent dès que Claude modifie un fichier dans n’importe quel terminal suffisamment large pour le contenir. Fermez le panneau et il reste fermé, dans cette session et les sessions ultérieures, jusqu’à ce que vous exécutiez /diff à nouveau.
Pendant que 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+HautetAlt+Bas, ouCtrl+HautetCtrl+Bas. - Demander à Claude des lignes spécifiques : sélectionnez-les dans le panneau avec la souris. Claude Code joint la sélection à votre prochaine invite et affiche un nombre de lignes à côté de l’entrée jusqu’à ce que vous l’envoyiez.
- Pour envoyer l’invite sans la sélection, déplacez le curseur juste après l’indicateur de nombre de lignes et appuyez sur
Retour arrièrepour le supprimer. Nécessite Claude Code v2.1.271 ou version ultérieure.
- Pour envoyer l’invite sans la sélection, déplacez le curseur juste après l’indicateur de nombre de lignes et appuyez sur
- Afficher les fichiers que le panneau omet : la liste ignore les fichiers de test et les fichiers générés, et réduit les modifications antérieures à cette session en une seule ligne en bas. Cliquez sur l’une ou l’autre ligne de comptage pour l’étendre.
- Modifier ce que le panneau compare : appuyez sur
Ctrl+X Bpour basculer entre les modifications de cette session, vos modifications non validées sous forme de liste unique, et tout ce qui s’est passé depuis que votre branche s’est séparée de la branche par défaut. Claude Code mémorise le choix pour chaque projet.
Visionneuse de diff
La visionneuse de diff prend la place de l’invite jusqu’à ce que vous la fermiez. Sa vue Actuelle affiche vos modifications non validées de git, ou, s’il n’y en a pas, ce que votre branche ajoute au-dessus de la branche par défaut. La visionneuse a également une vue de tour pour chaque invite après laquelle Claude a modifié des fichiers, affichant uniquement ces modifications. Claude Code construit les vues de tour à partir des modifications de fichiers de Claude plutôt qu’à partir de git, donc une modification que Claude apporte via une commande shell n’apparaît que sous Actuelle. Utilisez ces touches dans la visionneuse :- Gauche et Droite : se déplacer entre Actuelle et les vues de tour.
- Haut et Bas : sélectionner un fichier.
- Entrée : ouvrir le diff du fichier sélectionné. Faites-le défiler avec Haut et Bas, ou PageUp et PageDown.
- Échap : revenir du diff d’un fichier à la liste, ou fermer la visionneuse à partir de la liste.
Questions annexes avec /btw
Utilisez/btw pour poser une question sur votre travail actuel sans l’ajouter à l’historique de la conversation.
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.
/btw sans question. La superposition se rouvre sur votre échange le plus récent. Avant la version 2.1.212, /btw sans question affichait un message d’utilisation à la place.
Une fois que la réponse apparaît, la superposition accepte ces touches.
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 les modèles Claude 3.x, Opus 4 à 4.7, Sonnet 4 à 4.6 et Haiku 4.5. 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. Claude Code limite à la fois les récapitulatifs automatiques et la sortie de /recap à 400 caractères. Pour désactiver les récapitulatifs automatiques, ouvrez /config et désactivez Session recap.
Le récapitulatif de session est activé par défaut pour tous les plans et fournisseurs. Le récapitulatif est toujours ignoré en mode non interactif.
Attendre la réinitialisation d’une limite d’utilisation
Quand une limite d’utilisation de claude.ai arrête Claude au milieu d’une tâche, Claude Code attend dans la session ouverte et continue la tâche automatiquement après la réinitialisation de la limite. La continuation 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 version ultérieure. Pendant que Claude Code attend, une ligne en bas de la session indique quand il continuera :- À la réinitialisation : la ligne affiche
continuing shortly, puisUsage limit reset · continuing automatically, et Claude Code envoie à Claude une invite fixe pour reprendre la tâche où elle s’est arrêtée. Il ne renvoie pas votre dernier message. - Après la mise en veille de votre ordinateur : si elle a duré plus d’environ 30 minutes et que la limite s’est réinitialisée pendant la mise en veille, la ligne affiche
Your usage limit has reset · press enter to continue. Appuyez surEntréepour continuer. Après une mise en veille plus courte, Claude Code continue automatiquement. - Tôt : quand vous terminez l’ajout de crédits d’utilisation avec
/usage-credits, vous reconnectez après/upgrade, ou changez de modèle avec/modelpendant l’attente, Claude Code vérifie si l’utilisation est à nouveau disponible et continue immédiatement si c’est le cas. Il ne vérifie pas après une mise à niveau ou un achat que vous effectuez dans un navigateur de votre côté. Sousopusplanet d’autres paramètres de modèle qui exécutent le mode plan sur un modèle différent, Claude Code attend la réinitialisation à la place.
Automatic continue stopped after repeated usage-limit hits · /rate-limit-options to try again.
Annuler l’attente
Appuyez surÉchap à une invite vide, ou Ctrl+C, pendant que la ligne s’affiche, ou exécutez /rate-limit-options et choisissez Don’t continue automatically. Claude Code confirme avec une ligne qui commence par Automatic continue cancelled.
Après une annulation, rien ne continue jusqu’à ce que vous envoyiez une invite ou que vous choisissiez la ligne qui commence par Wait here, then continue automatically dans /rate-limit-options à nouveau. Claude Code ne démarre pas une attente de son propre chef pour cette fenêtre de réinitialisation ; la prochaine fenêtre de réinitialisation recommence à zéro.
L’attente se termine également sans continuer la tâche dans ces cas :
- Vous envoyez une invite : Claude Code exécute votre invite au lieu d’attendre.
- Vous quittez Claude Code : l’attente ne redémarre pas quand vous reprenez la session.
- La conversation change de mains : vous changez de compte avec
/login, effacez ou rembobinez la conversation,/resumeune autre session, en tirez une avec/teleport, relancez avec/tui, ou remettez la session à Claude Desktop, une session en arrière-plan, ou le cloud. - Le paramètre s’éteint, ou la réinitialisation dépasse 24 heures : cela termine uniquement une attente que Claude Code a démarrée de son propre chef. Une attente que vous avez choisie dans
/rate-limit-optionscontinue à compter à rebours. - La continuation est bloquée : un hook
UserPromptSubmitqui bloque l’invite de continuation, ou une défaillance avant qu’elle n’atteigne le modèle, termine l’attente. Claude Code vous indique que la continuation n’a pas été exécutée. Envoyez une invite pour continuer.
Démarrer une attente vous-même
Claude Code ne démarre pas l’attente de son propre chef dans ces cas :- Sessions Remote Control et agent team teammate : une personne à ce terminal peut toujours en démarrer une.
- Une réinitialisation à plus de 24 heures : une limite hebdomadaire peut se réinitialiser des jours à l’avance.
- Une limite Opus ou Sonnet pendant que vous exécutez un modèle en dehors de cette famille : votre prochain tour peut ne pas atteindre cette limite.
opusplanet d’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.
/rate-limit-options vous-même pour ouvrir le menu.
Claude Code n’offre pas du tout l’attente dans ces cas :
- Sessions en arrière-plan et exécutions
-p: la ligne du menu n’est pas disponible. - Clés API, fournisseurs cloud et facturation basée sur l’utilisation : l’utilisation y est mesurée par demande, il n’y a donc pas de réinitialisation à attendre.
- Une passerelle LLM sans connexion claude.ai enregistrée : Claude Code offre l’attente uniquement quand une connexion claude.ai enregistrée est l’identifiant actif.
Désactiver la continuation 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 peut pas le réactiver, car le paramètre accorde l’exécution sans surveillance. Les fichiers de paramètres que Claude Code lit pour cette clé sont 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
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.
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 badgeMR !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
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
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 formeowner/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
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