Claude Code’da Birden Fazla AI Sağlayıcısı Kullanmak: OmniRoute ile Kurulum, Yönlendirme, Maliyet ve Güvenlik Rehberi

Claude Code’u tek bir sağlayıcıya bağlı kalmadan, birden fazla model sağlayıcısı üzerinden çalıştırmak için pratik, dokümantasyonla doğrulanmış bir rehber. Araç: OmniRoute (açık kaynak, MIT).

Claude Code’u tek bir sağlayıcıya bağlı kalmadan, birden fazla model sağlayıcısı üzerinden çalıştırmak isteyenler için pratik bir rehber. Bu yazıda kurulumun her adımını, yönlendirme (routing) ve yedekleme (fallback) mantığını, maliyet gerçeğini ve güvenlik/gizlilik modelini ele alıyoruz. Kullanılan araç: OmniRoute (açık kaynak, MIT).

1. Hangi problemi çözüyoruz?

Tek bir model sağlayıcısına bağlı çalışmak üç somut soruna yol açar: sağlayıcı kesintisinde işiniz durur, tek fiyatlandırmaya mahkûm kalırsınız ve kota/limit dolduğunda alternatifiniz olmaz. Bir LLM gateway (yani birden fazla sağlayıcının önüne konan yerel bir yönlendirme katmanı), bu üç sorunu tek bir uç noktanın arkasında toplar: bir sağlayıcı düşerse bir diğerine geçer, maliyeti stratejiye göre dağıtır, kota bittiğinde otomatik yedeğe iner.

2. Kimler için uygun?

• Claude Code’u yoğun kullanan ve kesintiye tahammülü olmayan geliştiriciler.
• Farklı görevleri farklı modellere yönlendirerek maliyet optimize etmek isteyenler.
• Birden fazla sağlayıcı anahtarını tek yerden, şifreli yönetmek isteyen ekipler.

Kimler için uygun değildir: tek sağlayıcıyla sorunsuz çalışan, ek bir yerel servis işletmek istemeyen veya üçüncü taraf bir aracıdan geçen istekleri kurumsal politikası nedeniyle kabul edemeyen kullanıcılar (bkz. §17, §26).

3. Kavram karmaşasını netleştirelim

Bu dört şey aynı değildir; rehberin doğru anlaşılması için ayrımı netleştirelim:

• Claude Desktop: Anthropic’in masaüstü sohbet uygulaması. MCP sunucularına bağlanabilir; bir model gateway’i değildir. OmniRoute’un Claude Desktop’ı desteklediği resmî belgelerde doğrulanmadı — bu yazıda Claude Desktop entegrasyonu iddia edilmez.
• Claude Code: Anthropic’in komut satırı / editör tabanlı kodlama ajanı. Anthropic API protokolüyle konuşur ve ANTHROPIC_BASE_URL ile başka bir uç noktaya yönlendirilebilir. Bu rehberin konusu budur.
• MCP (Model Context Protocol): Bir modele araç ve bağlam sağlamak için kullanılan protokol. Model sağlayıcı seçmez, istek yönlendirmez; bir gateway değildir.
• LLM gateway / model sağlayıcı: Gateway, birden çok model sağlayıcının (Anthropic, OpenAI, vb.) önünde duran yönlendirme/yük dengeleme katmanıdır. OmniRoute bir gateway’dir; modelleri kendisi üretmez, sağlayıcılara yönlendirir.

Ek bir teknik ayrım: Anthropic-compatible endpoint (Claude Code’un konuştuğu protokol) ile OpenAI-compatible endpoint (birçok başka aracın konuştuğu protokol) farklıdır. OmniRoute, dokümantasyonuna göre her ikisini de sunar: kök yol (/) Anthropic uyumlu, /v1 yolu OpenAI uyumludur.

4. Mimari: veri nasıl akıyor?

Akış şu şekildedir (dokümantasyona göre):

Claude Code
   │  (Anthropic API protokolü)
   ▼
OmniRoute  →  http://localhost:20128  (yerel, Anthropic-uyumlu kök uç nokta)
   │  routing + fallback + yük dengeleme
   ▼
Seçilen sağlayıcı (Anthropic / OpenAI / diğerleri)
   │
   ▼
Model yanıtı  →  OmniRoute  →  Claude Code

Kritik nokta: OmniRoute yerelde çalışır (localhost:20128). Claude Code, isteği önce yerel gateway’e gönderir; gateway hangi sağlayıcıya gideceğine yönlendirme stratejisine göre karar verir.

5. Ücretsiz olan ve olmayan parçalar

