Claude Code’a deneysel bir özellik geldi: advisor tool. Bu araçla ana modelinizi, görevin kritik anlarında Claude’un danıştığı daha güçlü ikinci bir modelle eşleştirebiliyorsunuz. Örneğin bir yaklaşıma karar vermeden önce, tekrar eden bir hataya takıldığında ya da işin bittiğini söylemeden önce Claude advisor’a danışabiliyor. Advisor tüm konuşmayı, her tool çağrısı ve sonucuyla birlikte görüyor ve Claude’un devam etmeden önce uyguladığı yönlendirmeyi döndürüyor.
Advisor, Anthropic altyapısında sunucu tarafında çalışan bir server tool ve hem abonelik hem de API ile faturalanan hesaplarda kullanılabiliyor. Hangi modelin advisor olacağını siz seçiyorsunuz, ne zaman çağrılacağına Claude karar veriyor.
Önemli: Advisor tool deneysel ve sadece Anthropic API ile çalışıyor. Amazon Bedrock, Claude Platform on AWS, Google Cloud Agent Platform ya da Microsoft Foundry üzerinden kullanılamıyor. Davranışı, fiyatı ve erişilebilirliği değişebilir.
Ne zaman işe yarar
Advisor; turların çoğunun rutin olduğu ama sonucu planın kalitesinin belirlediği uzun, çok adımlı işler için uygun. Büyük refactoring’ler, bir hatanın sürekli tekrarladığı debug oturumları ve Claude’un “bitti” demeden önce bağımsız olarak kontrol edilmesini istediğiniz görevler iyi örnekler. Planlanacak pek bir şeyin olmadığı kısa görevlerde ya da her turun en güçlü modeli gerektirdiği işlerde daha az fayda sağlıyor; bu durumlarda doğrudan ana modeli değiştirmek daha mantıklı.
Advisor nasıl açılır
Advisor modelini üç şekilde ayarlayabilirsiniz:
/advisorkomutu: Oturum sırasında advisor’ı ayarlar ya da değiştirir ve varsayılan olarak kaydeder.advisorModelayarı: Ayar dosyanızda kalıcı bir varsayılan tanımlar.--advisorparametresi: Sadece başlattığınız oturum için advisor’ı belirler.
Oturum başladığında Claude Code Advisor Tool (experimental) is on and may use more tokens · /advisor bildirimini gösteriyor.
/advisor komutu: Argümansız çalıştırıldığında kullanılabilir advisor modellerini listeleyen bir seçici açıyor; model adını doğrudan da verebilirsiniz:
/advisor opusKomut Advisor set to mesajıyla onaylıyor ve seçiminizi kullanıcı ayarlarınızdaki advisorModel alanına kaydediyor. Komut, terminal seçicinin olmadığı yerlerde de çalışıyor: -p ile non-interactive modda, Agent SDK’da, masaüstü uygulamasında ve Remote Control üzerinden (Claude Code v2.1.260 ve sonrası). Bu ortamlarda argümansız /advisor mevcut advisor’ı ve kabul edilen takma adları yazdırıyor, /advisor off ise kapatıyor.
Kayıtlı advisor, mevcut ana modeliniz desteklemese bile saklanıyor ve /model ile uyumlu bir ana modele geçtiğinizde devreye giriyor. Kurumunuzun availableModels izin listesinin dışında kalan bir advisor ise çağrılmıyor.
Ayar dosyasında:
{
"advisorModel": "opus"
}Tek oturum için parametreyle:
claude --advisor opus--advisor parametresi claude --help çıktısında listelenmiyor. Ana model advisor’ı desteklemiyorsa, istenen model advisor olamıyorsa (örneğin Haiku 4.5), kurumun izin listesi modeli dışlıyorsa ya da Fable için gereken kullanım kredisi onayı verilmemişse Claude Code açılışta hatayla kapanıyor. Arka plan oturumlarında ise kapanmak yerine oturumu advisor olmadan başlatıyor.
Hangi model hangi modele danışabilir
Claude Code modelleri advisor rolü için yeteneklerine göre sıralıyor ve advisor’ın, oturumun ana modeliyle aynı ya da daha üst seviyede olması gerekiyor:
| Ana model | Kabul edilen advisor’lar |
|---|---|
| Haiku 4.5 | Fable, Opus, Sonnet, Haiku 5.5 |
| Sonnet 4.6 | Fable, Opus, Sonnet, Haiku 5.5 |
| Opus 4.6 | Fable, Opus, Sonnet 5 ve sonrası, Haiku 5.5 |
| Sonnet 5 veya Haiku 5.5 | Fable, Opus 4.7 ve sonrası, Sonnet 5 ve sonrası, Haiku 5.5 |
| Opus 4.7 veya Opus 4.8 | Fable, Opus 4.7 ve sonrası, Sonnet 5.5 |
| Sonnet 5.5 | Fable, Opus 5 ve sonrası, Sonnet 5.5 |
| Opus 5 veya Opus 5.5 | Fable, Opus 5 ve sonrası |
| Fable 5 | Fable 5.1 veya Fable 5 |
| Fable 5.1 | Fable 5.1 |
Advisor fable, opus ya da sonnet takma adlarıyla ya da claude-opus-5-5 gibi tam model ID’siyle ayarlanabiliyor. Takma adlar her model ailesinin Claude Code içindeki varsayılan sürümüne çözümleniyor. Haiku 4.5 advisor çağırabiliyor ama advisor olamıyor. Bazı sürüm gereksinimleri de var: Fable 5.1 için Claude Code v2.1.257, Opus 4.7/4.8 ana modeli için Sonnet 5.5 advisor’ı için v2.1.287, Haiku 5.5 için v2.1.293 ve sonrası gerekiyor. Subagent’lar ayarlanan advisor’ı devralıyor ve kendi modellerine göre aynı uyumluluk kontrolünden geçiyor.
Ana modelden daha alt seviyedeki bir advisor istekleri eklenmiyor; API bir eşleşmeyi reddederse Claude Code isteği advisor olmadan yeniden gönderiyor ve konuşma hata göstermeden advisor’sız devam ediyor.
Fable advisor ve kullanım kredileri
Bazı planlarda Fable kullanımı kullanım kredilerinden (usage credits) düşüyor ve Fable advisor da aynı şekilde faturalanıyor. Hesabınız bunun için tek seferlik onay gerektiriyorsa, Claude Code onay verilene kadar Fable’ı advisor olarak kaydetmiyor ve sizi /model fable komutuna yönlendiriyor. Onayı vermek için /model fable çalıştırıp Fable ile devam etmeyi seçmeniz, ardından Fable’ı advisor olarak seçmeniz gerekiyor.
Yaygın model eşleşmeleri
| Eşleşme | Ne zaman kullanılır |
|---|---|
| Sonnet ana model + Opus advisor | Sonnet rutin işleri yapıyor; planlama, belirsiz hatalar ve tamamlanma kontrolü Opus’a gidiyor |
| Sonnet ana model + Fable advisor | Fable’ı baştan sona çalıştırmadan karar noktalarında Fable yönlendirmesi. Fable erişimi gerekiyor |
| Haiku ana model + Opus advisor | En düşük maliyetli ana model ve güçlü planlama. Sadece Haiku’dan pahalı, ana modeli Sonnet ya da Opus yapmaktan ucuz |
| Opus ana model + Opus advisor | İkinci bir Opus ilkini kontrol ediyor. Bağımsız kontrolün maliyetten önemli olduğu kritik işler için |
| Fable ana model + Fable advisor | Fable erişimi olanlar için en yetenekli eşleşme. Fable ana modele Opus ya da Sonnet advisor eklenmiyor |
| Sonnet ana model + Sonnet advisor | Rutin gözden kaçmaları yakalamak için daha ucuz ikinci görüş |
Claude advisor’a ne zaman danışıyor
Ne zaman danışılacağına Claude karar veriyor. Genelde bir yaklaşıma karar vermeden önce, bir hata tekrar ettiğinde ve görevi bitti olarak bildirmeden önce danışıyor; ama zamanlama kurallara değil modele bağlı. Prompt’unuzda “devam etmeden önce advisor’a danış” gibi bir talimatla danışma isteyebilirsiniz. Advisor çağrılarını sınırlayan ya da zorlayan bir ayar yok; daha sık ya da daha seyrek danışılmasını istiyorsanız bunu talimatlarınızda belirtmeniz gerekiyor.
Oturumda ne görüyorsunuz
Claude advisor’ı çağırdığında konuşmada advisor model adıyla bir Advising satırı görünüyor. Sonuç geldiğinde satır üç durumdan birini gösteriyor:
- Reviewed: Advisor konuşmayı incelemiş. Okunabilir bir yönlendirme döndürdüyse
Ctrl+Oile okuyabilirsiniz. - Declined: Satırda
Advisor declined to advise on this requestyazıyor; bir gerekçe verdiyse yineCtrl+Oile görülebiliyor. - Unavailable: Advisor çağrısı başarısız olmuş; satırda
Advisor unavailable (<error_code>)yazıyor.
Claude genelde advisor’ın yönlendirmesini izliyor, ama kendi kanıtı belirli bir iddiayla çelişirse uyum sağlıyor: önerilen bir adım denendiğinde başarısız olursa ya da dosya içeriği tavsiyeyle çelişirse, yönlendirmeyi körü körüne izlemek yerine çelişkiyi size bildiriyor.
Maliyet ve prompt caching
Advisor her çağrıldığında konuşmanın tamamını okuyor; bu da ana modelinizin kullanımına ek olarak advisor modelinin fiyatlarıyla token tüketiyor. API faturalamasında advisor modelinin input ve output fiyatlarını ödüyorsunuz. Abonelik planlarında advisor kullanımı planınızın kullanım limitlerinden düşüyor; Fable kullanımının kullanım kredilerinden düştüğü planlarda ise Fable advisor da kredilerden faturalanıyor. Claude advisor’ı her turda değil karar noktalarında çağırdığı için, hızlı bir ana modeli güçlü bir advisor’la eşleştirmek genelde güçlü modeli baştan sona çalıştırmaktan daha ucuz. Advisor kullanımı /usage toplamlarına dahil.
Advisor’ı oturum ortasında açıp kapatmak, model değiştirmenin aksine ana modelin prompt cache’ini bozmuyor; advisor’ın döndürdüğü yönlendirme de sonraki turlarda konuşmanın parçası olarak cache’leniyor. Ancak advisor modelinin konuşmayı okuması cache’lenmiyor; her advisor çağrısı tüm konuşmayı baştan işliyor.
Gereksinimler ve kapatma
- Sadece Anthropic API: Advisor sunucu tarafında çalışan bir tool.
ANTHROPIC_BASE_URLile yapılandırılmış bir LLM gateway üzerinden kullanılabilirliği, gateway’in isteği Anthropic API’ye olduğu gibi iletip iletmediğine bağlı. - Desteklenen ana model: Fable, Opus 4.6 ve sonrası, Sonnet 4.6 ve sonrası, Haiku 4.5 ya da Haiku 5.5.
- Feature flag erişimi: Claude Code advisor’ı Anthropic’ten çektiği bir feature flag ile açıyor;
DISABLE_TELEMETRYgibi flag çekmeyi kapatan bir değişken tanımlıysa advisor kapalı kalıyor.
Advisor’ı kapatmak için /advisor off çalıştırabilir ya da seçicide No advisor‘ı seçebilirsiniz. Tamamen devre dışı bırakmak için CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 ortam değişkenini tanımlayın; bu durumda /advisor komutu kullanılamıyor ve kayıtlı advisorModel yok sayılıyor.
/advisor offBenzer özelliklerle karşılaştırma
| Yaklaşım | Güçlü model ne zaman çalışıyor | Nasıl başlıyor |
|---|---|---|
| Advisor tool | Görev ortasında karar noktalarında | Claude ihtiyaç duyduğunda çağırıyor |
| opusplan | Plan modunda; uygulama için Sonnet’e geçiyor | Siz plan moduna giriyorsunuz |
| model ayarlı subagent’lar | Devredilen alt görevin tamamında | Claude devrediyor ya da siz çağırıyorsunuz |
| /model | Bir sonraki istekten itibaren | Siz model değiştiriyorsunuz |
Advisor, “her şeyi en güçlü modelle yap” ile “ucuz modelle idare et” arasında makul bir orta yol sunuyor: rutin adımlar hızlı ve ucuz modelde ilerlerken, işin sonucunu belirleyen plan ve kontrol noktalarında daha güçlü bir model devreye giriyor. Bence en pratik kullanım Sonnet ana model ile Opus advisor eşleşmesi; özellikle uzun refactoring ve debug oturumlarında, Claude’un işi bitirdim demeden önce bağımsız bir kontrolden geçmesi değerli. Dikkat edilmesi gereken iki nokta var: özellik deneysel ve sadece Anthropic API üzerinde çalışıyor, ayrıca her advisor çağrısı tüm konuşmayı cache’siz okuduğu için çok uzun oturumlarda maliyet hızla artabilir.
