OmniRoute Nedir? Kurulumu ve Kullanımı (2026 Rehberi)

OmniRoute, kendi bilgisayarında ya da sunucunda çalıştırdığın, ücretsiz ve açık kaynaklı bir yapay zekâ ağ geçidi. Claude Code, Cursor, Codex veya Cline gibi kodlama araçlarını yüzlerce model sağlayıcısına tek bir adres üzerinden bağlıyor; bir sağlayıcının kotası bittiğinde ya da hata verdiğinde isteği otomatik olarak başka bir modele aktarıyor. Proje GitHub’da MIT lisansıyla yayımlanıyor ve 24 Ekim 2026 itibarıyla 78 binden fazla yıldız almış durumda.

OmniRoute Nedir?

OmniRoute, yapay zekâ dünyasında “AI gateway” ya da “LLM gateway” denen türden bir araç. Kodlama aracın ile model sağlayıcıları arasına oturan yerel bir aracı sunucu gibi düşünebilirsin. Aracın isteği doğrudan OpenAI’ye, Anthropic’e ya da Google’a göndermiyor; http://localhost:20128/v1 adresindeki OmniRoute’a gönderiyor. OmniRoute da isteği hangi sağlayıcıya, hangi modele ileteceğine kendisi karar veriyor.

Projeyi Brezilyalı geliştirici Diego Souza yönetiyor. Kod tabanı, decolua adlı geliştiricinin 9router projesinin bir çatalı (fork) olarak başladı ve kısa sürede ondan çok daha geniş bir platforma dönüştü. Projenin kendi açıklamasına göre bugün 375 sağlayıcıyı ve 1.400’den fazla modeli destekliyor; bu sağlayıcıların 150’den fazlasının ücretsiz bir kullanım katmanı var. Tamamı TypeScript ile yazılmış, 900’ü aşkın kişi koda katkı vermiş ve arayüz Türkçe dahil 67 dilde kullanılabiliyor (OmniRoute GitHub).

Burada bir ayrımı baştan net koyalım: OmniRoute kendi başına model sunan bir servis değil. Sana token vermiyor, kendi sunucularında model çalıştırmıyor. Hesapları, API anahtarlarını ve abonelikleri sen getiriyorsun; OmniRoute bunları tek bir yerde topluyor ve akıllıca dağıtıyor.

OmniRoute Ne İşe Yarar?

Yapay zekâyla kod yazanların neredeyse hepsinin yaşadığı birkaç sorun var. OmniRoute bunların her birine bir çözüm sunuyor:

• Limite takılmak: Ücretli abonelikte bile 5 saatlik ya da haftalık kotalar var. Kota dolduğunda OmniRoute isteği sıradaki modele aktarıyor, sen kod yazmaya devam ediyorsun.
• Her sağlayıcının farklı API formatı: OpenAI, Anthropic ve Google farklı istek biçimleri kullanıyor. OmniRoute bunlar arasında otomatik çeviri yapıyor; Claude formatında konuşan bir araç, arka planda bir Gemini ya da DeepSeek modeli kullanabiliyor.
• Her aracı ayrı ayrı ayarlamak: Cursor, Claude Code, Codex, Cline gibi araçların hepsine tek bir adres ve tek bir anahtar veriyorsun.
• Maliyeti görememek: Panelde hangi modelin ne kadar token harcadığı, gecikme süreleri ve tahmini maliyet tek ekranda görünüyor.
• Bütçe kısıtı: Groq, Cerebras, NVIDIA NIM, Cloudflare Workers AI gibi sağlayıcıların ücretsiz katmanlarını bir araya getirip sıfır maliyetle çalışan bir zincir kurabiliyorsun.

Proje, bu ücretsiz katmanların toplamının ayda yaklaşık 1,62 milyar token ettiğini hesaplıyor. Ancak bu rakam OmniRoute’un verdiği bir hak değil; her sağlayıcıya ayrı ayrı kaydolup kendi anahtarını almanı gerektiren, sağlayıcıların istediği an değiştirebileceği bir tahmin. Projenin kendisi de bunu açıkça belirtiyor (OmniRoute GitHub).

OmniRoute Nasıl Çalışır?

