# Crush nasıl kullanılır? Charm’ın kodlama ajanı için adım adım rehber

Adres: https://agentvera.dev/blog/crush-nasil-kullanilir/ · Yayın: 2026-11-17

Crush nasıl kullanılır: Charm’ın terminal kodlama ajanını kur, sağlayıcı ya da yerel model seç, araçları onayla, crush run, oturumlara dönüş ve crushrc tek rehberde.

**Kısaca:**

- brew install charmbracelet/tap/crush, npm install -g @charmland/crush ya da winget install charmbracelet.crush ile kur, bir projede crush çalıştır, Ctrl+L ile model seç ve bir anahtar yapıştır ya da giriş yap.
- Crush araç çağrılarından önce sorar ve bir aracı oturumun geri kalanı için serbest bırakmana izin verir. crush run tek seferlik işleri ve pipe girdisini halleder; crush -C ya da crush -s <id> bir oturuma geri döner.
- v0.88’den bu yana ayarlar bir crushrc dosyasında (Crush komutları içeren Bash) duruyor; crush.json hâlâ çalışıyor ama kullanımdan kalkıyor. Crush AGENTS.md, CRUSH.md ve CLAUDE.md’yi kendiliğinden okur.

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](https://github.com/charmbracelet "GitHub’da 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

```bash
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ç

```bash
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):

```bash
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+L` modeli değiştirir; `Ctrl+N` yeni bir oturum başlatır, `Ctrl+S` oturumları listeler.
- `@` bir dosyadan bahseder; `Ctrl+F` bir dosya ya da görsel ekler; `Ctrl+V` bir görsel yapıştırır.
- `Shift+Tab` modlar arasında dolaşır; bunlardan biri, Crush’ın düzenlemeden önce adımları çıkardığı Plan modu.
- `Ctrl+O` uzun bir mesaj için editörünü açar; `Ctrl+G` yardı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:

```bash
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

```bash
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:

```bash
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](/blog/claude-md-nasil-yazilir/ "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.** `--yolo` artı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-by` trailer’ı ekler. Bunu `option attribution-trailer-style` ile değiştir.
- **Linux’ta pano.** Kopyala-yapıştır için `wl-copy` ya da `xclip`/`xsel` gerekir.
- **Loglar nerede?** `crush logs --tail 50` neyin ters gittiğini gösterir; loglar projenin `.crush` klasö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](/ "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](/ajanlar/crush/ "AgentVera’da Crush") şöyle çalışıyor:

- **Her ajana bir oturum.** AgentVera, Crush’ın oluşturduğu oturumu `crush session list --json` ile 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](/ozellikler/mcp-yoneticisi/ "MCP yöneticisi") 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ı](/ozellikler/calisma-alani/ "Çalışma alanı") ızgarasında diğer ajanların yanında çalıştır ve değişikliklerini [kod incelemesiyle](/ozellikler/kod-incelemesi/ "Kod incelemesi") 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](/indir/ "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](https://github.com/charmbracelet/crush "Crush README"), [yapılandırma dokümanları](https://github.com/charmbracelet/crush/tree/main/docs/config "Crush yapılandırması"), [sürümler](https://github.com/charmbracelet/crush/releases "Crush sürümleri"), [lisans](https://github.com/charmbracelet/crush/blob/main/LICENSE.md "Crush lisansı"), [Hyper](https://hyper.charm.land "Charm’dan Hyper").

## Sık sorulanlar

**Crush ücretsiz mi?** Crush’ı kullanmak ücretsiz: kendi API anahtarlarını ya da yerel bir modeli getirirsin. Charm ayrıca açık ağırlıklı modeller için barındırılan bir sağlayıcı olan Hyper’ı satıyor; Kasım 2026 itibarıyla aylık planlar 10 $ ile 200 $ arasında, ön ödemeli kredi de 5 $’dan başlıyor. Crush, sürümleri ileride MIT’ye dönen, kaynak kodu görülebilen (source-available) bir lisans olan FSL-1.1-MIT ile dağıtılıyor.

**Crush yerel modellerle çalışır mı?** Evet. crushrc içine bir Ollama, LM Studio, llama.cpp ya da LiteLLM sağlayıcısı ekle, örneğin provider add ollama --type ollama --base-url "http://localhost:11434/v1/"; Crush modellerini kendisi bulur.

**Bir Crush oturumuna nasıl geri dönerim?** crush -C (ya da --continue) projedeki en son oturumu, crush -s <id> da belirli bir oturumu yeniden açar. crush session list oturumları listeler; Crush da çıkarken geri dönme komutunu ekrana yazar.

**Crush CLAUDE.md ya da AGENTS.md okur mu?** İkisini de okur. Crush; AGENTS.md, CRUSH.md, CLAUDE.md, GEMINI.md, .cursorrules ve .github/copilot-instructions.md varsa hepsini okur. Komut paletindeki Initialize Project senin için bir AGENTS.md yazar.

**crush --yolo ne yapar?** Onay sorularını atlar ama Crush’ın tehlikeli saydığı komutları yine engeller. -yy (sysadmin modu) bunlara da izin verir. İkisini de silip atabileceğin ortamlara sakla.

---

**AgentVera hakkında.** AgentVera, Solviera Teknoloji tarafından geliştirilen macOS, Windows ve Linux masaüstü uygulamasıdır. 18 yapay zeka kodlama ajanını (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) proje bazında, gerçek terminallerde ve kullanıcının kendi CLI kurulum ve girişleriyle yan yana çalıştırır. Ücretsiz plan aynı anda 2 ajan çalıştırır. İndir: https://agentvera.dev/indir/ · Fiyatlar: https://agentvera.dev/fiyatlar/
