Eskalasi keputusan sulit dengan alat advisor

Pasangkan model utama Anda dengan model advisor yang lebih kuat yang dikonsultasikan Claude pada momen-momen kunci selama tugas.

[!NOTE]

Tool advisor bersifat eksperimental dan memerlukan API Anthropic atau Claude Platform on AWS. Di Claude Platform on AWS, tool ini memerlukan Claude Code v2.1.300 atau yang lebih baru. Tool ini tidak tersedia di Amazon Bedrock, Google Cloud's Agent Platform, atau Microsoft Foundry. Perilaku, harga, dan ketersediaan dapat berubah.

Alat advisor memungkinkan Claude untuk berkonsultasi dengan model kedua yang biasanya lebih kuat pada momen-momen kunci selama tugas, seperti sebelum berkomitmen pada pendekatan, ketika terjebak pada kesalahan berulang, atau sebelum menyatakan tugas selesai. Advisor menerima percakapan lengkap, termasuk setiap pemanggilan alat dan hasilnya, dan mengembalikan panduan yang diterapkan Claude sebelum melanjutkan.

Advisor berjalan di sisi server pada infrastruktur Anthropic sebagai server tool, tersedia untuk akun berlangganan dan berbasis API. Anda memilih model mana yang bertindak sebagai advisor, dan Claude memutuskan kapan memanggilnya.

Halaman ini mencakup cara mengaktifkan advisor, pasangan model mana yang diterima, apa yang ditampilkan Claude selama konsultasi, dan bagaimana penggunaan advisor ditagih.

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
• Flag --advisor: atur advisor untuk sesi tunggal saat peluncuran

Masing-masing dari ini mengaktifkan advisor untuk sesi yang model utamanya mendukungnya. Setelah sesi dimulai, Claude Code menampilkan notifikasi Advisor Tool (experimental) is on and may use more tokens · /advisor. Untuk berhenti menggunakan advisor, lihat Matikan advisor.

Pada beberapa paket, Fable sebagai advisor juga memerlukan persetujuan satu kali Anda untuk menagih penggunaan Fable ke kredit penggunaan. Untuk apa yang terjadi sebelum Anda memberikan persetujuan itu, lihat Advisor Fable dan kredit penggunaan.

Gunakan perintah /advisor

Jalankan /advisor tanpa argumen untuk membuka pemilih yang mencantumkan model advisor yang tersedia, atau teruskan model secara langsung:

/advisor opus

Perintah mengonfirmasi dengan Advisor set to diikuti dengan nama model advisor. Pilihan Anda disimpan ke advisorModel dalam pengaturan pengguna Anda dan bertahan di seluruh sesi, kecuali dalam kasus yang entri advisorModel sebutkan sebagai berlaku hanya untuk sesi saat ini.

Perintah ini juga berfungsi di mana tidak ada pemilih terminal: dalam mode non-interaktif dengan -p, dalam Agent SDK, dalam aplikasi desktop, dan melalui Remote Control. Ini memerlukan Claude Code v2.1.260 atau lebih baru. Di surface tersebut:

• Jalankan /advisor tanpa argumen untuk mencetak model advisor saat ini dan alias yang diterimanya.
• Jalankan /advisor dengan model, seperti /advisor opus, untuk mengaturnya.
• Jalankan /advisor off untuk mematikannya.

Claude Code tidak memanggil advisor yang disimpan yang allowlist availableModels organisasi Anda kecualikan. Untuk menggunakan advisor, pilih model yang diizinkan dengan /advisor.

Claude Code masih menyimpan advisor yang model utama Anda saat ini tidak mendukung. Advisor itu diaktifkan setelah Anda beralih ke model utama yang kompatibel dengan /model. Jika API sudah menolak advisor yang disimpan dalam percakapan saat ini, itu tetap mati sampai /clear atau /compact, bahkan setelah Anda beralih model.

Pada beberapa paket, Fable sebagai advisor juga memerlukan persetujuan satu kali Anda untuk menagih penggunaan Fable ke kredit penggunaan. Untuk apa yang dilakukan /advisor fable sebelum Anda memberikan persetujuan itu, lihat Advisor Fable dan kredit penggunaan.

