Rendu en plein écran

Activez un mode de rendu plus fluide et sans scintillement avec support de la souris et une utilisation mémoire stable dans les longues conversations.

[!NOTE]

Le rendu en plein écran est un aperçu de recherche. Que vous commenciez en plein écran ou dans le rendu classique dépend de votre configuration. Exécutez /tui fullscreen ou /tui default pour basculer dans votre conversation actuelle. Le comportement peut changer en fonction des retours.

Le rendu en plein écran est un chemin de rendu alternatif pour le CLI Claude Code qui élimine le scintillement, maintient l'utilisation mémoire plate dans les longues conversations et ajoute le support de la souris. Il dessine l'interface sur le tampon d'écran alternatif du terminal, comme 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.

[!NOTE]

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 default pour revenir au moteur de rendu classique, ou /tui sans argument pour afficher quel moteur de rendu est actif.

En mode lecteur d'écran, Claude Code utilise toujours le moteur de rendu classique sauf dans les sessions d'arrière-plan attachées, qui restent en rendu plein écran. Si vous exécutez /tui fullscreen dans toute autre session, Claude Code affiche une explication au lieu de basculer et ne modifie pas le paramètre tui enregistré.

Claude Code conserve ceux-ci dans la session relancée :

• La conversation telle qu'elle apparaît à l'écran. Après un /rewind, cela signifie :
  • Si vous avez rembobiné plus tôt dans la session, Claude Code redémarre à partir du point rembobiné, et non à partir de la transcription plus longue enregistrée sur le disque. Par exemple, si vous avez rembobiné au-delà de vos trois derniers messages, la session relancée s'ouvre sans eux
  • Si vous avez rembobiné avant votre premier message, Claude Code redémarre avec une conversation vide
• Votre mode de permission et niveau d'effort
• Le modèle que vous avez sélectionné en dernier avec /model
• Les règles que vous avez transmises avec --allowed-tools ou --disallowed-tools, et vos drapeaux --agent, --agents, --append-system-prompt, et --system-prompt-snapshot
• Un flag --chrome ou --no-chrome avec lequel vous avez lancé la session, afin que l'intégration Chrome reste activée ou désactivée comme vous l'avez choisi pour cette session

Claude Code refuse de redémarrer si la session a une restriction qu'il ne peut pas transmettre au processus redémarré. Les restrictions qu'il ne peut pas transmettre incluent :

• Les drapeaux de lancement tels qu'un remplacement --system-prompt, une liste d'autorisation --tools, ou --setting-sources
• Les règles de refus ou de demande qu'une mise à jour de permission de hook ou SDK a ajoutées pour cette session uniquement

Dans ce cas, Claude Code affiche Cannot switch renderers in this session avec les raisons. Il ne bascule pas et n'enregistre rien.

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

Pour savoir comment le paramètre tui et la variable se combinent lorsque les deux sont définis, consultez l'entrée du paramètre. Après un démarrage en plein écran échoué, Claude Code honore toujours la variable mais pas le paramètre. La commande /tui efface CLAUDE_CODE_NO_FLICKER du processus relancé afin que le paramètre qu'elle écrit prenne effet.

Plein écran par défaut

Les sessions d'arrière-plan attachées se rendent en plein écran, et les autres sessions en mode lecteur d'écran utilisent le moteur de rendu classique. Sinon, Claude Code vous démarre dans le moteur de rendu de la première ligne de ce tableau qui correspond à votre configuration :

Les sessions qui ne récupèrent pas les drapeaux de fonctionnalités incluent celles via Amazon Bedrock, Google Cloud's Agent Platform, ou Microsoft Foundry, et celles avec la télémétrie désactivée.

Si vous démarrez dans le moteur de rendu classique et n'avez pas enregistré de paramètre tui, Claude Code peut ouvrir une boîte de dialogue au démarrage offrant le basculement :

• Si vous acceptez, Claude Code redémarre de la même manière que /tui fullscreen le fait, en conservant le même état de session, et enregistre le paramètre une fois que la session relancée a démarré avec succès.
• Si vous choisissez Pas maintenant, Claude Code n'offre plus sur cette machine.
• Claude Code cesse d'offrir après avoir affiché la boîte de dialogue sur trois lancements, répondus ou non.

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 :

