SpyBara
Go Premium

terminal-config.md 2026-11-09 23:02 UTC to 2026-11-10 21:57 UTC

This page contains 1 addition and 1 deletion.

2026
Fri 6 23:01 Tue 10 21:57 Fri 13 02:00

Configurer votre terminal pour Claude Code

Corrigez Shift+Enter pour les sauts de ligne, recevez une sonnerie du terminal lorsque Claude termine, configurez tmux, harmonisez le thème de couleurs et activez le mode Vim dans la CLI de Claude Code.

Claude Code fonctionne dans n'importe quel terminal sans configuration. Cette page s'adresse aux cas où quelque chose de précis ne se comporte pas comme vous l'attendez. Trouvez votre symptôme ci-dessous. Si tout vous semble déjà correct, vous n'avez pas besoin de cette page.

Cette page explique comment faire en sorte que votre terminal envoie les bons signaux à Claude Code. Pour modifier les touches auxquelles Claude Code lui-même répond, consultez plutôt raccourcis clavier.

Saisir des prompts multilignes

Appuyer sur Enter envoie votre message. Pour ajouter un saut de ligne sans envoyer, appuyez sur Ctrl+J, ou tapez \ puis appuyez sur Enter. Les deux méthodes fonctionnent dans tous les terminaux, sans aucune configuration.

Dans la plupart des terminaux, vous pouvez également appuyer sur Shift+Enter, mais la prise en charge varie selon l'émulateur de terminal :

Terminal Shift+Enter pour un saut de ligne
Ghostty, Kitty, iTerm2, WezTerm, Warp, Apple Terminal, Windows Terminal Fonctionne sans configuration
Autres terminaux prenant en charge le protocole clavier kitty, tels que foot et Alacritty 0.16 ou version ultérieure Fonctionne sans configuration. Nécessite Claude Code v2.1.269 ou version ultérieure
VS Code, Cursor, Devin Desktop, Alacritty antérieur à 0.16, Zed Exécuter /terminal-setup une fois
gnome-terminal, IDE JetBrains tels que PyCharm et Android Studio Non disponible ; utilisez Ctrl+J ou \ puis Enter

Pour VS Code, Cursor, Devin Desktop, Alacritty antérieur à 0.16 et Zed, /terminal-setup écrit un raccourci clavier Shift+Enter dans le fichier de configuration du terminal. Lors de la première exécution, une confirmation telle que Installed VSCode terminal Shift+Enter key binding s'affiche. Les raccourcis existants sont conservés ; si vous voyez un message tel que VSCode terminal Shift+Enter key binding already configured, aucune modification n'a été effectuée. Exécutez /terminal-setup directement dans le terminal hôte plutôt que dans tmux ou screen, car la commande doit écrire dans la configuration du terminal hôte.

Dans VS Code, Cursor et Devin Desktop, /terminal-setup met également à jour deux paramètres de l'éditeur : il définit terminal.integrated.gpuAcceleration sur "off" pour éviter l'affichage de texte corrompu dans le terminal intégré, et il définit terminal.integrated.mouseWheelScrollSensitivity pour un défilement plus fluide en mode plein écran. Pour annuler la modification de l'accélération GPU, redéfinissez-la sur "auto" et rechargez la fenêtre de l'éditeur.

Dans Zed, /terminal-setup met à jour votre keymap.json directement :

  • Si le keymap contient déjà des raccourcis et qu'aucun d'entre eux n'est un shift-enter de Terminal, Claude Code en crée d'abord une copie de sauvegarde dans le même répertoire, par exemple keymap.json.1a2b3c4d.bak, puis fusionne le raccourci Shift+Enter dans votre keymap, en conservant vos autres raccourcis clavier et vos commentaires
  • Si Claude Code ne parvient pas à lire ou à analyser le keymap, à le sauvegarder ou à vérifier le résultat de la fusion, il laisse le fichier inchangé et affiche le bloc de raccourci clavier à ajouter vous-même

Si vous travaillez dans tmux, Shift+Enter nécessite également la configuration tmux ci-dessous, même lorsque le terminal externe le prend en charge.

