Adaptörleri ve modelleri yönetme

Bu kılavuz, model sağlayıcılarını nasıl bağlayacağınızı ve bir ajanın neyin üzerinde çalışacağını nasıl seçeceğinizi gösterir.

Buradaki her şey tek bir sayfada yaşar: Ayarlar → Sunucu → Model sağlayıcıları. Yan alt kenar çubuğundaki girdi “Model sağlayıcıları”, sayfa başlığı ise “Adaptörler” olarak geçer.

Adaptör nedir

Adaptör, bir ajan turunu yürüten runner’dır. İki tanedir ve liste sabittir — üçüncüsünü ekleyemezsiniz.

Adaptör	CLI	Aktarım
Control Center (built-in)	yok	Süreç içi ajan döngüsü, sağlayıcılarla HTTP üzerinden konuşur
Claude Code	claude	claude -p --output-format stream-json

Cursor, Codex, Anthropic, OpenAI ve geri kalanı, yerleşik adaptör üzerinde sağlayıcıdır, ayrı CLI’ler değildir. Ekleyebileceğiniz şey ise başka bir sağlayıcıdır — OpenAI ya da Anthropic uyumlu herhangi bir uç nokta. Sıradaki bölüm de budur.

Algılama, makinenizi değil sunucuyu yoklar

Algılanan runner’lar kartı, cc_server’ın sunucu ana makinesinin PATH’inde ne bulduğunu listeler. İnce ya da web istemcide bu, baktığınız makineden farklı bir makinedir. CLI’yi cc_server’ı çalıştıran makineye kurun.

Model sağlayıcısı bağlama

Yerleşik adaptörün çalışabilmesi için en az bir bağlı sağlayıcı gerekir. Katalogda on dört tane bulunur.

1. Ayarlar → Sunucu → Model sağlayıcıları bölümüne gidin
2. Sağlayıcılar ve modeller bölümüne kaydırın
3. Sağlayıcınızı bulun ve bağlayın:

Sağlayıcı	Nasıl bağlanılır
Anthropic	API anahtarı. Claude Pro/Max aboneliği bir Anthropic API oturumu değildir — o plan için Claude Code adaptörünü kullanın
OpenAI, Codex, Cursor	Tarayıcıdan OAuth oturumu ya da bir API anahtarı. Codex, Codex Responses arka ucu üzerinden ChatGPT Plus/Pro’dur, bir CLI başlatması değildir
Kimi Code	Yalnızca tarayıcıdan OAuth — bir cihaz kodu akışı. Sabit ücretli bir plandır, dolayısıyla token başına fiyatı yoktur
OpenRouter, Google Gemini, DeepSeek, Mistral, xAI, z.ai, z.ai GLM Coding Plan, Moonshot (Kimi API)	API anahtarı

Kontrol noktası: satırın rozeti bağlı durumuna geçer ve satırı genişlettiğinizde o sağlayıcının sunduğu modeller listelenir; her biri milyon token başına fiyatı ve bağlam penceresiyle birlikte.

OAuth token’ları sunucunun kendi kimlik bilgisi deposuna düşer ve süreleri dolmadan önce yenilenir. Sağlayıcı kimlik bilgileri ana makine genelindedir — tek bir çalışma alanına kapsanmak yerine kurulumdaki her çalışma alanı tarafından paylaşılır.

Özel sağlayıcı ekleme

Bunu Ollama, LM Studio, vLLM veya özel bir dağıtım için kullanın.

