00 · Ne işine yarar
Kota dolunca elle model değiştirme derdi biter
Bu, bilgisayarınızda çalışan küçük bir yönlendirme paneli. Size tek bir adres verir; Claude Code, VS Code veya benzer araçlarınızı bu adrese bağlarsınız. Panel arka planda 290 farklı sağlayıcıya (bir kısmı tamamen ücretsiz) bağlanır ve isteğinizi en uygun olana yönlendirir — kota dolduğunda elle ayar değiştirmek yerine, sistem devreder. Yazılımcı olmanız gerekmiyor; iki komut + bir tarayıcı sekmesi yeterli.
Nasıl kullanılır:
- Önce paneli kurun ve şifrenizi değiştirin — bu tek başına ayrı, atlanmaması gereken bir adım.
- Sonra ücretsiz sağlayıcılardan başlayın, ihtiyaç oldukça anahtar/ücretli sağlayıcı ekleyin.
- Claude Code veya VS Code'a üç satırlık ayarla bağlayın, çalıştığını tek komutla doğrulayın.
- Kurulum sırasında en sık çıkan 4 hatanın çözümü de aşağıda, sırayla.
01 · Önce / sonra
Tek adres, otomatik yönlendirme
önce
Claude kotanız dolunca elle başka bir servise geçiyorsunuz; her araç için ayrı anahtar, ayrı ayar, ayrı hesap takibi.
sonra
Tek adres + tek anahtar. Panel arka planda hangi sağlayıcının uygun olduğuna bakıyor, isteğinizi oraya yönlendiriyor — siz fark etmiyorsunuz bile.
Kurulumun kendisi iki komut ve bir tarayıcı sekmesinden ibaret. Ama şifreyi değiştirmeden bırakmak, yanlış sırayla ilerlemek gibi gözden kaçan noktalar var — sırayla, denenmiş haliyle aşağıda.
02 · Kurulum
İki komut, sonra bir tarayıcı sekmesi
Terminali açın (Windows'ta Komut İstemi veya PowerShell) ve sırayla şu iki komutu çalıştırın.
$ npm install -g omniroute
$ omniroute
# İkinci komut paneli başlatırTarayıcıda şu adresi açın:
http://localhost:2012803 · İlk ayarlar (şifre!)
Panel sizi bir giriş ekranıyla karşılar
Kullanıcı adı yok, sadece şifre var — ve ilk kurulumda şifre herkeste aynı.
CHANGEMEBunu görür görmez ilk işiniz şifreyi değiştirmek. Panelin ayarlar bölümünden yeni bir şifre belirleyin. Varsayılan şifreyle bırakmak, panele kim isterse erişebilir demek — atlanacak bir adım değil.
04 · Ücretsiz araç bağlama
Hiçbir yere kayıt olmadan başlayabilirsin
- Panelde Sağlayıcılar sekmesine gidin.
- "Kimlik Doğrulama Yok" filtresini uygulayın — bu filtre 9 sağlayıcıyı listeler, hiçbiri hesap istemez.
- OpenCode Free kutusu zaten etkin gelir, ekstra ayar gerekmez.
Kayıt isteyen ama yine ücretsiz olan seçenekler de var: Kiro AI (ayda ~50 kredi), Gemini CLI, Groq, Cerebras, NVIDIA NIM, Mistral, Together AI, OpenRouter. Toplamda panelde 290 sağlayıcı var, 90'dan fazlası ücretsiz katman sunuyor.
05 · Anahtar üretme
Araçlarını panele bağlamak için kendi anahtarını üret
- Panelde API Yöneticisi sekmesine gidin.
- "API Anahtarı Oluştur" butonuna basın.
- Anahtara bir ad verin (örneğin "claude-code"), oluşturun.
- Karşınıza çıkan
sk-...ile başlayan anahtarı kopyalayın — bu anahtarı bir daha tam göremeyebilirsiniz, güvenli bir yere not edin.
06 · Claude Code'a bağlama
Üç ortam değişkeni yeterli
Claude Code'un bu adrese ve anahtara bakmasını sağlamak için üç ortam değişkeni ayarlayın.
ANTHROPIC_BASE_URL = http://localhost:20128
ANTHROPIC_AUTH_TOKEN = <panelden aldigin anahtar>
ANTHROPIC_MODEL = autoBunları ayarladıktan sonra Claude Code'u yeniden başlatın. Bir uyarı görebilirsiniz: "claude.ai bağlayıcıları devre dışı" — bu normal, panel üzerinden çalıştığınız için beklenen bir mesaj, hata değil.
07 · VS Code ve diğer araçlar
Aynı mantık her araç için geçerli
Temel adres + anahtar + model adı:
- Temel adres:
http://localhost:20128/v1 - Anahtar: panelden aldığınız
sk-... - Model:
auto
Kendi başınıza ayar yapmak istemiyorsanız, panelde CLI Kodu sayfasına gidin — Claude Code, Codex, Cursor, Cline, Copilot ve Kilo için hazır ayarları doğrudan oradan kopyalayabilirsiniz.
08 · Çalışıyor mu, nasıl anlarsın
Tek komutla doğrula
Terminalden şu komutu çalıştırın (anahtarınızı kendi anahtarınızla değiştirin):
$ curl http://localhost:20128/v1/models -H "Authorization: Bearer ANAHTARIN"
# Karşına bir model listesi dönüyorsa bağlantı sorunsuz kurulmuş demektir09 · Nereye ne gidiyor, nasıl görürsün
Hangi istek nereye gitti, kaça mal oldu — gizli değil
Güçlü tarafı burada: her cevabın başlığında hangi stratejinin, hangi sağlayıcının, hangi modelin kullanıldığı ve maliyetin ne olduğu görünür.
Daha detaylı bakmak isterseniz panelde Analitik → Kullanım ekranına gidin. Orada token sayısı, istek sayısı, toplam maliyet ve en çok kullandığınız modeli görebilirsiniz.
Dürüst not: Panelde bir "sıkıştırma" (token tasarrufu) özelliği var ve açık görünse bile bizim testimizde devreye girmedi — sistem "sıkıştırma: kapalı" raporladı. Bu yüzden "şu kadar tasarruf edersiniz" diye bir söz vermiyoruz; özellik var ama ayarlarını kurcalamanız gerekebilir.
10 · Kurmadan önce bilmen gereken 3 şey
Kimsenin söylemediği üç nokta
1
Bedava olanın bedeli veridir
Ücretsiz sağlayıcılar hizmeti karşılıksız vermiyor — gönderdiğiniz metni kaydedebilir, kendi modellerini eğitmekte kullanabilir. Müşteri bilgisi, sözleşme, fiyat listesi, kişisel veri gibi şeyleri ücretsiz sağlayıcılara göndermeyin. Bunlar için ücretli ve sözleşmeli sağlayıcınızı kullanın; panel zaten hangi işin nereye gittiğini size gösteriyor, bu ayrımı rahatça kurabilirsiniz.
2
Panel sizin bilgisayarınızda kalsın
Kurulum kendi makinenizde çalışır ve trafiğiniz dışarı çıkmaz. Paneli uzak bir sunucuya taşırsanız bu değişir — o zaman anahtarlarınız ve yazdığınız her şey o sunucudan geçer. Başlangıçta kendi bilgisayarınızda tutun.
3
Şifre gerçekten ilk iş
Panel kurulumda herkeste aynı şifreyle geliyor. Değiştirmeden bıraktığınız her dakika, o makineye erişebilen herkesin tüm anahtarlarına erişebildiği bir dakikadır.
11 · Takıldığın yer olursa
En sık çıkan 4 hata, birebir denenmiş çözümüyle
"Uyumsuz Node.js Sürümü" kırmızı ekranı çıkıyor
En az Node 22.22.2 veya 24.0.0+ istiyor. Önce sürümünüzü kontrol edin.
$ node -v
# Düşükse Node'u 24 LTS sürümüne güncelle
# Mevcut Node'a dokunmak istemiyorsan taşınabilir bir Node sürümü indirip sadece bu komut için kullanabilirsinNode sürümünü değiştirince panel yine açılmıyor
Bu genelde "better-sqlite3" adlı bir bileşenin eski sürümle uyuşmamasından kaynaklanır.
$ omniroute runtime repairGiriş ekranında şifre çalışmıyor
Varsayılan şifre CHANGEME — kullanıcı adı yok, sadece bu şifreyi girin. Değiştirdiyseniz yeni şifrenizi kullanın.
Bağladığınız araç cevap vermiyor
ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN ve ANTHROPIC_MODEL değişkenlerinin doğru ayarlandığından ve aracı yeniden başlattığınızdan emin olun. Adım 08'deki curl testiyle önce panelin kendisinin çalıştığını doğrulayın.
@kaandoganai