CC-Viewer

🌐 Web sitesi ve özellik turu: weiesky.github.io/cc-viewer — 18 dilde mevcut.

Claude Code üzerine inşa edilmiş, kendi geliştirme deneyiminden damıtılmış bir Vibe Coding aracı:

Yetenek tavanını yükseltir — /ultraPlan ve /ultraReview komutlarını yerel olarak çalıştırırken proje kodunuzun Claude bulutuna tamamen ifşa olmasını engeller;
Çoklu cihaz uyumu — mobil cihazlarda programlama (yerel ağ üzerinden), web sürümü çeşitli senaryolara uyum sağlar, tarayıcı eklentilerine veya işletim sistemi bölünmüş ekranına kolayca gömülebilir ve native kurulum paketi de sunulur;
Eksiksiz log saklama — Claude Code'un tam payload'unu yakalama ve analiz etme yeteneği sağlar; loglama, sorun analizi, öğrenme ve tersine mühendislik için idealdir;
Öğrenme deneyimi paylaşımı — birçok öğrenme materyali ve geliştirme deneyimi biriktirilmiştir (sistemin çeşitli yerlerindeki "?" simgelerine bakın);
Native deneyimi korur — yalnızca Claude Code'un yeteneklerini geliştirir, çekirdekte herhangi bir önemli değişiklik yapmaz, native deneyimi korur;
Üçüncü taraf model uyumu — deepseek-v4-*, GLM 5.1, Kimi K2.6 ile uyumludur; yerleşik cc-switch yeteneği ile üçüncü taraf araçlar arasında istediğiniz zaman sıcak geçiş yapabilirsiniz;

Kullanım

Önkoşullar

nodejs 20.0.0+ sürümünün kurulu olduğundan emin olun; İndir ve kur
claude code'un kurulu olduğundan emin olun; Kurulum kılavuzu

ccv kurulumu

npm üzerinden kurulum

npm install -g cc-viewer --registry=https://registry.npmjs.org

Homebrew üzerinden kurulum (macOS / Linux için önerilir)

brew tap weiesky/cc-viewer
brew install cc-viewer
brew upgrade cc-viewer   # Güncelleme için bunu kullanın; brew ile kurulan ccv için npm install -g kullanmayın

Başlatma yöntemi

ccv, claude'un doğrudan yerine geçen bir araçtır: tüm parametreler claude'a aktarılır ve aynı zamanda Web Viewer başlatılır.

ccv                    # == claude (etkileşimli mod)

Yazarın en sık kullandığı komut şudur:

ccv -c --d             # == claude --continue --dangerously-skip-permissions
                       # ccv tüm claude code başlatma parametrelerini iletir, istediğiniz gibi birleştirebilirsiniz

Programlama modunu başlattıktan sonra web sayfası otomatik olarak açılır.

cc-viewer'ın istemci sürümü de mevcuttur: İndirme bağlantısı

1.7.0 sürümüne yükseltme (log formatı v2)

1.7.0 sürümünden itibaren loglar, tek .jsonl dosyaları yerine oturum başına dizin biçiminde (wire-format v2) saklanır — diskte yaklaşık %90 daha az yer kaplar. Mevcut v1 .jsonl dosyaları asla değiştirilmez veya silinmez; log iletişim kutusu varsayılan olarak v2 oturumlarını listeler ve küçük bir “Eski (v1) logları görüntüle” girişi (eski dosyalar var olduğu sürece gösterilir) bunların görüntülenebileceği, taşınabileceği veya silinebileceği bir v1 görünümü açar. Başlangıçta, eski loglar bulunduğunda cc-viewer tek tıkla taşıma sunar (claude -c ile eski bir konuşmaya devam ederken şiddetle önerilir; bu konuşmanın ilk yarısı eski dosyalarda bulunur). Taşımayı terminalden de yapabilirsiniz:

ccv convert <project>   # tek bir projeyi taşı
ccv convert --all       # tüm projeleri taşı
ccv verify <v1-file>    # bir v1 dosyasını dönüştürülmüş oturumlarıyla karşılaştır

Bir oturum golden doğrulamasını geçemezse, tüm taşımayı başarısız kılmak yerine incelenmek üzere sessions-quarantine/ içinde tutulur; diğer oturumlar yine de taşınır.

Log modu

Hâlâ claude'un native aracını veya VS Code eklentisini kullanmaya alışkınsanız bu modu kullanın.

Bu modda claude çalıştırıldığında

otomatik olarak bir log süreci başlatılır ve istek logları ~/.claude/cc-viewer/yourproject/sessions/ altındaki oturum başına dizinlere kaydedilir (wire-format v2)

Log modunu başlat:

ccv -logger

Konsol belirli bir portu yazdıramadığında, varsayılan ilk başlangıç portu 127.0.0.1:7008'dir. Birden fazla örnek aynı anda çalışıyorsa portlar sırayla 7009, 7010 şeklinde devam eder.

Log modunu kaldır:

ccv --uninstall

Sık karşılaşılan sorunların giderilmesi (Troubleshooting)

Eğer başlatma sorunlarıyla karşılaşıyorsanız nihai bir çözüm yolu vardır:

Adım: Herhangi bir dizinde claude code'u açın;
Adım: claude code'a aşağıdaki içeriği komut olarak verin:

我已经安装了cc-viewer这个npm包，但是执行ccv以后仍然无法有效运行。查看cc-viewer的cli.js 和 findcc.js，根据具体的环境，适配本地的claude code的部署方式。适配的时候修改范围尽量约束在findcc.js中。

Claude Code'un kendi başına hataları kontrol etmesine izin vermek, başkalarına danışmaktan veya herhangi bir belgeyi okumaktan daha etkilidir!