1. Sağlayıcılar ve modeller içinde, Özel sağlayıcılar altında Sağlayıcı ekle’ye basın
2. Bir Ad girin, API türünü seçin (OpenAI uyumlu ya da Anthropic uyumlu) ve Temel URL’yi verin (örneğin http://localhost:11434/v1)
3. Uç nokta gerektiriyorsa bir API anahtarı ekleyin, ardından Sağlayıcı ekle’ye basın

Özel bir sağlayıcı aynı listede görünür ve yerleşik kardeşlerinde olmayan bir silme düğmesine sahiptir.

Bir ajan için model seçme

1. Ayarlar → Çalışma alanı → Ajanlar bölümüne gidin ve ajanı seçin
2. Ayarlar sekmesinde adaptörü seçin
3. Yanındaki açılır listeden modeli seçin

Yerleşik adaptör için açılır liste, bağlı her sağlayıcının kendi kataloğundan canlı olarak derlenir. Kayıtlı kimlik bilgisi olmayan bir sağlayıcı sıfır model katkısı yapar; bu yüzden boş bir açılır liste neredeyse her zaman “henüz hiçbir şey bağlı değil” anlamına gelir, “kullanılabilir bir şey yok” değil.

models.dev bir zenginleştirmedir, asla bir kimlik kaynağı değildir

Paketle gelen models.dev kataloğu, canlı listede zaten bulunan bir model için fiyat ve bağlam penceresi sağlar. Asla bir model kimliği eklemez. Beklediğiniz bir model eksikse, sağlayıcının uç noktası onu döndürmüyordur.

Yerleşik adaptördeki model kimlikleri provider/model biçiminde nitelenir ve | ile ayrılmış bir yedek zinciri taşıyabilir. Bir yedeğe düşüldüğünde maliyet, istediğiniz model üzerinden değil turu gerçekte sunan model üzerinden fiyatlandırılır.

Adaptörü olmayan bir ajan yerleşik döngüde çalışır

Her çalışma alanı, bir CEO ile qa, architect, engineer ve librarian’dan oluşan beş ajanı adaptörsüz ve modelsiz olarak başlatır. Gönderim, bu sayfadaki ve gönderim yolunun hiçbir zaman okumadığı bir istemci tercihi olan Varsayılan runner’lar ayarına değil, Control Center (built-in) seçeneğine geri düşer. Çalıştırma günlüğü bu çalıştırmalar için cc-harness kaydeder; böylece transkript gerçekte neyin çalıştığını adlandırır.

Model de yoksa, yerleşik döngü Anthropic’ten varsayılan modelini ister. Tamamen ayarsız bırakılan bir ajan, bu nedenle bir Anthropic hesabı bağladıysanız çalışır; aksi halde No credential for provider "anthropic" hatasıyla başarısız olur.

İlk kurulumun adaptör adımını tamamlamak, kendisinde hâlâ adaptör ya da model eksik olan her ajanı — o anda var olan her çalışma alanındaki CEO ve uzmanlar dahil — seçtiğiniz ikiliyle geriye dönük olarak yamalar. Daha sonra oluşturulan çalışma alanları yine de beş ajanı da ayarsız olarak başlatır. Kullanmayı düşündüğünüz her ajan için adaptörü ve modeli açıkça ayarlayın.

Bir runner CLI’si kurma

Yerleşik adaptör kurulum gerektirmez. Claude Code için, CLI’sini o aracın kendi paket yöneticisiyle sunucu ana makinesine kurun, örneğin:

npm install -g @anthropic-ai/claude-code

Ardından sayfanın üst kısmındaki Yenile’ye basın. Algılanan her satır, çözümlenen sürümü ve yolu, ayrıca JSON modunu ve model seçimini destekleyip desteklemediğine dair çipleri gösterir.

Harici bir CLI, kimlik bilgilerini kendi yapılandırmasında, sunucu ana makinesinde tutar. Control Center bunları yönetmez.

Adaptör argümanları ve ortam değişkenleri bu cihazda kalır

Her adaptör satırı bir Ek argümanlar alanı ve bir Ortam değişkenleri iletişim kutusu sunar. Bu değerler cihazınızda saklanır. Sunucu, başlatma argv’sini ve env’sini kendi ayar deposundan okur. Sağlayıcı anahtarlarını bu iki alana değil, sunucuya (OAuth ya da Model sağlayıcıları sayfasındaki anahtar alanı) koyun.

Bir çalışma alanının hangi sağlayıcıları kullanabileceğini kısıtlama

Sağlayıcı yönetişimi çalışma alanı başına geçerlidir ve son eşleşen kazanır kuralıyla değerlendirilir.

1. Sağlayıcılar ve modeller içinde, bir sağlayıcı satırındaki İzin ver anahtarını kapatın

Bu, etkin çalışma alanında o sağlayıcı için bir deny ifadesi yazar ve modelleri o çalışma alanının kataloğundan düşer. Anahtarı yeniden açmak ifadeyi kaldırır.

Sorun giderme

Bir runner bulunamadı olarak görünüyor

• CLI’nin yalnızca sizinkinde değil, sunucu ana makinesinin PATH’inde olduğunu kontrol edin
• Arayüzle başlatılan bir masaüstü uygulaması, sunucusunu asgari bir PATH ile başlatır; yalnızca kabuk yolunda kurulu bir CLI onun için görünmez olabilir
• Kurduktan sonra Yenile’ye basın

Model açılır listesi boş

• Adaptör yerleşik olandır ve hiçbir sağlayıcı bağlı değildir — Sağlayıcılar ve modeller içinden birini bağlayın
• Ya da sağlayıcı bağlıdır ama bu çalışma alanının yönetişim anahtarı tarafından reddedilmiştir

Bir model çalışıyor ama fiyatı bilinmiyor olarak görünüyor

Canlı model listesi kimliği taşır; fiyat ve bağlam models.dev’den gelir. Yepyeni bir modelin ya da özel bir sağlayıcıdan gelen bir modelin henüz bir katalog girdisi yoktur.

İlgili kılavuzlar

• Ajan oluşturma ve yapılandırma
• API anahtarlarını yönetme
• Bir ajanı tanılamak
• Maliyetleri yönetme

İlgili kavramlar

• Ajan modeli
• Ajan gönderim yaşam döngüsü