Pour associer le saut de ligne à une autre touche, ou pour inverser le comportement afin qu'Enter insère un saut de ligne et que Shift+Enter envoie le message, mappez les actions chat:newline et chat:submit dans votre fichier de raccourcis clavier.

Activer les raccourcis de la touche Option sur macOS

Certains raccourcis de Claude Code utilisent la touche Option, comme Option+Enter pour insérer une nouvelle ligne ou Option+P pour changer de modèle. Sur macOS, la plupart des terminaux n'envoient pas Option comme modificateur par défaut, de sorte que ces raccourcis ne font rien tant que vous ne l'avez pas activé. Le paramètre du terminal correspondant est généralement intitulé « Use Option as Meta Key » ; Meta est le nom historique Unix de la touche aujourd'hui appelée Option ou Alt.

[tab] Apple Terminal

Ouvrez Settings → Profiles → Keyboard et cochez « Use Option as Meta Key ».

Si vous avez accepté le prompt de configuration du terminal proposé au premier lancement de Claude Code, c'est déjà fait. Ce prompt exécute /terminal-setup pour vous, ce qui active Option comme Meta et désactive la sonnerie audible dans votre profil Apple Terminal.

En mode lecteur d'écran, /terminal-setup laisse le paramètre de sonnerie inchangé afin que la sonnerie du terminal reste audible. Si une exécution précédente a désactivé la sonnerie, réactivez-la sous Settings → Profiles → Advanced → « Audible bell ».

[tab] iTerm2

Ouvrez Settings → Profiles → Keys → General et définissez Left Option key et Right Option key sur « Esc+ ».

L'exécution de /terminal-setup dans iTerm2 active « Applications in terminal may access clipboard » sous Settings → General → Selection afin que la commande /copy puisse écrire dans le presse-papiers de votre système. La commande détecte iTerm2 même lorsqu'elle est exécutée depuis tmux. Redémarrez iTerm2 pour que la modification prenne effet.

[tab] VS Code

Ajoutez "terminal.integrated.macOptionIsMeta": true à vos paramètres VS Code.

Pour Ghostty, Kitty et les autres terminaux, recherchez un paramètre Option-as-Alt ou Option-as-Meta dans le fichier de configuration du terminal.

Obtenir une cloche de terminal ou une notification

Lorsque Claude termine une tâche ou s'arrête pour une demande de permission, et que vous semblez être absent du terminal, il déclenche un événement de notification. Consultez quand chaque type de notification se déclenche pour connaître le moment exact. Afficher cela comme une cloche de terminal ou une notification de bureau vous permet de passer à d'autres tâches pendant qu'une longue tâche s'exécute.

Par défaut, Claude Code envoie une notification de bureau dans certains terminaux, et un caractère de cloche ou rien du tout dans d'autres :

  • Ghostty, Kitty et iTerm2, lorsque Claude Code les détecte : une notification de bureau, qu'iTerm2 n'affiche qu'après l'activation de ses paramètres d'alerte.
  • Apple Terminal : aucun son ; un caractère de cloche silencieux lorsque Claude Code détecte que « Audible bell » est désactivé dans le profil de la fenêtre Terminal au premier plan, sinon rien. Ce caractère de cloche s'affiche sous forme de clignotement de la fenêtre, ou de rebond dans le Dock lorsque Terminal est en arrière-plan, si l'option « Visual bell » ou de rebond dans le Dock de ce profil est activée.
  • Autres terminaux : rien.

Pour que Claude Code envoie le caractère de cloche quel que soit le terminal ou le profil, définissez preferredNotifChannel sur "terminal_bell". Dans Apple Terminal, activez également Audible bell sous Settings > Profiles > Advanced pour l'entendre. L'entrée de paramètres suivante définit le canal :

{
  "preferredNotifChannel": "terminal_bell"
}

Via SSH depuis un terminal exécuté en dehors de tmux, définissez preferredNotifChannel sur la valeur de votre terminal local, "iterm2", "kitty" ou "ghostty", sur la machine qui exécute Claude Code. La notification de bureau atteint alors votre machine locale. Ghostty et Kitty la transmettent à votre centre de notifications du système d'exploitation sans configuration supplémentaire. iTerm2 vous demande d'activer la transmission :

