Claude Chill: Memperbaiki gejala kedipan Claude Code di terminal

 (github.com/davidbeesley)
6 poin oleh GN⁺ 2026-01-23 | 1 komentar | Bagikan ke WhatsApp
  • Claude Chill adalah alat proxy PTY yang mengurangi masalah lag dan kedipan yang terjadi saat Claude Code berulang kali menggambar ulang seluruh terminal
  • Mencegat output sinkron (sync blocks) yang digunakan Claude Code, lalu dengan rendering berbasis VT100 hanya memperbarui bagian layar yang berubah
  • Mempertahankan buffer riwayat sehingga scrollback tetap tersedia, dan bisa masuk ke mode lookback dengan tombol Ctrl+6 untuk melihat seluruh riwayat output
  • Menyediakan fitur auto-lookback yang secara otomatis melakukan dump riwayat jika tidak ada input selama jangka waktu tertentu
  • Berjalan di Linux dan macOS, sebagai solusi ringan untuk meningkatkan performa dan keterbacaan terminal

Ikhtisar

  • Claude Chill adalah program proxy PTY yang dibuat untuk mengatasi masalah output terminal pada Claude Code
    • Claude Code membungkus seluruh output dalam blok sinkron dan merendernya sekaligus, tetapi dalam proses ini terjadi penyegaran layar penuh hingga ribuan baris
    • Akibatnya muncul masalah seperti lag, kedipan, dan hilangnya scrollback
  • Claude Chill berada di antara terminal dan Claude Code untuk menerapkan hanya perbedaan output, sambil mempertahankan buffer riwayat

Fitur utama

  • Mencegat blok sync: mendeteksi dan memproses blok sinkron besar yang dikirim Claude Code
  • Rendering berbasis VT: menggunakan emulator VT100 untuk melacak status layar dan hanya menampilkan bagian yang berubah
  • Penyimpanan riwayat dan mode lookback: menyimpan output dalam buffer sehingga log lama dapat dilihat kembali
    • Masuk ke mode lookback dengan tombol Ctrl+6
    • Menghentikan sementara output Claude dan menampilkan seluruh riwayat di terminal
    • Bisa keluar dengan menekan tombol itu lagi atau Ctrl+C
  • Auto-lookback: jika tidak ada input selama waktu tertentu (default 15 detik), riwayat akan di-dump secara otomatis
    • Bisa dinonaktifkan dengan opsi -a 0
    • Saat dump otomatis, layar bisa berkedip sebentar

Instalasi dan penggunaan

  • Instalasi: 
    cargo install --path crates/claude-chill
  • Contoh menjalankan:
    • Menjalankan default: claude-chill claude
    • Meneruskan argumen: claude-chill -- claude --verbose
    • Menentukan ukuran riwayat: claude-chill -H 50000 claude
    • Menonaktifkan auto-lookback: claude-chill -a 0 claude
  • Opsi utama:
    • -H, --history: jumlah maksimum baris riwayat (default 100000)
    • -k, --lookback-key: tombol untuk berpindah ke mode lookback
    • -a, --auto-lookback-timeout: waktu tunggu auto-lookback (ms)

Berkas konfigurasi

  • Lokasi:
    • Linux: ~/.config/claude-chill.toml
    • macOS: ~/Library/Application Support/claude-chill.toml
  • Item utama:
    • history_lines: jumlah maksimum baris riwayat
    • lookback_key: tombol untuk berpindah ke mode lookback
    • refresh_rate: FPS rendering
    • auto_lookback_timeout_ms: waktu auto-lookback

Protokol keyboard dan pengaturan tombol

  • Mendukung Kitty Keyboard Protocol dan akan otomatis beralih mode di terminal yang mendukungnya (Kitty, Ghostty, WezTerm, dll.)
    • Jika Claude Code mengaktifkan mode Kitty, Claude Chill juga otomatis mengenali encoding tersebut
  • Format tombol: [modifier][key]
    • Contoh: [f12], [ctrl][g], [ctrl][shift][j]
  • Tombol default Ctrl+6 mengirim ASCII 0x1E dan tidak berbenturan dengan sebagian besar terminal
    • Di macOS, Ctrl+Shift+6 (Ctrl+^) memberikan perilaku yang sama

