Build This Now
Build This Now
Qu'est-ce que le code Claude ?Installer Claude CodeL'installateur natif de Claude CodeTon premier projet Claude Code
Configuration de Claude CodeGuide de configuration du terminal pour Claude CodeLe sandboxing de Claude CodeRéférence des paramètres de Claude Code
speedy_devvkoen_salo
Blog/Handbook/Setup/Claude Code Terminal Setup Guide

Guide de configuration du terminal pour Claude Code

Adapte les thèmes, active Shift+Entrée, configure les notifications, corrige la troncature des longs collages, et active le mode vim dans iTerm2, WezTerm, Ghostty, Kitty et d'autres terminaux.

Arrêtez de configurer. Commencez à construire.

Templates SaaS avec orchestration IA.

Published Mar 27, 2026Handbook hubSetup index

La façon dont tu configures ton terminal détermine le temps que tu gagnes vraiment avec Claude Code. Les réglages par défaut fonctionnent bien. Ils laissent aussi beaucoup sur la table. Une mauvaise gestion des sauts de ligne te coince dans des prompts sur une seule ligne. L'absence de notifications t'envoie à la cuisine pour un café qui refroidit pendant que Claude attend. Et si tu as déjà collé un snippet de 200 lignes pour le voir revenir à moitié mangé, le problème t'est déjà familier.

Voici tous les réglages qui valent la peine d'être touchés. Correspondance de thème, saisie multi-lignes, alertes, gestion des longs collages, mode vim, et les particularités des terminaux que les vrais développeurs utilisent.

Correspondance de thème

Ton terminal possède ses propres couleurs. Claude Code ne peut pas les changer, et il n'essaie pas. Ce qu'il peut faire, c'est aligner sa palette interne avec le schéma que ton terminal utilise.

Dans Claude Code, lance /config et choisis l'option de thème. La coloration syntaxique, les marqueurs d'état et l'interface s'adaptent pour s'afficher proprement sur un fond clair ou sombre.

Le même flux /config te permet de configurer une barre de statut personnalisée. Cette bande en bas du terminal affiche le contexte que tu veux avoir sous la main. Modèle, répertoire de travail, branche git. Pas besoin de commandes supplémentaires pour les vérifier.

Un point à noter. Si tu passes du clair au sombre pendant la journée, relance /config après chaque changement. Le thème ne se met pas à jour tout seul.

Méthodes de saisie multi-lignes

Les prompts sur une seule ligne te limitent. Tout ce qui a du détail, du code, une demande en plusieurs étapes, se lit mieux sur plusieurs lignes. Quatre façons d'y arriver dans Claude Code.

Méthode 1 : Backslash + Entrée (fonctionne partout)

Tape un \ puis appuie sur Entrée. Ça te fait passer à la ligne suivante. Tous les terminaux sur tous les systèmes d'exploitation l'honorent, ce qui en fait la solution de secours quand rien d'autre n'est configuré.

Ça paraît maladroit. Ça ne rate jamais non plus. Utilise-le quand tu es en SSH sur une machine ou que tu travailles dans un terminal que tu ne contrôles pas.

Méthode 2 : Shift+Entrée (support natif)

Quatre terminaux gèrent Shift+Entrée sans aucune configuration :

  • iTerm2
  • WezTerm
  • Ghostty
  • Kitty

Si tu utilises l'un d'eux, le raccourci fonctionne déjà. Rien à activer. C'est la plus naturelle des quatre options car toutes les fenêtres de chat et éditeurs de texte se comportent déjà de la même façon.

Méthode 3 : /terminal-setup (auto-configuration)

Quand un terminal ne connaît pas Shift+Entrée par lui-même, Claude Code peut le configurer pour toi. Tape /terminal-setup depuis Claude Code et la liaison est configurée automatiquement.

La commande sait gérer :

  • Le terminal intégré de VS Code
  • Alacritty
  • Zed
  • Warp

Bon à savoir. La commande /terminal-setup n'apparaît pas du tout si tu es déjà sur un terminal avec support natif (iTerm2, WezTerm, Ghostty, Kitty). Elle ne s'affiche que quand il y a une configuration à faire.

