Ana içeriğe geç

Kurulu Kodlama Ajanını Sohbet Modeli Olarak Kullanma

Ücretini ödediğiniz kodlama ajanı Libre WebUI bilgisayarında oturum açmışsa ayrı API anahtarı eklemek yerine normal sohbetten konuşabilirsiniz. Libre WebUI ajan komut satırını algılar ve model seçicide gösterir.

Algılananlar​

Her model listesi isteğinde Libre WebUI sunucu PATH değerinde şunları arar:

ModelKomutSağlayan
Claude CodeclaudeAnthropic
CodexcodexOpenAI
Kirokiro-cliAWS
OpenCodeopencodeSST
PipiMario Zechner

Bulunanlar model seçicide Agents grubunda görünür. Hiçbir şey kurulmaz ve yapılandırma dosyası gerekmez; komut sunucu kabuğunda çalışıyorsa görünür.

Ayarlar → Sohbet → Varsayılanlar bu girdileri Ajan olarak tanımlar; hesabınızın kullanmasına izin verildiğinde Strands de dahildir. Eklenti modelleri sağlayıcı adını korur; Ollama etiketini yalnızca Ollama modelleri alır. Ollama’yı kapatmak diğer ajan ve eklentileri gizlemez. Bilgi kartı ad ve sağlayıcıyı, boyut/aile/biçimi ise yalnızca katalog sağlıyorsa gösterir.

Yalnız CLI Değil, Model Seçme​

Her CLI Agents grubunda birden çok giriş sunabilir:

  • Claude Code oturum varsayılanı ile Sonnet, Opus ve Haiku’yu sunar. Ayrıca açık Sonnet 5.5 (claude-sonnet-5-5), Opus 5.5 (claude-opus-5-5) ve Haiku 5.5 (claude-haiku-5-5) seçenekleri sunulur. Sonnet 5.5 için Claude Code 2.1.284 veya daha yenisi, Opus 5.5 için Claude Code 2.1.280 veya daha yenisi, Haiku 5.5 için Claude Code 2.1.293 veya daha yenisi gerekir; hepsi için oturum açılan hesabın erişim yetkisi şarttır; CLI'yi güncellemek için claude update çalıştırın. Mevcut Sonnet, Opus ve Haiku takma adları, CLI'nin geçerli model eşlemesini izlemeye devam eder.
  • Codex yapılandırılmış varsayılanla belgelenmiş ChatGPT giriş ailesini sunar: GPT-6 Astra, GPT-6.1 Sol (gpt-6.1-sol), GPT-6 Sol, GPT-6 Luna, GPT-5.6 Sol, Terra, Luna, GPT-5.5, GPT-5.3 Codex Spark. Kullanılabilirlik CLI’nin oturumuna ve hesap erişimine bağlıdır.
  • Kiro, oturum açılan hesabın kullanabildiği modelleri (kiro-cli chat --list-models çıktısından) yapılandırılmış varsayılanın yanında listeler. Her tur, CLI'nin V3 ajan motorunda etkileşimsiz olarak ve yerleşik varsayılan ajan (vibe) sabitlenmiş şekilde çalışır; bu yüzden özel bir chat.defaultAgent uygulanmaz. Kiro CLI 2.27 veya daha yenisi gerekir.
  • Pi kendi CLI yapılandırmasındaki modeli çalıştırır.
  • OpenCode, kimliği doğrulanmış tüm sağlayıcıların modellerini (opencode models) listeler ve açık seçim ister; CLI varsayılanı Libre WebUI ana makinesinden erişilemeyen yerel sunucuyu gösterebilir.

Yerleşik Strands motoru da hesabınızın kullanmasına izin verildiğinde Ajanlar grubunda görünür. Bir CLI değildir: arka ucun içinde çalışır ve Ollama ile sağlayıcı eklentisi modellerinizi kullanır. Yalın Strands girişi (strands) varsayılan sohbet modelinizi kullanır. Diğer girişler (strands:<route>), örneğin Strands · gpt-5.6-sol (Codex (ChatGPT)) gibi, her kullanılabilir model için bir tane listelenir ve o konuşma için hem modeli hem de sağlayıcısını sabitler; kesinti sırasında kullanılabilir başka bir sağlayıcı onun yerini alamaz. Seçenekleri listelemek motoru başlatmaz.