Mantık basit: kodlama aracın tek bir adrese istek atıyor, OmniRoute isteği alıp formatını çeviriyor, ardından kota, maliyet ve sağlık durumuna bakarak uygun modele yönlendiriyor. Varsayılan yaklaşım dört katmanlı bir yedekleme sırası:

• 1. Abonelik: Zaten ödediğin bir planın kotası (örneğin bir kodlama aboneliği).
• 2. API anahtarı: DeepSeek, Groq, xAI, Mistral gibi kullandıkça öde sağlayıcılar.
• 3. Ucuz modeller: Token başına fiyatı düşük modeller.
• 4. Ücretsiz katman: Kayıtla ücretsiz kullanılabilen sağlayıcılar.

Bu sıralamayı OmniRoute’ta “combo” denen model zincirleriyle kendin de kurabiliyorsun. Bir combo, sırayla denenecek modellerin listesi. Projede 20 farklı yönlendirme stratejisi var: sırayla doldurma (priority), dönüşümlü dağıtma (round-robin), en ucuzu seçme (cost-optimized), en çok kotası kalanı seçme (headroom) gibi. Combo kurmakla uğraşmak istemiyorsan model adına sadece auto yazman yeterli; OmniRoute bağladığın sağlayıcılardan sanal bir zincir oluşturup her isteği sağlık, kota, maliyet, gecikme ve görev uyumu gibi 16 ölçüte göre puanlıyor. auto/coding, auto/fast ve auto/cheap gibi varyasyonlarla önceliği kaliteye, hıza ya da fiyata kaydırabiliyorsun.

OmniRoute’un Öne Çıkan Özellikleri

Kurulumda hata mı aldın? Sorununu Yapay Zekâ Forumu’nun Kodlama ve Otomasyon bölümünde sor, deneyimli kullanıcılardan yardım al.

OmniRoute Kurulumu: Adım Adım

En kolay yol npm ile kurmak. Bilgisayarında Node.js yüklü olması gerekiyor; projenin deposunda hedef sürüm olarak Node.js 24 belirtilmiş, bu yüzden güncel bir sürüm kurman en sorunsuz seçenek. Aşağıdaki adımlar projenin resmi kurulum rehberine dayanıyor.

node --version

npm install -g omniroute
omniroute

pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core

curl http://localhost:20128/v1/chat/completions \
  -H "Authorization: Bearer OMNIROUTE_ANAHTARIN" \
  -H "Content-Type: application/json" \
  -d '{"model":"auto","messages":[{"role":"user","content":"Merhaba!"}]}'

Docker ile kurulum

Sunucuda ya da bilgisayarını kirletmeden çalıştırmak istiyorsan resmi Docker imajını kullanabilirsin. Ayarlar ve veritabanı, yeniden başlatmalarda kaybolmasın diye ayrı bir birimde (volume) tutuluyor:

docker run -d \
  --name omniroute \
  --restart unless-stopped \
  -p 20128:20128 \
  -v omniroute-data:/app/data \
  diegosouzapw/omniroute:latest

Arch Linux kullananlar AUR’daki omniroute-bin paketini kurabilir. Terminalle uğraşmak istemeyenler için Windows, macOS ve Linux’a yönelik bir masaüstü uygulaması da var; kurulum dosyaları projenin GitHub Releases sayfasında yayımlanıyor. Güncellemek için omniroute update komutu yeterli.

Claude Code, Cursor ve Codex’e Bağlama

Kodlama aracına vereceğin bilgiler hep aynı üç değer:

Elle ayarlamak yerine OmniRoute’un hazır kurulum komutlarını da kullanabilirsin. Bu komutlar çalışan OmniRoute’tan güncel model listesini çekip ilgili aracın kendi ayar dosyasını yazıyor (CLI entegrasyonları rehberi):

omniroute setup-claude      # Claude Code için profil dosyaları
omniroute setup-codex       # Codex CLI profilleri
omniroute setup-opencode    # OpenCode ayarı
omniroute setup-cline       # Cline ayarı
omniroute setup-cursor      # Cursor için uygulama içi adımları yazdırır

