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:
| Model | Komut | Sağlayan |
|---|---|---|
| Claude Code | claude | Anthropic |
| Codex | codex | OpenAI |
| OpenCode | opencode | SST |
| Pi | pi | Mario 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) ve Opus 5.5 (claude-opus-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 gerekir; ikisi için de oturum açılan hesabın erişim yetkisi şarttır; CLI'yi güncellemek içinclaude updateçalıştırın. Mevcut Sonnet ve Opus 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. - 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.
Kullanım
- Yönetici olarak oturum açın.
- Sohbet başlatıp model seçiciyi açın.
- Agents altından giriş seçin.
- 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.
Kullanım takibi
Sağlayıcı Kullanımı (/usage) sayfasında üstteki Ajanlar bölümünü bulun. Claude Code, Codex, 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şken | Varsayılan | Amaç |
|---|---|---|
AGENT_CLI_MODELS_ENABLED | ayarlanmamış | Özelliği true/false değerine sabitler; yoksa yönetici anahtarına bağlıdır (varsayılan kapalı) |
AGENT_CLI_TIMEOUT_MS | 600000 | Tek 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" veya codex exec "hello"). 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.
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.