Aynı Strands girişleri, otomatik başlıklar ve düşünme özetleri için Ayarlar → Sohbet → Varsayılanlar altında görev modeli olarak kullanılabilir. Geçerli çalışan modeli kullan, konuşmanın kayıtlı Strands seçimini kullanır. Bu kısa metin istekleri temeldeki sağlayıcı modeli doğrudan çağırır; ajanın araçlarını çalıştırmaz ve ajan oturumu oluşturmaz. Diğer CLI profilleri bu yardımcı istekler için Ollama, eklenti veya Strands görev modeli gerektirir.

Pi her turu durumsuz (--no-session), yerel araçlar kapalı ve tarafsız sistem istemiyle çalıştırır; yanıtlar işletim sistemi kullanıcısının kişisel Pi yapılandırmasından etkilenmez ve sohbetler ona dokunmaz.

Kiro her iki açıdan da tam tersidir: sunucu kullanıcısının Kiro yapılandırmasıyla çalışır (yerleşik varsayılan ajan sabitlenir, ancak izin kuralları (~/.kiro/settings/permissions.yaml), MCP sunucuları ve yapılandırılmış varsayılan model yine geçerlidir) ve her tur o kullanıcının Kiro oturum deposuna yeni bir oturum olarak kaydedilir (kiro-cli chat --list-sessions bunu, içindeki son sohbet dökümüyle birlikte gösterir). Bunu kapatacak bir bayrak yoktur; bu yüzden sohbet içeriği backend kullanıcısının ana dizininde, Libre WebUI veritabanının dışında da yaşar. Kiro’nun araçları açık kalır: bu izin kurallarının güvendiği her şey (varsayılan olarak okumalar ve date gibi salt okunur komutlar) sormadan çalışır; onay gerektiren her araç çağrısı ise reddedilir, çünkü bir sohbet turu istemi yanıtlayamaz.

Kullanım​

  1. Yönetici olarak oturum açın.
  2. Sohbet başlatıp model seçiciyi açın.
  3. Agents altından giriş seçin.
  4. Mesaj gönderin. Yanıtlar belirteç belirteç akar.

Konuşma diğer sohbetler gibi saklanır; dönebilir, yeniden adlandırabilir ve komut paletinden bulabilirsiniz. Her tur son konuşmanın dökümünü ajana yollar ve yanıtı aktarır.

Kim Kullanabilir ve Neye Erişebilir?​

Bu özellik yalnız yöneticiler içindir. Ajan, Work kapsayıcısında değil, ana makinede Libre WebUI arka ucuyla aynı işletim sistemi kullanıcısı olarak çalışır. Bu kullanıcının ajan kimlik bilgilerini ve normal erişimini, dosya okuma ve sunucuda komut çalıştırma dâhil, devralır.

Etkinleştirmeyi ajana makinenin shell erişimini vermek gibi değerlendirin. Bu nedenle özellik varsayılan olarak kapalıdır; yönetici Ayarlar → Kullanıcı Yönetimi → Erişim ve ilkeler → CLI ajan modelleri altında açmalıdır. Ayar kaydedilir ve yeniden başlatmadan hemen uygulanır.

Bu denetimi değiştirmek model kataloğunu hemen yeniler; Ajanlar kategorisi doğrudan CLI girdilerini, Eklenti Modelleri ise Codex (ChatGPT) gibi sağlayıcı API entegrasyonlarını içerir. Strands aynı kategoride listelenir, ancak bu anahtara değil kendi Strands motoru erişim ayarına bağlıdır; bu yüzden CLI ajan modelleri kapalıyken de görünebilir. Model keşfi, kurulu CLI ajanlarının keşfini engelleyemez.