1. Ouvrir les paramètres de notification d'iTerm2

Allez à Paramètres → Profils → Terminal.

2. Activer les alertes

Cochez « Notification Center Alerts », puis cliquez sur « Filter Alerts » et activez « Send escape sequence-generated alerts ».

Si les notifications n'apparaissent toujours pas, confirmez que votre application de terminal dispose de la permission de notification dans les paramètres de votre système d'exploitation, et si vous exécutez tmux, activez la transmission.

Jouer un son avec un hook Notification

Dans n'importe quel terminal, vous pouvez configurer un hook Notification pour jouer un son ou exécuter une commande personnalisée lorsque Claude a besoin de votre attention. Les hooks s'exécutent aux côtés de la notification intégrée plutôt que de la remplacer, de sorte que les terminaux qui ne reçoivent pas de notification de bureau, comme Warp ou le terminal intégré de VS Code, peuvent utiliser un hook ou définir preferredNotifChannel sur "terminal_bell" à la place.

L'exemple ci-dessous joue un son système sur macOS. Le guide lié contient des commandes de notification de bureau pour macOS, Linux et Windows.

{
  "hooks": {
    "Notification": [
      {
        "hooks": [{ "type": "command", "command": "afplay /System/Library/Sounds/Glass.aiff" }]
      }
    ]
  }
}

Voir le statut de la session dans votre terminal

Si votre terminal implémente le protocole OSC 7501 Program Status Protocol, il peut indiquer si chaque session interactive de Claude Code est en cours de travail, en attente de votre intervention ou terminée, ce qui est utile lorsque vous exécutez des tâches longues ou plusieurs sessions à la fois. Il n'y a rien à activer dans Claude Code. Pour savoir si votre terminal implémente le protocole et où il affiche le statut, consultez sa documentation.

Si c'est le cas et que vous ne voyez aucun statut pour une session, vérifiez chacune de ces causes :

  • Version de Claude Code : le signalement du statut nécessite Claude Code v2.1.295 ou une version ultérieure. Exécutez claude --version dans votre shell pour vérifier.
  • tmux : dans tmux, Claude Code vérifie la prise en charge auprès de tmux plutôt que de votre terminal, et allow-passthrough n'a aucun effet sur ce point. Démarrez la session en dehors de tmux.
  • Session en arrière-plan : une session en arrière-plan ne signale pas son statut à votre terminal, même lorsque vous y êtes attaché. La vue agent affiche son statut à la place.
  • CLAUDE_CODE_DISABLE_TERMINAL_TITLE : si vous définissez cette variable sur 1, Claude Code ne vérifie pas la prise en charge et ne signale pas le statut. Supprimez-la.

Le titre de l'onglet ne commence pas par un glyphe de statut dans un terminal qui signale sa prise en charge du protocole. Le terminal affiche lui-même l'état de la session ; Claude Code omet donc le glyphe qu'il place devant le titre dans les autres terminaux.

Configurer tmux

Lorsque Claude Code s'exécute dans tmux, Shift+Enter envoie par défaut le message au lieu d'insérer un saut de ligne, et les notifications de bureau n'atteignent pas le terminal externe. Ajoutez ces lignes à ~/.tmux.conf, puis exécutez tmux source-file ~/.tmux.conf pour les appliquer au serveur en cours d'exécution :

set -g allow-passthrough on
set -g focus-events on
set -s extended-keys on
set -as terminal-features 'xterm*:extkeys'

Pour envoyer des notifications depuis un volet visible vers le terminal externe, conservez la ligne allow-passthrough et définissez preferredNotifChannel sur "iterm2", "kitty" ou "ghostty". Avec cet exemple, un volet situé dans une fenêtre que vous ne consultez pas n'en envoie aucune. Les lignes extended-keys permettent à tmux de distinguer Shift+Enter d'un simple Enter afin que le raccourci de saut de ligne fonctionne.

L'Image d'un mod nécessite les lignes allow-passthrough et focus-events, ainsi que les autres prérequis pour dessiner dans tmux. Après avoir ajouté ces lignes, détachez-vous également de tmux, rattachez-vous, puis redémarrez Claude Code.