Redémarre ton terminal une fois /terminal-setup terminé. La liaison prend effet au prochain lancement.

Méthode 4 : Option+Entrée (Mac)

macOS propose Option+Entrée comme autre touche de saut de ligne. L'activer est une modification ponctuelle, et le menu à modifier dépend du terminal que tu utilises.

Pour Mac Terminal.app :

  1. Ouvre Préférences, puis Profils, puis Clavier
  2. Coche "Use Option as Meta Key"

Pour iTerm2 et le terminal VS Code :

  1. Ouvre Préférences, puis Profils, puis Touches
  2. Sous Général, règle la touche Option gauche/droite sur "Esc+"

Option+Entrée vaut surtout si Option fait déjà partie de ta mémoire musculaire pour les modificateurs. L'avantage, c'est que Shift reste libre pour sélectionner du texte.

Notifications

Une tâche difficile dans Claude Code peut durer des minutes. Sans alertes, tu fixes l'écran ou tu t'éloignes et tu oublies de revenir. Les bonnes notifications éliminent les deux problèmes.

Notifications système iTerm2

iTerm2 est livré avec des bannières macOS natives pour les tâches longues :

  1. Ouvre les Préférences d'iTerm2
  2. Va dans Profils, puis Terminal
  3. Active "Silence bell"
  4. Sous Filtres d'alertes, active "Send escape sequence-generated alerts"
  5. Règle le délai de notification souhaité

Une fois activé, macOS affiche une bannière chaque fois que Claude finit un travail lent. Les alertes se déclenchent même quand iTerm2 est minimisé ou que tu es passé à une autre app.

À noter. Ce chemin est réservé à iTerm2. Le Terminal.app macOS standard ne l'offre pas.

Hooks de notification personnalisés

Pour une logique d'alerte plus élaborée, Claude Code accepte des hooks de notification personnalisés. Tu écris ton propre chemin de code qui s'exécute sur un événement donné. Poster sur Slack. Déclencher une sonnerie. Envoyer un webhook.

Les hooks vivent dans le système de hooks général de Claude Code. Configure-les pour se déclencher à la fin d'une tâche, sur des erreurs, ou sur n'importe quel pattern de sortie qui t'intéresse.

Gestion des grandes entrées

Coller un long bloc de code ou une spec volumineuse directement dans Claude Code finit mal. Le tampon de collage de la plupart des terminaux a une limite, et la dépasser transforme ton texte en morceau tronqué.

Trois règles pour les grandes entrées :

1. Ne colle pas directement. Dès que tu dépasses environ 100 lignes, sauvegarde d'abord dans un fichier. Puis indique à Claude Code ce fichier et dis-lui de le lire.

2. Surveille le terminal de VS Code. Le terminal intégré dans VS Code coupe les longs collages plus agressivement que la plupart. Si VS Code est ta maison principale, la méthode par fichier n'est pas optionnelle. C'est le seul moyen que quelque chose de plus long qu'un court prompt passe intact.

3. Découpe la demande. Plutôt que de balancer toute une spec, divise-la en morceaux. Donne un morceau à Claude Code, vérifie la sortie, puis passe au suivant.

Mode Vim

Si tes doigts tournent déjà en hjkl, Claude Code t'a prévu ça. Il y a un mode vim intégré qui câble un sous-ensemble des liaisons vim normales dans la zone de saisie.

Activer le mode Vim

Deux façons de le basculer :

  • Tape /vim dans Claude Code pour activer le mode vim immédiatement
  • Ouvre /config et active le mode vim dans les paramètres (celui-ci persiste entre les sessions)

Une fois activé, tu démarres en mode NORMAL. L'indicateur de mode habituel apparaît dans la zone de saisie pour que tu saches toujours dans quel mode tu es.

Référence des raccourcis clavier

Changement de mode :

ToucheAction
EscPasser en mode NORMAL
iInsérer avant le curseur
IInsérer au début de la ligne
aInsérer après le curseur
AInsérer à la fin de la ligne
oOuvrir une nouvelle ligne en dessous
OOuvrir une nouvelle ligne au-dessus