Si la capture de souris interfère avec votre flux de travail, vous pouvez la désactiver tout en conservant le rendu sans scintillement.

Utiliser la souris

Le rendu plein écran capture les événements de la souris et les gère dans Claude Code :

• Cliquez dans la zone de saisie du prompt pour placer votre curseur n'importe où dans le texte que vous tapez.
• Cliquez sur une suggestion dans la liste des commandes / ou des fichiers @ pour l'accepter. Le survol met en surbrillance la ligne sous votre curseur.
• Cliquez sur une option dans un menu de sélection pour la choisir. Cela concerne les demandes de permission, /model, /config et les autres boîtes de dialogue qui affichent une liste d'options.
• Cliquez sur une option dans un menu à sélection multiple pour l'activer ou la désactiver, puis cliquez sur le bouton de validation pour confirmer vos choix. Cliquer sur une ligne de texte libre, comme la ligne Other d'une question à choix multiple, place le focus sur son champ de saisie afin que vous puissiez taper une réponse.
• Cliquez sur la valeur d'un paramètre dans le panneau /config pour la modifier, et faites défiler la liste des paramètres avec la molette de la souris. Nécessite Claude Code v2.1.271 ou une version ultérieure.
• Faites défiler un menu de sélection ou à sélection multiple avec la molette de la souris lorsqu'il contient plus d'options qu'il n'en affiche à la fois, comme la liste /model dans une fenêtre de terminal de petite taille. La molette fait défiler la liste lorsque le pointeur se trouve sur ses options. Nécessite Claude Code v2.1.280 ou une version ultérieure.
• Faites défiler une liste qui déborde à l'aide de sa barre de défilement. Dans les panneaux de liste tels que /skills, /mcp et la liste Installed de /plugin, une barre de défilement apparaît à côté d'une liste comportant plus de lignes que l'espace disponible lorsque le pointeur la survole. Cliquez sur la piste pour accéder directement à cet endroit, ou faites glisser le curseur. Nécessite Claude Code v2.1.281 ou une version ultérieure.
  • Lorsque la barre comporte des flèches ↑ et ↓ à ses extrémités, cliquez sur une flèche pour faire défiler une seule ligne, ou maintenez-la enfoncée pour continuer le défilement. Les flèches nécessitent Claude Code v2.1.286 ou une version ultérieure.
• Cliquez sur la ligne ↑ N more ou ↓ N more au bord d'une liste pour accéder directement à cette extrémité de la liste sans choisir d'option. Nécessite Claude Code v2.1.286 ou une version ultérieure.
• Cliquez sur un résultat d'outil réduit pour le développer et afficher 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 ayant davantage de contenu à afficher sont cliquables.
  • Un clic développe également la sortie d'une commande shell !, qu'il s'agisse d'un ancien résultat tronqué ou de la ligne de progression en direct pendant l'exécution de la commande. Nécessite Claude Code v2.1.257 ou une version ultérieure.
  • Un clic développe également une ligne estompée Message from @<sender> lorsque l'expéditeur est un coéquipier ou un autre agent s'exécutant dans votre session.
