- Shift+Enter envoie le prompt au lieu d’insérer un saut de ligne
- Les raccourcis avec la touche Option ne font rien sur macOS
- Aucun son ni alerte lorsque Claude termine
- Vous exécutez Claude Code dans tmux
- Retour arrière supprime un mot entier sous Windows
- L’affichage scintille ou l’historique de défilement saute
- Vous souhaitez utiliser les touches Vim dans le prompt
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 :
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-enterde Terminal, Claude Code en crée d’abord une copie de sauvegarde dans le même répertoire, par exemplekeymap.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
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.- Apple Terminal
- iTerm2
- VS Code
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 ».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.
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 :
~/.claude/settings.json
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 ».
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éfinirpreferredNotifChannel 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.
~/.claude/settings.json
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 --versiondans 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-passthroughn’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 sur1, Claude Code ne vérifie pas la prise en charge et ne signale pas le statut. Supprimez-la.
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 :
~/.tmux.conf
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 :
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 :
~/.claude/themes/dracula.json
~/.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.
Référence des tokens de couleur
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.
~/.claude/themes/midnight.json
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.Couleurs de statut
Signalez les états de réussite, d’échec et d’avertissement dans les messages et les indicateurs.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.Rendu des diffs
Colorez le code ajouté et supprimé dans les modifications de fichiers et les revues.Mode plein écran
Claude Code utiliseuserMessageBackgroundHover, 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.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.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.claudeetclaudeShimmerwarningetwarningShimmerpermissionetpermissionShimmerpromptBorderetpromptBorderShimmerinactiveetinactiveShimmerfastModeetfastModeShimmer
<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 :
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éfinissezmaxProseWidth 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 queCtrl+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