Atur advisorModel dalam pengaturan

Untuk mengonfigurasi advisor sebagai default tanpa membuka sesi, aturnya di file pengaturan Anda:

{
  "advisorModel": "opus"
}

Gunakan flag --advisor

Untuk mengatur advisor untuk sesi tunggal tanpa mengubah pengaturan yang disimpan, luncurkan dengan flag:

claude --advisor opus

Claude Code menggunakan flag sebagai pengganti pengaturan advisorModel untuk sesi itu. Ini tidak mencantumkan --advisor dalam claude --help. Claude Code keluar dengan kesalahan saat peluncuran jika:

• Model utama sesi tidak mendukung advisor
• Model yang diminta, seperti Haiku 4.5, tidak dapat bertindak sebagai advisor
• Allowlist availableModels organisasi Anda mengecualikan model yang diminta
• Anda meminta Fable dan akun Anda masih memerlukan persetujuan kredit penggunaan

Jika Anda memulai sesi latar belakang dengan --advisor dan salah satu dari ini berlaku, Claude Code memulai sesi tanpa advisor sebagai gantinya dari keluar.

Jika model yang Anda teruskan dapat bertindak sebagai advisor tetapi berperingkat di bawah model utama Anda, sesi tetap dimulai, baik itu sesi latar belakang maupun bukan. Model utama Anda kemudian berjalan tanpa advisor.

Memilih model advisor

Claude Code memeringkat model berdasarkan kemampuannya untuk peran advisor, dan advisor harus memiliki peringkat yang sama dengan atau lebih tinggi dari model utama sesi Anda. Baris diurutkan dari model utama dengan peringkat terendah hingga tertinggi:

Fable 5.2 memerlukan Claude Code v2.1.321 atau yang lebih baru, dan Fable 5.1 memerlukan v2.1.257 atau yang lebih baru. Model Fable memerlukan akses Fable. Sonnet 5.5 sebagai advisor untuk model utama Opus 4.7 atau Opus 4.8 memerlukan Claude Code v2.1.287 atau yang lebih baru. Haiku 5.5 sebagai model utama atau sebagai advisor memerlukan Claude Code v2.1.293 atau yang lebih baru.

Tetapkan advisor sebagai fable, opus, atau sonnet. Alias ini di-resolve ke versi default bawaan Claude Code untuk setiap keluarga model, yang diperbarui seiring rilis Claude Code yang baru. Anda juga dapat memberikan ID model lengkap seperti claude-opus-5-5 atau claude-haiku-5-5. Haiku 4.5 dapat memanggil advisor tetapi tidak dapat bertindak sebagai advisor.

Subagent mewarisi advisor yang dikonfigurasi dan menerapkan pemeriksaan pasangan yang sama terhadap model mereka sendiri.

Claude Code memvalidasi pasangan sebelum mengirim permintaan, dan API memvalidasinya lagi:

• Untuk advisor yang peringkatnya di bawah model utama, Claude Code tidak melampirkannya ke permintaan model utama. Output perintah /advisor dan sebuah notifikasi menunjukkan hal ini; lihat Advisor is less capable than the current main model. Subagent yang modelnya sendiri memenuhi syarat pasangan tetap dapat menggunakan advisor.
• Jika API menolak pasangan dari advisor yang dilampirkan Claude Code, Claude Code mengirim ulang permintaan tersebut tanpa advisor. Percakapan berlanjut tanpa advisor, sehingga Anda tidak melihat error dan tidak mendapatkan panggilan advisor. Jika Anda kemudian memilih advisor lain dengan /advisor, pilihan tersebut berlaku setelah /clear atau /compact dan di sesi baru.
• Jika model utama atau advisor adalah model yang tidak dikenali Claude Code, advisor tidak dilampirkan.

Advisor Fable dan kredit penggunaan

Pada beberapa paket, penggunaan Fable ditagihkan ke kredit penggunaan, dan Fable sebagai advisor ditagihkan dengan cara yang sama. Jika akun Anda memerlukan persetujuan satu kali untuk menagihkan penggunaan Fable ke kredit penggunaan, Claude Code memintanya saat Anda memilih model Fable dengan /model dan tidak menerapkan Fable sebagai advisor sampai Anda menerima persetujuan tersebut.

