OmniRoute senin bilgisayarında çalışan bir yönlendirici. Claude Code, Cursor ya da Codex'i tek bir adrese bağlıyorsun, o da arkada 350'den fazla sağlayıcı arasında dolaşıyor ve biri limite takılınca ya da hata verince sıradakine geçiyor. Açık kaynak, MIT lisanslı ve hesap istemiyor. Kurulumu tek satır ama üç yerde takılıyorsun. Birincisi Node sürümü: desteklenmeyen sürümde kurulum bitmiş görünüyor, panel boş açılıyor. İkincisi Claude Code: diğer araçlara verilen adres ona uymuyor, dokümandaki ayar komutu da mevcut ayar dosyanın üstüne yazıyor. Üçüncüsü ücretsiz sağlayıcı seçimi: hızlı başlangıcın önerdiği Kiro ve OpenCode Free, projenin kendi kullanım koşulları tablosunda "avoid" yani kaçın işaretli. Aşağıda doğrulanmış kurulum, Claude Code'u hiçbir dosyaya dokunmadan bağlamanın yolu ve hangi sağlayıcıyı bağlamanın temiz olduğunu nereden anlayacağın var.
OmniRoute bir AI gateway. Kodlama aracın isteğini ona gönderiyor, o da bağladığın sağlayıcılardan uygun olanına iletiyor. Sağlayıcı cevap vermezse, limiti dolarsa ya da hata dönerse sıradakine geçiyor. Her şey senin bilgisayarında çalışıyor: istemlerin OmniRoute'un bir sunucusundan geçmiyor, doğrudan seçilen sağlayıcıya gidiyor, anahtarların da diskte şifreli duruyor.
Aşağıda fazladan olan şey şu: hangi Node sürümlerinde çalıştığı, Claude Code'un neden diğer araçlardan farklı bağlandığı, dokümandaki ayar komutunun neyi sildiği ve README'nin önerdiği ücretsiz sağlayıcıların projenin kendi tablosunda neden kaçın işaretli olduğu.
İstek nereden nereye gidiyor
Kodlama aracın
Claude Code, Cursor, Codex, Cline. Hepsi tek bir adrese bağlı.
OmniRoute, localhost:20128
İsteği alıyor, hangi sağlayıcıya gideceğini seçiyor, hata olursa sıradakini deniyor.
Sağlayıcılar
Önce aboneliklerin, sonra API anahtarların, sonra ucuz ve en son ücretsiz katmanlar.
Model adı olarak auto yazarsan hangi modelin kullanılacağına OmniRoute karar veriyor. Varyantları da var: auto/coding kod kalitesini, auto/fast hızı, auto/cheap fiyatı öne alıyor.
Bir şeyi baştan bilmek lazım: Claude Code'u OmniRoute üzerinden açtığında arayüz Claude Code oluyor ama cevabı veren model Claude olmayabiliyor. Kalite beklentini buna göre ayarla. Aynı ayrımı arşivde 110 numarada daha ayrıntılı anlattım.
Node 20 ve 23'te çalışmıyor
Kabul edilen sürümler 22 serisinde 22.22.2 ve üstü, ya da 24, 25 ve 26. Node 20, Node 23 ve 22'nin eski yamaları desteklenmiyor. Desteklenmeyen sürümde kurulum bitmiş gibi görünüyor ama panel boş açılıyor ya da Module did not self-register hatası çıkıyor. Emin değilsen 24'ü kur.
node -vnpm install -g omniroute
omnirouteİkinci komut sunucuyu başlatıyor ve paneli tarayıcıda açıyor: http://localhost:20128. Bu terminal açık kaldığı sürece OmniRoute çalışıyor. Kapatırsan araçların bağlanacak bir adres bulamıyor.
Kurulum sırasında ekrana npm warn ERESOLVE ve deprecated uyarıları dökülüyor. Zararsızlar, projenin kendi dokümanı da böyle diyor. Sonda added ile başlayan ve kaç paket eklendiğini yazan satırı görüyorsan kurulum tamam.
omniroute doctor
# sağlayıcıları, portu ve bağımlılıkları kontrol ederYeni kurulumda hiçbir anahtar girmeden model olarak auto yazdığında cevap geliyor, çünkü OmniRoute anahtar istemeyen OpenCode Free'yi hazır bağlı getiriyor. README'nin hızlı başlangıcı da bir sonraki adım olarak Kiro AI ya da OpenCode Free bağlamanı öneriyor.
Aynı projenin ücretsiz katmanlar belgesinde her sağlayıcının kullanım koşulları okunmuş ve işaretlenmiş. Bu ikisi avoid, yani kaçın işaretli. Kiro'nun SSS'i üçüncü taraf araçlar üzerinden kullanımı yasaklıyor ve proje OmniRoute'un da bu kapsama girdiğini yazıyor. OpenCode'un koşulları da kullanımı kendi iç kullanımınla sınırlıyor. Kiro'ya kendi hesabınla giriş yaptığın için oradaki risk doğrudan o hesabın.
Panelde gördüğün işaretler
| İşaret | Anlamı | Ne yap |
|---|---|---|
| ok | Koşullar bu kullanıma açıkça izin veriyor | Bağla |
| caution | Kişisel kullanım ya da proxy maddesi var | Bağlamadan önce maddeyi oku |
| ambiguous | Koşullar net değil | Kararı sen ver |
| avoid | Koşullar bu kullanımı yasaklıyor ya da ciddi şekilde kısıtlıyor | Bağlama |
Kaçın işareti yönlendirmeyi durdurmuyor
Bu işaretler sadece bilgi. Kaçın işaretli bir sağlayıcıyı bağlarsan OmniRoute onu auto'da ve yedek sıralamasında kullanmaya devam ediyor. Arada bir engel yok, kararı sen veriyorsun.
İşaretleri panelde Free Tiers sayfasında görüyorsun: http://localhost:20128/dashboard/free-tiers. Belge iki haftada bir yeniden gözden geçiriliyor, yani işaretler de ücretsiz token rakamları da değişebiliyor. Bağlamadan önce oradan bak. Şu an ok alan az sayıda sağlayıcı var, Z.AI'nin ücretsiz GLM Flash modelleri ve DeepSeek'in kayıt kredisi bunlardan. Gemini, Groq ve Mistral gibi kendi API anahtarınla bağlandıkların caution işaretli.
Cursor, Codex ve Cline gibi araçlar OpenAI formatında konuşuyor ve adres olarak http://localhost:20128/v1 istiyor. Claude Code ise Anthropic formatında konuşuyor ve adresin sonuna /v1'i kendisi ekliyor. Ona /v1'li adresi verirsen istekler yanlış yere gidiyor.
En temiz yol OmniRoute'un kendi başlatıcısı. Hiçbir ayar dosyasına yazmıyor, adresi ve modeli sadece o an açtığın Claude Code oturumuna veriyor. Normal claude komutun aboneliğinle çalışmaya aynen devam ediyor.
# 1. terminal: OmniRoute açık kalsın
omniroute
# 2. terminal: Claude Code'u OmniRoute üzerinden aç
omniroute run claude --model autoİkinci komut önce OmniRoute'un ayakta olup olmadığına bakıyor. İlk terminali kapattıysan OmniRoute is not reachable diyor ve Claude Code'u açmıyor. Bilgisayarında Claude Code kurulu değilse de açılmıyor, önce onu kurman gerekiyor.
Her seferinde model yazmak istemiyorsan her model için ayrı profil oluşturabilirsin. Bu komut profilleri ~/.claude/profiles altına yazıyor, ana settings.json dosyana dokunmuyor. Profil adları bağladığın modellere göre oluşuyor.
omniroute setup-claude
omniroute launch --profile <profil-adı>Claude Code'da en sık üç hata
Adres olarak http://localhost:20128/v1 vermek
Claude Code için adres http://localhost:20128, sonunda /v1 yok. /v1 sadece OpenAI formatındaki araçlar için
Dokümandaki cat > ~/.claude/settings.json komutunu olduğu gibi çalıştırmak
Tek > işareti dosyayı baştan yazıyor, izinlerin, hook'ların ve eklenti ayarların gidiyor. omniroute run claude hiçbir dosyaya dokunmuyor
Ayarı değiştirip açık olan Claude Code oturumunda denemek
Claude Code bu ayarları sadece açılırken okuyor. Değiştirdiysen kapatıp yeniden aç
OpenAI formatındaki araçlar için üç bilgi yetiyor: adres, anahtar ve model. Anahtarı panelde Endpoints sayfasından kopyalıyorsun.
Base URL: http://localhost:20128/v1
API Key: Panel → Endpoints sayfasından kopyala
Model: autoBazı araçlarda bunu elle girmene de gerek yok. omniroute configure codex komutu model listesini gösterip Codex'in kendi ayarını yazıyor, aynı komut OpenCode, Aider, Goose, Cline, Continue ve Kilo için de çalışıyor. Cursor'ın ayarları dışarıdan yazılamadığı için omniroute setup-cursor sadece uygulamanın içinde nereye tıklayacağını yazdırıyor.
Varsayılan bellek kodlama ajanına yetmiyor
Docker imajı 1 GB bellek ayarıyla geliyor. Panel ve kısa sohbetler için yeterli, ama Claude Code ya da Codex gibi bir kodlama ajanı bağladığında süreç bellek hatasıyla çöküyor. Tek bir ajan için belleği 8 GB'a çıkar ve konteynere en az 10 GB ver.
docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \
-e OMNIROUTE_MEMORY_MB=8192 --memory=10g \
-p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latestKodlama araçlarını tek adrese bağlayan, limit dolunca ya da hata olunca başka sağlayıcıya geçen açık kaynak AI gateway. MIT lisanslı, kendi bilgisayarında çalışıyor, hesap istemiyor.
npm install -g omniroute
omnirouteNode 22.22.2 ve üstü ya da 24 ile 26 arası gerekiyor. Claude Code'a bağlarken adresin sonuna /v1 koyma, en kolayı omniroute run claude --model auto.
Buradaki araçları tek başına kurmak bir şey, onlarla gerçekten üretmeye başlamak başka bir şey. Toplulukta hem bu araçları günlük kullananlar var hem de sıfırdan sistem kuranlar.
İşinde gerçekten çalışan bir sistem kurmak istiyorsan 10 dakika konuşalım; ne yapmaya çalıştığına bakıp sana uygun yolu söyleyeyim. Ücretsiz, satış konuşması değil.
10 dakikalık görüşme alBunu tek başına değil, aynı işi yapanlarla birlikte öğrenmek istiyorsan topluluk her zaman açık:
Topluluğa katılBu bağlantı bir ortaklık (affiliate) bağlantısıdır.