AI Kodlama Araçlarını Tek Tıkla Devralma
Tek Tıkla Devralma (Takeover), herhangi bir yapılandırma dosyasını elle düzenlemeden, sık kullandığınız AI kodlama CLI araçlarını yerel AI Ağ Geçidi'ne yönlendirmenizi sağlar. Devralma sonrasında bu araçlardan gelen istekler http://127.0.0.1:11580 üzerinden ağ geçidinde yapılandırdığınız sağlayıcı kanallarına yönlendirilir ve birleşik kullanım ile maliyet istatistiklerine dahil edilir.
Nasıl Çalışır?
Her araç için tek tıkla devralma işlemi yürütüldüğünde ağ geçidi sırasıyla şunları yapar:
- Ağ geçidinin sağlık durumunu kontrol eder ve proxy uç noktasının kullanılabilir olduğunu doğrular.
- Otomatik olarak özel bir sanal anahtar oluşturur (ağ geçidi bunu araç yapılandırmasına yazar; düz metin Anahtarlar sayfasından dilediğiniz zaman alınabilir).
- Mevcut yapılandırma dosyasını yedekler
.bakuzantılı olarak (örn.~/.claude/settings.json.bak). - Ağ geçidine işaret eden yapılandırmayı hassasiyetle yazar / derin birleştirir ve diğer ayarlarınıza dokunmaz.
- Arayüz durumunu yeniler ve mevcut devralma durumunu gösterir.
Devralmayı durdurduğunuzda da işlem "hassas kaldırma" şeklindedir: yalnızca yapılandırma gerçekten bu ağ geçidine işaret ediyorsa ilgili anahtarlar kaldırılır; böylece elle ayarladığınız diğer seçeneklerin yanlışlıkla silinmesi önlenir. Ayrıca devralma sırasında otomatik oluşturulan sanal anahtar iptal edilir.
Devralma Durumu
Her araç AI Ağ Geçidi → Erişim Yönetimi → İstemciler sayfasında dört durumdan birini gösterir:
| Durum | Anlamı |
|---|---|
| Devralındı (bu ağ geçidi) | Araç yerel AI Ağ Geçidi'ne yönlendirildi |
| Bağlı (başka adres) | Araç başka bir adresle yapılandırılmış (elle yapılandırdınız veya başka bir ağ geçidini işaret ediyor); ağ geçidi bunu izinsiz geçersiz kılmaz |
| Devralınmadı | Araç algılandı ancak henüz ağ geçidine yönlendirilmedi |
| Algılanmadı | Bu makinede aracın yapılandırma dizini bulunamadı |
Ön Koşullar
- ServBay hesabına giriş yapılmış olmalı ve Kanallar sayfasında en az bir kullanılabilir kanal yapılandırılmış olmalıdır.
- Hedef AI aracı bu makinede kurulu olmalıdır (ağ geçidi, varlığını yapılandırma dizinine göre belirler).
Tek Tıkla Devralma İşlemi
AI Ağ Geçidi → Erişim Yönetimi → İstemciler sayfasına gidin, araç listesinde hedef aracı bulun ve Tek Tıkla Devral seçeneğine tıklayın. Devralma başarılı olduğunda durum Devralındı (bu ağ geçidi) olarak değişir. Geri almak isterseniz Devralmayı Durdur seçeneğine tıklamanız yeterlidir.
Araçlara Göre Devralma Ayrıntıları
Aşağıdaki tablo, her aracın devralınması sırasında gerçekte değiştirilen yapılandırma dosyalarını ve içeriklerini listeler; böylece durumu anlayabilir ve sorun giderebilirsiniz:
| Araç | Yapılandırma Dosyası | Yazılan İçerik | Ağ Geçidi Adresi |
|---|---|---|---|
| Claude Code | ~/.claude/settings.json | env.ANTHROPIC_BASE_URL + env.ANTHROPIC_AUTH_TOKEN | http://127.0.0.1:11580 (/v1 olmadan) |
| Codex | ~/.codex/config.toml | [model_providers.servbay] bölümü + üst düzey model_provider = "servbay" | http://127.0.0.1:11580/v1 |
| Qwen Code | ~/.qwen/.env | OPENAI_BASE_URL + OPENAI_API_KEY (OpenAI uyumlu) | http://127.0.0.1:11580/v1 |
| Kimi CLI | ~/.kimi/config.toml | [model_providers.servbay] bölümü + model tanımı | http://127.0.0.1:11580/v1 |
| CodeBuddy | ~/.codebuddy/models.json | servbay model düğümünü derin birleştirir | http://127.0.0.1:11580/v1 |
| opencode | ~/.config/opencode/opencode.json | provider.servbay düğümünü derin birleştirir (tüm kanalların modellerini toplar) | http://127.0.0.1:11580/v1 |
| Crush | ~/.config/crush/crush.json | providers.servbay düğümünü derin birleştirir | http://127.0.0.1:11580/v1 |
Claude Code'un adresi neden /v1 içermiyor?
Claude Code, Anthropic protokolünü kullanır; ağ geçidi /v1/messages gibi yolları kendisi birleştirir. Bu nedenle ANTHROPIC_BASE_URL ağ geçidinin kök adresi olmalıdır (/v1 olmadan). Diğer çoğu araç OpenAI uyumlu protokolü kullanır ve /v1 son ekini gerektirir. Tek Tıkla Devralma, her aracın sözleşmesine göre otomatik olarak doldurur; elle ayrım yapmanıza gerek yoktur.
Geri Yükleme ve Sorun Giderme
- Orijinal yapılandırmayı geri yükleme — Kaldır seçeneğine tıklayın; ağ geçidi bu ağ geçidine işaret eden yapılandırmayı hassasiyetle kaldırır. Dilerseniz aynı dizindeki
.bakyedek dosyasını kullanarak da elle geri yükleyebilirsiniz. - Durum "Bağlı (başka adres)" görünüyor — Bu, aracın şu anda başka bir adrese işaret ettiği anlamına gelir (elle yapılandırdınız veya başka bir ağ geçidini işaret ediyor). Ayarlarınızın üzerine yazmamak için ağ geçidi otomatik devralma yapmaz; önce bu yapılandırmayı elle temizleyip ardından devralabilirsiniz.
- Devralma sonrasında araç hâlâ hata veriyor — Ağ geçidi proxy hizmetinin çalıştığından, ilgili kanalın sağlıklı olduğundan ve sanal anahtarın iptal edilmediğinden emin olun; ayrıca İstatistikler ve İzleme sayfasından isteklerin ağ geçidine ulaşıp ulaşmadığını kontrol edebilirsiniz.
Sık Sorulan Sorular (SSS)
- S: Tek Tıkla Devralma mevcut araç yapılandırmamı bozar mı?
- C: Hayır. Ağ geçidi yalnızca ağ geçidiyle ilgili anahtarları hassasiyetle yazar / birleştirir ve yazmadan önce orijinal dosyayı
.bakolarak yedekler. Diğer ayarlar değişmeden kalır.
- C: Hayır. Ağ geçidi yalnızca ağ geçidiyle ilgili anahtarları hassasiyetle yazar / birleştirir ve yazmadan önce orijinal dosyayı
- S: Devralma sonrasında elle geri alabilir miyim?
- C: Evet. Kaldır seçeneğine tıklayarak ağ geçidinin geri almasını sağlayabilir veya
.bakyedeğini kullanarak elle geri yükleyebilirsiniz.
- C: Evet. Kaldır seçeneğine tıklayarak ağ geçidinin geri almasını sağlayabilir veya
- S: Devralma için kullanılan sanal anahtar nerede?
- C: Ağ geçidi, devralınan her araç için özel bir sanal anahtar otomatik oluşturur; bunları Anahtarlar sayfasından görüntüleyip yönetebilirsiniz.
- S: Listede araç "Algılanmadı" olarak mı görünüyor?
- C: Bu, bu makinede aracın yapılandırma dizininin bulunamadığı anlamına gelir. Lütfen önce aracı kurup bir kez çalıştırın; yapılandırma dizini oluştuktan sonra devralma işlemini yapın.
Özet
Tek Tıkla Devralma, "her aracın yapılandırma dosyasını elle düzenleme" gibi zahmetli ve hataya açık bir işi tek bir tıklamaya indirger: anahtarı otomatik oluşturur, otomatik yedekler, hassasiyetle yazar ve dilediğiniz zaman geri yükler. Birleşik kanallar ve kullanım istatistikleriyle birlikte, elinizdeki tüm AI kodlama araçlarının aynı sağlayıcı yapılandırmasını ve maliyet görünümünü paylaşmasını sağlayabilirsiniz. Kendi kodunuzdan ağ geçidini çağırmak isterseniz, Uç Noktalar ve Ortam Değişkenleri bölümüne bakın.