• Maintenez Cmd sur macOS, ou Ctrl sur Linux et Windows, et cliquez sur une URL ou un chemin de fichier pour l'ouvrir. Les URL simples http:// et https:// s'ouvrent dans votre navigateur. Lorsque Claude Code gère le clic, les chemins de fichiers dans la sortie des outils, comme ceux affichés après un Edit ou un Write, s'ouvrent dans votre gestionnaire de fichiers avec le fichier sélectionné. Un simple clic sans la touche de modification n'ouvre pas les liens, conformément au comportement natif du terminal.
  • Sur Linux et WSL, cliquer sur un chemin de fichier nécessite un gestionnaire de fichiers qui fournit l'interface D-Bus org.freedesktop.FileManager1. Sans celui-ci, rien ne s'ouvre.
  • Claude Code affiche un chemin réseau (UNC), tel que \\server\share\file.ts, sous forme de texte brut sans lien, car l'ouverture d'un chemin réseau peut envoyer vos identifiants Windows à l'hôte qu'il désigne.
  • Certains terminaux macOS transmettent Cmd+clic à l'application en cours d'exécution au lieu d'ouvrir eux-mêmes le lien, et le protocole de souris du terminal ne permet pas d'encoder la touche Cmd : Claude Code reçoit donc un simple clic. Dans Ghostty, et dans Warp sur macOS, Claude Code détecte cette situation et permet d'ouvrir un lien par un simple clic, tout en conservant le fonctionnement avec Cmd enfoncé.
  • Dans le terminal intégré de VS Code et les terminaux similaires basés sur xterm.js, Claude Code s'en remet au gestionnaire de liens propre au terminal, qui utilise le même geste.
• Cliquez et faites glisser pour sélectionner du texte n'importe où dans la conversation. Un double-clic sélectionne un mot, selon les limites de mots d'iTerm2, de sorte qu'un chemin de fichier est sélectionné comme une seule unité. Un double-clic sur une URL sélectionne l'URL entière, schéma compris. Un triple-clic sélectionne la ligne.
• Faites défiler avec la molette de la souris pour parcourir la conversation.

Le texte sélectionné est automatiquement copié dans votre presse-papiers lorsque vous relâchez le bouton de la souris. Pour désactiver ce comportement, basculez l'option Copy on select dans /config.

Lorsque Copy on select est désactivé, appuyez sur Ctrl+Shift+c pour copier manuellement. Sur les terminaux qui prennent en charge le protocole clavier kitty, tels que kitty, WezTerm, Ghostty et iTerm2, Cmd+c fonctionne également. Si une sélection est active, Ctrl+c copie au lieu d'annuler.

Lorsqu'une sélection est active, maintenez Shift et appuyez sur les touches fléchées pour l'étendre au clavier. Shift+↑ et Shift+↓ font défiler la zone d'affichage lorsque la sélection atteint le bord supérieur ou inférieur. Shift+Home et Shift+End étendent la sélection jusqu'au début ou à la fin de la ligne actuelle.

Dans la vue normale du prompt, ce qu'il advient d'une sélection active dépend de la touche sur laquelle vous appuyez :

• Esc : Claude Code exécute l'action habituelle de la touche, comme interrompre la réponse en cours ou fermer une boîte de dialogue ouverte, et la sélection reste en surbrillance.
• PgUp, PgDn, Ctrl+Home, Ctrl+End, ou Shift, Alt ou Option, ou Cmd, Win ou Super avec une touche fléchée, Home ou End : la sélection est conservée.
• Toute autre touche, y compris les touches fléchées seules, Enter et les caractères saisis : Claude Code efface la sélection.
• Une touche associée à selection:clear : Claude Code efface la sélection, même lorsque la touche est Esc ou une autre touche qui la conserverait normalement. Cette action n'a pas de raccourci clavier par défaut.

En mode transcription, les touches de navigation qui y sont répertoriées conservent également la sélection.

Faire défiler la conversation

Le rendu en plein écran gère le défilement dans l'application. Utilisez ces raccourcis pour naviguer :

Si vous fermez une session compactée et que vous la reprenez, le défilement vers le haut s'arrête à la ligne Conversation compacted, et vos messages antérieurs restent sur le disque dans le fichier de transcription. Pour obtenir un détail de ces messages, demandez à Claude de le rechercher dans ce fichier.

Sur les claviers sans touches dédiées PgUp, PgDn, Home ou End, 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. Ctrl+Fn+→ n'atteint pas Claude Code sur macOS, donc un clavier MacBook n'a pas de combinaison de touches fonctionnelle pour sauter vers le bas par défaut. À la place, utilisez l'une de ces options :

• Cliquez sur le bouton sauter vers le bas.
• Faites défiler vers le bas avec la molette de la souris pour reprendre le suivi.
• Réaffectez scroll:bottom à une combinaison de touches que votre clavier peut envoyer.

