Skip to main content

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 mot Alt+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 avec Ctrl+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ée envoie toujours votre invite telle que vous l’avez tapée. Appuyez sur Tab pour insérer la correspondance supérieure, ou choisissez une ligne avec les touches fléchées et Entré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 +2 lorsque plusieurs commandes correspondent. Appuyez sur Tab pour insérer la seule correspondance, ou pour ouvrir la liste lorsque plusieurs correspondent, puis choisissez une ligne avec les touches fléchées et Entrée.
Dans les deux rendus, appuyez sur 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ètre vimInsertModeRemaps 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 :
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.
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 comme d, c et y :

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. 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 /clear dé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 sur Ctrl+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 :
  1. Démarrer la recherche : appuyez sur Ctrl+R pour activer la recherche d’historique inversée
  2. 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
  3. Naviguer dans les correspondances : appuyez à nouveau sur Ctrl+R pour parcourir les correspondances plus anciennes
  4. Étendue de la recherche : la recherche en ligne recherche toujours les invites de tous les projets
  5. Accepter une correspondance :
    • Appuyez sur Tab ou Échap pour accepter la correspondance actuelle et continuer l’édition
    • Appuyez sur Entrée pour accepter et exécuter la commande immédiatement
  6. Annuler la recherche :
    • Appuyez sur Ctrl+C pour annuler et restaurer votre entrée d’origine
    • Appuyez sur Retour arrière sur une recherche vide pour annuler
La recherche en ligne analyse votre historique d’invites complet, du plus récent au plus ancien, avec les doublons réduits à l’occurrence la plus récente. La boîte de dialogue plein écran recherche tout votre historique d’invites dans l’étendue sélectionnée, du plus récent au plus ancien, avec les doublons réduits à l’occurrence la plus récente : les invites les plus récentes apparaissent immédiatement, et les correspondances des invites plus anciennes se remplissent au fur et à mesure que Claude Code charge le reste. Les invites correspondantes s’affichent avec le terme de recherche mis en évidence, afin que vous puissiez trouver et réutiliser les entrées précédentes. Accepter une correspondance ou annuler la recherche prend effet immédiatement, même si Claude Code charge toujours 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+B pour déplacer une invocation d’outil Bash régulière vers l’arrière-plan. Les utilisateurs de Tmux doivent appuyer sur Ctrl+B deux 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. 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 /tasks ou 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 sous setsid ou timeout, 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
  • 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
Pour désactiver toutes les fonctionnalités de tâche en arrière-plan, définissez la variable d’environnement 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 ! :
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+B pour 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 Tab pour 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 sur Tab pour accepter. Utilisez des barres obliques sur Windows également ; la liste déroulante est déclenchée par /, pas \
  • Quittez avec Escape, Backspace, ou Ctrl+U sur 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 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 sur Entré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
Pour envoyer ce que vous avez mis en file d’attente sans attendre, appuyez sur 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
En mode shell, la touche met uniquement votre commande en file d’attente. Dans les terminaux qui ne signalent pas les touches étendues, 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 sur Haut à 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 Tab ou Flèche droite pour placer la suggestion dans l’entrée de prompt, puis Entrée pour soumettre
  • Commencez à taper pour la rejeter
Claude Code génère chacune de ces suggestions de prompt suivant avec une demande en arrière-plan auprès du même modèle que celui utilisé par votre session. La demande compte dans les limites d’utilisation de votre plan ou vos coûts d’API. Parce qu’elle réutilise le cache de prompt de la conversation, il s’agit principalement de lectures du cache plus quelques jetons de sortie, de sorte que le coût supplémentaire est minime.

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_SUGGESTION sur true. Avant la v2.1.238, Claude Code les ignorait près de la limite même avec la variable définie sur true
  • Dans une équipe d’agents, dans les sessions des coéquipiers par défaut. La session du responsable affiche les suggestions
En mode impression, 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 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 promptSuggestionEnabled sur false dans votre fichier de paramètres
  • Définissez la variable d’environnement CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION sur false, qui a la priorité sur le paramètre :
Pour désactiver les suggestions de prompt 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.

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 sur Tab ou Entrée pour insérer l’emoji en surbrillance
Le code court doit commencer l’entrée ou suivre un espace, donc un : à 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’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 .cmd qu’un gestionnaire de paquets installe sur Windows.
  • Pour vérifier que le programme se trouve dans votre PATH, exécutez aspell --version, hunspell --version, ou ispell -v dans votre terminal. Une erreur « command not found » signifie qu’il ne se trouve pas encore dans votre PATH.

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 :
Ajoutez spellcheck à ~/.claude/settings.json. Il s’applique dans chaque projet que vous ouvrez, comme le reste de vos paramètres utilisateur :
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, ou ispell. Claude Code ne revient pas à un vérificateur que vous nommez, et traite toute autre valeur comme auto.
  • language : un nom de dictionnaire dans la forme de votre vérificateur, tel que en_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 que yellow, ou une valeur #rrggbb, #rgb, rgb(r,g,b), ansi256(n), ou ansi:<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 :
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 checker est 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 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 que Removed 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
Lorsque le panneau ne peut pas s’ouvrir, /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+Haut et Alt+Bas, ou Ctrl+Haut et Ctrl+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ère pour le supprimer. Nécessite Claude Code v2.1.271 ou version ultérieure.
  • 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 B pour 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.
Pour lier des touches à ces actions, consultez Actions du panneau de diff.

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.
Pour rebinder ces touches, consultez Actions de diff.

Questions annexes avec /btw

Utilisez /btw pour poser une question sur votre travail actuel sans l’ajouter à l’historique de la conversation.
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 /btw mê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 sur f pour 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. 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+T pour 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 --resume ou --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_ID pour 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 :
Gardez la session ouverte. Ce qui se passe ensuite dépend de la façon dont l’attente se termine :
  • À la réinitialisation : la ligne affiche continuing shortly, puis Usage 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 sur Entrée pour 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 /model pendant 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é. Sous opusplan et 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.
La tâche continuée s’exécute comme n’importe quel autre tour. Claude Code demande toujours les permissions comme d’habitude, de sorte que la tâche peut s’arrêter sur une invite pendant que vous êtes absent. S’il atteint à nouveau la limite, Claude Code réarme l’attente automatiquement 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 É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, /resume une 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-options continue à compter à rebours.
  • La continuation est bloquée : un hook UserPromptSubmit qui 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. opusplan et 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.
Dans ces cas, et chaque fois que la continuation automatique est désactivée, Claude Code ouvre le menu des options de limite d’utilisation une fois par fenêtre de réinitialisation quand vous atteignez une limite à votre propre terminal. Choisissez la ligne qui commence par Wait here, then continue automatically pour démarrer l’attente. Dans une session Remote Control ou agent team teammate, exécutez /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
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.
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_TOKEN ou GITHUB_TOKEN, ou le jeton enregistré par gh auth login. Sans celui-ci, le pied de page affiche install gh for PR status lorsque la CLI gh n’est pas installée, ou gh auth login for PR status lorsqu’elle l’est
  • Un hôte GitHub Enterprise défini comme GH_HOST : GH_ENTERPRISE_TOKEN ou GITHUB_ENTERPRISE_TOKEN, ou le jeton enregistré par gh 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 glab sur votre PATH, authentifiée avec glab 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. 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 #123 isolé
  • 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
Claude Code construit le lien pour l’hôte du référentiel qu’il identifie à partir de votre git remote, et non pour le référentiel que la référence nomme :

Voir aussi