Sebelum Anda menerimanya, Claude Code tidak menyimpan Fable sebagai advisor saat Anda mengetik /advisor fable atau memilih Fable di pemilih /advisor. Claude Code justru mengarahkan Anda ke /model fable. Dengan claude --advisor fable, Claude Code keluar saat peluncuran dengan pesan yang mengarahkan ke /model fable. Dalam sesi latar belakang, Claude Code memulai sesi tanpa advisor alih-alih keluar. Jika Fable sudah tersimpan sebagai advisorModel Anda, Claude Code mengirim permintaan tanpa advisor. Dalam sesi interaktif yang model utamanya mendukung advisor, Claude Code juga menampilkan notifikasi yang mengarahkan ke /model fable.

Untuk menerima persetujuan, jalankan /model fable dan pilih untuk melanjutkan dengan Fable. Claude Code mencatat persetujuan tersebut dan menyimpan Fable sebagai model yang Anda pilih. Kemudian pilih Fable sebagai advisor.

Pasangan model yang umum

Setiap pasangan yang diterima dapat digunakan. Kombinasi berikut menyeimbangkan biaya dan 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, 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 melaporkan apakah advisor memberikan panduan:

• Reviewed: baris mengkonfirmasi bahwa advisor telah meninjau percakapan. Ketika advisor mengembalikan panduan yang dapat dibaca, tekan Ctrl+O untuk membacanya.
• Declined: baris berbunyi Advisor declined to advise on this request. Jika advisor memberikan alasan, tekan Ctrl+O untuk membacanya.
• Unavailable: panggilan advisor gagal, dan baris berbunyi Advisor unavailable (<error_code>), di mana <error_code> adalah kode yang dikembalikan oleh panggilan.

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

Ketika Claude memanggil advisor, model advisor membaca percakapan, jadi setiap panggilan mengonsumsi token pada tarif model advisor sebagai tambahan dari penggunaan model utama Anda. Bagaimana token advisor ditagih tergantung pada cara Anda membayar:

• Penagihan API: Anda membayar tarif input dan output model advisor untuk token advisor
• Paket berlangganan: penggunaan advisor dihitung terhadap batas penggunaan paket Anda, kecuali bahwa advisor Fable ditagih ke kredit penggunaan pada paket di mana penggunaan Fable melakukannya

Untuk cara kerja advisor Fable dengan kredit penggunaan, lihat Advisor Fable dan kredit penggunaan.

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, 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

• Penyedia: API Anthropic atau Claude Platform on AWS, bukan Amazon Bedrock, Google Cloud's Agent Platform, atau Microsoft Foundry. Di Claude Platform on AWS, advisor memerlukan Claude Code v2.1.300 atau lebih baru.
• LLM gateway: melalui LLM gateway yang dikonfigurasi dengan ANTHROPIC_BASE_URL, ketersediaan tergantung pada apakah gateway meneruskan permintaan utuh ke API Anthropic. Jika gateway atau upstream-nya tidak mengenali tool advisor, lihat Retry otomatis dan penerusan kesalahan untuk mengetahui bagaimana Claude Code merespons.
• Model utama yang didukung: Fable, Opus 4.6 atau lebih baru, Sonnet 4.6 atau lebih baru, Haiku 4.5, atau Haiku 5.5. Lihat Pilih model advisor untuk mengetahui advisor mana yang diterima masing-masing.
• Pengambilan feature flag: kecuali Anda menggunakan Claude Platform on AWS, advisor memerlukan feature flag yang diambil dari Anthropic. Sesi dengan variabel yang mematikan pengambilan, seperti DISABLE_TELEMETRY, tidak memiliki flag tersebut. Untuk memeriksa sesi Anda, lihat sesi mana yang melewati pengambilan atau dimulai tanpa flag tersebut.

Matikan advisor

Untuk berhenti menggunakan advisor, jalankan /advisor off atau pilih No advisor di pemilih /advisor:

/advisor off

Untuk menonaktifkan alat advisor sepenuhnya, atur 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. 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