Claude Chill: Terminalde Claude Code titreme sorununu düzeltmek

 (github.com/davidbeesley)
6 puan yazan GN⁺ 2026-01-23 | 1 yorum | WhatsApp'ta paylaş
  • Claude Chill, Claude Code terminalin tamamını tekrar tekrar yeniden çizdiğinde ortaya çıkan gecikme ve titreme sorunlarını hafifleten bir PTY proxy aracı
  • Claude Code’un kullandığı senkronize çıktılarını (sync blocks) yakalar ve VT100 tabanlı render ile ekranın yalnızca değişen kısımlarını günceller
  • Geçmiş tamponunu koruyarak scrollback’i mümkün kılar; Ctrl+6 tuşuyla ‘lookback modu’na girip tüm çıktı geçmişi görülebilir
  • Belirli bir süre giriş olmazsa geçmişi otomatik olarak döken otomatik lookback (auto-lookback) özelliği sunar
  • Linux ve macOS’ta çalışır; terminal performansını ve okunabilirliği iyileştiren hafif bir çözüm

Genel Bakış

  • Claude Chill, Claude Code’un terminal çıktı sorunlarını çözmek için yapılmış bir PTY proxy programı
    • Claude Code, çıktının tamamını senkronizasyon bloklarıyla sarıp tek seferde render eder; ancak bu süreçte binlerce satırlık tam ekran yenilemeleri oluşur
    • Bunun sonucunda gecikme, titreme, scrollback kaybı gibi sorunlar ortaya çıkar
  • Claude Chill, terminal ile Claude Code arasına yerleşerek yalnızca çıktı farklarını uygular ve geçmiş tamponunu korur

Başlıca Özellikler

  • Sync bloklarını yakalama: Claude Code’un gönderdiği büyük senkronizasyon bloklarını algılar ve işler
  • VT tabanlı render: VT100 emülatörü kullanarak ekran durumunu izler ve yalnızca değişen bölümleri yazar
  • Geçmiş koruma ve lookback modu: Çıktıları tamponda saklayarak eski logların görüntülenmesini sağlar
    • Ctrl+6 tuşuyla lookback moduna girilir
    • Claude’un çıktısı geçici olarak duraklatılır ve tüm geçmiş terminalde gösterilir
    • Tuşa yeniden basarak veya Ctrl+C ile çıkılabilir
  • Otomatik lookback (auto-lookback): Belirli bir süre (varsayılan 15 saniye) giriş olmazsa geçmişi otomatik olarak döker
    • -a 0 seçeneğiyle devre dışı bırakılabilir
    • Otomatik döküm sırasında ekran kısa süreliğine titreyebilir

Kurulum ve Kullanım

  • Kurulum: 
    cargo install --path crates/claude-chill
  • Çalıştırma örnekleri:
    • Temel kullanım: claude-chill claude
    • Argüman aktarma: claude-chill -- claude --verbose
    • Geçmiş boyutunu belirleme: claude-chill -H 50000 claude
    • Otomatik lookback’i devre dışı bırakma: claude-chill -a 0 claude
  • Başlıca seçenekler:
    • -H, --history: Maksimum geçmiş satırı sayısı (varsayılan 100000)
    • -k, --lookback-key: Lookback modu geçiş tuşu
    • -a, --auto-lookback-timeout: Otomatik lookback bekleme süresi (ms)

Yapılandırma Dosyası

  • Konum:
    • Linux: ~/.config/claude-chill.toml
    • macOS: ~/Library/Application Support/claude-chill.toml
  • Başlıca alanlar:
    • history_lines: Maksimum geçmiş satırı sayısı
    • lookback_key: Lookback modu geçiş tuşu
    • refresh_rate: Render FPS değeri
    • auto_lookback_timeout_ms: Otomatik lookback süresi

Klavye Protokolü ve Tuş Ayarları

  • Kitty Keyboard Protocol destekleyen terminallerde (Kitty, Ghostty, WezTerm vb.) otomatik olarak mod değiştirir
    • Claude Code Kitty modunu etkinleştirirse Claude Chill de ilgili kodlamayı otomatik olarak tanır
  • Tuş biçimi: [modifier][key]
    • Örnek: [f12], [ctrl][g], [ctrl][shift][j]
  • Varsayılan tuş Ctrl+6, ASCII 0x1E gönderir ve çoğu terminalle çakışmaz
    • macOS’ta Ctrl+Shift+6 (Ctrl+^) ile aynı işlev çalışır