OmniRoute’un resmî README’sinde geçen “290 sağlayıcı”, “90+ ücretsiz sağlayıcı”, “500+ model” ve “aylık ~1.53B ücretsiz token” ifadeleri projenin kendi beyanıdır; bu çalışma kapsamında bağımsız olarak doğrulanmamıştır. “Claude tamamen ücretsiz oldu”, “tüm modeller ücretsiz” veya “sınırsız kullanım” gibi iddialar doğru değildir ve bu rehber bunları savunmaz.

6. Güven ve güvenlik modeli

• OmniRoute, kimlik bilgilerini yerelde şifreli saklar (dokümantasyona göre AES-256-GCM) ve denetim izini kendi yerel SQLite’ında tutar.
• Sağlayıcı API anahtarlarınız gateway’de durur; Claude Code’a yalnızca OmniRoute’un kendi anahtarını verirsiniz.
• Yine de bu, istekleriniz yerel bir aracıdan geçiyor demektir; kurumsal gizlilik gereksinimleriniz varsa §26’yı okuyun.

7. Windows gereksinimleri

OmniRoute; Windows, macOS ve Linux’ta çalışır (dokümantasyona göre). Windows için Node.js/npm kurulu olmalıdır. Docker ile de çalıştırılabilir. Bu rehberdeki komutlar bu ortamda çalıştırılmamıştır.

8. Kurulum

En basit yöntem (dokümantasyona göre) global npm kurulumudur:

# Global kurulum (dokümantasyona göre; bu ortamda çalıştırılmadı)
npm install -g omniroute

Docker tercih ederseniz, yerel porta bağlayarak:

# Docker (yerel porta bağlı; dokümantasyona göre)
docker run -d --name omniroute -p 127.0.0.1:20128:20128 diegosouzapw/omniroute:latest

9. İlk çalıştırma

Kurulumdan sonra servis http://localhost:20128 üzerinde yayına gelir. Yönetim panosuna tarayıcıdan aynı adresle erişilir (dokümantasyona göre).

10. Health check

# Tanılama (dokümantasyona göre)
omniroute doctor

# Ayrıntılı durum
omniroute health

omniroute doctor, sağlayıcı bağlantılarının doğrulanması dahil tanılama yapar. Bu komutlar bu ortamda çalıştırılmadı.

11. Provider (sağlayıcı) ekleme

Sağlayıcılar panodan eklenir: abonelik tabanlı sağlayıcılar için OAuth ile bağlanılır; API anahtarı olanlar için panodan “Add API Key” ile sağlayıcı adı ve anahtar girilir (dokümantasyona göre).

12. Secret (gizli anahtar) güvenliği

• Sağlayıcı anahtarlarını yalnız panonun güvenli alanına girin; ortam değişkeni olarak tutuyorsanız kabuk geçmişine düşürmeyin.
• OmniRoute anahtarını (ANTHROPIC_AUTH_TOKEN olarak Claude Code’a verilir) gerçek bir sağlayıcı anahtarıyla karıştırmayın.
• Anahtarları koda, log’a veya sürüm kontrolüne yazmayın.

13. Claude Code bağlantısı

Claude Code, Anthropic API protokolüyle konuştuğu için OmniRoute’un Anthropic-uyumlu kök uç noktasına yönlendirilir. Dokümantasyona göre ~/.claude/settings.json dosyasına şu eklenir:

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://localhost:20128",
    "ANTHROPIC_AUTH_TOKEN": "<omniroute-api-anahtariniz>"
  }
}

14. Routing (yönlendirme) örneği

OmniRoute, dokümantasyonunda adı geçen çok sayıda yönlendirme stratejisi sunar (priority, weighted, round-robin, cost-optimized, least-used vb.). Örneğin “önce ucuz model, doğruluk gerekince güçlü model” gibi bir maliyet-öncelikli strateji panodan seçilebilir. Yönlendirme kuralları panodaki sağlayıcı/model önceliğine göre uygulanır.

15. Fallback (yedekleme) örneği

Dokümantasyona göre OmniRoute 4 katmanlı otomatik yedeklemeye sahiptir: Abonelik → API anahtarı → Ucuz model → Ücretsiz sağlayıcı. Üstteki katman kota/limit nedeniyle başarısız olursa istek otomatik olarak bir alt katmana iner. Böylece tek bir sağlayıcının kesintisi işi durdurmaz.

16. Round-robin gerçekten destekleniyor mu?

