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 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 → Create API key. Flash modelleri ücretsiz. Zincirin ilk halkası için en iyisi.
• Z.AI (GLM): 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. 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.