Corriger la suppression d'un mot entier avec Retour arrière sur Windows

Sur Windows, Claude Code lit un Retour arrière qui arrive sous la forme ^H comme Ctrl+Retour arrière, ce qui supprime le mot précédent, sauf quand TERM_PROGRAM est mintty ou TERM est cygwin. Sur macOS et Linux, Claude Code le lit comme un simple Retour arrière.

Si chaque appui sur Retour arrière supprime un mot entier, votre terminal envoie ^H pour un simple Retour arrière. Définissez CLAUDE_CODE_BS_AS_CTRL_BACKSPACE=0. Retour arrière et Ctrl+H effacent alors chacun un caractère. Si Ctrl+Retour arrière efface seulement un caractère sur macOS ou Linux parce que votre terminal envoie ^H pour cela, définissez plutôt la variable à 1.

Adapter le thème de couleurs

Utilisez la commande /theme, ou le sélecteur de thème dans /config, pour choisir un thème Claude Code adapté à votre terminal. L'option auto détecte l'arrière-plan clair ou sombre de votre terminal, de sorte que le thème suit les changements d'apparence du système d'exploitation dès que votre terminal les suit. Claude Code ne contrôle pas le jeu de couleurs propre au terminal, qui est défini par l'application de terminal.

Pour personnaliser ce qui s'affiche en bas de l'interface, configurez une barre de statut personnalisée qui affiche le modèle actuel, le répertoire de travail, la branche git ou d'autres éléments de contexte.

Créer un thème personnalisé

En plus des préréglages intégrés, /theme liste les thèmes personnalisés que vous avez définis ainsi que les thèmes fournis par les plugins installés. Sélectionnez New custom theme… à la fin de la liste pour en créer un de manière interactive : vous nommez le thème, puis choisissez les tokens de couleur individuels à remplacer. Appuyez sur Ctrl+E lorsqu'un thème personnalisé est en surbrillance pour le modifier.

Chaque thème personnalisé est un fichier JSON situé dans ~/.claude/themes/. Le nom du fichier sans l'extension .json constitue le slug du thème, et la sélection du thème enregistre custom:<slug> comme préférence de thème. Le fichier comporte trois champs facultatifs :

Champ Type Description
name string Libellé affiché dans /theme. Par défaut, le slug du nom de fichier
base string Préréglage intégré servant de point de départ au thème : dark, light, dark-daltonized, light-daltonized, dark-ansi ou light-ansi. Par défaut, dark
overrides object Correspondance entre des noms de tokens de couleur et des valeurs de couleur. Les tokens absents de cette liste reprennent la valeur du préréglage de base

Les valeurs de couleur acceptent #rrggbb, #rgb, rgb(r,g,b), ansi256(n) ou ansi:<name>, où <name> est l'un des 16 noms de couleurs ANSI standard, comme red ou cyanBright. Les tokens inconnus et les valeurs de couleur invalides sont ignorés, de sorte qu'une faute de frappe ne peut pas casser le rendu.

L'exemple suivant définit un thème qui conserve le préréglage sombre mais recolore l'accent du prompt, le texte d'erreur et le texte de réussite :

{
  "name": "Dracula",
  "base": "dark",
  "overrides": {
    "claude": "#bd93f9",
    "error": "#ff5555",
    "success": "#50fa7b"
  }
}

Claude Code surveille ~/.claude/themes/ et recharge les thèmes lorsqu'un fichier est ajouté ou modifié, de sorte que les modifications effectuées dans votre éditeur s'appliquent à une session en cours sans redémarrage. Si le dossier ~/.claude/themes/ lui-même n'existait pas au démarrage de Claude Code, redémarrez une fois après avoir créé votre premier fichier de thème. Ensuite, les modifications s'appliquent sans redémarrage.

La référence ci-dessous présente les tokens que vous pouvez définir dans overrides. L'éditeur interactif de /theme affiche les mêmes tokens avec un aperçu en direct, ainsi que quelques accents à usage unique, comme les couleurs de l'écran d'accueil, qui sont omis ici.