Mevcut kurulumlar, bağımsız bir CLI ayarı kaydedilene kadar önceden kaydedilmiş Ajanlar kararını devralır.

Çalışma zamanı anahtarından bağımsız dağıtım kararı için ortam değişkenini ayarlayın (arayüz anahtarını da kilitler):

AGENT_CLI_MODELS_ENABLED=false   # or true

Dosyalarda çalışıp korumalı alanda kalan model için Work kullanın; araç destekli modeli yalıtılmış çalışma alanlı kapalı kapsayıcıda çalıştırır.

Work'te aynı ajanlar​

Work aynı ajanları aynı model seçenekleri ve aynı girişlerle sunar, ancak onları ana makinede değil görevin korumalı alanı içinde, gerçek belirteçleri korumalı alanın dışında tutan bir çıkış proxy'sinin arkasında çalıştırır. Kendi erişim modları olan Work'te ajan CLI'ları vardır ve yukarıdaki anahtara ihtiyaç duymazlar. Bkz. Work'te ajan CLI'ları.

Kullanım takibi​

Sağlayıcı Kullanımı (/usage) sayfasında üstteki Ajanlar bölümünü bulun. Claude Code, Codex, Kiro, OpenCode, Pi ve Strands etkinliği ayrı kayıtlarla gösterilir; dönemde çağrı yoksa bu açıkça belirtilir.

LWUI üzerinden CLI çağrıları sonucu, süreyi ve bildirilen tokenları kaydeder. Her çalıştırma tek olaydır; tekrar eden anlık görüntüler veya adım raporları olay ve tokenları çoğaltmaz. Eksik sayaçlar bildirilmemiş kalır. Durdurma iptal kaydeder; başarısız CLI çıkışı, kısmi metin üretmiş olsa da başarı sayılmaz. LWUI dışı çağrılar alınmaz.

Strands çağrıları Strands ajanına atanır. Ayrıntı ve sınırlar için Ajan kullanımı bölümüne bakın.

Yapılandırma​

DeğişkenVarsayılanAmaç
AGENT_CLI_MODELS_ENABLEDayarlanmamışÖzelliği true/false değerine sabitler; yoksa yönetici anahtarına bağlıdır (varsayılan kapalı)
AGENT_CLI_TIMEOUT_MS600000Tek ajan turunun sonlandırılmadan önceki süresi

Sorun Giderme​

Ajanlar grubu görünmüyor. Ayarlar → Kullanıcı Yönetimi → Erişim ve ilkeler → CLI ajan modelleri seçeneğinin açık olduğunu (varsayılan kapalı) ve yönetici girişi yaptığınızı doğrulayın. Komut yalnızca etkileşimli shell’de değil backend sürecinin PATH değerinde olmalıdır. Servis yöneticisi, Docker veya desktop başlatıcısı genellikle daha dar PATH kullanır.

Yanıt hemen başarısız. Aynı komutu sunucu kullanıcısı olarak çalıştırın (claude -p "hello", codex exec "hello" veya echo hello | kiro-cli chat --no-interactive --output-format stream-json --agent-engine v3 --agent vibe). Kiro CLI 2.27 veya daha yenisi gerekir; daha eski bir CLI önce burada, hatası görünür şekilde başarısız olur; sohbette aynı hata yalnızca Kiro exited unsuccessfully olarak görünür. Genellikle ajan girişi süresi dolmuş ya da abonelik sınırına ulaşılmıştır. OpenCode süresi dolan sağlayıcı girişini yalnız günlüklerinde bildirir; sunucu kullanıcısı olarak opencode auth login çalıştırın. Kiro kiro-cli login ile oturum açar; süresi dolmuş bir oturum da aynı şekilde başarısız olur.

Yanıt yarıda kesiliyor. Uzun tur AGENT_CLI_TIMEOUT_MS değerine ulaşmış olabilir. Değeri artırın veya isteği küçük adımlara bölün.

İlgili​