Charm’ın kodlama ajanı Crush’ı kullanmak için brew install charmbracelet/tap/crush ile (ya da npm, winget ve diğer yollarla) kurarsın, bir projenin içinde crush çalıştırırsın, Ctrl+L ile bir model seçip API anahtarını yapıştırır ya da giriş yaparsın, sonra işi anlatırsın. Crush araçları çalıştırmadan önce sorar ve 0.88 sürümünden bu yana ayarları crush.json yerine bir crushrc dosyasında tutar.
Bu rehber, Kasım 2026 itibarıyla Crush’ı (sürüm 0.101) anlatıyor: kurulum, sağlayıcılar ve yerel modeller, arayüz, onaylar, crush run, oturumlar, yapılandırma, bağlam dosyaları, MCP ve maliyet.
Crush nedir?
Crush, Bubble Tea ve başka terminal araçlarının arkasındaki ekip olan Charm tarafından geliştirilen bir terminal kodlama ajanı; bu da hemen belli oluyor, çünkü kategorisindeki en özenli arayüzlerden birine sahip. Neredeyse her modelle çalışıyor: Anthropic, OpenAI, Gemini, OpenRouter, Groq, xAI, Bedrock, Vertex, Azure, yerel modeller ve Charm’ın kendi hizmeti Hyper. Oturumun ortasında bağlamı kaybetmeden model değiştirebilirsin.
Crush henüz 1.0 sürümüne ulaşmadı; yaklaşık her hafta bir ara sürüm çıkarıyor, aralarda da nightly derlemeler geliyor. Lisansı FSL-1.1-MIT: kaynak kodu herkese açık ve her sürüm ileride MIT lisansına geçiyor, ama bugün OSI onaylı bir açık kaynak lisansı değil.
1. Adım: kur
brew install charmbracelet/tap/crush # macOS and Linux
npm install -g @charmland/crush # any platform with Node
winget install charmbracelet.crush # Windows
go install github.com/charmbracelet/crush@latest
Arch (yay -S crush), Nix, FreeBSD ve Scoop için paketler, repo.charm.sh üzerinde de apt ve yum depoları var. Crush macOS, Linux, Windows (PowerShell ve WSL) ve BSD’lerde çalışıyor.
2. Adım: bir model seç
cd my-project
crush
Model seçiciyi açmak için Ctrl+L’ye bas, bir sağlayıcı seç ve anahtarını yapıştır. Crush anahtarları ortam değişkenlerinden de okur, örneğin ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY ya da OPENROUTER_API_KEY. Anahtar yerine bir abonelik kullanmak istiyorsan crush login komutunu copilot, openai (bir ChatGPT planı), grok ya da hyper ile çalıştır.
Yerel bir model için yapılandırmana bir sağlayıcı ekle (6. adım):
provider add ollama --type ollama --base-url "http://localhost:11434/v1/"
Crush model listesini, kendi kendini güncelleyen bir topluluk kataloğu olan Catwalk’tan alır; crush models neyin kullanılabilir olduğunu gösterir, crush update-providers da listeyi yeniler.
3. Adım: bir oturumda çalış
İşi kendi cümlelerinle anlat. İlk öğrenmeye değer tuşlar:
Ctrl+P(ya da/) komut paletini açar: oturumu özetle, projeyi başlat, MCP sunucularını ve skill’leri aç kapat, temayı değiştir.Ctrl+Lmodeli değiştirir;Ctrl+Nyeni bir oturum başlatır,Ctrl+Soturumları listeler.@bir dosyadan bahseder;Ctrl+Fbir dosya ya da görsel ekler;Ctrl+Vbir görsel yapıştırır.Shift+Tabmodlar arasında dolaşır; bunlardan biri, Crush’ın düzenlemeden önce adımları çıkardığı Plan modu.Ctrl+Ouzun bir mesaj için editörünü açar;Ctrl+Gyardımı gösterir;Ctrl+Cçıkar.
4. Adım: onaylar ve yolo modu
Crush her araç çağrısından önce sorar. Açılan pencerede a bir kez izin verir, s o aracı oturumun geri kalanı için serbest bırakır, d reddeder, t de diff’i gösterir. ls ya da git status gibi salt okunur komutlar sormadan çalışır.
Güvendiğin araçlar için soru gelmesin istiyorsan onlara yapılandırmanda izin ver; bir aracı tamamen gizlemek için de engelle:
permissions allow view ls grep edit
permissions deny bash
crush --yolo (ya da -y, ya da oturum içinde Ctrl+Y) onay sorularını atlar ama Crush’ın tehlikeli saydığı komutları yine engeller. -yy sysadmin modunu açar ve bunlara da izin verir. İkisini de container’lar ve silip atabileceğin makineler için sakla.
5. Adım: tek seferlik işler için crush run
crush run "add a unit test for the price formatter"
git diff | crush run "review this diff for bugs"
cat README.md | crush run "tighten the wording" > README.new.md
-m modeli seçer (provider/model), -q yükleme göstergesini gizler, -s <id> ya da -C de bir oturumu sürdürür. crush run’ın JSON çıktı seçeneği yok; yapılandırılmış sonuç istiyorsan formatı prompt’ta iste ve kontrol et.
6. Adım: crushrc ve yapılandırma
0.88 sürümünden bu yana Crush ayarlarını bir crushrc dosyasından okur: Crush komutları içeren, Windows’ta da aynı davranması için Crush’ın kendi yorumlayıcısıyla çalıştırılan bir Bash betiği. Projede .crushrc ya da crushrc, genel olarak da ~/.config/crush/crushrc arar ve bulduklarını birleştirir; çakışmada proje kazanır. Küçük bir örnek:
model large anthropic/claude-sonnet-5-5
model small anthropic/claude-haiku-5-5
permissions allow view ls grep
mcp add docs --type http --url https://example.com/mcp
lsp add go --command gopls
crush.json ve .crush.json hâlâ çalışıyor ama kullanımdan kalkıyor ve yeni özellik almıyor. crush dirs, Crush’ın yapılandırmayı ve verileri nerede tuttuğunu gösterir.
Bir uyarı: crushrc koddur. $(...) içindeki her şey Crush başlarken çalışır; yani tanımadığın bir depoda Crush’ı başlatmadan önce dosyayı oku.
7. Adım: AGENTS.md, MCP ve LSP
Bağlam dosyaları. Crush hiçbir kurulum gerektirmeden AGENTS.md, CRUSH.md, CLAUDE.md, GEMINI.md, .cursorrules ve .github/copilot-instructions.md dosyalarını, tüm projeler için de ~/.config/crush/CRUSH.md’yi okur. Komut paletindeki Initialize Project depoya bakarak bir AGENTS.md yazar. İçine ne yazacağını CLAUDE.md ve AGENTS.md rehberimiz anlatıyor.
MCP. Crush, OAuth ile giriş dahil stdio, HTTP ve SSE sunucularını destekler. Onları crushrc içinde mcp add ile ekle, paletten de aç ya da kapat.
LSP. Dil sunucuları Crush’a editörünün gördüğü tanılamaların aynısını verir. lsp add ile bir tane ekle ya da kurulumu option auto-lsp’ye bırak.
Crush’ın maliyeti (Kasım 2026 itibarıyla)
| Seçenek | Fiyat | Notlar |
|---|---|---|
| Crush | Ücretsiz | Kendi anahtarların ya da yerel modellerle |
| Hyper kullandıkça öde | 5 $’dan başlayan ön ödeme | Charm’ın barındırdığı açık ağırlıklı modeller |
| Hyper aylık planları | Aylık 10 $ ile 200 $ arası | Kayan 5 saatlik pencereyle haftalık krediler |
| Kendi anahtarın | Sağlayıcının fiyatı | Anthropic, OpenAI, Gemini, OpenRouter ve daha fazlası |
Crush varsayılan olarak takma adlı (pseudonymous) kullanım metrikleri gönderir; kapatmak için CRUSH_DISABLE_METRICS=1 ya da DO_NOT_TRACK=1 ayarla.
Sık yapılan hatalar
- crush.json rehberlerini izlemek. Ağustos 2026 öncesindeki çoğu rehber yalnızca JSON gösterir. Hâlâ çalışıyor, ama yeni seçenekler
crushrc’ye geliyor. - Yolo, v0.100’de değişti.
--yoloartık tehlikeli komutlar için soru sormak yerine onları engelliyor; eski davranışa güvenen betiklerin-yy’ye ihtiyacı olabilir. - Commit trailer’ları. Crush varsayılan olarak commit’lere bir
Assisted-bytrailer’ı ekler. Bunuoption attribution-trailer-styleile değiştir. - Linux’ta pano. Kopyala-yapıştır için
wl-copyya daxclip/xselgerekir. - Loglar nerede?
crush logs --tail 50neyin ters gittiğini gösterir; loglar projenin.crushklasöründe durur.
Crush’ı diğer CLI’ların yanında AgentVera’da çalıştırmak
Tek kullandığın ajan Crush ise kendi arayüzü sana yetebilir. İş, Crush aynı projede Claude Code, Codex ya da Gemini CLI’ın yanında çalışınca zorlaşıyor. AgentVera, bu CLI’ları kendi kurulumların ve anahtarlarınla gerçek terminallerde yan yana çalıştıran bir masaüstü uygulaması. Crush desteği şöyle çalışıyor:
- Her ajana bir oturum. AgentVera, Crush’ın oluşturduğu oturumu
crush session list --jsonile bulur ve sonraki açılışlarda--session <id>ile yeniden açar; böylece konuşma uygulama yeniden başlasa da kaybolmaz. - Her ajana bir hesap. Ayarlar → Hesaplar bölümündeki her Crush hesabı kendi veri klasörünü ve kendi
crush login’ini alır; Anthropic, OpenAI, OpenRouter ya da Gemini anahtarları da ekleyebilirsin. - MCP ve çakışmalar. AgentVera’nın MCP yöneticisindeki sunucular Crush’a onun yapılandırması üzerinden ulaşır; AgentVera da her ajanın hangi dosyalara dokunduğunu görmek için kendi hook’unu ekler.
- Paneller ve inceleme. Crush’ı çalışma alanı ızgarasında diğer ajanların yanında çalıştır ve değişikliklerini kod incelemesiyle kontrol et.
Ücretsiz plan aynı anda 2 ajan çalıştırır; MCP, Git, Docker, SSH, kod incelemesi ve token tasarrufu içerir. Pro aylık 9,99 $ ve ajan sınırı yok; daha önce hiç deneme kullanmadıysan uygulamaya ilk girişin Pro’yu kart istemeden 7 gün açar. Denemek için AgentVera’yı indir.
Toparlarsak
Crush’a başlamak iki adım alıyor: kurup crush çalıştırmak, sonra Ctrl+L ile bir model seçmek. Ondan sonra önemli ayarlar crushrc içinde: hangi araçların sormadan çalışabileceği, büyük ve küçük işler için hangi modellerin kullanılacağı, hangi MCP ve dil sunucularının yükleneceği. Projede bir AGENTS.md tut; Crush da diğer çoğu ajan gibi ona uyacaktır.
Kaynaklar: GitHub’da Crush, yapılandırma dokümanları, sürümler, lisans, Hyper.