Claude Code Unpacked: Görsel Rehber

 (ccunpacked.dev)
31 puan yazan GN⁺ 29 일 전 | 1 yorum | WhatsApp'ta paylaş
  • Claude Code'un genel yapısını ve iç işleyişini görsel olarak analiz eden gayriresmî bir proje; girdi işlemeden yanıtın render edilmesine kadar ajan döngüsünü ve 50'den fazla araç sistemini keşfetmeyi mümkün kılıyor
  • Toplam 804 dosya, 220 binden fazla satır kod, 40'tan fazla komut ve 22'den fazla araçtan oluşuyor; Anthropic ile bağlantısı olmayan bağımsız bir analiz sonucu
  • Ajan döngüsü, girdi, mesaj, sistem, API, araç çağrısı, render gibi 11 aşamalı bir işleme sürecinden oluşuyor ve Claude Code'un yanıt üretim sürecini izlemeyi sağlıyor
  • Araç sistemi ve komut kataloğu üzerinden dosya işlemleri, çalıştırma, arama, planlama, sistem yönetimi gibi ayrıntılı işlevler sınıflandırılıyor; ayrıca çok sayıda özel/deneysel özellik de yer alıyor
  • Buddy, Kairos, UltraPlan, Coordinator Mode gibi gizli özellikler sayesinde uzun vadeli planlama, paralel çalışma, uzaktan kontrol, kalıcı oturumlar gibi genişletilmiş davranışlar destekleniyor

Claude Code'un yapısı ve iç işleyişi

  • Claude Code'un girdi işlemeden yanıtın render edilmesine kadar tüm ajan döngüsünü (agent loop), 50'den fazla aracı, çoklu ajan orkestrasyonunu ve özel özellikleri görsel olarak keşfetmeye imkân veren bir proje
  • Toplam 804 dosya, 220 binden fazla satır kod, 40'tan fazla komut ve 22'den fazla araçtan oluşuyor
  • Açık kaynak kod temel alınarak analiz edilmiş olup, Anthropic ile bağlantısı olmayan gayriresmî bir proje
  • Analiz tarihi 31 Mart 2026, kürasyonu zackautocracy tarafından DeepWiki ile birlikte yapılmış

  • Ajan döngüsü

    • Kullanıcı bir mesaj girdiğinde Claude Code, girdi → mesaj → geçmiş → sistem → API → token → araç → döngü → render → hook → bekleme şeklinde 11 aşamadan geçiyor
    • Girdi, Ink'in TextInput bileşeni üzerinden işleniyor; etkileşimsiz modda ise standart girdi (stdin) kullanılıyor
    • Her aşama, Claude Code'un mesajı alıp yanıt üretme sürecini ayrıntılı biçimde izlemeyi sağlayacak şekilde yapılandırılmış

  • Mimari gezgini

    • Tüm kaynak ağacı tıklanarak gezilebiliyor ve ana bileşenler şunlardan oluşuyor
      • Tools & Commands: yerleşik araçlar ve komutlar
      • Core Processing: çekirdek işleme mantığı
      • UI Layer: kullanıcı arayüzü bileşenleri
      • Infrastructure: altyapı ve çalışma ortamı
      • Support & Utilities: yardımcı araçlar
      • Personality & UX: kullanıcı deneyimiyle ilgili öğeler

