OmniRoute nedir? Claude Code ile kurulum, ücretsiz modeller ve riskler

Claude Code, Codex, Cline gibi kodlama araçlarını tek bir yerel adrese (http://localhost:20128/v1) bağlarsın; kendi bilgisayarında çalışan OmniRoute isteği bağladığın sağlayıcılara dağıtır, kota dolunca ya da hata olunca bir sonrakine geçer. MIT lisanslı açık kaynak; npm, Docker ya da masaüstü uygulamasıyla kurulur, terminal bilgisi gerekir. Yazılım ücretsiz ama modeller değil: "ücretsiz kota", bağladığın hesapların kendi kotasıdır, OmniRoute vermez. Sağlayıcı şartları ve hesap riski sende.

Ne yapar: Kodlama araçlarını tek adresten sağlayıcılara dağıtır
Tür: Yerel ağ geçidi (açık kaynak)
Yazılım: Ücretsiz (MIT)
Model ücreti: Sağlayıcılara ait; OmniRoute vermez
Kodsuz: Kısmen; panel tarayıcıda, kurulum terminalde
Risk: Sağlayıcı şartları ve hesap riski sende
Son sürüm: v3.8.51 (30.09.2026)

OmniRoute ne işe yarar? Kodsuz kullanabilir miyim?

Yapay zekâ ile kod yazan araçların (Claude Code, Codex, Cline gibi) her biri kendi sağlayıcısına bağlanır. OmniRoute bunların arasına girer: bilgisayarında çalışan tek bir adres açar, araçlar o adrese bağlanır, OmniRoute isteği senin bağladığın sağlayıcılardan birine gönderir. Biri kota ya da hata verince otomatik bir sonrakini dener. Bu türden araçlara "ağ geçidi" (gateway) denir. Panel ve ayarlar tarayıcıda açılır.

Tek yerel adresten çok sağlayıcıNe alırsın: OpenAI uyumlu /v1 uç noktasıAyrı kurulum gerekir Kota dolunca otomatik geçişNe alırsın: Aynı istek başka sağlayıcıdan yanıtlanırAyrı kurulum gerekir Kodlama araçlarını bağlamakNe alırsın: omniroute run <araç> komutuyla ya da Base URL ayarıylaAyrı kurulum gerekir

Kodsuz kullanabilir miyim?

Kısmen. Kurulumdan sonra sağlayıcı ekleme, anahtar kopyalama ve ayarlar tarayıcıdaki panelde (http://localhost:20128) yapılır. Ama kurulum için ya Node.js ve bir terminal komutu (npm install -g omniroute), ya Docker ya da masaüstü kurulum dosyası gerekir; araçlara adresi ve anahtarı yazmak da senin işin. Hiç teknik bilgin yoksa bu araç sana göre değil.

Kime yarar: birden çok yapay zekâ sağlayıcısı kullanan, kota ve maliyeti tek yerden yönetmek isteyen geliştiricilere ve ileri kullanıcılara. README "tasarruf" ve "hiç durma" vaat ediyor; bunlar üreticinin ifadesi. Rehber her şeyi olduğu gibi aktarıyor, kendi denemen yok.

Sağlayıcı sayısı belgeler arasında farklı (README 372, depo açıklaması 359, omniroute.online 352); bu yüzden kesin sayı yazılmadı. Ad dikkat: "omni router" aramaları başka ürünlere de çıkabilir; bu sayfa GitHub'daki diegosouzapw/OmniRoute içindir.

OmniRoute nasıl kurulur? Hangi sürüm ve donanım gerekir?

Yayınlanmış son sürüm v3.8.51 (30.09.2026, GitHub Releases ve npm). Depodaki varsayılan dal 3.8.52 gösteriyor; bu henüz yayınlanmamış gelişim dalı.

Node.js sürümü 22.22.2 ve üstü (22.x) ya da 24 ve üstü (27'den önce) olmalı (package.json).

Kur ve başlat

› npm install -g omniroute
omniroute

Panel http://localhost:20128, API http://localhost:20128/v1 adresinde açılır. npm uyarıları (ERESOLVE) zararsız. npm 11 kullanıyorsan README'deki --allow-scripts komutuyla gerekli paketlere izin vermen gerekebilir.

Yalnızca bu bilgisayardan erişilir

› docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \
  -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest

İş yükü	Bellek ayarı	Konteyner (--memory)
Panel, hafif sohbet	`1024` (imaj varsayılanı)	en az 2 GB
Bir kodlama aracı	`8192` (OMNIROUTE_MEMORY_MB)	en az 10 GB
İki uzun istek aynı anda	`10240` ila `12288`	en az 12 ila 16 GB

Değerler README'nin Docker bölümünden. Kodlama araçları için varsayılan bellek yetmeyebilir.

Releases sayfasında Windows için OmniRoute.Setup.3.8.51.exe (yaklaşık 0,58 GB), macOS için .dmg, Linux için .AppImage ve .deb dosyaları var.

Sorun giderme belgesi Windows kurulum dosyasının henüz kod imzalı olmadığını ve antivirüs ya da SmartScreen uyarısı verebileceğini yazıyor. Dosyayı yalnız resmî GitHub Releases sayfasından indir.

Yönetici girişi için .env dosyasında INITIAL_PASSWORD ayarlanır (sorun giderme belgesi: koda gömülü varsayılan parola yok). Parolayı bir yere yazma, paylaşma.

Kurulum bilgisi README, package.json ve sorun giderme belgesinden (15.10.2026).

OmniRoute nasıl kullanılır? Claude Code, Codex, VS Code ve kendi kodun

Önce panelde Providers bölümünden şartları sana uyan bir sağlayıcıyı ekle (API anahtarı gir ya da hesabınla giriş yap). Sonra Endpoints bölümünden OmniRoute anahtarını kopyala. Araçlar bu anahtarla yerel adrese bağlanır; sağlayıcı anahtarların OmniRoute'da kalır.

Aracı OmniRoute üzerinden başlat› omniroute run claude --model <sağlayıcı>/<model>

claude yerine codex, aider, goose, opencode, qwen, gemini yazabilirsin. README örneğindeki model adı yerine bağladığın sağlayıcının model adını yaz. Yapılandırma dosyalarına yazılmaz, kimlik bilgileri süreç başına verilir.

Aracın kendi ayar dosyasını yazdır› omniroute configure codex

configure komutu claude, opencode, qwen, aider, goose, gemini, cline, continue, kilo için de çalışır. Ne yapacağını görmek için komuta --dry-run, anahtarı kabuk geçmişine yazmamak için --api-key-env AD ekleyebilirsin.

Adres ve anahtarı kabul eden her OpenAI uyumlu araçta şunları gir:

Base URL: http://localhost:20128/v1
API Key: Panel > Endpoints bölümünden kopyaladığın OmniRoute anahtarı
Model: auto (bağlı uygun sağlayıcılar arasından seçer) ya da sağlayıcı/model

README, başlık (Authorization) gönderemeyen araçlar için anahtarı adrese gömen alternatif adresler de veriyor. Anahtar adreste göründüğü için yalnız zorunluysa kullan; başlıkla göndermek tercih edilen yol.

README'ye göre OmniCopilot eklentisini kurup OmniRoute sunucuna (varsayılan localhost:20128) yönlendirirsin; sonra Copilot Chat > model seçici > Manage Models… > OmniRoute yolundan modeller görünür. VS Code 1.122'den beri sağlayıcı modelleri GitHub girişi ve Copilot aboneliği olmadan çalışıyor (README). Eklenti VS Code Marketplace ve Open VSX'te; Open VSX üzerinden Cursor, Windsurf, VSCodium gibi editörlerde de kurulabiliyor.

Çalıştığını kontrol et (README)› curl http://localhost:20128/v1/models -H "Authorization: Bearer ANAHTARIN"

Bir istek gönder (README)

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

auto yalnız uygun bir bağlantı varsa çalışır; yeni kurulumda hiç uygun hedef olmayabilir.

Komutlar README'den aynen (15.10.2026). Her aracın ayrıntılı kurulumu için README 36 araçlık bir belge (docs/reference/CLI-TOOLS.md) veriyor.

OmniRoute riskleri: hesap, veri ve ticari kullanım. Türkçe mi?

Yapabilirsin

Yazılımı MIT lisansıyla ticari amaçla kullanmak, değiştirmek ve dağıtmak
Bağladığın sağlayıcıları kendi hesap ve şartlarına uygun kullanmak

Yasak

Sağlayıcının kota ya da erişim politikasını aşmak için ek hesap açmak (rehber uyarıyor)
Dağıttığın kopyalarda telif notunu silmek

Hesap ve şartlar

Her sağlayıcının hizmet şartı, gizlilik politikası ve ücretsiz katman koşulu ayrı geçerli. Rehber "hesap politikası riskinden" söz ediyor. Abonelik hesabı (OAuth) bağlamadan önce o sağlayıcının güncel şartlarını oku. Hukuki görüş değildir.

Veriler nereye gidiyor

Ağ geçidi ve panel kendi makinende çalışır, telemetri varsayılan olarak kapalı. Ama istemlerin her istekte seçilen sağlayıcıya gider; bazı ücretsiz sağlayıcılar istekleri kaydedebilir ya da eğitimde kullanabilir. Kimlik bilgileri şifreli saklanır, yerel bir denetim kaydı tutulur.

Erişim

Docker komutu yalnız bu bilgisayardan erişilecek biçimde (127.0.0.1) bağlıyor. Başka cihazlara açarsan OmniRoute anahtarını ve parolayı ciddiye al. README, anahtarı adrese gömen alternatif adresleri yalnız başlık gönderemeyen araçlar için öneriyor.

Türkçe panelVar	Depoda Türkçe çeviri dosyası (tr.json) ve Türkçe README (docs/i18n/tr) var. Çevirinin ne kadar eksiksiz olduğu ölçülmedi.
Türkçe yanıtNet değil	OmniRoute isteği seçilen modele iletir; yanıt dili ve kalitesi modele bağlı. Resmî kaynak ayrıca yazmıyor.

Bu bölüm hukuki görüş değildir. Bilgiler README ve resmî belgelerin 15.10.2026 sürümünden.

OmniRoute ücretsiz mi? "Ücretsiz modeller" gerçekten ücretsiz mi?

Yazılım ücretsiz (MIT). Ama OmniRoute senin yerine model sağlamaz ve token vermez. README'nin başındaki "ayda yaklaşık 1,62 milyar token" rakamı, ayrı ayrı uygun üçüncü taraf ücretsiz katmanların tahmini toplamı; README bunun OmniRoute'un verdiği bir hak olmadığını kendisi yazıyor. Her ücretsiz kota için o sağlayıcıda kayıt olursun.

Ücretsiz katmanlar kayıt, onay, ödeme yöntemi ya da kimlik doğrulaması isteyebilir. Ücretsiz Katmanlar Rehberi'nin "Yakalanacak bir şey var mı?" bölümü şunları sayıyor: sıkı limitler, bekleme listesi, KYC, kredi kartı doğrulaması, istemlerin eğitimde kullanılması, zayıf gizlilik, SLA yok, model değişimi, coğrafi kısıtlar, ücretli aşım ve hesap politikası riski.

Örnek (rehberden, tarihli)	Ne diyor
Cerebras	Tek seferlik 5 dolar kredi, 30 günde sona erer, ödeme yöntemi gerekir; yinelenen kota değil (rehber 08.10.2026'da doğruladığını yazıyor).
OpenRouter	Ücretsiz modeller kota ve istek sınırlı; isteğe bağlı bir yükleme sınırı artırıyor.
Logfare	Ücretsiz anahtar, ama rehber "her istek araştırma için kaydedilir" diyor (vazgeçme bağlantısı var).
Kiro, OpenCode Free	"tos: avoid" işaretli; hesap şartı riski nedeniyle otomatik yönlendirmeden varsayılan olarak çıkarılır, hesap bağlamak bunu geçersiz kılmaz.

Garanti yok: README her sağlayıcının kota koyabileceğini, model değiştirebileceğini, erişimi askıya alabileceğini ya da kapanabileceğini yazıyor. "Ücretsiz" ibaresi sağlayıcıya göre değişir; kendi koşuluna sağlayıcının sayfasından bak. Rehber çoklu hesabı da kısıtlıyor: sağlayıcı kotasını aşmak için fazladan hesap açma.

Sunucu ve güncelleme

Kendi bilgisayarında ya da kendi sunucunda çalıştırırsın; bilgisayar, elektrik, sunucu maliyeti ve güncellemeler sende. Sunucu tutarı burada yok, resmî kaynak vermiyor.

Sponsor tanıtımları

omniroute.online ve README sponsor bölümü ücretli bir geçidi (Cheaper Inference) tanıtıyor; site sahibinin ona katıldığını yazıyor. Bu bir tanıtımdır, kurulum için gerekli değildir ve burada önerilmiyor.

Resmî fiyat sayfası en son 28 Ekim 2026 tarihinde kontrol edildi.

OmniRoute sık sorunlar: API anahtarı, giriş ve hata kodları

Ne oluyor	Ne yapmalı (resmî sorun giderme)
`429` / "Rate limit exceeded"	1 dakika bekle ya da `model: auto` ile otomatik yedeklemeyi kullan.
"Quota exceeded"	Kotan bitmiş; daha fazla sağlayıcı bağla.
`401 Unauthorized`	API anahtarını kontrol et ya da OAuth ile yeniden giriş yap.
`502 Bad Gateway`	Sağlayıcı kapalı; bekle ya da `auto` ile başka sağlayıcıya geç.
İlk girişte parola çalışmıyor	`.env` dosyasında `INITIAL_PASSWORD` ayarla.
`auto` hata veriyor	Yeni kurulumda uygun anahtarsız hedef olmayabilir; en az bir sağlayıcı bağla. "tos: avoid" sağlayıcılar otomatik yönlendirmeden hariç.
"omniroute is not recognized" (Windows)	npm genel dizinini PATH'e ekle; yolu `npm config get prefix` ile bul.
Windows kurulum dosyası antivirüsçe işaretleniyor	Kurulum dosyası henüz kod imzalı değil; belge, dosyayı `latest.yml` içindeki sha512 değeriyle karşılaştırmayı anlatıyor.

Sık sorulan sorular

OmniRoute nedir, ne işe yarar?

Kendi bilgisayarında çalışan, OpenAI uyumlu tek bir adresten birçok yapay zekâ sağlayıcısına istek gönderen ve kota dolunca ya da hata olunca otomatik başka sağlayıcıya geçen MIT lisanslı bir ağ geçidi. Panel tarayıcıda açılır.

OmniRoute Claude Code ile nasıl kullanılır?

OmniRoute'u kur, panelden bir sağlayıcı ekle ve omniroute run claude --model <sağlayıcı>/<model> komutunu ya da aracın Base URL ayarını http://localhost:20128/v1 yapıp OmniRoute anahtarını gir. Ayrıntılar kullanım bölümünde.

OmniRoute nasıl kurulur?

npm ile npm install -g omniroute ve omniroute (Node.js 22.22.2 ya da 24 ve üstü), Docker ile diegosouzapw/omniroute imajı ya da masaüstü uygulaması. Panel http://localhost:20128 adresinde açılır.

OmniRoute ücretsiz mi, ücretsiz modeller var mı?

Yazılım ücretsiz (MIT). Ücretsiz modeller üçüncü taraf sağlayıcıların kendi kotalarıdır; kayıt, kart ya da kimlik doğrulaması isteyebilir ve garanti yoktur. OmniRoute kota vermez.

OmniRoute API anahtarını nereden alırım?

OmniRoute anahtarı panelde Endpoints bölümünden kopyalanır. Sağlayıcı anahtarlarını ise her sağlayıcının kendi sitesinden alıp Providers bölümüne girersin. 401 hatasında anahtarı kontrol et ya da yeniden giriş yap.

OmniRoute VS Code ve GitHub Copilot ile çalışır mı?

README'ye göre OmniCopilot eklentisiyle OmniRoute modelleri Copilot Chat'in model seçicisinde görünür; VS Code 1.122'den beri bunun için GitHub girişi ya da Copilot aboneliği gerekmiyor.

İlgili rehberler

Cline

OpenRouter

Meta Muse: API ve Muse Code

Claude Code

Cursor

GitHub Copilot

Kaynaklar

Resmî kaynaklarda net olmayanlar: Ücretsiz sağlayıcıların güncel kotaları ve şartları · abonelik hesabı bağlamanın sağlayıcıların şartlarıyla uyumu · sağlayıcı sayısı (belgeler arasında farklı) · "%15 ila 95 token tasarrufu" gibi üretici iddiaları (içeriğe bağlı) · Türkçe panel çevirisinin eksiksizliği ve Türkçe yanıt kalitesi · masaüstü paketinin davranışı (indirilmedi) · sunucu maliyeti (resmî kaynak vermiyor) · sorun kayıtlarının tamamı (444 açık kayıt). Her biri ilgili bölümde ne yapabileceğinle birlikte yazılı.