OpenRouter ile Claude Code Nasıl Kullanılır

Anthropic'in komut satırı aracı olan Claude Code'un akıcı iş akışından hoşlanıyorsanız, varsayılan olarak Anthropic API formatını beklediğini muhtemelen biliyorsunuzdur. Peki ya farklı bir model kullanmak veya Anthropic'in doğrudan API'si aracılığıyla erişilemeyen yeni modelleri keşfetmek isterseniz ne olur? İşte bu noktada OpenRouter devreye giriyor! Birçok farklı sağlayıcıdan yüzlerce modele birleşik, OpenAI uyumlu API erişimi sunar.

İki sistemi birleştirerek, her iki dünyanın en iyisini elde edebilirsiniz: Claude Code'un geliştirici dostu arayüzü ve OpenRouter'ın geniş model kataloğu. Bu entegrasyona "Openrouter ile Claude Code" adını veriyoruz.

Püf nokta, iki API formatı arasında çeviri yapan bir "yönlendirici / proxy" kullanmaktır. Kurulumu yaptıktan sonra, Claude Code'u her zamanki gibi çalıştırabilirsiniz, ancak arka planda OpenRouter gücünü kullanır.

Openrouter ile Claude Code Kullanmanın Temel Avantajları

Claude Code ve Openrouter'ı birleştirmek, bir dizi güçlü faydanın kilidini açar:

• 400'den fazla modele erişim — Claude varyantları, GPT tarzı modeller, açık kaynaklı büyük dil modelleri ve daha fazlası dahil.
• Anthropic aboneliğine gerek yok — Openrouter'ın kullandıkça öde fiyatlandırmasıyla yalnızca kullandığınız kadar ödersiniz.
• Esnek model geçişi — Claude Code'da oturum ortasında /model ile modelleri değiştirin veya görev türüne göre yönlendirin (hafifletilmiş vs akıl yürütme, maliyet vs performans).
• Maliyet optimizasyonu — rutin görevler için düşük maliyetli veya ücretsiz modeller, yalnızca gerektiğinde güçlü modeller: bütçe bilincine sahip geliştiriciler için idealdir.
• Yerel veya bulut tabanlı yönlendirme — gizlilik için her şeyi yerel olarak çalıştırın veya paylaşılan ekip kullanımı, CI/CD veya bulut otomasyonu için yönlendiricinizi barındırın.
• Araçlar ve esneklik — bazı yönlendiriciler akış, model geri dönüşü, çoklu sağlayıcı çoğullama ve daha geniş geliştirme iş akışlarıyla entegrasyon gibi gelişmiş özellikleri destekler.

Ön Koşullar

Başlamadan önce şunlara sahip olduğunuzdan emin olun:

1. Claude Code'un genel olarak yüklü olması (örneğin npm install -g @anthropic-ai/claude-code aracılığıyla).

