AI Programlama Araçlarında Tek Tıkla Devralma

Tek tıkla devralma (Takeover) özelliğiyle, hiçbir yapılandırma dosyasını elle değiştirmenize gerek kalmadan popüler AI programlama CLI araçlarını doğrudan yerel AI ağ geçidiniz üzerinden çalıştırabilirsiniz. Devralma işlemi sonrası, bu araçlardan gelen talepler http://127.0.0.1:11580 adresi üzerinden yönlendirilerek, ağ geçidi üzerinde belirlediğiniz sağlayıcılara aktarılır ve kullanım ile maliyet istatistiklerine dahil edilir.

Çalışma Prensibi

Her bir araç için tek tıkla devralma işlemi gerçekleştirdiğinizde, ağ geçidi otomatik olarak şu adımları uygular:

1. Ağ geçidi sağlık kontrolü yapılır ve proxy uç noktası kullanılabilir mi doğrulanır.
2. Özel bir sanal anahtar otomatik olarak oluşturulur (şifrelenmemiş anahtar yalnızca ilk oluşturulduğunda gösterilir ve ağ geçidi araç yapılandırmasına ekler).
3. Orijinal yapılandırma dosyası yedeklenir ve dosya adına .bak uzantısı eklenir (örneğin, ~/.claude/settings.json.bak).
4. Ağ geçidini işaret eden ayarlar hassas şekilde eklenir/derin birleştirilir, mevcut diğer ayarlarınız korunur.
5. Arayüz durumu güncellenir ve güncel devralma durumu gösterilir.

Devralmayı kaldırmak istediğinizde de aynı titizlikle işlem yapılır: Yalnızca yapılandırmada gerçekten ağ geçidi adresi varsa ilgili ayar kaldırılır; diğer özel ayarlarınız asla yanlışlıkla silinmez.

Devralma Durumları

Her bir aracın durumu, AI Ağ Geçidi → Uç Noktalar (Endpoints) sayfasında dört farklı şekilde gösterilir:

Durum	Anlamı
Devralındı (Bu Ağ Geçidi)	Araç, yerel AI ağ geçidine yönlendirilmiştir.
Bağlandı (Başka Adres)	Araç farklı bir adrese yönlendirilmiş (manuel yapılandırdınız ya da başka bir ağ geçidine bağlı), ağ geçidi otomatik olarak üzerine yazmaz.
Devralınmadı	Araç tespit edildi ama henüz ağ geçidine yönlendirilmemiş.
Tespit Edilmedi	Aracın yapılandırma dizini yerel makinede bulunamadı.

Ön Koşullar

• ServBay hesabınızda oturum açmış olmalısınız ve Kanallar sayfasından en az bir kullanılabilir kanal eklemiş olmalısınız.
• Hedef AI aracı bilgisayarınıza kurulu ve yapılandırma klasörü mevcut olmalı (ağ geçidi bunun üzerinden aracı tespit eder).

Tek Tıkla Devralma İşlemi

AI Ağ Geçidi → Uç Noktalar (Endpoints) sayfasına gidin, listeden ilgili aracı bulun, ardından Tek Tıkla Devral seçeneğine tıklayın. Devralma başarıyla tamamlandıktan sonra aracın durumu "Devralındı (Bu Ağ Geçidi)" olarak değişecektir. Devralmayı kaldırmak isterseniz, Kaldır / Geri Yükle butonuna tıklamanız yeterli.

Araçlarda Yapılan Değişiklikler

Aşağıdaki tablo, her bir araç devralındığında hangi yapılandırma dosyasının ve içeriğin değişeceğini özetlemektedir. Bu sayede yapılan işlemleri kolayca anlayabilir ve gerekirse sorunları tespit edebilirsiniz:

Araç	Yapılandırma Dosyası	Eklenen İç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 uzantısı YOK)
Codex	~/.codex/config.toml	[model_providers.servbay] bölümü + üst seviye model_provider = "servbay"	http://127.0.0.1:11580/v1
Gemini CLI	~/.gemini/.env	GOOGLE_GEMINI_BASE_URL + GEMINI_API_KEY iki ayrı satır	http://127.0.0.1:11580
Qwen Code	~/.qwen/.env	OPENAI_BASE_URL + OPENAI_API_KEY (OpenAI ile 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 modeli için derin birleştirme	http://127.0.0.1:11580/v1
opencode	~/.config/opencode/opencode.json	provider.servbay bölümü derin birleştirilir (kanal bazlı modeller eklenir)	http://127.0.0.1:11580/v1
Crush	~/.config/crush/crush.json	providers.servbay bölümü derin birleştirilir	http://127.0.0.1:11580/v1

Claude Code adresinde neden /v1 bulunmuyor

Claude Code, Anthropic protokolünü kullanır ve ağ geçidi /v1/messages gibi yolları kendisi ekler; bu nedenle ANTHROPIC_BASE_URL doğrudan ağ geçidinin kök adresi olmalıdır (yani /v1 olmadan). Diğer çoğu araç OpenAI ile uyumlu olduğu için /v1 uzantısı gerekir. Tek tıkla devralma, her araca uygun biçimde adresleri otomatik ayarlar; sizin elle değiştirmenize gerek yoktur.

Geri Yükleme ve Sorun Giderme

• Orijinal yapılandırmayı geri yükleme — "Kaldır" seçeneğine tıklayarak ağ geçidi tarafından eklenen ayarlar tam olarak silinir. Dilerseniz aynı klasördeki .bak yedeğini de kendiniz yükleyebilirsiniz.
• Durum "Bağlandı (Başka Adres)" gösteriyor — Bu, aracın şu anda farklı bir adrese yönlenmiş olduğu anlamına gelir (manuel ayarladınız veya başka bir ağ geçidine bağlı). Mevcut ayarlarınızı korumak için ağ geçidi üzerine yazmaz; önce yapılandırmayı temizleyip yeniden devralabilirsiniz.
• Devralma sonrası araç hata veriyor — Ağ geçidi hizmetinin çalıştığından, ilgili kanalın sağlıklı olduğundan, sanal anahtarın iptal edilmemiş olduğundan ve İstatistikler ve İzleme sayfasında isteklerin ağ geçidine ulaşıp ulaşmadığından emin olun.

Sıkça Sorulan Sorular (SSS)

• S: Tek tıkla devralma, mevcut araç ayarlarımı bozar mı?
  • C: Hayır, bozmaz. Ağ geçidi yalnızca kendi ilgili satırlarını ekler/derin birleştirir ve işlem öncesinde orijinal dosyayı .bak ile yedekler. Diğer ayarlarınız korunur.
• S: Devralma sonrası elle eski haline getirebilir miyim?
  • C: Elbette! "Kaldır" seçeneğiyle ağ geçidi değişiklikleri geri alır veya .bak yedeğini elle yükleyebilirsiniz.
• S: Devralmada kullanılan sanal anahtar nerede yer alır?
  • C: Her devralınan araç için ayrı sanal anahtar otomatik oluşturulur; Anahtarlar sayfasından görüntüleyip yönetebilirsiniz.
• S: Listede "Tespit Edilmedi" gösteriyorsa ne yapmalıyım?
  • C: Bu, aracın yapılandırma klasörünün bulunamadığı anlamına gelir. Lütfen ilgili aracı kurup bir kez çalıştırarak yapılandırma dizininin oluştuğundan emin olun, ardından devralmayı deneyin.

Özet

Tek tıkla devralma, geleneksel olarak karmaşık ve hata yapmaya açık olan "her araç için elle yapılandırma dosyası değiştirme" işini tek tıkla kolaylaştırır: Otomatik anahtar oluşturma, otomatik yedekleme, hassas ve güvenli ekleme, anında geri yükleme. Bütün araçların kullanım ve harcama raporlarını tek bir çatıya toplayabilir, hepsi için ortak sağlayıcı yapılandırmaları kullanabilirsiniz. Kendi kodunuzda ağ geçidini kullanmak istiyorsanız Uç Noktalar ve Ortam Değişkenleri bölümüne bakabilirsiniz.