Navigation :

ToucheAction
h / j / k / lGauche / Bas / Haut / Droite
wSauter au début du mot suivant
eSauter à la fin du mot suivant
bSauter au début du mot précédent
0Sauter au début de la ligne
$Sauter à la fin de la ligne
^Sauter au premier caractère non vide
ggSauter à la première ligne
GSauter à la dernière ligne
f<char>Trouver le prochain caractère sur la ligne
F<char>Trouver le caractère précédent sur la ligne
t<char>Déplacer avant le prochain caractère
T<char>Déplacer après le caractère précédent
;Répéter le dernier f/F/t/T vers l'avant
,Répéter le dernier f/F/t/T vers l'arrière

Édition :

ToucheAction
xSupprimer le caractère sous le curseur
dwSupprimer jusqu'au prochain mot
deSupprimer jusqu'à la fin du mot
dbSupprimer jusqu'au début du mot
ddSupprimer toute la ligne
DSupprimer jusqu'à la fin de la ligne
cwChanger jusqu'au prochain mot
ceChanger jusqu'à la fin du mot
cbChanger jusqu'au début du mot
ccChanger toute la ligne
CChanger jusqu'à la fin de la ligne
.Répéter la dernière commande d'édition

Copier et coller :

ToucheAction
yy / YCopier toute la ligne
ywCopier jusqu'au prochain mot
yeCopier jusqu'à la fin du mot
ybCopier jusqu'au début du mot
pColler après le curseur
PColler avant le curseur

Objets texte (utiliser avec d, c ou y) :