Ces actions sont réaffectables. 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.

Pendant que vous êtes défilé vers le haut, une ligne d'en-tête atténuée en haut de la conversation affiche l'invite la plus récente qui a défilé au-dessus de la vue. Cliquez sur la ligne pour sauter à cette invite.

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. Un bouton Jump to bottom flotte sur le bord inférieur de la transcription lorsque vous êtes défilé vers le haut, et affiche un décompte tel que 3 new messages lorsqu'une nouvelle sortie arrive. Cliquez dessus, appuyez sur Ctrl+End, ou faites défiler vers le bas pour reprendre le suivi.

Lorsque le suivi automatique est en pause, la vue reste également où vous l'avez défilée lorsqu'une réponse termine le streaming.

L'indice clavier du bouton reflète ce que votre clavier peut envoyer. Sur macOS, il suggère de cliquer, ou Fn+↓ pour faire défiler, car Ctrl+End n'atteint pas Claude Code depuis un clavier Mac. Réaffectez scroll:bottom et le bouton affiche votre combinaison de touches sur chaque plateforme.

Sur un terminal trop étroit pour l'étiquette complète, le bouton raccourcit l'indice au lieu de l'enrouler sur la ligne de transcription en dessous.

Pour désactiver entièrement le suivi automatique afin que la vue reste où vous la laissez, ouvrez /config et définissez Auto-scroll sur off. 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 défilent toujours 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 transfère les événements de la 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 que PgUp et PgDn fonctionnent, ouvrez Paramètres → Profils → Terminal et activez Enable mouse reporting. 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 peut envoyer 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 :

export CLAUDE_CODE_SCROLL_SPEED=3

Une valeur de 3 correspond à la valeur par défaut dans vim et les applications similaires. Le paramètre accepte toute valeur positive jusqu'à 20, y compris les valeurs fractionnaires inférieures à 1 telles que 0.25 pour ralentir le défilement du trackpad et de la molette accélérés dans les terminaux qui amplifient déjà les événements de molette.

Pour ajuster la vitesse de défilement de manière interactive, exécutez /scroll-speed. Faites défiler pendant que le dialogue est ouvert pour sentir le changement immédiatement. Appuyez sur ← et → pour ajuster la vitesse, r pour réinitialiser à la valeur par défaut détectée automatiquement, et Enter pour enregistrer. Le dialogue augmente par nombres entiers jusqu'à 10, et sur les terminaux qui supportent un contrôle plus fin, il offre également des quarts de pas jusqu'à 0,25.

La commande écrit la même valeur que la variable d'environnement CLAUDE_CODE_SCROLL_SPEED définit, persistée dans ~/.claude/settings.json. Le maximum du dialogue est 10 : si vous définissez une valeur plus élevée via la variable d'environnement, le dialogue affiche 10, et l'enregistrement à partir du dialogue persiste 10. La commande n'est pas disponible dans le terminal IDE JetBrains.

Séparément de la vitesse de base, Claude Code accélère la vitesse de défilement lorsque vous tournez la molette rapidement, donc une rotation rapide couvre plus de distance que le même nombre de crans lents. Pour désactiver l'accélération et maintenir une vitesse constante par cran, définissez wheelScrollAccelerationEnabled sur false dans settings.json. Ce paramètre nécessite Claude Code v2.1.174 ou version ultérieure.

Défilement dans le terminal IDE JetBrains

Dans le terminal IDE JetBrains, Claude Code applique sa propre gestion du défilement et ignore CLAUDE_CODE_SCROLL_SPEED. Le terminal envoie des événements de défilement à un taux beaucoup plus élevé que les autres émulateurs, donc un multiplicateur accordé ailleurs dépasse 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 les détecte à l'exécution et les atténue automatiquement, donc le défilement du trackpad et de la molette de la souris fonctionnent sans configuration. Pour la meilleure expérience de défilement, mettez à niveau vers 2025.3 ou 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 parcourir la conversation

Ctrl+o bascule entre le prompt normal et le mode transcription.