Araç ve komut sistemi

  • Araç sistemi

    • Claude Code'un çağırabildiği 22'den fazla yerleşik araç işlevlerine göre sınıflandırılmış

    • Dosya işlemleri

      • FileRead, FileEdit, FileWrite, Glob, Grep, NotebookEdit gibi 6 araç

    • Çalıştırma

      • Bash, PowerShell, REPL gibi 3 araç

    • Arama ve getirme

      • WebBrowser🔒, WebFetch, WebSearch, ToolSearch gibi 4 araç

    • Ajanlar ve görevler

      • Agent, SendMessage, TaskCreate, TaskList, TeamCreate gibi 11 araç

    • Planlama

      • EnterPlanMode, ExitPlanMode, VerifyPlanExecution🔒 gibi 5 araç

    • MCP ile ilgili

      • ListMcpResources, ReadMcpResource, McpAuth gibi 4 araç

    • Sistem

      • AskUserQuestion, TodoWrite, Config, Workflow🔒, TerminalCapture🔒 gibi 11 araç

    • Deneysel özellikler

      • Sleep, SendUserMessage, LSP🔒, PushNotification🔒 gibi 8 araç

  • Komut kataloğu

    • Claude Code'da kullanılabilen tüm slash komutları işlevlerine göre sınıflandırılmış

    • Ayarlar ve yapılandırma

      • /init, /login, /logout, /config, /permissions, /model, /theme gibi 12 komut

    • Günlük iş akışı

      • /compact, /memory, /context, /plan, /resume, /files, /summary gibi 24 komut

    • Kod inceleme ve Git

      • /review, /commit, /diff, /branch, /issue, /autofix-pr🔒 gibi 13 komut

    • Hata ayıklama ve tanılama

      • /status, /stats, /usage, /think-back, /debug-tool-call, /heapdump gibi 23 komut

    • Gelişmiş ve deneysel özellikler

      • /advisor, /remote-control🔒, /teleport, /plugin, /web-setup, /help, /exit gibi 23 komut

Gizli özellikler

  • Kod içinde mevcut olan ancak henüz dağıtılmamış çok sayıda özel özellik içeriyor

  • Buddy

    • Terminal içinde bulunan bir sanal evcil hayvan; türü ve nadirliği hesap kimliğine göre belirleniyor

  • Kairos

    • Oturumlar arasında hafıza birleştirme ve otonom arka plan çalışması sağlayan kalıcı mod

  • UltraPlan

    • Opus düzeyindeki modellerde en fazla 30 dakika çalışabilen uzun vadeli planlama oturumu

  • Coordinator Mode

    • Lider ajan, işi bölüyor ve paralel worker'lar oluşturup sonuçları topluyor

  • Bridge

    • Telefon veya tarayıcıdan Claude Code'u uzaktan kontrol etme özelliği

  • Daemon Mode

    • --bg seçeneğiyle arka plan oturumu çalıştırma; içeride tmux kullanılıyor

  • UDS Inbox

    • Unix domain socket üzerinden oturumlar arası iletişim desteği

  • Auto-Dream

    • Oturumlar arasında yapay zekanın önceki etkinlikleri gözden geçirip öğrendiklerini düzenlemesi

Proje bilgileri

  • Gayriresmî bir analiz projesi olup Anthropic ile doğrudan bağlantısı yok
  • Herkese açık Claude Code kaynak kodu temel alınarak hazırlanmış; bazı içerikler hatalı veya eski sürüme ait olabilir
  • Analiz, @Fried_rice tarafından paylaşılan kaynak kod temel alınarak yapıldı
  • Yapımcı zackautocracy, DeepWiki'nin yapay zeka destekli kürasyon desteğiyle

İlgili okumalar

