Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Le rendu en plein écran est un aperçu de recherche optionnel et nécessite Claude Code v2.1.89 ou ultérieur. Exécutez
/tui fullscreen pour basculer dans votre conversation actuelle, ou définissez CLAUDE_CODE_NO_FLICKER=1 sur les versions antérieures à v2.1.110. Le comportement peut changer en fonction des retours.vim ou htop, et ne rend que les messages actuellement visibles. Cela réduit la quantité de données envoyées à votre terminal à chaque mise à jour.
La différence est plus notable dans les émulateurs de terminal où le débit de rendu est le goulot d’étranglement, comme le terminal intégré VS Code, tmux et iTerm2. Si votre position de défilement du terminal saute vers le haut pendant que Claude travaille, ou si l’écran clignote à mesure que la sortie de l’outil s’affiche, ce mode résout ces problèmes.
Le terme plein écran décrit comment Claude Code prend le contrôle de la surface de dessin du terminal, de la même manière que
vim. Cela n’a rien à voir avec la maximisation de votre fenêtre de terminal, et fonctionne à n’importe quelle taille de fenêtre.Activer le rendu en plein écran
Exécutez/tui fullscreen dans n’importe quelle conversation Claude Code. Le CLI enregistre le paramètre tui et redémarre en plein écran avec votre conversation intacte, afin que vous puissiez basculer en cours de session sans perdre le contexte. Exécutez /tui sans argument pour afficher quel moteur de rendu est actif.
Vous pouvez également définir la variable d’environnement CLAUDE_CODE_NO_FLICKER avant de démarrer Claude Code :
tui et la variable d’environnement sont équivalents. La commande /tui efface CLAUDE_CODE_NO_FLICKER du processus relancé afin que le paramètre qu’elle écrit prenne effet.
Ce qui change
Le rendu en plein écran change la façon dont le CLI dessine sur votre terminal. La boîte d’entrée reste fixe en bas de l’écran au lieu de se déplacer à mesure que la sortie s’affiche. Si l’entrée reste en place pendant que Claude travaille, le rendu en plein écran est actif. Seuls les messages visibles sont conservés dans l’arborescence de rendu, donc la mémoire reste constante quel que soit la longueur de la conversation. Parce que la conversation vit dans le tampon d’écran alternatif au lieu du scrollback de votre terminal, quelques choses fonctionnent différemment :| Avant | Maintenant | Détails |
|---|---|---|
Cmd+f ou recherche tmux pour trouver du texte | Ctrl+o pour le mode transcription, puis / pour rechercher ou [ pour écrire dans le scrollback | Rechercher et examiner la conversation |
| Clic et glissement natif du terminal pour sélectionner et copier | Sélection dans l’application, copie automatique au relâchement de la souris | Utiliser la souris |
Cmd-clic pour ouvrir une URL | Cliquez sur l’URL | Utiliser la souris |
Utiliser la souris
Le rendu en plein écran capture les événements de souris et les traite dans Claude Code :- Cliquez dans l’entrée d’invite pour positionner votre curseur n’importe où dans le texte que vous tapez.
- Cliquez sur un résultat d’outil réduit pour le développer et voir la sortie complète. Cliquez à nouveau pour le réduire. L’appel d’outil et son résultat se développent ensemble. Seuls les messages qui ont plus à afficher sont cliquables.
- Cliquez sur une URL ou un chemin de fichier pour l’ouvrir. Les chemins de fichiers dans la sortie de l’outil, comme ceux imprimés après une modification ou une écriture, s’ouvrent dans votre application par défaut. Les URLs
http://ethttps://simples s’ouvrent dans votre navigateur. Dans la plupart des terminaux, cela remplace leCmd-clic ouCtrl-clic natif, que la capture de souris intercepte. Dans le terminal intégré VS Code et les terminaux basés sur xterm.js similaires, continuez à utiliserCmd-clic. Claude Code se défère au gestionnaire de lien du terminal pour éviter d’ouvrir les liens deux fois. - Cliquez et glissez pour sélectionner du texte n’importe où dans la conversation. Double-cliquez pour sélectionner un mot, en correspondant avec les limites de mots d’iTerm2 afin qu’un chemin de fichier se sélectionne comme une unité. Triple-cliquez pour sélectionner la ligne.
- Faites défiler avec la molette de la souris pour vous déplacer dans la conversation.
/config. Avec cette option désactivée, appuyez sur Ctrl+Shift+c pour copier manuellement. Sur les terminaux qui supportent le protocole clavier kitty, comme kitty, WezTerm, Ghostty et iTerm2, Cmd+c fonctionne également. Si vous avez une sélection active, Ctrl+c copie au lieu d’annuler.
Avec une sélection active, maintenez Shift et appuyez sur les touches fléchées pour l’étendre à partir du clavier. Shift+↑ et Shift+↓ font défiler la fenêtre d’affichage lorsque la sélection atteint le bord supérieur ou inférieur. Shift+Home et Shift+End étendent jusqu’au début ou à la fin de la ligne actuelle.
Faire défiler la conversation
Le rendu en plein écran gère le défilement dans l’application. Utilisez ces raccourcis pour naviguer :| Raccourci | Action |
|---|---|
PgUp / PgDn | Faites défiler vers le haut ou vers le bas de moitié écran |
Ctrl+Home | Allez au début de la conversation |
Ctrl+End | Allez au dernier message et réactivez le suivi automatique |
| Molette de la souris | Faites défiler quelques lignes à la fois |
PgUp, PgDn, Home ou End dédiées, comme les claviers MacBook, maintenez Fn avec les touches fléchées : Fn+↑ envoie PgUp, Fn+↓ envoie PgDn, Fn+← envoie Home, et Fn+→ envoie End. Cela rend Ctrl+Fn+→ le raccourci de saut vers le bas. Si cela semble maladroit, faites défiler vers le bas avec la molette de la souris pour reprendre le suivi, ou reliez scroll:bottom à quelque chose de plus accessible.
Ces actions sont reliables. Consultez Actions de défilement pour la liste complète des noms d’actions, y compris les variantes de demi-page et de page complète qui n’ont pas de liaison par défaut.
Suivi automatique
Le défilement vers le haut met en pause le suivi automatique afin que la nouvelle sortie ne vous ramène pas vers le bas. Appuyez surCtrl+End ou faites défiler vers le bas pour reprendre le suivi.
Pour désactiver entièrement le suivi automatique afin que la vue reste où vous la laissez, ouvrez /config et définissez Défilement automatique sur désactivé. Avec le défilement automatique désactivé, la vue ne saute jamais vers le bas d’elle-même. Les invites de permission et autres dialogues qui nécessitent une réponse font toujours défiler dans la vue indépendamment de ce paramètre.
Défilement à la molette de la souris
Le défilement à la molette de la souris nécessite que votre terminal transmette les événements de souris à Claude Code. La plupart des terminaux le font chaque fois qu’une application le demande. iTerm2 en fait un paramètre par profil : si la molette ne fait rien mais quePgUp et PgDn fonctionnent, ouvrez Paramètres → Profils → Terminal et activez Activer le rapport de souris. Le même paramètre est également requis pour que le clic pour développer et la sélection de texte fonctionnent.
Si le défilement à la molette de la souris semble lent, votre terminal envoie peut-être un événement de défilement par cran physique sans multiplicateur. Certains terminaux, comme Ghostty et iTerm2 avec défilement plus rapide activé, amplifient déjà les événements de molette. D’autres, y compris le terminal intégré VS Code, envoient exactement un événement par cran. Claude Code ne peut pas détecter lequel.
Définissez CLAUDE_CODE_SCROLL_SPEED pour multiplier la distance de défilement de base :
3 correspond à la valeur par défaut dans vim et les applications similaires. Le paramètre accepte les valeurs de 1 à 20.
Pour ajuster la vitesse de défilement de manière interactive, exécutez /scroll-speed. La boîte de dialogue affiche une règle que vous pouvez faire défiler pendant qu’elle est ouverte afin que vous puissiez ressentir le changement immédiatement. Appuyez sur ← et → pour ajuster, r pour réinitialiser à la valeur par défaut détectée automatiquement, et Entrée pour enregistrer. La commande écrit la même valeur que la variable d’environnement CLAUDE_CODE_SCROLL_SPEED définit, persistée à ~/.claude/settings.json. La commande n’est pas disponible dans le terminal de l’IDE JetBrains.
Défilement dans le terminal de l’IDE JetBrains
Dans le terminal de l’IDE JetBrains, Claude Code applique sa propre gestion du défilement et ignoreCLAUDE_CODE_SCROLL_SPEED. Le terminal envoie les événements de défilement à un taux beaucoup plus élevé que les autres émulateurs, donc un multiplicateur accordé ailleurs dépasse la limite ici.
En 2025.2, le terminal a également des bogues de défilement à la molette qui produisent des touches fléchées parasites et des événements de mauvaise direction. Claude Code détecte ces bogues à l’exécution et les atténue automatiquement, donc le défilement au trackpad et à la molette de la souris fonctionnent sans configuration. Pour la meilleure expérience de défilement, mettez à niveau vers 2025.3 ou une version ultérieure. Claude Code affiche un indice la première fois que vous faites défiler si le bogue est détecté.
Rechercher et examiner la conversation
Ctrl+o bascule entre l’invite normale et le mode transcription. Pour une vue plus calme qui affiche uniquement votre dernière invite, un résumé d’une ligne des appels d’outil avec les statistiques de diff de modification, et la réponse finale, exécutez /focus. Le paramètre persiste entre les sessions. Exécutez /focus à nouveau pour le désactiver.
Le mode transcription gagne la navigation et la recherche de style less :
| Touche | Action |
|---|---|
/ | Ouvrir la recherche. Tapez pour trouver des correspondances, Entrée pour accepter, Échap pour annuler et restaurer votre position de défilement |
n / N | Allez à la correspondance suivante ou précédente. Fonctionne après avoir fermé la barre de recherche |
j / k ou ↑ / ↓ | Faites défiler une ligne |
g / G ou Home / End | Allez au début ou à la fin |
Ctrl+u / Ctrl+d | Faites défiler une demi-page |
Ctrl+b / Ctrl+f ou Espace / b | Faites défiler une page complète |
Ctrl+o, Échap, ou q | Quitter le mode transcription et revenir à l’invite |
Cmd+f de votre terminal et la recherche tmux ne voient pas la conversation car elle vit dans le tampon d’écran alternatif, pas le scrollback natif. Pour rendre le contenu à votre terminal, appuyez sur Ctrl+o pour entrer d’abord en mode transcription, puis :
[: écrit la conversation complète dans le tampon de scrollback natif de votre terminal, avec toute la sortie de l’outil développée. La conversation est maintenant du texte ordinaire dans votre terminal, doncCmd+f, le mode copie tmux et tout autre outil natif peuvent la rechercher ou la sélectionner. Les longues sessions peuvent faire une pause pendant un moment pendant que cela se produit. Cela dure jusqu’à ce que vous quittiez le mode transcription avecÉchapouq, ce qui vous ramène au rendu en plein écran. Le prochainCtrl+orecommence à zéro.v: écrit la conversation dans un fichier temporaire et l’ouvre dans$VISUALou$EDITOR.
Échap ou q pour revenir à l’invite.
Effacer la conversation
Appuyez deux fois surCtrl+L dans les deux secondes pour exécuter /clear et démarrer une nouvelle conversation. Le premier appui redessine l’écran et affiche un indice ; le deuxième appui efface la conversation. Sur macOS, appuyer deux fois sur Cmd+K exécute également /clear.
Utiliser avec tmux
Le rendu en plein écran fonctionne à l’intérieur de tmux, avec trois mises en garde. Le défilement à la molette de la souris nécessite le mode souris de tmux. Si votre~/.tmux.conf ne l’active pas déjà, ajoutez cette ligne et rechargez votre configuration :
PgUp et PgDn fonctionne de toute façon. Claude Code imprime un indice unique au démarrage s’il détecte tmux avec le mode souris désactivé.
Le rendu en plein écran est incompatible avec le mode d’intégration tmux d’iTerm2, qui est le mode dans lequel vous entrez avec tmux -CC. En mode intégration, iTerm2 rend chaque volet tmux comme une division native plutôt que de laisser tmux dessiner sur le terminal. Le tampon d’écran alternatif et le suivi de la souris ne fonctionnent pas correctement là : la molette de la souris ne fait rien, et le double-clic peut corrompre l’état du terminal. N’activez pas le rendu en plein écran dans les sessions tmux -CC. Le tmux régulier à l’intérieur d’iTerm2, sans -CC, fonctionne bien.
tmux ne supporte pas la sortie synchronisée, donc vous pouvez voir plus de scintillement lors des redessins que lors de l’exécution de Claude Code directement dans votre terminal. Si le scintillement est notable, en particulier sur SSH, exécutez Claude Code dans son propre onglet de terminal en dehors de tmux.
Conserver la sélection de texte natif
La capture de souris est le point de friction le plus courant, surtout sur SSH ou à l’intérieur de tmux. Lorsque Claude Code capture les événements de souris, la copie à la sélection natif de votre terminal cesse de fonctionner. La sélection que vous faites avec clic et glissement existe à l’intérieur de Claude Code, pas dans le tampon de sélection de votre terminal, donc le mode copie tmux, les indices Kitty et les outils similaires ne la voient pas. Claude Code essaie d’écrire la sélection dans votre presse-papiers, mais le chemin qu’il utilise dépend de votre configuration. À l’intérieur de tmux, il écrit dans le tampon de collage tmux. Sur SSH, il revient aux séquences d’échappement OSC 52, que certains terminaux bloquent par défaut. iTerm2 les bloque jusqu’à ce que vous activiez Paramètres → Général → Sélection → Les applications du terminal peuvent accéder au presse-papiers. Exécutez/terminal-setup dans iTerm2 pour activer cela pour vous. Claude Code imprime un toast après chaque copie vous indiquant quel chemin il a utilisé.
Pour une sélection natif ponctuelle, maintenez le modificateur de contournement de votre terminal pendant que vous cliquez et glissez : Option dans iTerm2, ou Shift dans la plupart des terminaux Linux et Windows. Le modificateur indique à votre terminal de gérer la sélection lui-même au lieu de transférer les événements de souris à Claude Code, donc Cmd+C et les autres raccourcis de copie de votre terminal fonctionnent dessus.
Si vous comptez sur la sélection natif de votre terminal, définissez CLAUDE_CODE_DISABLE_MOUSE=1 pour refuser la capture de souris tout en conservant le rendu sans scintillement et la mémoire plate :
PgUp, PgDn, Ctrl+Home et Ctrl+End fonctionne toujours, et votre terminal gère la sélection nativement. Vous perdez le clic pour positionner le curseur, le clic pour développer la sortie de l’outil, le clic sur URL et le défilement à la molette à l’intérieur de Claude Code.
Aperçu de recherche
Le rendu en plein écran est une fonctionnalité d’aperçu de recherche. Il a été testé sur les émulateurs de terminal courants, mais vous pouvez rencontrer des problèmes de rendu sur les terminaux moins courants ou les configurations inhabituelles. Si vous rencontrez un problème, exécutez/feedback à l’intérieur de Claude Code pour le signaler, ou ouvrez un problème sur le référentiel GitHub claude-code. Incluez le nom et la version de votre émulateur de terminal.
Pour désactiver le rendu en plein écran, exécutez /tui default, ou déconfigurez CLAUDE_CODE_NO_FLICKER si vous l’avez activée de cette façon. Pour forcer le moteur de rendu classique indépendamment du paramètre tui enregistré, définissez CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1. Le moteur de rendu classique conserve la conversation dans le défilement natif de votre terminal afin que Cmd+f et le mode copie tmux fonctionnent comme d’habitude.