Alat advisor bersifat eksperimental dan memerlukan API Anthropic. Alat ini tidak tersedia di Amazon Bedrock, Claude Platform on AWS, Google Cloud’s Agent Platform, atau Microsoft Foundry. Perilaku, harga, dan ketersediaan dapat berubah.
Kapan menggunakan advisor
Advisor cocok untuk tugas multi-langkah yang panjang di mana sebagian besar giliran bersifat rutin tetapi kualitas rencana menentukan hasilnya. Contohnya termasuk refaktor besar, sesi debugging di mana kesalahan terus berulang, dan tugas yang ingin Anda periksa secara independen sebelum Claude menyatakan selesai. Ini menambah nilai lebih sedikit pada tugas pendek di mana ada sedikit untuk direncanakan, atau pada pekerjaan di mana setiap giliran memerlukan model terkuat. Untuk itu, ubah model utama sebagai gantinya, atau lihat bagaimana advisor dibandingkan dengan opusplan dan subagents untuk cara lain mendapatkan pendapat kedua.Aktifkan advisor
Anda dapat mengatur model advisor dengan tiga cara:- Perintah
/advisor: atur atau ubah advisor di tengah sesi dan simpan sebagai default Anda - Pengaturan
advisorModel: konfigurasi default persisten di file pengaturan Anda - Bendera
--advisor: atur advisor untuk sesi tunggal saat peluncuran
Untuk menggunakan Fable 5 sebagai advisor, Anda memerlukan Claude Code v2.1.170 atau lebih baru dan akses Fable 5 untuk organisasi Anda.
Gunakan perintah /advisor
Jalankan /advisor tanpa argumen untuk membuka pemilih yang mencantumkan model advisor yang tersedia, atau teruskan model secara langsung:
advisorModel dalam pengaturan pengguna Anda dan bertahan di seluruh sesi. Jika availableModels allowlist organisasi Anda mengecualikan model advisor yang disimpan, advisor tidak dipanggil sampai Anda memilih model yang diizinkan dengan /advisor. Jika model utama Anda saat ini tidak mendukung advisor, pilihan masih disimpan dan diaktifkan ketika Anda beralih ke model utama yang kompatibel dengan /model.
Atur advisorModel dalam pengaturan
Untuk mengonfigurasi advisor sebagai default tanpa membuka sesi, aturnya di file pengaturan Anda:
Gunakan bendera --advisor
Untuk mengatur advisor untuk sesi tunggal tanpa mengubah pengaturan yang disimpan, luncurkan dengan bendera:
advisorModel untuk sesi itu. Bendera keluar dengan kesalahan jika model utama sesi tidak mendukung advisor, atau jika model advisor yang diminta dikecualikan oleh allowlist availableModels organisasi Anda.
Pilih model advisor
Advisor harus setidaknya sama mampu dengan model utama. Advisor yang diterima untuk setiap model utama adalah:
Fable 5 memerlukan Claude Code v2.1.170 atau lebih baru dan akses Fable 5, baik bertindak sebagai model utama atau advisor.
Atur advisor sebagai
opus, sonnet, atau fable. Alias ini diselesaikan ke versi terbaru dari setiap model. Anda juga dapat melewatkan ID model lengkap seperti claude-opus-4-8.
Subagent mewarisi advisor yang dikonfigurasi dan menerapkan pemeriksaan pasangan yang sama terhadap model mereka sendiri.
Claude Code memvalidasi pasangan sebelum mengirim permintaan:
- Jika advisor kurang mampu daripada model utama, advisor tidak dilampirkan ke permintaan model utama. Output perintah
/advisordan notifikasi menunjukkan hal ini. Subagent yang model mereka sendiri memenuhi pasangan mungkin masih menggunakan advisor. - Jika model utama atau advisor adalah model yang Claude Code tidak kenali, advisor tidak dilampirkan.
Pasangan model umum
Pasangan apa pun yang diterima berfungsi. Kombinasi ini menyeimbangkan biaya terhadap kemampuan dengan cara yang berbeda:Kapan Claude berkonsultasi dengan advisor
Claude memutuskan kapan memanggil advisor. Cenderung berkonsultasi sebelum berkomitmen pada pendekatan, ketika kesalahan terus berulang, dan sebelum menyatakan tugas selesai, tetapi waktu didorong oleh model daripada berbasis aturan. Anda dapat meminta konsultasi dalam prompt Anda dengan cara yang sama seperti Anda meminta alat apa pun, misalnyaconsult the advisor before you continue. Tidak ada pengaturan untuk membatasi atau memaksa panggilan advisor; jika Anda ingin Claude berkonsultasi lebih atau kurang sering selama tugas, katakan dalam instruksi Anda.
Apa yang Anda lihat selama sesi
Ketika Claude memanggil advisor, transkrip menampilkan barisAdvising dengan nama model advisor saat panggilan sedang berlangsung. Ketika hasilnya kembali, baris mengkonfirmasi bahwa advisor telah meninjau percakapan. Tekan Ctrl+O untuk memperluas dan membaca panduan lengkap advisor.
Claude umumnya mengikuti panduan advisor, tetapi beradaptasi ketika bukti miliknya bertentangan dengan klaim spesifik: jika langkah yang direkomendasikan gagal saat dicoba, atau isi file bertentangan dengan saran, Claude menampilkan konflik daripada mengikuti panduan secara tidak terbatas.
Advisor selalu menerima percakapan lengkap, dan Claude mengontrol waktu. Untuk kontrol lebih atau konfigurasi berbeda, lihat bagaimana advisor dibandingkan dengan subagents dan opusplan.
Biaya
Setiap panggilan advisor mengirim percakapan ke model advisor, jadi mengonsumsi token pada tarif model advisor sebagai tambahan dari penggunaan model utama Anda. Dengan penagihan API, token advisor ditagih pada tarif input dan output model advisor. Pada paket berlangganan, penggunaan advisor dihitung terhadap batas penggunaan paket Anda. Claude memanggil advisor pada titik keputusan daripada pada setiap giliran, jadi memasangkan model utama yang lebih cepat dengan advisor yang lebih kuat biasanya biaya lebih rendah daripada menjalankan model yang lebih kuat di seluruh. Penggunaan advisor dihitung terhadap total sesi yang ditampilkan oleh/usage.
Untuk bagaimana token advisor dilaporkan dalam respons API, lihat Usage and billing dalam dokumentasi Claude API.
Dampak pada prompt caching
Mengaktifkan atau menonaktifkan advisor di tengah sesi tidak membatalkan prompt cache model utama Anda. Tidak seperti mengubah model atau tingkat upaya, mengalihkan/advisor menjaga awalan yang di-cache tetap utuh, dan panduan yang dikembalikan advisor di-cache sebagai bagian dari transkrip pada giliran berikutnya.
Pembacaan percakapan model advisor sendiri tidak di-cache. Setiap panggilan advisor memproses transkrip lengkap baru, tanpa penggunaan kembali di antara panggilan.
Persyaratan
Alat advisor memerlukan semua hal berikut:- Hanya API Anthropic: advisor adalah alat yang dieksekusi server. Alat ini tidak tersedia di Amazon Bedrock, Claude Platform on AWS, Google Cloud’s Agent Platform, atau Microsoft Foundry. Melalui LLM gateway yang dikonfigurasi dengan
ANTHROPIC_BASE_URL, ketersediaan tergantung pada apakah gateway meneruskan permintaan utuh ke API Anthropic. - Model utama yang didukung: Opus 4.6 atau lebih baru, Sonnet 4.6 atau lebih baru, atau Haiku 4.5. Fable 5 juga memenuhi syarat di Claude Code v2.1.170 atau lebih baru.
Matikan advisor
Untuk berhenti menggunakan advisor dan menghapusadvisorModel yang disimpan, jalankan /advisor off atau pilih No advisor di pemilih /advisor:
CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1. Perintah /advisor menjadi tidak tersedia dan advisorModel yang dikonfigurasi apa pun diabaikan. Bendera --advisor diterima tetapi tidak memiliki efek; skrip yang ada yang meneruskannya terus berfungsi tanpa kesalahan. Lihat Environment variables.
Bandingkan dengan fitur terkait
Advisor adalah salah satu dari beberapa cara untuk menggabungkan kekuatan model. Pilih berdasarkan kapan Anda ingin model kedua terlibat.Lihat juga
- Model configuration: ubah model, atur tingkat upaya, dan gunakan
opusplan - Manage costs effectively: lacak penggunaan token di seluruh model
- Advisor tool in the Claude API: pahami alat server yang mendasar, atau gunakan langsung dari Messages API
- The advisor strategy: mengapa memasangkan model utama yang cepat dengan advisor yang lebih kuat berfungsi