Cara kerja

  • Claude Chill membuat terminal virtual (PTY) dan menjalankan Claude Code sebagai proses anak
  • Struktur proxy I/O: 
    Terminal ⇄ claude-chill ⇄ Claude Code
  • Tahapan pemrosesan utama:
    • Input: diteruskan ke Claude, hanya tombol lookback yang dicegat
    • Output: mendeteksi blok sinkron dan meneruskan output asinkron apa adanya
    • Melacak status layar dengan emulasi VT
    • Membandingkan dengan status sebelumnya lalu merender hanya perbedaannya
    • Mempertahankan buffer riwayat dan mendukung mode lookback
    • Meneruskan sinyal seperti SIGWINCH, SIGINT, SIGTERM ke Claude

Hal yang perlu diperhatikan

  • Ini adalah alat yang dikembangkan untuk kenyamanan pribadi, dan belum melalui pengujian yang luas
  • Sudah dipastikan berjalan di Linux dan macOS
  • Tidak disarankan digunakan di sistem penting atau lingkungan infrastruktur
  • Lisensi MIT

Bacaan terkait

1 komentar

 
GN⁺ 2026-01-23
Komentar Hacker News

  • Saya menangani rendering TUI Claude Code
    Maaf atas ketidaknyamanan yang sudah berlangsung lama, tetapi hari ini kami telah meluncurkan differential renderer untuk semua pengguna
    Kami menulis ulang sistem rendering sepenuhnya, dan sekarang hanya sekitar 1/3 sesi yang masih mengalami flicker sesekali. Flicker yang terus-menerus hampir hilang
    Saya juga telah mengajukan patch dukungan synchronized output (DEC mode 2026) untuk terminal VSCode dan tmux, dan itu sudah di-merge
    Jika ingin benar-benar tanpa flicker, saya merekomendasikan Ghostty. Detail terkait bisa dilihat di komentar issue #769, xterm.js PR #5453, tmux PR #4744

    • Saya penasaran kenapa komunikasi resmi soal masalah sepenting ini sangat minim
      Issue GitHub(#1913, #826, #3648) mendapat komentar setiap hari, tetapi sejak rollback pada Desember hampir tidak ada tanggapan dari Anthropic
      Saya paham tingkat kesulitan teknisnya, tetapi kurangnya komunikasi tampaknya membuat kepercayaan pengguna menurun
    • Saya memakai paket $200 dan API request timeout sering terjadi
      Saya hanya menjalankan satu atau dua agen, tetapi masalah ini tetap muncul. Saya penasaran apakah mungkin masih ada rate limit dari paket sebelumnya, atau sesi dengan konteks panjang yang menjadi penyebabnya
      Meski begitu, alat ini tetap sangat menarik karena membantu saya membuat aplikasi yang sebelumnya tidak mungkin dibuat
    • Saya berharap issue #769 mendapat perhatian lebih
      Di macOS iTerm, setiap kali jendela kehilangan fokus, layar akan bergulir ke atas dan itu sangat mengganggu
    • Sebelum merekomendasikan Ghostty, saya sarankan membaca tulisan ini
      Sejak Ghostty 1.0 ada memory leak, dan aplikasi CLI seperti Claude Code sering menciptakan kondisi yang memunculkan masalah itu
      Perbaikannya sudah di-merge dan akan masuk dalam rilis 1.3
    • Saya penasaran apakah ada rencana untuk memisahkan TUI dan UI agar siapa pun bisa membuat antarmuka mereka sendiri
      Jika bisa dikonfigurasi secara fleksibel seperti Zed, rasanya pengalamannya akan jauh lebih baik

  • Saya sudah beberapa bulan tidak memakai Claude Code, dan ternyata flicker masih belum diperbaiki itu cukup mengejutkan
    Saya jadi berpikir alasan belum di-open-source bukan karena persaingan, melainkan mungkin karena codebase-nya terlalu berantakan

    • Penyebab masalah ini adalah library Ink yang setiap update menghapus seluruh tampilan lalu menggambarnya ulang
      Ada penjelasan terkait di issue #769
      Saya sudah mem-patch paket npm secara lokal, tetapi belum sempurna. Secara struktural cara rendering-nya memang harus diubah
      Sebagai perbandingan, OpenAI Codex ditulis dengan Rust + ratatui sehingga tidak mengalami masalah ini
    • Dugaan saya, tim Claude Code mengembangkan Claude Code dengan Claude Code, jadi penyelesaiannya berjalan lambat
      Bug rumit seperti ini pada akhirnya tetap harus diperbaiki langsung oleh manusia yang duduk dan mengerjakannya di akhir pekan, tetapi tampaknya mereka hanya menjalankan agen saja
    • Anthropic pernah berkata “90% kode akan ditulis AI”, tetapi ironisnya mereka bahkan tidak bisa memperbaiki bug flicker yang mendasar
      Alat CLI lain(opencode, codex, gemini, droid, dll.) tidak punya masalah ini
    • Tampaknya timnya sedang bertahan di tengah terlalu banyak issue dan perubahan model yang sangat cepat
      Kalau pernah benar-benar memakainya di lingkungan tmux, pasti tahu betapa menyiksanya ini, tetapi saya tetap ingin sedikit memakluminya
    • Codex jauh lebih halus dan stabil dibanding Claude Code. Fakta bahwa Codex ditulis dengan Rust tampaknya membuat perbedaan besar

  • Saya ingin memakai Claude Code, tetapi tidak bisa karena fitur scrollback Ghostty rusak
    PTY proxy mencegat output stream sehingga akses ke buffer internal Ghostty terhalang

    • Saya tidak merasakan masalah scroll di Ghostty. Hanya saja saya agak kecewa karena tidak ada scrollbar
    • Saya sarankan mencoba tmux. Memang tidak ada smooth scrolling, tetapi fiturnya beragam sehingga tetap memuaskan

  • Saya penasaran apa sebenarnya yang dimaksud dengan flickering
    Kadang Claude Code tiba-tiba tergulir ke atas sehingga sulit menurunkannya lagi, dan terminal harus direstart agar kembali normal

    • Saya juga mengalami masalah yang sama. Di macOS iTerm2 juga begitu, dan restart sesi adalah satu-satunya solusi sementara
    • Di terminal VSCode, bukan hanya Claude Code tetapi Gemini juga lebih parah. Setelah pindah ke Ghostty, masalahnya sepenuhnya hilang

  • Akan bagus kalau ada fitur toggle untuk mengunci kolom input di bagian bawah terminal
    Terus-menerus scroll bolak-balik antara chat dan kolom input itu merepotkan

    • Saya juga terpikir hal yang sama saat memakainya di lingkungan tmux–mosh–mobile
      Dari sisi kegunaan di perangkat mobile, ini terasa seperti fitur yang benar-benar game changer

  • Menarik melihat format readme.md karena terasa seperti ditulis langsung oleh Claude Code

    • Tetapi CC sendiri mungkin bukan yang menulisnya, melainkan kemungkinan hasil yang dibuat lewat model lain(Codex, Gemini, dll.)

  • Update kali ini tampaknya adalah kontribusi terbesar untuk Claude Code dalam beberapa bulan terakhir
    Saya akan langsung menginstal dan mengujinya

  • Sebagai kabar terkait, saya melihat posting sebelumnya yang mengatakan “terminal rendering Claude Code membaik 85%”

    • Tetapi masalah scroll masih tetap ada

  • Terima kasih karena akhirnya mengurangi flickering. Ini adalah bug pemicu sakit kepala, jadi sekarang rasanya sedikit lebih lega
    Saya berharap Anthropic bisa segera menuntaskan masalah ini sepenuhnya

  • Codex jauh lebih responsif meski sesi sudah panjang, sedangkan Claude mulai terasa berat seiring waktu

    • Fakta bahwa Codex ditulis dengan Rust tampaknya memang membuat perbedaan besar