Çalışma Şekli

  • Claude Chill, sanal bir terminal (PTY) oluşturur ve Claude Code’u alt süreç olarak çalıştırır
  • Giriş/çıkış proxy yapısı: 
    Terminal ⇄ claude-chill ⇄ Claude Code
  • Başlıca işleme adımları:
    • Girdi: Claude’a iletilir, yalnızca lookback tuşu engellenir
    • Çıktı: Senkronizasyon blokları algılanır, asenkron çıktılar olduğu gibi iletilir
    • VT emülasyonu ile ekran durumu izlenir
    • Önceki durumla karşılaştırılarak yalnızca farklar render edilir
    • Geçmiş tamponu korunur ve lookback modu desteklenir
    • SIGWINCH, SIGINT, SIGTERM gibi sinyaller Claude’a iletilir

Dikkat Edilmesi Gerekenler

  • Kişisel kullanım kolaylığı için geliştirilmiş bir araçtır; kapsamlı testlerden geçmemiştir
  • Linux ve macOS üzerinde çalıştığı doğrulanmıştır
  • Kritik sistemlerde veya altyapı ortamlarında kullanılması önerilmez
  • MIT lisansı

İlgili okumalar

1 yorum

 
GN⁺ 2026-01-23
Hacker News görüşleri

  • Claude Code’un TUI render’ından ben sorumluyum
    Uzun süredir yaşattığımız rahatsızlık için özür dilerim ama bugün tüm kullanıcılara diferansiyel renderer’ı dağıttık
    Render sistemini baştan sona yeniden yazdık ve artık oturumların yalnızca yaklaşık 1/3’ü aralıklı flicker yaşıyor. Sürekli flicker ise neredeyse ortadan kalktı
    Ayrıca VSCode terminali ve tmux için senkronize çıktı (DEC mode 2026) desteği yamasını sundum ve bu yamalar zaten birleştirildi
    Tamamen flicker’sız bir deneyim istiyorsanız Ghostty’yi öneririm. Ayrıntılar için issue #769 yorumu, xterm.js PR #5453, tmux PR #4744 bağlantılarına bakabilirsiniz

    • Neden bu kadar önemli bir sorun hakkında resmî iletişim bu kadar azdı merak ediyorum
      GitHub issue’larında(#1913, #826, #3648) her gün yorum geliyor ama Aralık ayındaki rollback’ten sonra Anthropic’ten neredeyse hiç yanıt gelmedi
      Teknik zorluğu anlıyorum ama iletişim eksikliği sanki kullanıcı güvenini zedeledi
    • $200’lük planı kullanıyorum ama API istek zaman aşımı sık sık yaşanıyor
      Yalnızca bir iki ajan çalıştırıyor olmama rağmen bu oluyor. Acaba önceki planın rate limit’i hâlâ geçerli olabilir mi ya da sebep uzun context oturumları olabilir mi diye merak ediyorum
      Yine de bu araç sayesinde daha önce imkânsız olan uygulamaları yapabiliyor olmak gerçekten heyecan verici
    • issue #769 ile biraz daha ilgilenilmesini isterdim
      macOS iTerm’de pencere odağını her kaybettiğimde ekran yukarı kayıyordu ve bu çok can sıkıcıydı
    • Ghostty’yi önermeden önce şu yazının okunmasını tavsiye ederim
      Ghostty 1.0’dan beri bir bellek sızıntısı vardı ve Claude Code gibi CLI uygulamaları bu koşulları sık sık oluşturduğu için sorun görünür hâle gelmişti
      Düzeltme zaten merge edildi ve 1.3 sürümüne dâhil edilecek
    • Acaba TUI ile UI’ı ayırıp herkesin kendi arayüzünü yapmasına izin verme planı var mı merak ediyorum
      Zed gibi esnek biçimde yapılandırılabilirse deneyim çok daha iyi olabilir

  • Aylardır Claude Code kullanmıyordum; flicker sorununun hâlâ çözülmemiş olmasına şaşırdım
    Açık kaynak yapılmamasının nedeni rekabet değil de belki kod tabanının dağınık olmasıdır diye düşündürüyor

    • Sorunun kaynağı, Ink kütüphanesinin her güncellemede her şeyi silip yeniden çizmesi
      Bununla ilgili içerik issue #769’da var
      Ben yerelde npm paketine yama uyguladım ama bu mükemmel değil. Yapısal olarak render yaklaşımının değişmesi gerekiyor
      Bu arada OpenAI Codex Rust + ratatui ile yazıldığı için böyle bir sorun yaşamıyor
    • Benim tahminim, Claude Code ekibi Claude Code’u Claude Code ile geliştiriyor, bu yüzden sorun çözümü yavaş ilerliyor
      Böyle karmaşık bug’larda sonunda bir insanın hafta sonunda oturup doğrudan düzeltme yapması gerekir ama sanki yalnızca ajan çalıştırıyorlar
    • Anthropic, “kodun %90’ını AI yazacak” dedi ama işin ironik tarafı temel bir flicker bug’ını bile düzeltememeleri
      Diğer CLI araçlarında(opencode, codex, gemini, droid vb.) böyle bir sorun yok
    • Ekip sanki fazla fazla issue ve hızlı model değişimleri altında ayakta kalmaya çalışıyor
      Bunu tmux ortamında bizzat kullanmış olsalardı ne kadar acı verici olduğunu bilirlerdi, ama yine de biraz anlayış göstermek istiyorum
    • Codex, Claude Code’a kıyasla çok daha akıcı ve kararlı. Rust ile yazılmış olmasının büyük fark yarattığı anlaşılıyor

  • Claude Code kullanmak istiyorum ama Ghostty’nin scrollback özelliği bozuk olduğu için kullanamıyorum
    PTY proxy çıktı akışını araya girerek yakaladığı için Ghostty’nin dahili buffer’ına erişim engelleniyor

    • Ghostty’de scroll sorununu ben fark etmedim. Yalnızca scrollbar olmaması üzücü
    • tmux denemenizi tavsiye ederim. Akıcı scroll yok ama çeşitli özellikleri sayesinde tatmin edici

  • flickering’in tam olarak ne olduğunu merak ediyordum
    Bazen Claude Code aniden yukarı kayıyor, tekrar aşağı inmek zorlaşıyor ve ancak terminali yeniden başlatınca normale dönüyor

    • Ben de aynı sorunu yaşıyorum. macOS iTerm2’de de aynı ve oturumu yeniden başlatmak tek geçici çözüm
    • VSCode terminalinde yalnızca Claude Code’da değil, Gemini’de de daha kötüydü. Ghostty’ye geçince tamamen çözüldü

  • Giriş kutusunu terminalin altına sabitleyen bir aç/kapat özelliği olsa güzel olurdu
    Sohbet ile giriş kutusu arasında sürekli scroll yapmak zahmetli

    • Ben de tmux–mosh–mobil ortamında kullanırken aynı şeyi düşündüm
      Mobil kullanılabilirlik açısından oyun değiştirici seviyesinde bir özellik olabilir

  • readme.md formatına bakınca sanki Claude Code doğrudan yazmış gibi hissettirmesi ilginç

    • Ama CC metni bizzat yazmıyor olabilir; muhtemelen başka modeller(Codex, Gemini vb.) üzerinden üretilmiş bir sonuçtur

  • Bu güncelleme sanki son birkaç ayda Claude Code’a yapılan en büyük katkı gibi görünüyor
    Hemen kurup test edeceğim

  • İlgili bir gelişme olarak, “Claude Code’un terminal render’ını %85 iyileştirdik” diyen önceki gönderiyi görmüştüm

    • Ama buna rağmen scroll sorunu hâlâ duruyor

  • Sonunda flicker’ı azalttığınız için teşekkürler. Baş ağrısı yapan bir bug’dı; artık biraz rahatlayacağım gibi
    Anthropic’in bu sorunu tamamen ve hızlıca çözmesini umuyorum

  • Codex, oturum uzadığında bile çok daha iyi tepki veriyor; Claude ise zaman geçtikçe ağırlaşıyor

    • Codex’in Rust ile yazılmış olması gerçekten belirgin bir fark yaratıyor