Pour une vue plus épurée qui affiche uniquement votre dernier prompt, un résumé d'une ligne des appels d'outils avec les statistiques de diff des modifications, ainsi que la réponse finale, exécutez /focus. Ce paramètre est conservé d'une session à l'autre. Exécutez à nouveau /focus pour le désactiver.

Le mode transcription offre une navigation et une recherche de style less :

Le Cmd+f de votre terminal et la recherche tmux ne voient pas la conversation, car celle-ci se trouve dans le tampon d'écran alternatif, et non dans l'historique de défilement natif. Pour rendre le contenu à votre terminal, appuyez d'abord sur Ctrl+o pour passer en mode transcription, puis :

• [ : écrit l'intégralité de la conversation dans le tampon de défilement natif de votre terminal, avec toutes les sorties d'outils développées. La conversation devient alors du texte ordinaire dans votre terminal, de sorte que Cmd+f, le mode copie de tmux et tout autre outil natif peuvent la rechercher ou la sélectionner. Les longues sessions peuvent marquer une brève pause pendant cette opération. Cet état dure jusqu'à ce que vous quittiez le mode transcription avec Esc ou q, ce qui vous ramène à l'affichage plein écran. Le Ctrl+o suivant repart de zéro.
• v : écrit la conversation dans un fichier temporaire et l'ouvre dans $VISUAL ou $EDITOR.

Regardez vos modifications dans le panneau de diff

En rendu plein écran, /diff ouvre un panneau à côté de la conversation, afin que vous puissiez regarder les modifications s'accumuler pendant que Claude travaille. Panneau de diff couvre ce qu'il affiche, quand il s'ouvre de lui-même, comment le garder fermé et comment modifier ce à quoi il compare.

Effacer la conversation

Exécutez /clear pour démarrer une nouvelle conversation.

Si l'affichage semble garni ou partiellement vide, appuyez sur Ctrl+L pour redessiner l'écran. Le redessinage conserve la conversation et votre saisie en place.

Cmd+K fait la même chose que Ctrl+L lorsque votre terminal le transmet à Claude Code. iTerm2 et Terminal.app gèrent Cmd+K eux-mêmes et effacent leur propre écran, et Claude Code détecte l'écran effacé et repeint la conversation. Avant v2.1.280, à partir de v2.1.260, appuyer sur Ctrl+L ou Cmd+K où il atteint Claude Code effaçait l'écran dans le rendu en plein écran. Avant v2.1.238, appuyer sur Ctrl+L deux fois en deux secondes exécutait /clear.

Utilisation avec tmux

Le rendu en plein écran fonctionne dans tmux, avec trois réserves.

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 :

set -g mouse on

Sans le mode souris, les événements de molette vont à tmux au lieu de Claude Code. Le défilement au clavier avec PgUp et PgDn fonctionne de toute façon. Claude Code affiche 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 dans iTerm2, sans -CC, fonctionne bien.

Les versions de tmux jusqu'à la série 3.6 n'implémentent pas la sortie synchronisée, donc sous ces versions vous pouvez voir plus de scintillement lors des redessins que lors de l'exécution de Claude Code directement dans votre terminal. Claude Code sonde le terminal pour la prise en charge de la sortie synchronisée au démarrage et l'utilise quand le terminal le signale. Si vous voyez du scintillement sous tmux, mettez à jour vers le dernier tmux ou exécutez Claude Code dans son propre onglet de terminal en dehors de tmux.

Conserver la sélection de texte native

La capture de souris est le point de friction le plus courant, en particulier sur SSH ou à l'intérieur de tmux. Quand Claude Code capture les événements de souris, la copie native au survol de votre terminal cesse de fonctionner. La sélection que vous effectuez avec un clic-glisser existe à l'intérieur de Claude Code, pas dans le tampon de sélection de votre terminal, donc le mode copie de tmux, les indices de Kitty et les outils similaires ne la voient pas.

Claude Code écrit la sélection dans le presse-papiers de votre système, et le chemin qu'il utilise dépend de votre configuration. Sur une session locale, il exécute un outil de presse-papiers natif :

• macOS : pbcopy
• Linux : wl-copy sur Wayland, ou xclip ou xsel sur X11, selon ce qui est installé. Claude Code écrit à la fois le presse-papiers et la sélection PRIMARY, donc le collage au clic du milieu fonctionne.
• Windows et WSL : PowerShell Set-Clipboard

À l'intérieur de tmux, il écrit également dans le tampon de collage de tmux. Sur SSH, il revient aux séquences d'échappement OSC 52. À l'intérieur de GNU screen, Claude Code copie également les longues sélections dans le presse-papiers. Avant la v2.1.219, si vous copiiez une sélection plus longue qu'environ 570 caractères, GNU screen imprimait du texte en base64 dans la fenêtre à la place. Claude Code affiche un toast après chaque copie vous indiquant quel chemin il a utilisé.

Certains terminaux bloquent OSC 52 par défaut. iTerm2 le bloque jusqu'à ce que vous activiez Paramètres → Général → Sélection → Les applications du terminal peuvent accéder au presse-papiers ; l'exécution de /terminal-setup dans iTerm2 active cela pour vous.

Pour une sélection native ponctuelle, la touche à utiliser dépend de votre terminal :

• Terminal.app : Fn
• iTerm2 : Option
• VS Code, Cursor et Devin Desktop : Shift, ou Option sur macOS avec le paramètre terminal.integrated.macOptionClickForcesSelection activé
• La plupart des autres terminaux : Shift

Maintenez cette touche enfoncée pendant que vous cliquez et glissez. Votre terminal gère la sélection lui-même au lieu de la transmettre à Claude Code, donc les raccourcis de copie comme Cmd+C fonctionnent sur ce que vous sélectionnez. Claude Code affiche également la touche correcte dans son indice à l'écran.

Sur SSH ou à l'intérieur de tmux, Claude Code ne peut pas toujours détecter le terminal auquel vous vous connectez, donc l'indice énumère les touches candidates à la place.

Si vous comptez sur la sélection native tout le temps, définissez CLAUDE_CODE_DISABLE_MOUSE=1 pour désactiver la capture de souris tout en conservant le rendu sans scintillement et la mémoire plate :

CLAUDE_CODE_NO_FLICKER=1 CLAUDE_CODE_DISABLE_MOUSE=1 claude

Avec la capture de souris désactivée, le défilement au clavier avec 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, le clic sur URL et le défilement à la roulette à l'intérieur de Claude Code.

Pour conserver le défilement à la roulette mais désactiver le clic, le glisser et la gestion du survol, définissez plutôt CLAUDE_CODE_DISABLE_MOUSE_CLICKS=1. CLAUDE_CODE_DISABLE_MOUSE a la priorité quand les deux variables sont définies.

Avec les clics désactivés, Claude Code capture toujours la souris, donc la roulette et le pavé tactile font défiler la conversation mais les clics gauches ne font rien à l'intérieur de Claude Code. Vous devez toujours maintenir la touche de votre terminal pour la sélection native au clic-glisser. Le clic droit et le collage au clic du milieu continuent de fonctionner sur les terminaux qui les supportent.

Dépannage

Texte obsolète ou mal placé à l'écran

Le rendu en plein écran envoie uniquement les cellules qui ont changé entre les images. Certains terminaux, notamment Windows Terminal et autres hôtes basés sur ConPTY, fusionnent ces écritures positionnées de manière incorrecte et laissent des fragments de la sortie antérieure à l'écran jusqu'à ce que vous redimensionniez la fenêtre.

Définissez CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT=1 pour repeindre chaque cellule à chaque image au lieu d'envoyer des mises à jour incrémentielles.

Sur Windows PowerShell :

$env:CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT = "1"
claude

Sur macOS ou Linux :

CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT=1 claude

Sur Windows, Claude Code active déjà automatiquement le repeint complet pour les sessions en arrière-plan et la vue agent, vous n'avez donc besoin de définir la variable que pour une session interactive en plein écran que vous avez lancée directement.

Claude Code's fullscreen renderer didn't finish starting last time apparaît au démarrage

Si une session en plein écran sur cette machine s'arrête avant d'avoir démarré avec succès, Claude Code démarre votre session suivante dans le rendu classique et affiche l'une de deux lignes. Une session a démarré avec succès une fois qu'elle a dessiné sa première image et qu'elle est restée active pendant 10 secondes ou que vous l'avez terminée avec /exit, Ctrl+C ou Ctrl+D. La ligne que vous voyez vous indique ce que Claude Code fait après cette session :

• Après un premier démarrage échoué, vous voyez Claude Code's fullscreen renderer didn't finish starting last time on this machine. Claude Code essaie à nouveau le rendu en plein écran dans la session suivante que vous démarrez
• Après deux démarrages échoués, vous voyez Claude Code's fullscreen renderer has repeatedly failed to start on this machine. Claude Code continue à utiliser le rendu classique jusqu'à ce que vous mettiez à jour Claude Code ou exécutiez /tui fullscreen, et n'affiche rien dans ces sessions ultérieures

Pour confirmer qu'un démarrage échoué est la raison pour laquelle vous êtes dans le rendu classique, exécutez /tui sans argument. Tant qu'un démarrage échoué est la raison, la ligne Current renderer l'indique.

Pour conserver le rendu classique, exécutez /tui default, qui enregistre le paramètre tui sans relancer. Pour essayer à nouveau le rendu en plein écran, exécutez /tui fullscreen. Si cette session ne démarre pas non plus, signalez le problème.

Avant la v2.1.236, Claude Code continuait à démarrer les sessions en rendu plein écran après un démarrage échoué.

Comment Claude Code compte les démarrages échoués

• Sessions qui comptent : uniquement les sessions qui ont démarré en rendu plein écran parce que votre paramètre tui le dit, parce que vous avez accepté la boîte de dialogue de démarrage, ou parce que Claude Code vous démarre en plein écran par défaut
• CLAUDE_CODE_NO_FLICKER=1 : si vous le définissez, Claude Code rend cette session en plein écran même après un démarrage échoué, et ne le compte pas
• Réinitialisation du comptage : Claude Code compte les démarrages échoués par version de Claude Code, et un démarrage plein écran réussi réinitialise le comptage
• Boîte de dialogue de démarrage : si vous avez accepté la boîte de dialogue et que la session relancée s'est arrêtée, Claude Code n'affiche aucune ligne et n'affiche plus la boîte de dialogue sur cette version de Claude Code

Research preview

Le rendu en plein écran est une fonctionnalité en research preview. Elle a été testée sur les émulateurs de terminal courants, mais vous pourriez rencontrer des problèmes de rendu sur des terminaux moins courants ou avec des configurations inhabituelles.

Si vous rencontrez un problème, exécutez /feedback dans Claude Code pour le signaler, ou ouvrez une issue sur le dépôt GitHub claude-code. Indiquez le nom et la version de votre émulateur de terminal.

Pour désactiver le rendu en plein écran, exécutez /tui default, ou supprimez CLAUDE_CODE_NO_FLICKER si vous l'avez activé de cette façon. Lorsque vous revenez en arrière avec /tui default, Claude Code peut d'abord afficher une demande de commentaire facultative vous demandant ce qui vous a poussé à changer. Saisissez une raison et appuyez sur Enter pour l'envoyer, ou appuyez sur Esc pour l'ignorer. Dans les deux cas, la CLI redémarre avec le moteur de rendu classique. Pour forcer le moteur de rendu classique quel que soit le paramètre tui enregistré, définissez CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1. Le moteur de rendu classique conserve la conversation dans l'historique de défilement natif de votre terminal, de sorte que Cmd+f et le mode copie de tmux fonctionnent normalement.

Les sessions en arrière-plan ouvertes depuis la vue des agents ou claude attach utilisent toujours le rendu en plein écran. Le terminal qui s'y attache passe dans le tampon d'écran alternatif pour afficher la session, et le moteur de rendu classique n'y dispose ni de l'historique de défilement ni de la gestion de la souris ; le paramètre tui et CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN ne s'y appliquent donc pas.