Alat advisor bersifat eksperimental dan memerlukan Claude Code v2.1.98 atau lebih baru dengan API Anthropic. Alat ini tidak tersedia di Amazon Bedrock, Google Vertex AI, 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
Jika salah satu dari ini mengatur model advisor, advisor diaktifkan untuk sesi yang model utamanya mendukungnya. Untuk berhenti menggunakannya, lihat Matikan advisor.
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:
Pilihan Anda disimpan ke advisorModel dalam pengaturan pengguna Anda dan bertahan di seluruh sesi. 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:
{
"advisorModel": "opus"
}
Gunakan bendera --advisor
Untuk mengatur advisor untuk sesi tunggal tanpa mengubah pengaturan yang disimpan, luncurkan dengan bendera:
Bendera ini mengambil alih pengaturan advisorModel untuk sesi itu. Tidak seperti /advisor, yang menyimpan pilihan tidak aktif, bendera keluar dengan kesalahan jika model utama sesi tidak mendukung advisor.
Pilih model advisor
Advisor harus setidaknya sama mampu dengan model utama. Advisor yang diterima untuk setiap model utama adalah:
| Model utama | Advisor yang diterima | Catatan |
|---|
| Haiku 4.5 | Fable, Opus, Sonnet | Haiku dapat memanggil advisor tetapi tidak dapat bertindak sebagai advisor |
| Sonnet 4.6 | Fable, Opus, Sonnet | |
| Opus 4.6 atau lebih baru | Fable, Opus pada atau di atas versi model utama | Opus 4.7 utama dengan advisor Opus 4.6 ditolak |
| Fable 5 (v2.1.170+) | Fable | Advisor Opus atau Sonnet ditolak |
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
/advisor dan 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:
| Pasangan | Kapan menggunakan |
|---|
| Sonnet utama + advisor Opus | Sonnet menangani pekerjaan rutin dan eskalasi perencanaan, kegagalan ambigu, dan pemeriksaan penyelesaian ke Opus |
| Sonnet utama + advisor Fable | Panduan Fable 5 pada titik keputusan tanpa menjalankan Fable 5 di seluruh. Memerlukan v2.1.170 atau lebih baru dan akses Fable 5 |
| Haiku utama + advisor Opus | Model utama dengan biaya terendah dengan perencanaan yang kuat. Harapkan biaya lebih tinggi daripada Haiku saja tetapi lebih rendah daripada beralih model utama ke Sonnet atau Opus |
| Opus utama + advisor Opus | Opus kedua meninjau yang pertama. Berguna untuk tugas berisiko tinggi di mana pemeriksaan independen lebih penting daripada biaya |
| Fable utama + advisor Fable | Pasangan kemampuan tertinggi ketika Fable 5 tersedia (v2.1.170+). Fable adalah tingkat yang lebih tinggi daripada Opus dan Sonnet, jadi ini adalah satu-satunya advisor yang diterima untuk model utama Fable |
| Sonnet utama + advisor Sonnet | Pendapat kedua dengan biaya lebih rendah untuk menangkap pengawasan rutin |
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, misalnya consult 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 baris Advising 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:
- Claude Code v2.1.98 atau lebih baru: jalankan
claude update untuk upgrade.
- Hanya API Anthropic: advisor adalah alat yang dieksekusi server. Alat ini tidak tersedia di Amazon Bedrock, Google Vertex AI, 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 Haiku 4.5. Fable 5 juga memenuhi syarat di Claude Code v2.1.170 atau lebih baru.
Matikan advisor
Untuk berhenti menggunakan advisor dan menghapus advisorModel yang disimpan, jalankan /advisor off atau pilih No advisor di pemilih /advisor:
Untuk menonaktifkan alat advisor sepenuhnya, termasuk perintah /advisor dan bendera --advisor, atur CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1. Lihat Environment variables.
Advisor adalah salah satu dari beberapa cara untuk menggabungkan kekuatan model. Pilih berdasarkan kapan Anda ingin model kedua terlibat.
| Pendekatan | Kapan model yang lebih kuat berjalan | Bagaimana dimulai |
|---|
| Alat advisor | Pada titik keputusan di tengah tugas | Claude memanggilnya ketika memerlukan panduan |
opusplan | Selama mode rencana, kemudian beralih ke Sonnet untuk eksekusi | Anda memasuki mode rencana |
Subagents dengan model diatur | Untuk seluruh subtask yang didelegasikan | Claude mendelegasikan, atau Anda memanggil subagent |
/model | Untuk semua giliran berikutnya | Anda beralih model |
Lihat juga