ToucheSélectionne
iw / awIntérieur / autour du mot
iW / aWIntérieur / autour du MOT
i" / a"Intérieur / autour des guillemets doubles
i' / a'Intérieur / autour des guillemets simples
i( / a(Intérieur / autour des parenthèses
i[ / a[Intérieur / autour des crochets
i{ / a{Intérieur / autour des accolades

Opérations sur les lignes :

ToucheAction
>>Indenter la ligne
<<Désindenter la ligne
JJoindre la ligne actuelle avec la suivante

Quand le mode Vim est utile

Le mode vim devient rentable sur les prompts longs et multi-lignes. Quand tu passes à Claude Code un brief détaillé avec des chemins de fichiers, des snippets de code et des demandes en plusieurs étapes, les sauts et éditions de style vim font gagner de vraies minutes.

Quand le sauter

Tu n'utilises pas déjà vim ? Passe. La zone de saisie de Claude Code ne vaut pas l'apprentissage de cette courbe à elle seule.

Conseils par terminal

Terminal intégré VS Code

  • Lance /terminal-setup pour configurer Shift+Entrée pour la saisie multi-lignes
  • Surveille la troncature des longs collages. Passe en mode fichier pour tout ce qui dépasse 100 lignes
  • Le terminal partage les ressources avec l'éditeur. Beaucoup d'extensions actives peuvent rendre Claude Code lent
  • Configure Option+Entrée en réglant la touche Option sur "Esc+" dans les paramètres du terminal

iTerm2

  • Shift+Entrée fonctionne nativement. Rien à configurer
  • Active les alertes système via Profils, puis Terminal, puis "Silence bell" pour les bannières de fin de tâche
  • Règle la touche Option sur "Esc+" sous Profils, puis Touches pour activer Option+Entrée
  • L'intégration tmux intégrée fonctionne bien avec les sessions Claude Code parallèles

Warp

  • Lance /terminal-setup pour configurer Shift+Entrée
  • La saisie par blocs de Warp peut parfois perturber la détection de prompt de Claude Code. Passe en mode de saisie classique si tu as des problèmes

Alacritty

  • Lance /terminal-setup pour configurer Shift+Entrée
  • Le rendu accéléré par GPU fait d'Alacritty l'un des terminaux les plus rapides pour la sortie de Claude Code

Ghostty

  • Shift+Entrée fonctionne nativement
  • Ghostty est encore jeune mais fonctionne déjà bien avec Claude Code. Le rendu macOS natif et les lancements rapides en font un bon choix pour les sessions dédiées

Kitty

  • Shift+Entrée fonctionne nativement
  • Le rendu GPU garde Kitty fluide même sur les longues sorties de Claude Code
  • Un multiplexeur intégré gère les sessions parallèles sans avoir besoin de tmux

Tout mettre ensemble

Un terminal correctement configuré pour Claude Code a cinq éléments en place :

  1. Thème adapté via /config pour que la coloration soit lisible
  2. Saisie multi-lignes via Shift+Entrée ou Option+Entrée, selon ta préférence
  3. Notifications activées pour que les tâches terminées attirent ton attention
  4. Plan pour les grandes entrées défini. Flux basés sur les fichiers pour tout ce qui est plus lourd qu'un court prompt
  5. Mode Vim activé si vim est déjà dans tes doigts

Règle ces cinq points. Le terminal arrête de te gêner et commence à se comporter comme le cockpit qu'il aurait dû être.

Continue in Setup

  • Configuration de Claude Code
    Trois fichiers configurent Claude Code par projet : CLAUDE.md pour le contexte, les serveurs MCP pour les outils, les commandes slash pour les workflows. Une hiérarchie, chaque session prête.
  • Le sandboxing de Claude Code
    Le sandboxing de Claude Code applique des restrictions sur le système de fichiers et le réseau au niveau du noyau. Configuration pour macOS Seatbelt, Linux, WSL2 bubblewrap et les listes blanches de proxy.
  • Référence des paramètres de Claude Code
    Chaque clé dans settings.json, la liste complète des variables d'environnement, et la chaîne de priorité à cinq niveaux qui décide quelle config gagne quand managed et user s'affrontent.

More from Handbook

  • Principes de base de l'agent
    Cinq façons de construire des agents spécialisés dans le code Claude : Sous-agents de tâches, .claude/agents YAML, commandes slash personnalisées, personas CLAUDE.md, et invites de perspective.
  • Patterns d'agents
    Orchestrateur, fan-out, chaîne de validation, routage par spécialiste, raffinement progressif, et watchdog. Six formes d'orchestration pour câbler des sub-agents Claude Code.
  • Meilleures pratiques des équipes d'agents
    Patterns éprouvés pour les équipes d'agents Claude Code. Prompts de création riches en contexte, tâches bien calibrées, propriété des fichiers, mode délégué, et correctifs v2.1.33-v2.1.45.
  • Contrôles des équipes d'agents
    Configure le mode délégué, les modes d'affichage, l'approbation des plans, les limites de fichiers et les règles CLAUDE.md pour que le chef d'équipe Claude Code coordonne au lieu de coder.

Arrêtez de configurer. Commencez à construire.

Templates SaaS avec orchestration IA.

Configuration de Claude Code

Trois fichiers configurent Claude Code par projet : CLAUDE.md pour le contexte, les serveurs MCP pour les outils, les commandes slash pour les workflows. Une hiérarchie, chaque session prête.

Le sandboxing de Claude Code

Le sandboxing de Claude Code applique des restrictions sur le système de fichiers et le réseau au niveau du noyau. Configuration pour macOS Seatbelt, Linux, WSL2 bubblewrap et les listes blanches de proxy.

On this page

Correspondance de thème
Méthodes de saisie multi-lignes
Méthode 1 : Backslash + Entrée (fonctionne partout)
Méthode 2 : Shift+Entrée (support natif)
Méthode 3 : /terminal-setup (auto-configuration)
Méthode 4 : Option+Entrée (Mac)
Notifications
Notifications système iTerm2
Hooks de notification personnalisés
Gestion des grandes entrées
Mode Vim
Activer le mode Vim
Référence des raccourcis clavier
Quand le mode Vim est utile
Quand le sauter
Conseils par terminal
Terminal intégré VS Code
iTerm2
Warp
Alacritty
Ghostty
Kitty
Tout mettre ensemble

Arrêtez de configurer. Commencez à construire.

Templates SaaS avec orchestration IA.