Rendering fullscreen adalah pratinjau penelitian yang bersifat opt-in dan memerlukan Claude Code v2.1.88 atau lebih baru. Aktifkan dengan CLAUDE_CODE_NO_FLICKER=1. Perilaku dapat berubah berdasarkan umpan balik.
Rendering fullscreen adalah jalur rendering alternatif untuk Claude Code CLI yang menghilangkan flicker, menjaga penggunaan memori tetap datar dalam percakapan panjang, dan menambahkan dukungan mouse. Ini menggambar antarmuka pada buffer layar alternatif terminal, seperti vim atau htop, dan hanya merender pesan yang saat ini terlihat. Ini mengurangi jumlah data yang dikirim ke terminal Anda pada setiap pembaruan.
Perbedaannya paling terlihat di emulator terminal di mana throughput rendering adalah hambatan, seperti terminal terintegrasi VS Code, tmux, dan iTerm2. Jika posisi scroll terminal Anda melompat ke atas saat Claude sedang bekerja, atau layar berkedip saat output alat mengalir masuk, mode ini mengatasi masalah tersebut.
Istilah fullscreen menggambarkan bagaimana Claude Code mengambil alih permukaan gambar terminal, seperti yang dilakukan vim. Ini tidak ada hubungannya dengan memaksimalkan jendela terminal Anda, dan bekerja pada ukuran jendela apa pun.
Aktifkan rendering fullscreen
Atur variabel lingkungan CLAUDE_CODE_NO_FLICKER saat memulai Claude Code:
CLAUDE_CODE_NO_FLICKER=1 claude
Untuk mengaktifkannya untuk setiap sesi, ekspor variabel di profil shell Anda seperti ~/.zshrc atau ~/.bashrc:
export CLAUDE_CODE_NO_FLICKER=1
Apa yang berubah
Rendering fullscreen mengubah cara CLI menggambar ke terminal Anda. Kotak input tetap berada di bagian bawah layar alih-alih bergerak saat output mengalir masuk. Jika input tetap di tempatnya saat Claude sedang bekerja, rendering fullscreen aktif. Hanya pesan yang terlihat yang disimpan di pohon render, sehingga memori tetap konstan terlepas dari panjang percakapan.
Karena percakapan berada di buffer layar alternatif alih-alih scrollback terminal Anda, beberapa hal bekerja berbeda:
| Sebelumnya | Sekarang | Detail |
|---|
Cmd+f atau pencarian tmux untuk menemukan teks | Ctrl+o lalu / untuk mencari, atau Ctrl+o lalu [ untuk menulis percakapan ke scrollback asli sehingga Cmd+f berfungsi lagi | Cari dan tinjau percakapan |
| Klik-dan-seret asli terminal untuk memilih dan menyalin | Pemilihan dalam aplikasi, menyalin secara otomatis saat pelepasan mouse | Gunakan mouse |
Cmd-klik untuk membuka URL | Klik URL | Gunakan mouse |
Jika penangkapan mouse mengganggu alur kerja Anda, Anda dapat mematikannya sambil mempertahankan rendering bebas flicker.
Gunakan mouse
Rendering fullscreen menangkap peristiwa mouse dan menanganinya di dalam Claude Code:
- Klik di input prompt untuk memposisikan kursor Anda di mana saja dalam teks yang Anda ketik.
- Klik hasil alat yang diciutkan untuk memperluasnya dan melihat output lengkap. Klik lagi untuk menciutkan. Panggilan alat dan hasilnya berkembang bersama. Hanya pesan yang memiliki lebih banyak untuk ditampilkan yang dapat diklik.
- Klik URL atau jalur file untuk membukanya. Jalur file dalam output alat, seperti yang dicetak setelah Edit atau Write, terbuka di aplikasi default Anda. URL
http:// dan https:// biasa terbuka di browser Anda. Di sebagian besar terminal ini menggantikan Cmd-klik atau Ctrl-klik asli, yang penangkapan mouse mencegat. Di terminal terintegrasi VS Code dan terminal berbasis xterm.js serupa, terus gunakan Cmd-klik. Claude Code menunda ke penanganan tautan terminal sendiri di sana untuk menghindari pembukaan tautan dua kali.
- Klik dan seret untuk memilih teks di mana saja dalam percakapan. Klik ganda memilih kata, mencocokkan batas kata iTerm2 sehingga jalur file memilih sebagai satu unit. Klik tiga kali memilih baris.
- Gulir dengan roda mouse untuk bergerak melalui percakapan.
Teks yang dipilih disalin ke clipboard Anda secara otomatis saat pelepasan mouse. Untuk mematikan ini, alihkan Copy on select di /config. Dengan itu dimatikan, tekan Ctrl+Shift+c untuk menyalin secara manual. Di terminal yang mendukung protokol keyboard kitty, seperti kitty, WezTerm, Ghostty, dan iTerm2, Cmd+c juga berfungsi. Jika Anda memiliki pemilihan aktif, Ctrl+c menyalin alih-alih membatalkan.
Gulir percakapan
Rendering fullscreen menangani scrolling di dalam aplikasi. Gunakan pintasan ini untuk menavigasi:
| Pintasan | Tindakan |
|---|
PgUp / PgDn | Gulir naik atau turun setengah layar |
Ctrl+Home | Lompat ke awal percakapan |
Ctrl+End | Lompat ke pesan terbaru dan aktifkan kembali auto-follow |
| Roda mouse | Gulir beberapa baris sekaligus |
Pada keyboard tanpa tombol PgUp, PgDn, Home, atau End khusus, seperti keyboard MacBook, tahan Fn dengan tombol panah: Fn+↑ mengirim PgUp, Fn+↓ mengirim PgDn, Fn+← mengirim Home, dan Fn+→ mengirim End. Itu membuat Ctrl+Fn+→ pintasan lompat-ke-bawah. Jika itu terasa canggung, gulir ke bawah dengan roda mouse untuk melanjutkan mengikuti, atau ikat ulang scroll:bottom ke sesuatu yang dapat dijangkau.
Menggulir naik menjeda auto-follow sehingga output baru tidak menarik Anda kembali ke bawah. Tekan Ctrl+End atau gulir ke bawah untuk melanjutkan mengikuti.
Tindakan ini dapat diikat ulang. Lihat Keybindings untuk menyesuaikannya. Nama tindakan adalah scroll:pageUp, scroll:pageDown, scroll:top, dan scroll:bottom. Tindakan tambahan tanpa pengikatan default termasuk scroll:lineUp, scroll:lineDown, scroll:halfPageUp, scroll:halfPageDown, scroll:fullPageUp, dan scroll:fullPageDown.
Jika scrolling roda mouse terasa lambat, terminal Anda mungkin mengirim satu peristiwa scroll per takik fisik tanpa pengganda. Beberapa terminal, seperti Ghostty dan iTerm2 dengan scrolling lebih cepat diaktifkan, sudah memperkuat peristiwa roda. Yang lain, termasuk terminal terintegrasi VS Code, mengirim tepat satu peristiwa per takik. Claude Code tidak dapat mendeteksi mana.
Atur CLAUDE_CODE_SCROLL_SPEED untuk mengalikan jarak scroll dasar:
export CLAUDE_CODE_SCROLL_SPEED=3
Nilai 3 cocok dengan default di vim dan aplikasi serupa. Pengaturan menerima nilai dari 1 hingga 20.
Cari dan tinjau percakapan
Tekan Ctrl+o untuk memasuki mode transkrip. Dengan rendering fullscreen aktif, mode transkrip mendapatkan navigasi dan pencarian gaya less:
| Kunci | Tindakan |
|---|
/ | Buka pencarian. Ketik untuk menemukan kecocokan, Enter untuk menerima, Esc untuk membatalkan dan mengembalikan posisi scroll Anda |
n / N | Lompat ke kecocokan berikutnya atau sebelumnya. Bekerja setelah Anda menutup bilah pencarian |
j / k atau ↑ / ↓ | Gulir satu baris |
g / G atau Home / End | Lompat ke atas atau bawah |
Ctrl+u / Ctrl+d | Gulir setengah halaman |
Ctrl+b / Ctrl+f atau Space / b | Gulir halaman penuh |
Esc, q, atau Ctrl+o | Keluar dari mode transkrip |
Cmd+f dan pencarian tmux terminal Anda tidak melihat percakapan karena berada di buffer layar alternatif, bukan scrollback asli. Untuk mengembalikan konten ke terminal Anda, tekan Ctrl+o untuk memasuki mode transkrip terlebih dahulu, kemudian:
[: menulis percakapan lengkap ke buffer scrollback asli terminal Anda, dengan semua output alat diperluas. Percakapan sekarang merupakan teks biasa di terminal Anda, sehingga Cmd+f, mode salinan tmux, dan alat asli lainnya dapat mencari atau memilihnya. Sesi panjang mungkin berhenti sejenak saat ini terjadi. Ini berlangsung sampai Anda keluar dari mode transkrip dengan Esc atau q, yang mengembalikan Anda ke rendering fullscreen. Ctrl+o berikutnya dimulai segar.
v: menulis percakapan ke file sementara dan membukanya di $VISUAL atau $EDITOR.
Tekan Esc, q, atau Ctrl+o untuk kembali ke prompt.
Gunakan dengan tmux
Rendering fullscreen bekerja di dalam tmux, dengan dua peringatan.
Scrolling roda mouse memerlukan mode mouse tmux. Jika ~/.tmux.conf Anda belum mengaktifkannya, tambahkan baris ini dan muat ulang konfigurasi Anda:
Tanpa mode mouse, peristiwa roda pergi ke tmux alih-alih Claude Code. Scrolling keyboard dengan PgUp dan PgDn bekerja baik cara. Claude Code mencetak petunjuk satu kali saat startup jika mendeteksi tmux dengan mode mouse dimatikan.
Rendering fullscreen tidak kompatibel dengan mode integrasi tmux iTerm2, yang merupakan mode yang Anda masuki dengan tmux -CC. Dalam mode integrasi, iTerm2 merender setiap panel tmux sebagai pemisah asli daripada membiarkan tmux menggambar ke terminal. Buffer layar alternatif dan pelacakan mouse tidak bekerja dengan benar di sana: roda mouse tidak melakukan apa pun, dan klik ganda dapat merusak status terminal. Jangan aktifkan rendering fullscreen di sesi tmux -CC. Tmux reguler di dalam iTerm2, tanpa -CC, bekerja dengan baik.
Pertahankan pemilihan teks asli
Penangkapan mouse adalah titik gesekan paling umum, terutama melalui SSH atau di dalam tmux. Ketika Claude Code menangkap peristiwa mouse, copy-on-select asli terminal Anda berhenti bekerja. Pemilihan yang Anda buat dengan klik-dan-seret ada di dalam Claude Code, bukan di buffer pemilihan terminal Anda, sehingga mode salinan tmux, petunjuk Kitty, dan alat serupa tidak melihatnya.
Claude Code mencoba menulis pemilihan ke clipboard Anda, tetapi jalur yang digunakan tergantung pada pengaturan Anda. Di dalam tmux itu menulis ke buffer pasta tmux. Melalui SSH itu kembali ke urutan escape OSC 52, yang beberapa terminal blokir secara default. Claude Code mencetak toast setelah setiap salinan memberi tahu Anda jalur mana yang digunakan.
Jika Anda mengandalkan pemilihan asli terminal Anda, atur CLAUDE_CODE_DISABLE_MOUSE=1 untuk keluar dari penangkapan mouse sambil mempertahankan rendering bebas flicker dan memori datar:
CLAUDE_CODE_NO_FLICKER=1 CLAUDE_CODE_DISABLE_MOUSE=1 claude
Dengan penangkapan mouse dinonaktifkan, scrolling keyboard dengan PgUp, PgDn, Ctrl+Home, dan Ctrl+End masih berfungsi, dan terminal Anda menangani pemilihan secara asli. Anda kehilangan klik-untuk-memposisikan-kursor, klik-untuk-memperluas-output-alat, klik-URL, dan scrolling roda di dalam Claude Code.
Pratinjau penelitian
Rendering fullscreen adalah fitur pratinjau penelitian. Ini telah diuji pada emulator terminal umum, tetapi Anda mungkin mengalami masalah rendering pada terminal yang kurang umum atau konfigurasi yang tidak biasa.
Jika Anda mengalami masalah, jalankan /feedback di dalam Claude Code untuk melaporkannya, atau buka masalah di repositori GitHub claude-code. Sertakan nama dan versi emulator terminal Anda.
Untuk mematikan rendering fullscreen, batalkan pengaturan variabel lingkungan atau atur CLAUDE_CODE_NO_FLICKER=0.