1 yorum

 
GN⁺ 29 일 전
Hacker News görüşleri

  • 500 bin satırlık bir ajan CLI kod tabanı, olasılıksal LLM’leri deterministik şekilde kontrol etme girişiminin ne kadar karmaşık bir durum yönetimi cehennemi olduğunu gösteriyor
    Basit platformlarda iyi çalışıyor ama büyük kurumsal depolarda kolayca kırılıyor
    Harici bir durum makinesi olmadan güvenilirliği brute force ile sağlamak gerekiyor; bu yüzden kodun %90’ı savunmacı programlamayla dolu — regex’ler, bağlam temizleme, yeniden deneme döngüleri, durum geri alma gibi yapılarla ajanın sapmasını engelliyor
    Görselleştirme harika ama sistem düzeyi yönetişimden çok hâlâ büyük bir kod yığınını zorla ilerletiyormuş hissi veriyor

    • Kod hakkında çok negatif tartışma var ama mimarinin kendisi hakkında tartışma neredeyse hiç olmaması tuhaf
      İstemci tarafının yalnızca basit bir araç seti sunduğu (read file, zengin metin çıktısı vb.) ve sunucunun hızlı inovasyon yapabilmesi için tasarlandığı noktası asıl önemli olan şey
      Sunucu ekibinin “bu sınırlı API ile ne kadar yaratıcı olabiliriz?” diye düşünmesini sağlayan yapı bence işin gizli sosu
    • İnsanları deterministik olarak kontrol etmeye dönük çok sayıda endüstriyel araştırma da vardı ama onlar bile kontrol edilemeyen bir topluluktu
    • Zaten bütün ekonomi bu tür teknolojilerin üstüne kurulu
      Eğer verilen sözler tutulamazsa bu, “kod kararsız” düzeyinde bir sorun değil, tüm finans sistemini sarsacak bir mesele olur
    • Bu kodun savunmacı programlamanın sonucu mu olduğu, yoksa AI ile kod yazarken kaçınılmaz olarak ortaya çıkan karmaşıklık mı olduğu ayırt etmesi zor
    • “Büyük şirket depolarında kırılıyor” sözüne katılmıyorum
      Meta gibi yerler tam tersine CC’yi en iyi kullanan örnekler arasında

  • Yazarıyım. Claude Code sızıntısından sadece birkaç saat sonra bu görselleştirme sitesini yaptım
    Normalde pi kullanarak kendi kodlama ajanımı geliştiriyordum ve Anthropic’in yapısını (araç sistemi, ajan döngüsü vb.) incelemek istiyordum
    500 bin satırlık kodu keşfetmek zor olduğu için referans amaçlı kullanmak üzere görsel bir harita oluşturdum
    Geri bildirim aldıkça siteyi güncellemeye devam ediyorum; eksik kalan bir şey varsa söylemeniz harika olur

    • Ben de pi ve cc’yi yerel llama.cpp ile bağlayıp tamamen çevrimdışı ortamda çalıştırıyorum
      İki sistemin tasarımını ve implementasyonunu karşılaştırmalı olarak analiz ettim; yazarın sitesinin de pi ile yapılmış gibi görünmesi etkileyiciydi
      Mümkünse bir pi vs cc görselleştirmesi de görmek isterim
    • Sitenin UX’i ve işlevselliği mükemmel. Kaynak kodunu açma planı olup olmadığını merak ediyorum
    • Yazının tonu ve ritmi çok iyi
      Ama ‘Anthropic’in mesaj formatı’ bölümüne açıklama ya da tooltip eklenirse iyi olur — çünkü fiilen OpenAI’nin formatı da sayılır
    • Yazarın ajan kurulum yöntemini daha çok öğrenmek isterim

  • AI olmadan yazılmış bir ajan harness’i olup olmadığını merak ediyorum
    Sadece model endpoint’ini çağıran basit bir TUI yapısı için 500 bin satır fazla geliyor

    • LoC zaten anlamsız bir üretkenlik metriği
      Kod yeniden kullanımı ya da kütüphaneleştirme amacı olabilir veya startup’lara özgü zaman baskısının sonucu olabilir
    • pi coding agent bakmanızı öneririm
    • CC’nin TUI’si basit bir metin arayüzü değil, React tabanlı render kullanıyor
    • Opencode’un kod kalitesi oldukça iyiydi
    • Claude Code CLI aslında headless browser’ı metne çeviren bir yapı, bu yüzden debug ederken çok rahatsız edici
      ASCII → Unicode dönüşüm sorunları yüzünden pipe’lar ya da parser’lar bozuluyor, kopyala-yapıştırı da zorlaştırıyor
      Basit olması gereken bir özellik Rube Goldberg tarzı bir makineye dönüşmüş gibi hissettiriyor

  • “500 bin satır mı, bu basit bir REPL değil mi?” diye soranlar var

    • Rakip ürünler de benzer ölçekte
      Opencode 670 bin, Codex 720 bin, Gemini ise yaklaşık 570 bin satır; yani Claude Code’un boyutu anormal değil
    • LLM’lerin karmaşıklığı nedeniyle araçların da karmaşık olması gerektiğine dair bilinçsiz bir teşvik oluşmuş olabilir
    • Gerçekte çok sayıda doğaçlama düzeltme (vibe fix) var ve tutarlı bir tasarım eksik
      Yine de cache TTL takibi gibi bazı ayrıntılı fikirler ilginçti
    • “JS/Electron olduğu için şişmiş” gibi basit eleştirilerden ziyade, gidip gerçekten okuyun (RTFA) görüşündeyim
    • Böyle bir program için uygun LoC’nin ne olması gerektiği de ayrıca tartışılıyor

  • 2020’de olsaydı, sızdırılmış kodu böyle görsel olarak analiz etmek hayal bile edilemezdi

    • O dönemin statik analiz araçlarıyla da yapılabileceğini söyleyenler var
    • Gerçekte hangi süreçle üretildiğini ve AI’nin nasıl kullanıldığını merak ediyorum

  • Ben de benzer bir siteyi 11 saat önce yaptım ama ilgi görmedi
    Yine de başka bir uygulamayı görmek hoşuma gitti
    Benim denemem burada

    • Artık herkesin benzer şeyler denediği bir dönemdeyiz; kimin dikkat çektiğinin çok da büyük önemi yok

  • Hâlâ şaşırtıcı olan şey, böyle harika bir siteyi iki günde yapabilmek

    • Muhtemelen Claude Code ile üretilmiştir
      LLM’lerin yaptığı siteler bazen görünüşte çok kaliteli ama içerik açısından düşük güvenilirlikte olabiliyor
      Örneğin nzoilwatch.com uzman işi gibi görünse de gerçekte kişisel bir proje olabilir
      LLM kullanımının açıkça belirtilmesi yanlış anlamaları azaltabilir
    • Claude’a doğru istek verilirse birkaç dakika içinde web sitesi üretebilir
    • Büyük ajan araçları geliştiren biriyle konuştum; onlar araçla araç yapıyor
      Yaptığım UI’ın zayıf olduğunu söylediğimde, bana kendi UI bileşen kütüphanelerini kullandıklarını anlattılar
      Bu yüzden ben de substrateui.dev adlı bir kütüphane yaptım ve Claude Code ile tasarım sistemini yeniden kurarken UI öğrenme sürecinin kendisinden keyif alıyorum
    • Bazıları ise bu sitenin okunabilirliğini ve etkileşimlerini rahatsız edici buluyor
    • Buna rağmen HN’de insanların LLM’lerin üretkenliği düşürdüğünü söylemesi ironik

  • Sızdırılmış kaynak kod Codeberg deposunda görülebilir

  • Anthropic’in kendi araçlarıyla kendi ürününü geliştirmesi ilginç
    Ama proje bir yıllıksa artık istikrar kazanmış olması gereken bir noktada

    • Birden fazla geliştiricinin yer aldığı bir yıllık bir projede hâlâ çok sayıda bug bulunması gayet olası
    • Teknik borcu ertelemek mantıklı bir tercih de olabilir
      Nasıl olsa gelecekte bakımı LLM’ler yapacak, dolayısıyla insanların bizzat toparlamasına gerek yok görüşü var
    • Boris Cherny doğrudan “CC’yi CC ile yapıyoruz” diye bahsediyor
    • Gerçekten de övündükleri tweet’lere bakınca, TUI API’sinin 68 GB RAM istemesi ya da metin render’ının 16 ms sürmesi gibi aşırı kaynak kullanımı örnekleri görülüyor

  • Awesome Claude Code listesine bu proje eklenebilir