2. Geçerli bir API anahtarına (sk-or-...) sahip bir Openrouter hesabı (Hesabı OpenRouter'da oluşturun).

3. Format dönüşümünü yönetmek için bir yönlendirici/proxy aracı (Docker en kolay olanıdır, ancak Node.js tabanlı yönlendiriciler de çalışır)

4. Ortam değişkenlerini ve komut satırını kullanma konusunda temel düzeyde rahatlık

Bu kurulumla, Claude Code'u yönlendiriciye yönlendirebilirsiniz — yönlendirici daha sonra istekleri Openrouter'a iletir ve yanıtları geri yönlendirir.

Yöntem 1: y-router (En Basit ve Önerilen)

Bu kurulum için en yaygın kullanılan yönlendiricilerden biri y-router'dır. Anthropic'in beklenen API formatı ile Openrouter'ın OpenAI tarzı API'si arasında bir çevirici görevi görür (depoyu görüntülemek için: GitHub). y-router ile adım adım nasıl yapılacağı aşağıda açıklanmıştır:

1. y-router'ı yerel olarak dağıtın (Docker önerilir):

git clone https://github.com/luohy15/y-router.git
cd y-router
docker compose up -d

Bu, http://localhost:8787 adresinde (varsayılan olarak) dinleyen yerel bir yönlendirici hizmeti başlatır.

2. Claude Code'un isteklerini doğrudan Anthropic'e değil, y-router'a göndermesi için ortam değişkenlerinizi yapılandırın:

export ANTHROPIC_BASE_URL="http://localhost:8787"
export ANTHROPIC_AUTH_TOKEN="sk-or-<your-openrouter-key>"
export ANTHROPIC_MODEL="z-ai/glm-4.5-air"   # for a fast, lightweight model
# or export ANTHROPIC_MODEL="z-ai/glm-4.5"   # for a more powerful model

3. Claude Code'u çalıştırın:

claude

Arayüz her zamanki gibi başlayacaktır. /model yazarsanız, Openrouter destekli modelin seçildiğini göreceksiniz. Tebrikler — artık Openrouter ile Claude Code'u kullanıyorsunuz. (ishan.rs)

Bu yöntem, yönlendirmeyi yerel, basit ve kontrolünüz altında tutar — gizliliği ve minimum ek yükü seven geliştiriciler için idealdir.

Yöntem 2: Claude Code Router (npm tabanlı, Özellik Bakımından Zengin)

Docker kullanmamayı tercih ederseniz, başka bir sağlam seçenek daha var: Claude Code Router — Claude Code'a harici sağlayıcılara erişim sağlamak için tasarlanmış Node.js tabanlı bir yönlendirici aracıdır (depoyu görüntülemek için: GitHub). İşte nasıl kurulacağı:

1. Genel olarak yükleyin:

npm install -g @musistudio/claude-code-router

Ardından tercih ettiğiniz ayarları ve modelleri içeren bir yapılandırma dosyası (örn. ~/.claude-code-router/config.json) oluşturun. Birçok kullanıcı Openrouter'ı bir sağlayıcı olarak dahil eder, API anahtarlarını belirtir ve desteklenen modelleri listeler (bu yöntemle ilgili daha fazla ayrıntı için lgallardo.com adresine bakın).

2. Yönlendiriciyi başlatın:

ccr start

Çalışmaya başladıktan sonra, ANTHROPIC_BASE_URL'yi yönlendiricinin URL'sine ayarlayın ve claude'u her zamanki gibi kullanın. Yönlendirici, istekleri çevirecek ve modeller arasında dinamik geçişe izin verecektir — geri dönüş davranışı, yönlendirme kuralları ve daha fazlası dahil.

Bu yöntem, model yönlendirmesi, geri dönüş politikaları veya daha büyük araç zincirlerine (CI/CD, otomatik komut dosyaları veya çoklu model deneyleri gibi) entegrasyon üzerinde daha fazla kontrol istiyorsanız güçlüdür.

Yöntem 3: Doğrudan Openrouter Proxy (Hızlı Testler için Minimum Kurulum)

Sadece hızlı bir kontrol veya test yapmak istiyorsanız — tam bir yönlendirici çalıştırmadan — Claude Code'u doğrudan Openrouter uyumlu bir proxy'ye veya minimal bir adaptöre yönlendirmeyi deneyebilirsiniz. Bunu kolaylaştırmak için bazı topluluk çözümleri mevcuttur (depolarını görüntülemek için: GitHub).

Örneğin, şunları ayarlayabilirsiniz:

export ANTHROPIC_BASE_URL="https://proxy-your-choice.com"
export ANTHROPIC_AUTH_TOKEN="sk-or-<your-key>"
export ANTHROPIC_MODEL="openrouter/model-name"

Ardından Claude Code'u çalıştırın. Bu yaklaşım, geçici testler veya hızlı deneyler için kullanışlıdır. Ancak, proxy uygulamasının türüne bağlı olarak sağlamlıktan yoksun olabilir (örn. akış, araç çağırma veya uzun süreli oturumlar için).

Sorunsuz Bir Deneyim İçin En İyi Uygulamalar ve İpuçları

1. Model uyumluluğunu kontrol edin — tüm modeller araç çağrıları veya uzun bağlam pencereleri gibi gelişmiş özellikleri desteklemez. Basit görevler için daha hafif modelleri, muhakeme veya kodlama gibi ağır görevler için daha yetenekli modelleri kullanın.
2. API anahtarınızı güvende tutun — Openrouter API anahtarınızı bir sır gibi saklayın; güvenli bir şekilde depolayın ve asla istemci tarafında açığa çıkarmayın.
3. Maliyetleri yönetin — büyük modelleri kullanırken token kullanımını izleyin; maliyet/performans dengesini optimize etmek için istem önbelleğini, geri dönüş modellerini veya görev tabanlı yönlendirmeyi düşünün.
4. Yönlendirme kurulumunu test edin — yapılandırmadan sonra, her şeyin doğru şekilde yönlendirildiğinden emin olmak için her zaman basit komutlarla (örn. claude --model <model>) test edin.
5. Güvenilirlik için geri dönüş yönlendirmesi kullanın — çoklu model kurulumlarında, bir model kullanılamadığında yönlendiricinin otomatik olarak başka birine geçebilmesi için geri dönüş seçeneklerini yapılandırın.

Sıkça Sorulan Sorular

S1. Openrouter ile Claude Code kullanmak için Anthropic'e ödeme yapmam gerekiyor mu?
Hayır. Openrouter (bir yönlendirici veya proxy aracılığıyla) ile yapılandırıldığında, Claude Code istekler için Openrouter API anahtarınızı kullanır — ücretli bir Anthropic aboneliğine ihtiyacınız yoktur.

S2. Aynı Claude Code oturumu içinde modelleri anında değiştirebilir miyim?
Evet. Birçok yönlendirici (ve Claude Code'un kendisi) /model <model_name> kullanarak modelleri değiştirmenize olanak tanır. Bu, çoğu durumda konuşma ortasında çalışır.

S3. Openrouter'daki tüm modeller Claude Code özellikleriyle (araç yürütme, akış gibi) uyumlu mu?
Her zaman değil. Bazı "yalnızca metin" veya daha hafif modeller, araç çağırma, uzun bağlam veya akış desteği sunmayabilir. Karmaşık iş akışları için, bu özellikleri desteklediği bilinen modelleri kullanın.

S4. Yerel bir Docker yönlendirici, barındırılan bir yönlendiriciden daha mı güvenlidir?
Genel olarak evet. Bir yönlendiriciyi yerel olarak çalıştırmak size tam kontrol sağlar ve API anahtarınızı harici hizmetlere maruz bırakmaktan kaçınır. Barındırılan yönlendiriciler kullanışlıdır ancak güvenlik veya güvenilirlik konusunda ödünler verebilir.

S5. Bu kurulumu CI/CD'ye veya otomatik iş akışlarına entegre edebilir miyim?
Kesinlikle. Claude Code Router gibi araçlar, yapılandırma dosyalarını ve ortam değişkenlerini destekler, bu da onları otomasyon işlem hatlarına (GitHub Actions, komut dosyaları vb.) entegre etmeyi kolaylaştırır.

Sonuç

Openrouter ile Claude Code kullanmak, tek sağlayıcı kilitlenmelerinden kurtulurken tanıdık, kolaylaştırılmış bir geliştirici arayüzünü korumanın zarif ve güçlü bir yoludur. İster Docker aracılığıyla yerel bir yönlendirici çalıştırmayı, ister Node.js tabanlı bir yönlendirici kullanmayı veya minimal bir proxy aracılığıyla test etmeyi seçin — devasa bir model kataloğuna, esnek maliyet seçeneklerine ve özelleştirilmiş iş akışlarına kapı açıyorsunuz.

Yüksek ek yük olmadan yapay zeka destekli kodlamayı optimize etmek isteyen geliştiriciler, yan projeler veya ekipler için bu kurulum, kontrol, esneklik ve ölçeklenebilirliğin çekici bir dengesini sunar. Yalnızca birkaç yapılandırma adımıyla, yapay zeka asistanınızın yapabileceklerini önemli ölçüde genişletebilir — ardından ihtiyaçlarınız geliştikçe değiştirebilir veya ölçeklendirebilirsiniz.

Bir deneyin: bir sonraki kod oturumunuz, tanıdık Claude Code arayüzü altında, hiç mümkün olduğunu düşünmediğiniz bir model tarafından desteklenebilir.