Yukarıdaki komut tamamlandıktan sonra findcc.js güncellenir. Projenizin sık sık yerel dağıtıma ihtiyacı varsa veya fork edilen kod sık sık kurulum sorunlarını çözmek zorundaysa, bu dosyayı saklayın; bir sonraki seferde doğrudan kopyalayabilirsiniz. Şu aşamada claude code kullanan birçok proje ve şirket mac'te değil, sunucu tarafında barındırılan ortamlarda dağıtım yapıyor, bu yüzden yazar findcc.js dosyasını ayırarak cc-viewer'ın kaynak kodu güncellemelerini takip etmeyi kolaylaştırmıştır.

Not: Bu uygulama claude-code-switch ve claude-code-router ile çakışır; proxy rekabeti sorunu vardır. Bu nedenle kullanırken claude-code-switch ve claude-code-router'ı mutlaka kapatın; cc-viewer içinde eşdeğer proxy hot-reload yeteneği sunulmaktadır.

Diğer yardımcı komutlar

Bakınız:

ccv -h

Sessiz mod (Silent Mode)

Varsayılan olarak ccv, claude'u sararken sessiz moddadır; terminal çıktınızın temiz kalmasını ve native deneyimle uyumlu olmasını sağlar. Tüm loglar arka planda yakalanır ve http://localhost:7008 adresinden görüntülenebilir.

Yapılandırma tamamlandıktan sonra claude komutunu normal şekilde kullanın. İzleme arayüzüne erişmek için http://localhost:7008 adresini ziyaret edin.

Özellikler

Programlama modu

ccv ile başlattıktan sonra şunu göreceksiniz:

Düzenlemeyi tamamladıktan sonra kod diff'ini doğrudan görüntüleyebilirsiniz:

Dosyaları açıp manuel olarak programlayabilseniz de, manuel programlama önerilmez — bu, eski moda programlamadır!

Mobil programlama

Hatta QR kodunu tarayarak mobil cihazlarda programlama yapabilirsiniz:

Mobil programlamaya dair hayallerinizi gerçekleştirin. Ayrıca bir eklenti mekanizması da var — kendi programlama alışkanlıklarınıza göre özelleştirmek isterseniz, ileride eklenti hooks güncellemelerini takip edebilirsiniz.

Modele özgü sistem promptları

Sistem promptunu düzenle modalı (hamburger menü → Sistem promptunu düzenle) sekmelere ayrılmıştır:

Varsayılan sekmesi klasik davranışı korur: geçerli çalışma alanına CC_SYSTEM.md (üzerine yazma) veya CC_APPEND_SYSTEM.md (ekleme) dosyasını yazar; bu dosya bir sonraki ccv başlatılışında --system-prompt-file / --append-system-prompt-file olarak enjekte edilir.
Model sekmeleri: + Model ekle düğmesine tıklayın, opus veya Gemini3 gibi bir ad yazın ve bir kapsam seçin — Genel (~/.claude/cc-viewer/system_prompt/, tüm çalışma alanlarına uygulanır) veya Çalışma alanı (<project>/system_prompt/). Her sekmenin kendi Ekle/Üzerine yaz anahtarı ve Markdown önizlemesi vardır.
Girdiler büyük harfli dosyalar olarak saklanır: OPUS_SYSTEM.md (üzerine yazma) veya OPUS_APPEND_SYSTEM.md (ekleme). Eşleştirme bulanıktır — ETKİN yapılandırmadan çözümlenen model kimliğinin (etkin üçüncü taraf proxy profile'ın model eşlemesi > başlatma ortam değişkenleri ANTHROPIC_MODEL/CLAUDE_MODEL > settings.json içindeki model; yapılandırma sinyali yoksa hiçbir girdi enjekte edilmez) büyük/küçük harfe duyarsız bir alt dizesi aranır; bu yüzden opus, sürümden bağımsız olarak claude-opus-4-8[1m] ile eşleşir. Çalışma alanı eşleşmesi genel eşleşmeye üstün gelir; aynı kapsam içinde en uzun ad kazanır; eşleşen bir girdi, o başlatma için Varsayılan dosyaların yerini tamamen alır. Bilinen sınırlamalar: oturum ortasında proxy profile değiştirmek ancak claude oturumu yeniden başlatıldığında yeniden eşleştirilir; ek argümanlarla iletilen --model bayrağı dikkate alınmaz.
Bir sekmeyi boş kaydetmek girdiyi siler. Oturum ortasında yapılan model değişiklikleri bir sonraki yeniden başlatmada geçerli olur. Tüm otomatik enjeksiyonu devre dışı bırakmak için CCV_DISABLE_AUTO_SYSTEM_PROMPT=1 ayarlayın. Promptları ekibinizle paylaşmak için <project>/system_prompt/ dizinini commit edebilir veya gizli tutmak için .gitignore dosyasına ekleyebilirsiniz.

Log modu (claude code'un eksiksiz oturumlarını görüntüleyin)

Claude Code'un gönderdiği tüm API isteklerini gerçek zamanlı olarak yakalar; orijinal metin olduğunu, kırpılmış logları değil (bu çok önemli!!!)
Main Agent ve Sub Agent isteklerini otomatik olarak tanımlar ve etiketler (alt türler: Plan, Search, Bash)
MainAgent istekleri Body Diff JSON'u destekler; bir önceki MainAgent isteğine göre farkları katlanmış olarak gösterir (yalnızca değişen/yeni alanlar)
Her istek satır içinde Token kullanım istatistiklerini gösterir (giriş/çıkış Token, önbellek oluşturma/okuma, isabet oranı)
Claude Code Router (CCR) ve diğer proxy senaryolarıyla uyumludur — API yol kalıbı eşleştirmesi ile yedek bir yol sağlar

License

MIT

FilesExpand file tree

README.tr.md

Latest commit

History