Claude Code, zorlu kararları daha güçlü bir modele danışarak çözmenizi sağlayan advisor (danışman) aracını sunuyor. Bu özellik, ana modelinizi daha güçlü bir "danışman" model ile eşleştirerek, görev sırasında kritik anlarda Claude'un bu modele danışmasını sağlar.
Ne zaman kullanılmalı (When to use the advisor)
Advisor aracı, çoğu adımın rutin olduğu ancak plan kalitesinin sonucu belirlediği uzun, çok adımlı görevler için idealdir. Örnekler:
- Büyük ölçekli yeniden düzenlemeler (refactor)
- Aynı hatanın tekrarlandığı hata ayıklama oturumları
- Claude'un görevi tamamlandı olarak işaretlemeden önce bağımsız bir kontrol istediğiniz işler
Kısa görevlerde veya her adımda en güçlü modele ihtiyaç duyulan işlerde daha az değer katar. Bu durumlarda ana modeli değiştirmek veya opusplan ile subagent özelliklerini değerlendirmek daha uygun olabilir.
Advisor'ı etkinleştirme (Enable the advisor)
Advisor modelini üç farklı yöntemle ayarlayabilirsiniz:
/advisor komutunu kullanma
Argümansız /advisor yazdığınızda, mevcut danışman modellerini listeleyen bir seçici açılır. Doğrudan model adını da iletebilirsiniz:
/advisor opus
Bu seçim, kullanıcı ayarlarınıza advisorModel olarak kaydedilir ve oturumlar arasında kalıcı olur.
advisorModel ayarını yapılandırma
Oturum açmadan kalıcı bir varsayılan belirlemek için ayar dosyanıza ekleyin:
{
"advisorModel": "opus"
}
--advisor bayrağını kullanma
Kayıtlı ayarınızı değiştirmeden tek bir oturum için danışman belirlemek amacıyla CLI'da şu komutu kullanın:
claude --advisor opus
Bu bayrak, o oturum için advisorModel ayarını geçersiz kılar. /advisor'dan farklı olarak, oturumun ana modeli danışmanı desteklemiyorsa hata ile çıkar.
Danışman modeli seçme (Choose an advisor model)
Danışman, en az ana model kadar yetenekli olmalıdır. Kabul edilen eşleşmeler aşağıdaki gibidir:
| Ana Model | Kabul Edilen Danışmanlar | Notlar |
|---|---|---|
| Haiku 4.5 | Fable, Opus, Sonnet | Haiku danışman çağırabilir ancak danışman olamaz |
| Sonnet 4.6 | Fable, Opus, Sonnet | |
| Opus 4.6 veya üzeri | Fable, Opus (ana modelin sürümüne eşit veya üzeri) | Opus 4.7 ana + Opus 4.6 danışman reddedilir |
| Fable 5 (v2.1.170+) | Fable | Opus veya Sonnet danışman reddedilir |
Fable 5, Claude Code v2.1.170 veya üzerini ve Fable 5 erişimini gerektirir. /advisor seçicisinde görünmez; doğrudan /advisor fable, --advisor fable veya "advisorModel": "fable" olarak iletilmelidir.
Yaygın model eşleşmeleri (Common model pairings)
| Eşleşme | Ne zaman kullanılmalı |
|---|---|
| Sonnet ana + Opus danışman | Sonnet rutin işleri yapar, planlama ve hata durumlarını Opus'a yükseltir |
| Sonnet ana + Fable danışman | Fable 5'i tüm görev boyunca çalıştırmadan karar noktalarında kullanır |
| Haiku ana + Opus danışman | En düşük maliyetli ana model, güçlü planlama |
| Opus ana + Opus danışman | Yüksek riskli görevlerde bağımsız kontrol |
| Fable ana + Fable danışman | En yüksek yetenek eşleşmesi |
| Sonnet ana + Sonnet danışman | Düşük maliyetli ikinci görüş |
Claude danışmana ne zaman danışır (When Claude consults the advisor)
Claude, danışmanı ne zaman çağıracağına kendisi karar verir. Genellikle şu durumlarda danışır:
- Bir yaklaşıma başlamadan önce
- Tekrarlayan bir hatayla karşılaştığında
- Görevi tamamlanmış olarak işaretlemeden önce
Ancak bu zamanlama kural tabanlı değil, model odaklıdır. İsteminizde "devam etmeden önce danışmana danış" gibi bir talep verebilirsiniz. Danışman çağrılarını sınırlamak veya zorlamak için bir ayar bulunmaz.
Oturum sırasında görünenler (What you see during a session)
Claude danışmanı çağırdığında, transkriptte çağrı devam ederken danışman model adıyla birlikte bir Advising satırı görünür. Sonuç döndüğünde, satır danışmanın konuşmayı incelediğini onaylar. Ctrl+O tuşuna basarak danışmanın tam rehberliğini genişletebilir ve okuyabilirsiniz.
Claude genellikle danışmanın rehberliğini takip eder, ancak kendi kanıtları belirli bir iddiayla çelişiyorsa uyum sağlar. Örneğin, önerilen bir adım denendiğinde başarısız olursa veya dosya içeriği tavsiyeyle çelişiyorsa, Claude rehberliği koşulsuz takip etmek yerine çatışmayı yüzeye çıkarır.
Maliyet (Cost)
Her danışman çağrısı, konuşmayı danışman modeline gönderir, bu nedenle ana model kullanımına ek olarak danışman modelinin ücretleri üzerinden token tüketir. API faturalamasında danışman token'ları, danışman modelinin girdi ve çıktı ücretleri üzerinden hesaplanır. Abonelik planlarında danışman kullanımı, planınızın kullanım limitlerine dahil edilir.
Danışman kullanımı, /usage komutuyla gösterilen oturum toplamlarına dahildir.
Prompt önbelleğine etkisi (Impact on prompt caching)
Oturum ortasında advisor'ı etkinleştirmek veya devre dışı bırakmak, ana modelinizin prompt önbelleğini geçersiz kılmaz. Model veya çaba seviyesini değiştirmenin aksine, /advisor'ı açıp kapatmak önbelleğe alınmış öneki bozulmadan tutar. Danışmanın döndürdüğü rehberlik, sonraki turlarda transkriptin bir parçası olarak önbelleğe alınır.
Danışman modelinin konuşmayı kendi okuması önbelleğe alınmaz. Her danışman çağrısı, transkripti yeniden işler ve çağrılar arasında yeniden kullanım olmaz.
Gereksinimler (Requirements)
- Claude Code v2.1.98 veya üzeri:
claude updateile güncelleyin. - Yalnızca Anthropic API: Amazon Bedrock, Google Vertex AI veya Microsoft Foundry'de kullanılamaz.
- Desteklenen ana model: Opus 4.6 veya üzeri, Sonnet 4.6 veya Haiku 4.5. Fable 5, Claude Code v2.1.170 veya üzerinde desteklenir.
Advisor'ı kapatma (Turn the advisor off)
Kullanmayı durdurmak ve kayıtlı advisorModel ayarını temizlemek için:
/advisor off
Veya /advisor seçicisinde No advisor seçeneğini işaretleyin. Advisor aracını tamamen devre dışı bırakmak için CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 ortam değişkenini ayarlayın.
İlgili özelliklerle karşılaştırma (Compare with related features)
| Yaklaşım | Daha güçlü model ne zaman çalışır | Nasıl başlar |
|---|---|---|
| Advisor aracı | Görev sırasında karar noktalarında | Claude rehberlik gerektiğinde çağırır |
| opusplan | Plan modu sırasında, ardından Sonnet yürütür | Plan moduna girersiniz |
| model ayarlı subagent'lar | Tüm devredilen alt görev boyunca | Claude devreder veya siz subagent'ı çağırırsınız |
| /model | Sonraki tüm turlar için | Model değiştirirsiniz |
Ayrıca bakınız (See also)
- Model yapılandırması: model değiştirme, çaba seviyesi ayarlama ve opusplan kullanımı
- Maliyetleri etkin yönetme: modeller arası token kullanımını takip etme
- Claude API'de Advisor aracı: temel sunucu aracını anlama veya doğrudan Messages API'den kullanma
- Advisor stratejisi: hızlı bir ana modeli daha güçlü bir danışmanla eşleştirmenin neden işe yaradığı
Örnek kullanım senaryosu
Bir yazılım geliştiricisi, büyük bir monolitik uygulamayı mikroservislere ayırmak için Claude Code kullanıyor. Görev çok adımlı ve her adımda doğru mimari kararların alınması kritik.
- Geliştirici, oturumu başlatırken danışman modelini belirler:
claude --advisor opus - Ana model Sonnet 4.6 olarak çalışırken, Claude bir servis ayrıştırma planı yapmaya başlar.
- Claude, hangi modüllerin ayrılacağına karar vermeden önce otomatik olarak Opus danışmanına danışır. Transkriptte Advising (Opus) satırı belirir.
- Danışman, önerilen modül sınırlarını inceler ve bağımlılık döngüsü oluşturabilecek bir ayrıştırma konusunda uyarır.
- Geliştirici
Ctrl+Oile danışmanın tam rehberliğini okur ve Claude'un önerilen değişikliği uygulamasını izler. - Bir hata durumunda Claude tekrar danışmana başvurur; danışman hata ayıklama stratejisi önerir.
- Görev tamamlanmaya yaklaşırken Claude, son bir kez danışmana danışarak tüm değişikliklerin tutarlı olduğunu onaylatır.
- Oturum sonunda
/usagekomutuyla hem Sonnet hem de Opus kullanımını görüntüler. Geliştirici, Opus'u tüm görev boyunca kullanmaktan daha düşük maliyetle güçlü bir mimari denetim almış olur.