# Claude Code Router kurulum rehberi

Claude Code'un limiti dolunca beklemek yerine Gemini, GLM gibi ücretsiz modellerle devam etmek için. 10-15 dakika sürüyor, kod yazmak gerekmiyor.

Kaynak: https://ozgurakanay.com/kutuphane/claude-code-router-kurulum-rehberi/

## Başlamadan önce

- Claude Code bilgisayarında kurulu olsun.
- Terminalden kuracaksan Node.js 22 veya üstü lazım. Masaüstü uygulamasını indirirsen Node'a gerek yok.

## 1. Claude Code Router'ı kur

**Kolay yol (masaüstü uygulaması):** [GitHub'daki releases sayfasından](https://github.com/musistudio/claude-code-router/releases) işletim sistemine uygun dosyayı indir ve aç: Mac için .dmg (Apple Silicon ve Intel ayrı), Windows için .exe, Linux için .AppImage.

**Terminal yolu:**

```
npm install -g @musistudio/claude-code-router
ccr ui
```

`ccr ui` tarayıcıda yönetim panelini açıyor. Adresin sonundaki `ccr_web_token` panel şifren sayılır; paylaşma.

## 2. Ücretsiz model anahtarlarını al

Her birine kayıt olup bir API anahtarı alıyorsun. Gemini ve OpenRouter kart istemiyor.

- **Gemini (Google AI Studio):** [aistudio.google.com](https://aistudio.google.com) → Create API key. Flash modelleri ücretsiz. Zincirin ilk halkası için en iyisi.
- **Z.AI (GLM):** [z.ai](https://z.ai) → kayıt ol → API key. Flash modelleri ücretsiz (GLM-4.7-Flash, GLM-4.5-Flash); büyük GLM modelleri ücretli.
- **OpenRouter:** [openrouter.ai/keys](https://openrouter.ai/keys). Sonu `:free` biten modeller ücretsiz; dakikada 20, günde 50 istek. Hesaba bir kez 10 dolar yüklersen günlük limit 1000'e çıkıyor.

> Ücretsiz katmanlarda gönderdiğin veriyi modeli geliştirmek için kullanabiliyorlar. Gizli kalması gereken bir projede kullanma.

## 3. Modelleri Router'a bağla

Panelde **Providers → Add provider**:

1. **Select preset provider** listesinden sağlayıcıyı seç; Google Gemini, Z.ai ve OpenRouter hazır geliyor, adresleri kendisi dolduruyor. Z.ai için **General Endpoint** olanı seç; Coding Plan ücretli bir abonelik.
2. API anahtarını yapıştır.
3. Modeller otomatik listeleniyor; kullanacaklarını işaretle.
4. **Check Connection**'a bas, yeşil görünce kaydet.

Üç sağlayıcı için de aynısını yap.

## 4. Sunucuyu başlat

- **API Keys → Add API key**. Bir isim ver (mesela `Claude Code`), oluştur. Anahtarı bir yere kopyala; bir daha göstermiyor.
- **Server → Start**.

## 5. Claude Code profilini oluştur

**Agent Profiles → Add profile → Claude Code**:

- **Profile name:** istediğin bir isim, mesela `Claude Code - Bedava`.
- **Effect scope:** `Only opened from CCR` (varsayılan). Böylece normal `claude` komutun eskisi gibi kendi aboneliğinle çalışmaya devam ediyor.
- **Model:** ilk kullanılacak model, mesela Gemini'nin Flash modeli.
- Kaydet.

## 6. Yedek zincirini kur (asıl olay bu)

**Global Routing** sayfasının en üstündeki **Default on failure** ayarını **Fallback targets** yap. Profildeki model zaten ilk deneniyor; **Add** ile sırayla yedekleri ekle:

1. GLM Flash
2. OpenRouter'daki `:free` modellerden biri

Bir model limitine takılınca (429) ya da başka bir hata verince Router sıradakine geçiyor; sen hiçbir şey yapmıyorsun.

## 7. Çalıştır

Agent Profiles'ta profil kartındaki **terminal** butonu komutu kopyalıyor. Ya da terminale:

```
ccr "Claude Code - Bedava"
```

Masaüstü uygulamasını kurduysan komut `ccr-app "Claude Code - Bedava"`; karttaki buton zaten doğrusunu veriyor.

Aynı Claude Code açılıyor, sadece arkada senin bağladığın modeller çalışıyor. İçeride `/model` yazarak modeli elle de değiştirebilirsin.

Gerçekten Router'dan geçtiğini görmek için panelde **Logs**'a bak: sağlayıcı, model, token sayısı hepsi orada. Liste boşsa **Settings → Logs & Observability** altından **Request logs**'u aç.

## Nasıl kullanılır

- Claude aboneliğinle her zamanki gibi `claude` yazıp çalış.
- Limit dolunca `ccr "Claude Code - Bedava"` ile devam et.
- Limit sıfırlanınca tekrar `claude`'a dön.

Ücretsiz modeller Claude kadar iyi değil. Claude'u zor işlere, ücretsiz zinciri limit dolduğunda ve basit işlerde kullanmak en mantıklısı.

## Sorun çıkarsa

- **Claude Code Router'dan geçmiyor:** Server çalışıyor mu, profil etkin mi, Claude Code'u `claude` ile değil Router komutuyla mı açtın; sırayla bak.
- **401 / 403 hatası:** API anahtarı yanlış ya da o sağlayıcıda pasif.
- **model not found:** Profilde ya da yedek zincirinde seçtiğin model o sağlayıcının listesinde işaretli değil. Providers'a girip işaretle.
- **Sürekli sıradakine geçiyor:** Logs'ta 429 görüyorsan ilk modelin günlük limiti dolmuş; normal, ertesi gün sıfırlanıyor. 401 görüyorsan anahtar yanlış; Router her hatada sıradakine geçtiği için bunu ancak Logs'ta fark edersin.

## Güvenlik notu

Router sağlayıcı anahtarlarını bilgisayarında şifresiz saklıyor. O yüzden:

- Disk şifrelemen açık olsun (Mac'te FileVault, Windows'ta BitLocker).
- Ortak kullanılan bir bilgisayara kurma.
- Server adresini (`127.0.0.1`) olduğu gibi bırak; `0.0.0.0` yaparsan ağdaki herkes Router'ına erişebilir.

---

Kaynaklar: musistudio/claude-code-router GitHub deposu ve ccrdesk.top dokümantasyonu, Eylül 2026 (sürüm 3.1.0). Ücretsiz katman limitleri sık değişiyor; güncel rakamlar için sağlayıcının kendi sayfasına bak.