[accordion] Référence des tokens de couleur

L'exemple suivant combine des tokens issus de plusieurs des groupes ci-dessous : l'accent de la marque, la bordure du mode plan, les arrière-plans des diffs et l'arrière-plan des messages.

{
  "name": "Midnight",
  "base": "dark",
  "overrides": {
    "claude": "#a78bfa",
    "planMode": "#38bdf8",
    "diffAdded": "#14532d",
    "diffRemoved": "#7f1d1d",
    "userMessageBackground": "#1e1b4b"
  }
}

Couleurs du texte et des accents

Contrôlez l'accent principal de la marque et les nuances de texte de premier plan utilisées dans toute l'interface.

Token Contrôle
claude Accent principal de la marque, utilisé pour l'indicateur de chargement et le libellé de l'assistant
text Texte de premier plan par défaut
inverseText Texte affiché sur un arrière-plan coloré, comme les badges de statut
inactive Texte secondaire comme les indications, les horodatages et les éléments désactivés
subtle Bordures discrètes et texte secondaire atténué
suggestion Suggestions d'autocomplétion et surbrillance de la sélection dans les sélecteurs
permission Bordures des boîtes de dialogue, y compris les demandes de permission et les sélecteurs
remember Indicateurs de mémoire et de CLAUDE.md

Couleurs de statut

Signalez les états de réussite, d'échec et d'avertissement dans les messages et les indicateurs.

Token Contrôle
success Messages de réussite et vérifications réussies
error Messages d'erreur et échecs
warning Avertissements, messages de mise en garde et indicateur du mode auto
merged Statut de pull request fusionnée

Zone de saisie et indicateurs de mode

Définissez la couleur de la bordure de la zone de saisie et l'accent affiché lorsqu'un mode de permission ou un indicateur est actif.

Token Contrôle
promptBorder Bordure de la zone de saisie
planMode Accent du mode plan, messages de plan et boîtes de dialogue du mode plan
autoAccept Accent du mode d'acceptation des modifications
bashBorder Bordure de la zone de saisie lors de la saisie d'une commande shell !
ide Indicateur de connexion à l'IDE
fastMode Indicateur du mode rapide
effortUltra La balise ultracode sur la bordure de la zone de saisie lorsque ultracode est activé. Votre remplacement de cette couleur prend effet à partir de Claude Code v2.1.239

Rendu des diffs

Colorez le code ajouté et supprimé dans les modifications de fichiers et les revues.

Token Contrôle
diffAdded Arrière-plan des lignes ajoutées
diffRemoved Arrière-plan des lignes supprimées
diffAddedDimmed Arrière-plan des lignes ajoutées dans le diff atténué affiché après le rejet d'une modification
diffRemovedDimmed Arrière-plan des lignes supprimées dans le diff atténué affiché après le rejet d'une modification
diffAddedWord Surbrillance au niveau des mots dans une ligne ajoutée
diffRemovedWord Surbrillance au niveau des mots dans une ligne supprimée

Mode plein écran

Claude Code utilise userMessageBackgroundHover, selectionBg et composerSidebarBackground uniquement en mode de rendu plein écran. Il applique userMessageBackground, bashMessageBackgroundColor et memoryBackgroundColor dans le moteur de rendu par défaut comme dans le moteur de rendu plein écran.

Token Contrôle
userMessageBackground Arrière-plan derrière vos messages dans la transcription
userMessageBackgroundHover Arrière-plan derrière un message survolé ou développé
bashMessageBackgroundColor Arrière-plan derrière les entrées de commande shell ! dans la transcription
memoryBackgroundColor Arrière-plan derrière les entrées de mémoire # dans la transcription
selectionBg Arrière-plan du texte sélectionné avec la souris
composerSidebarBackground Arrière-plan du panneau situé à côté de la conversation, comme le panneau de diff ou le volet d'un mod

Jauge d'utilisation et libellés des interlocuteurs

Ajustez la barre affichée dans la vue /usage et les libellés qui distinguent vos messages de ceux de Claude.

