DokümantasyonBaşlarken
Sağlayıcılar
Agentbits'in desteklediği beş yapay zeka sağlayıcısı, her biriyle ajanların neler yapabildiği, kurulumları ve sağlayıcı ile modellerin karıştırılması.
Sağlayıcı, bir ajanın neyle düşündüğüdür: bilgisayarındaki resmi bir CLI, bir model API’si ya da ücretsiz Demo. Ajanın neler yapabileceğini sağlayıcı belirler. Claude Code ajanı proje klasöründeki dosyaları düzenleyebilir; API ajanı ise yalnızca metinle ve Agentbits’in kendi araçlarıyla çalışır. Bir varsayılan sağlayıcı seçersin, istediğin ajana farklı bir sağlayıcı verebilirsin.
Hangi sağlayıcı ne yapabilir?
| Claude Code CLI | Codex CLI | Anthropic API | OpenAI API | Demo | |
|---|---|---|---|---|---|
| Gerekenler | Kurulu ve giriş yapılmış Claude Code | Kurulu ve giriş yapılmış Codex CLI | Anthropic API anahtarı | OpenAI API anahtarı | Hiçbir şey |
| Proje klasörü | Zorunlu | Zorunlu | İsteğe bağlı | İsteğe bağlı | İsteğe bağlı |
| Proje klasöründe dosya okuma ve düzenleme | Evet | Evet, kendi sandbox’ında | Hayır | Hayır | Taklit |
| Komut çalıştırma | Evet | Evet, kendi sandbox’ında | Hayır | Hayır | Taklit |
| Web erişimi | Evet | Evet | Hayır | Hayır | Hayır |
| Bağlantılar (SSH, veritabanları) | Evet | Henüz yok | Evet | Evet | Evet |
| Eklenen dosyalar | Evet | Yalnızca prompt içinde | Evet | Evet | Evet |
| Görseller | Evet | Evet | Evet, taranmış PDF’ler de | Evet (PDF yerel gönderilmez) | Hayır |
| Skill’ler ve uygulamalar (MCP) | Evet | Evet | Evet | Evet | Evet |
| Token kullanımı | Tam, $ maliyetiyle | Yalnızca toplam | Tam, $ maliyeti yok | Tam, $ maliyeti yok | Tahmini |
Tablodaki her şey yine ajanın izinlerine bağlıdır. Örneğin bir Claude Code ajanı dosyaları yalnızca Dosya yazma açıkken düzenler, komutları yalnızca Terminal açıkken çalıştırır, web’e yalnızca Ağ açıkken çıkar. Onay iste her sağlayıcıda çalışır.
Claude Code CLI
Agentbits resmi claude CLI’ını arka planda çalıştırır. Dosya ve terminal araçları izin matrisine göre açılır.
-
Bilgisayarına Claude Code kur.
-
Bir terminalde bir kez giriş yap. Bunu Agentbits içinde Terminal → Kabuklar’dan da yapabilirsin:
claude auth login -
Agentbits’te Ayarlar → Sağlayıcılar → Sağlayıcı ekle’yi aç ve Claude Code CLI’ı seç.
claudebulunduysa formda ● kurulu görünür. PATH’ten bulunması için CLI yolu alanını boş bırak ya da tam yolu yaz. -
Bir Model seç ve Kaydet ve test et’e tıkla. Test, CLI sürümünü ve giriş yapıp yapmadığını kontrol eder.
Notlar:
- Projenin bir klasörü olmalı. Ajanlar orada başlar; klasörün (ve izin verilen ek klasörlerin) dışındaki dosya düzenlemeleri reddedilir.
- Agentbits, Claude Code’u projendeki
.claudeayarlarını, hook’ları ve.mcp.json’u yok sayarak başlatır; böylece bir depo ajanın nasıl çalışacağını değiştiremez. - Listedeki modellerin yanında
sonnetya daopusgibi takma adlar da kullanabilirsin. Takma ad her zaman o ailenin hesabındaki en yeni modelini kullanır.
Codex CLI
Agentbits OpenAI’nin codex exec komutunu sandbox moduyla çalıştırır.
-
Codex CLI’ı kur.
-
Bir terminalde bir kez giriş yap:
codex login -
Ayarlar → Sağlayıcılar → Sağlayıcı ekle’de Codex CLI’ı seç, bulunduğunu kontrol et, bir model seç ve Kaydet ve test et’e tıkla.
Notlar:
- Codex komutlarını her zaman kendi sandbox’ında çalıştırır. Yalnızca proje klasörünün içine yazar; ağa yalnızca ajanın Ağ izni varsa çıkar.
- Codex ajanı Dosya okuma iznine ihtiyaç duyar; bu izin kapalıysa ajan çalışmaz.
- Codex ajanları henüz bağlantıları kullanamaz. Eklenen dosyalar sığdığı kadarıyla prompt’a girer, görseller CLI’a iletilir. Ek izinli klasörler desteklenmez.
- Codex yalnızca toplam token sayısını bildirir; maliyet ya da giriş/çıkış ayrımı yoktur.
Not: Codex entegrasyonunun bazı parçaları (uygulamalar ve görseller) şimdiye kadar yalnızca taklit bir CLI ile test edildi. Bir şey çalışmazsa lütfen bildir.
Anthropic API ve OpenAI API
Bu iki sağlayıcı modeli senin API anahtarınla doğrudan çağırır: Anthropic Messages API ya da OpenAI Chat Completions API.
- Anthropic’ten ya da OpenAI’den bir API anahtarı al.
- Ayarlar → Sağlayıcılar → Sağlayıcı ekle’de sağlayıcıyı seç, API anahtarı’nı yapıştır, bir Model seç ve Kaydet ve test et’e tıkla.
Anahtar işletim sisteminin anahtar zinciriyle şifrelenip yerelde saklanır. Arayüze, ajanlara ya da loglara asla geri gönderilmez. Anahtarı değiştirmek için sağlayıcıyı silip yeniden ekle.
API ajanlarının dosya sistemine ve terminale erişimi yoktur. Proje klasöründeki dosyaları değiştiremez, komut çalıştıramazlar. Metinle ve Agentbits’in kendi araçlarıyla çalışırlar: kullanmalarına izin verilen bağlantılar, kendileriyle paylaşılan dosyalar, yeni metin dosyası kaydetme, skill’ler ve uygulamalar. Kod değişikliği için bir CLI sağlayıcısı kullan.
Anahtarı girdiğinde model listesinde Hesabındaki diğer modeller de görünür. OpenAI’nin GPT-6 modelleri listede yoktur, çünkü Chat Completions üzerinden araç kullanamıyorlar. Onları Codex CLI ile kullanabilirsin.
Demo (simülasyon)
Demo anahtar istemez ve hiçbir modeli çağırmaz. Ajanlar gerçekten çalışıyormuş gibi davranır: lider isteğini görevlere böler, ajanlar “araç kullanır”, rapor yazar ve incelemeye gönderir. Dosyalarına hiç dokunmaz. Görev veri ya da sunucularla ilgiliyse Demo bağlantıların üzerinden gerçek ama zararsız çağrılar yapar; böylece izinleri, onayları ve denetim kaydını iş başında görürsün.
Demo’yu uygulamayı öğrenmek ve şablonları denemek için kullan; gerçek iş yapmaz. Hiç sağlayıcı ayarlamadıysan ajanlar demo modunda çalışır.
Sağlayıcıları ve modelleri karıştır
Varsayılan sağlayıcı, kendine özel sağlayıcısı olmayan tüm ajanlar için kullanılır. Değiştirmek için Ayarlar → Sağlayıcılar’da bir sağlayıcının yanındaki Varsayılan yap’a tıkla.
Bir ajana farklı bir sağlayıcı ya da model vermek için:
- Organizasyon → Ajanlar’ı aç ve ajanı seç.
- Model bölümünde bir Sağlayıcı ve bir Model seç.
Sağlayıcının modeli, sağlayıcıda hangi model ayarlıysa onu kullanır. Ajanı başka türde bir sağlayıcıya geçirirsen modeli sıfırlanır. Modeller listeden seçilir. Listede henüz olmayan bir model için Özel model adı…’nı seç ve tam adını yaz.
Örneğin Claude Code CLI kullanan geliştiriciler proje klasöründe çalışırken bir API ajanı araştırma yazısı hazırlayabilir ya da eklenen belgeleri analiz edebilir.
Oturum süresi dolarsa
Bir CLI oturumunun süresi dolarsa ya da bir anahtar çalışmayı bırakırsa Agentbits projenin #general kanalına bir mesaj yazar, ajanı hatalı olarak işaretler ve tüm ekibi duraklatır. Yeniden giriş yap (claude auth login ya da codex login) veya anahtarı yenile, sağlayıcıyı Ayarlar → Sağlayıcılar’da test et, sonra üst çubuktaki Devam et’e tıkla.
Desteklenmeyenler
- Agentbits CLI’ları içermez, kurmaz ve onlarda oturum açmaz. Onları sen kurar, girişini sen yaparsın.
- Uygulama içinde Claude hesabı ya da aboneliğiyle giriş yapamazsın. API anahtarı ya da kendi Claude Code girişini kullan.
- Gemini, yerel modeller ve diğer sağlayıcılar henüz yok; planlı.
- Görev ya da proje başına harcama sınırı yok. Token kullanımını Reports’tan takip et.
Yanlış ya da eksik bir şey mi buldun? GitHub'da bildir