Komutların ne yazacağını önce görmek istersen sonuna --dry-run ekle; dosyalara dokunmadan ön izleme gösteriyor. Hiç ayar dosyası yazmadan denemek için omniroute launch komutu Claude Code’u doğru ortam değişkenleriyle başlatıyor. Claude Code’u elle bağlıyorsan bir ayrıntıya dikkat et: Claude Code için adres /v1 olmadan, http://localhost:20128 şeklinde verilmeli, çünkü araç /v1/messages yolunu kendisi ekliyor.

Cursor’un ayarları uygulamanın içinde tutulduğu için OmniRoute dosya yazmıyor, sadece adımları listeliyor: Cursor ayarlarında OpenAI uyumlu bir model ekleyip yukarıdaki üç değeri girmen yeterli. Cursor’u yeni tanıyorsan Cursor rehberimize, OpenCode için OpenCode ve Windsurf rehberimize göz atabilirsin. Modelleri tamamen kendi bilgisayarında çalıştırmak istiyorsan OmniRoute, Ollama ve LM Studio gibi yerel çalıştırıcıları da sağlayıcı olarak ekleyebiliyor.

OmniRoute’un Avantajları ve Dezavantajları

Yedekleme özelliğinin bir bedeli olduğunu da unutmamak lazım. Bir istek pahalı ve güçlü bir modelden ücretsiz ve küçük bir modele düştüğünde, aldığın cevabın kalitesi de düşebilir. Panelde her yanıtın hangi sağlayıcıdan geldiği görünüyor; kritik işlerde bunu kontrol etmek iyi bir alışkanlık.

Hesap Güvenliği ve Kullanım Şartları

OmniRoute’u kurmadan önce okunması gereken en önemli bölüm bu. Aracın kendisi yasal ve açık kaynak, ancak ona bağladığın hesapların kullanım şartları ayrı bir konu.

Benzer kısıtlar başka sağlayıcılarda da var. OmniRoute’un kendisi bazı sağlayıcıları kullanım şartları açısından riskli olarak işaretliyor ve örneğin Kiro gibi “kaçınılması önerilen” olarak etiketlenen sağlayıcıları otomatik yönlendirmeden varsayılan olarak çıkarıyor; o hesabı bağlaman bu ayarı değiştirmiyor (OmniRoute GitHub). Pratik öneriler şöyle:

• Ana iş hesabını ya da tek ücretli aboneliğini OAuth ile bağlamadan önce o sağlayıcının şartlarını oku.
• Mümkün olduğunca resmi API anahtarlarını ve proxy kullanımına izin veren ücretsiz katmanları tercih et.
• Şirketin ya da ekibin aboneliğini, sözleşmenin sahibine sormadan bir havuza bağlama.
• OmniRoute’u bir VPS’e kurup internete açacaksan mutlaka API anahtarı zorunluluğu, güçlü bir panel şifresi ve HTTPS kullan; yoksa adresini bulan herkes senin kotanı tüketebilir.

OmniRoute, OpenRouter ve LiteLLM Arasındaki Fark

Tek bir hesap ve tek bir faturayla uğraşmak istiyorsan OpenRouter daha kolay. Kodlama araçlarını mevcut aboneliklerin, API anahtarların ve ücretsiz katmanlar arasında akıllıca dağıtmak, maliyeti mümkün olduğunca düşük tutmak istiyorsan OmniRoute daha esnek. OmniRoute OpenRouter’ı da bir sağlayıcı olarak ekleyebildiği için ikisini birlikte kullanmak da mümkün. Açık modellere ücretsiz erişim arıyorsan NVIDIA’nın ücretsiz modeller kataloğu da OmniRoute’a bağlanabilen sağlayıcılardan biri.

Sıkça Sorulan Sorular

Kaynaklar

1. OmniRoute: The Free AI Gateway (diegosouzapw/OmniRoute, GitHub, Ekim 2026)
2. Setup Guide: OmniRoute (OmniRoute belgeleri, GitHub, Ağustos 2026)
3. CLI Integrations: point any coding CLI at OmniRoute (OmniRoute belgeleri, GitHub, Ağustos 2026)
4. Legal and compliance: Claude Code Docs (Anthropic)

Daha fazla güncel gelişme: Günün tüm yapay zeka haberleri için Yapay Zeka Haberleri sayfamızı takip et.