Token Contrôle
rate_limit_fill Partie remplie de la jauge d'utilisation
rate_limit_empty Partie non remplie de la jauge d'utilisation
briefLabelYou Couleur du libellé You sur vos messages
briefLabelClaude Couleur du libellé Claude sur les messages de l'assistant

Variantes de scintillement et couleurs des sous-agents

Plusieurs tokens disposent d'une variante de scintillement associée qui fournit la couleur plus claire utilisée dans le dégradé animé de l'indicateur de chargement. Remplacez la variante de scintillement en même temps que son token de base si l'animation semble mal assortie.

  • claude et claudeShimmer
  • warning et warningShimmer
  • permission et permissionShimmer
  • promptBorder et promptBorderShimmer
  • inactive et inactiveShimmer
  • fastMode et fastModeShimmer

Chaque sous-agent et chaque tâche parallèle s'affiche dans l'une des huit couleurs nommées afin que vous puissiez les distinguer dans la transcription. Les noms de tokens suivent le modèle <color>_FOR_SUBAGENTS_ONLY, où <color> vaut red, blue, green, yellow, purple, orange, pink ou cyan. Remplacez-les pour modifier l'apparence de chaque couleur nommée. Par exemple, un sous-agent dont la définition contient color: blue est affiché avec la valeur de blue_FOR_SUBAGENTS_ONLY.

Lorsque ultrathink peut augmenter le niveau d'effort d'un tour, Claude Code affiche le mot dans la zone de saisie du prompt avec un dégradé arc-en-ciel de sept couleurs. Les noms de tokens suivent le modèle rainbow_<color> et rainbow_<color>_shimmer, où <color> vaut red, orange, yellow, green, blue, indigo ou violet.

Basculer vers le rendu en plein écran

En mode lecteur d'écran, cette section ne s'applique pas. Claude Code s'affiche toujours sous forme de texte défilant simple sauf dans les sessions en arrière-plan attachées, et si vous exécutez /tui fullscreen dans toute autre session, Claude Code affiche une explication au lieu de basculer.

Si l'affichage scintille ou la position de défilement saute pendant que Claude travaille, basculez vers le mode de rendu en plein écran. Dans ce mode, vous faites défiler avec la souris ou PageUp à l'intérieur de Claude Code plutôt qu'avec le défilement natif de votre terminal ; consultez la page plein écran pour savoir comment rechercher et copier.

Si le scintillement est le seul problème et que votre terminal prend en charge la sortie synchronisée mais n'est pas détecté automatiquement, comme Emacs eat, définissez CLAUDE_CODE_FORCE_SYNC_OUTPUT=1 pour arrêter le scintillement sans changer de moteur de rendu.

Exécutez /tui fullscreen pour basculer et enregistrer la préférence. Votre conversation redémarre intacte et les futures sessions commencent en plein écran sauf si un démarrage en plein écran échoue. Vous pouvez également définir la variable d'environnement CLAUDE_CODE_NO_FLICKER avant de démarrer Claude Code :

CLAUDE_CODE_NO_FLICKER=1 claude
$env:CLAUDE_CODE_NO_FLICKER = "1"; claude
{
  "env": {
    "CLAUDE_CODE_NO_FLICKER": "1"
  }
}

Limiter la largeur des réponses dans les terminaux larges

Dans un terminal large, chaque ligne de prose dans les réponses de Claude s'étend sur toute la largeur de la fenêtre. Pour envelopper la prose à un nombre de colonnes défini, définissez maxProseWidth dans vos paramètres.

Coller un contenu volumineux