Evet. round-robin, OmniRoute’un resmî deposunda listelenen yönlendirme stratejileri arasında açıkça yer alır. Aynı öncelikteki sağlayıcılar arasında istekleri sırayla dağıtır. (Bu strateji kod olarak bu ortamda çalıştırılmadı; varlığı dokümantasyonla doğrulandı.)

17. Log ve audit

Ayrıntılı durum omniroute health ile görülür; uygulama log’ları APP_LOG_TO_FILE=true iken diske yazılır. Denetim izi yerel SQLite’ta tutulur (dokümantasyona göre). Log’lara hassas veri düşmemesi için üretimde log seviyesini ve saklama süresini gözden geçirin.

18. Port çakışması

Varsayılan port 20128’dir. Bu port doluysa servis başlamaz; kaynaktan çalıştırırken PORT değişkeniyle değiştirilebilir. Değiştirdiğinizde Claude Code’daki ANTHROPIC_BASE_URL’i de aynı porta güncelleyin.

19. Geçersiz API anahtarı

Sağlayıcı anahtarı geçersizse ilgili sağlayıcı için istekler başarısız olur; yönlendirme stratejisi ayakta olan diğer sağlayıcılara/katmanlara düşebilir. omniroute doctor bağlantı doğrulaması yaparak sorunlu sağlayıcıyı işaret eder (dokümantasyona göre).

20. Rate limit

Sağlayıcı tarafında hız sınırına takılırsanız, 4 katmanlı fallback devrede olduğunda istek bir alt katmana inebilir. OmniRoute’un kendi rate-limit davranışı bu çalışmada bağımsız olarak doğrulanmadı; sağlayıcı limitleri ilgili sağlayıcının koşullarına tabidir.

21. Streaming ve tool-use uyumluluğu

Claude Code, akışlı (streaming) yanıt ve araç kullanımını (tool use) yoğun kullanır. Bir gateway üzerinden çalışırken bu özelliklerin uçtan uca çalıştığını kendi ortamınızda doğrulamanız gerekir; bu çalışmada streaming/tool-use davranışı gerçek bir kurulumda test edilmedi.

22. Prompt ve veri gizliliği

İstekleriniz yerel gateway’den ve seçilen sağlayıcıdan geçer. Hassas kod veya veri gönderiyorsanız, hangi sağlayıcıya yönlendirildiğini ve o sağlayıcının veri saklama politikasını bilmelisiniz. Yerel-öncelikli mimari veriyi makinenizde tutmaya yardımcı olur, ancak sağlayıcıya giden içerik yine o sağlayıcının politikasına tabidir.

23. Maliyet kontrolü

Maliyet-öncelikli yönlendirme, ucuz modelleri önceleyip yalnız gerektiğinde güçlü modele çıkarak harcamayı düşürebilir. Yine de gerçek maliyet, seçtiğiniz sağlayıcıların fiyatlandırmasına bağlıdır; gateway maliyeti “sıfırlamaz”, yalnız dağıtır.

24. Ne zaman kullanılmamalı?

• Tek sağlayıcıyla sorunsuz çalışıyorsanız ve ek karmaşıklık istemiyorsanız.
• Kurumsal politikanız isteklerin üçüncü taraf/yerel bir aracıdan geçmesine izin vermiyorsa.
• Streaming/tool-use uyumluluğunu kendi ortamınızda doğrulayamıyorsanız (kritik iş akışlarında).

25. Kaldırma ve eski ayarlara dönme

# Global kurulumu kaldır (dokümantasyona göre)
npm uninstall -g omniroute

# Docker ise
docker rm -f omniroute

Ardından ~/.claude/settings.json içindeki ANTHROPIC_BASE_URL ve ANTHROPIC_AUTH_TOKEN satırlarını kaldırın; Claude Code doğrudan Anthropic’e geri döner. Değişikliği omniroute health yerine Claude Code’un normal çalışmasıyla doğrulayın.

26. Resmî kaynaklar ve son doğrulama

• OmniRoute resmî deposu: github.com/diegosouzapw/OmniRoute (incelenen sürüm: v3.8.49, lisans: MIT)
• OmniRoute kullanım kılavuzu: depo içindeki docs/guides/USER_GUIDE.md
• Claude Code resmî dokümantasyonu (Anthropic)

Son doğrulama tarihi: 25 Temmuz 2026. Bu rehberdeki komutlar bu ortamda çalıştırılmamıştır; “dokümantasyona göre” etiketli adımları kendi ortamınızda doğrulayın. Doğrulanamayan proje iddiaları (“290 sağlayıcı”, “~1.53B ücretsiz token” vb.) açıkça işaretlenmiştir.