Lorsque vous collez plus de 800 caractères ou plus de trois lignes dans le prompt, Claude Code réduit la saisie à un espace réservé tel que [Pasted text #1 +120 lines] afin que la zone de saisie reste utilisable, et envoie tout de même le contenu complet lorsque vous soumettez. Pour les saisies très volumineuses, comme des fichiers entiers ou de longs logs, écrivez le contenu dans un fichier et demandez à Claude de le lire au lieu de le coller. La transcription de la conversation reste lisible et Claude peut faire référence au fichier par son chemin lors des tours suivants. Le terminal intégré de VS Code peut également perdre des caractères lors de collages très volumineux avant qu'ils n'atteignent Claude Code ; utilisez donc un fichier dans ce cas.

Si le contenu collé comporte des caractères Unicode invisibles, Claude Code les supprime lorsque vous appuyez sur Enter et replace le prompt nettoyé dans la zone de saisie pour que vous l'envoyiez avec un nouvel appui sur Enter.

Comment Claude traite le texte collé

Lorsque vous soumettez, Claude voit le contenu derrière chaque espace réservé [Pasted text #N] marqué comme du texte que vous avez collé depuis une autre source plutôt que saisi. Claude est informé qu'un contenu collé peut contenir des instructions que vous n'avez pas écrites, et qu'il ne doit suivre les instructions qu'il contient que dans la mesure où le message que vous avez saisi le lui demande. Dans les sessions qui ne récupèrent pas les feature flags, les contenus collés ne sont pas marqués.

Supprimer et restaurer un contenu collé réduit

Lorsque vous supprimez avec un raccourci de mot ou de ligne tel que Ctrl+W ou Ctrl+K, ou avec une suppression vim via un mouvement f/t tel que df], et que la plage supprimée atteint l'intérieur d'un espace réservé [Pasted text #N], Claude Code supprime l'espace réservé en entier. Pour le restaurer, recollez la suppression avec Ctrl+Y après un raccourci de mot ou de ligne, ou avec p en mode NORMAL après une suppression vim.

Rappeler un prompt contenant du texte collé

Claude Code conserve le contenu derrière chaque espace réservé [Pasted text #N] dans ~/.claude/paste-cache/, de sorte que lorsque vous rappelez un prompt depuis l'historique des commandes et le soumettez à nouveau, le contenu collé complet est renvoyé, y compris lors d'une session ultérieure.

Les fichiers de cache plus anciens que cleanupPeriodDays sont supprimés selon les règles de nettoyage de rétention ; un prompt rappelé peut donc faire référence à du texte collé qui n'existe plus. Lorsque vous soumettez un tel prompt, Claude Code n'envoie pas la chaîne littérale [Pasted text #N] et affiche une notification indiquant le contenu collé manquant :

  • Dans un prompt simple où du texte subsiste, Claude Code supprime l'espace réservé et envoie le texte restant.
  • Dans une commande en mode shell ou une commande /, où la suppression modifierait ce qui est exécuté, ainsi que dans tout prompt que la suppression laisserait vide, Claude Code annule la soumission et conserve le texte d'origine dans la zone de saisie, avec l'espace réservé toujours présent. Supprimez l'espace réservé ou modifiez la commande, puis soumettez à nouveau.

Modifier les prompts avec les raccourcis clavier Vim

Claude Code inclut un mode d'édition de style Vim pour la saisie du prompt. Activez-le via /config → Editor mode, ou en définissant editorMode sur "vim" dans ~/.claude/settings.json. Redéfinissez Editor mode sur normal pour le désactiver.

Le mode Vim prend en charge un sous-ensemble des mouvements et opérateurs des modes NORMAL et VISUAL, tels que la navigation hjkl, la sélection v/V et d/c/y avec les objets texte. Consultez la référence du mode éditeur Vim pour le tableau complet des touches.

Les mouvements Vim ne peuvent pas être remappés via le fichier de raccourcis clavier. Pour associer une séquence de deux touches en mode INSERT, telle que jj, à Escape, définissez vimInsertModeRemaps dans vos paramètres utilisateur.

Appuyer sur Enter soumet toujours votre prompt en mode INSERT, contrairement à Vim standard. Utilisez plutôt o ou O en mode NORMAL, ou Ctrl+J, pour insérer un saut de ligne.

Ressources connexes

  • Mode interactif : référence complète des raccourcis clavier et tableau des touches Vim
  • Raccourcis clavier : remappez n'importe quel raccourci de Claude Code, y compris Enter et Shift+Enter
  • Rendu plein écran : détails sur le défilement, la recherche et la copie en mode plein écran
  • Guide des hooks : davantage d'exemples de hooks Notification pour Linux et Windows
  • Dépannage : solutions aux problèmes qui ne relèvent pas de la configuration du terminal