Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Parameter "effort" (upaya) memungkinkan Anda mengontrol berapa banyak token yang digunakan Claude saat merespons permintaan. Anda dapat menukar antara kelengkapan respons dan efisiensi token dengan satu model. Parameter effort tersedia pada semua model yang didukung tanpa memerlukan header beta.
Secara default, Claude menggunakan effort tinggi, menggunakan sebanyak mungkin token yang diperlukan untuk hasil yang sangat baik. Anda dapat menaikkan tingkat effort ke max untuk kemampuan tertinggi mutlak, atau menurunkannya agar lebih konservatif dalam penggunaan token, mengoptimalkan kecepatan dan biaya sambil menerima sedikit pengurangan kemampuan.
Parameter effort memengaruhi semua token dalam respons, termasuk:
Pendekatan ini memiliki dua keunggulan utama:
| Tingkat | Deskripsi | Kasus penggunaan umum |
|---|---|---|
max | Kemampuan maksimum mutlak tanpa batasan pada penggunaan token. Tersedia pada Claude Fable 5, Claude Mythos 5, Claude Opus 5, Claude Opus 4.8, Claude Mythos Preview, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5, dan Claude Sonnet 4.6. | Tugas yang memerlukan penalaran sedalam mungkin dan analisis paling menyeluruh |
xhigh | Kemampuan diperluas untuk pekerjaan jangka panjang. Tersedia pada Claude Fable 5, Claude Mythos 5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, dan Claude Sonnet 5. | Tugas agentic dan coding yang berjalan lama (lebih dari 30 menit) dengan anggaran token dalam jutaan |
high | Kemampuan tinggi. Setara dengan tidak mengatur parameter. | Penalaran kompleks, masalah coding yang sulit, tugas agentic |
medium | Pendekatan seimbang dengan penghematan token moderat. | Tugas agentic yang memerlukan keseimbangan kecepatan, biaya, dan performa |
low | Paling efisien. Penghematan token signifikan dengan sedikit pengurangan kemampuan. |
xhigh adalah tingkat yang lebih baru; beberapa model yang mendukung max tidak mendukung xhigh.
Claude Sonnet 5 secara default menggunakan effort high pada Claude API dan Claude Code.
Sonnet 4.6 secara default menggunakan effort high. Atur effort secara eksplisit saat menggunakan Sonnet 4.6 untuk menghindari latensi yang tidak terduga:
Mulai dengan xhigh untuk kasus penggunaan coding dan agentic, dan gunakan high sebagai minimum untuk sebagian besar beban kerja yang sensitif terhadap kecerdasan. Turunkan ke medium untuk beban kerja yang sensitif terhadap biaya, atau naikkan ke max hanya ketika evaluasi Anda menunjukkan ruang peningkatan yang terukur pada xhigh.
Default API adalah high. Untuk menggunakan xhigh, atur effort secara eksplisit; nilai yang Anda berikan akan menggantikan default.
| Effort | Panduan untuk Claude Opus 4.7 |
|---|---|
low | Efisien, tetapi paling baik untuk tugas pendek dan terbatas. Pasangkan low dengan checklist eksplisit jika tugas Anda memiliki beberapa bagian. |
medium | Pilihan langsung untuk alur kerja rata-rata di mana Anda menginginkan hasil yang baik sambil mengurangi biaya. |
high | Kasus penggunaan lanjutan yang masih memerlukan keseimbangan antara kecerdasan dan konsumsi token. Ini sering kali merupakan keseimbangan terbaik antara kualitas dan efisiensi token. |
xhigh | Titik awal yang direkomendasikan untuk pekerjaan coding dan agentic, serta untuk tugas eksploratif seperti pemanggilan alat berulang, pencarian web terperinci, dan pencarian basis pengetahuan. Harapkan penggunaan token yang jauh lebih tinggi daripada high. |
max | Simpan untuk masalah yang benar-benar di garis depan. Pada sebagian besar beban kerja, max menambah biaya signifikan untuk peningkatan kualitas yang relatif kecil, dan pada beberapa tugas output terstruktur atau yang kurang sensitif terhadap kecerdasan, ini dapat menyebabkan overthinking. |
Claude Opus 4.7 juga mematuhi tingkat effort lebih ketat daripada Claude Opus 4.6, terutama pada low dan medium. Pada tingkat effort yang lebih rendah, model membatasi pekerjaannya pada apa yang diminta daripada melakukan lebih dari yang diminta. Jika Anda mengamati penalaran yang dangkal pada masalah kompleks dengan Claude Opus 4.7, naikkan effort daripada mengatasinya melalui prompting. Jika Anda harus menjaga effort tetap rendah untuk latensi, tambahkan panduan yang ditargetkan seperti "Tugas ini melibatkan penalaran multilangkah. Pikirkan dengan cermat sebelum merespons."
Saat menjalankan Claude Opus 4.7 pada effort xhigh atau max, atur max_tokens yang besar agar model memiliki ruang untuk berpikir dan bertindak di seluruh subagent dan pemanggilan alat. Memulai dari 64k token dan menyesuaikan dari sana adalah default yang wajar.
Panduan untuk Claude Opus 4.7 juga berlaku untuk Claude Opus 4.8. Mulai dengan xhigh untuk kasus penggunaan coding dan agentic, gunakan high untuk sebagian besar beban kerja lain yang sensitif terhadap kecerdasan, dan turunkan ke medium atau low hanya ketika Anda telah mengukur bahwa tingkat yang lebih rendah mempertahankan kualitas pada evaluasi Anda.
Default API adalah high. Atur effort secara eksplisit untuk menggunakan tingkat yang berbeda; nilai yang Anda berikan akan menggantikan default.
Saat menjalankan Claude Opus 4.8 pada effort xhigh atau max, atur max_tokens yang besar agar model memiliki ruang untuk berpikir dan bertindak di seluruh subagent dan pemanggilan alat. Memulai dari 64k token dan menyesuaikan dari sana adalah default yang wajar.
Claude Opus 5 mendukung kelima tingkat effort. Mulai dengan high, default, dan sesuaikan berdasarkan evaluasi Anda: naikkan ke xhigh untuk pekerjaan coding dan agentic yang menuntut, atau ke max ketika suatu tugas membenarkan penggunaan token tanpa batasan, dan gunakan low dan medium secara bebas sebagai kontrol utama Anda untuk biaya token dan waktu respons di mana pun evaluasi Anda menunjukkan kualitas tetap terjaga. Jika Anda membawa pengaturan effort dari model sebelumnya, jalankan sweep effort baru pada evaluasi Anda daripada menggunakannya kembali.
Effort mengontrol volume thinking, bukan panjang respons yang terlihat: pada Claude Opus 5, mengubah effort tidak secara andal mempersingkat respons, jadi gunakan prompt untuk panjang sebagai gantinya.
Default API adalah high. Atur effort secara eksplisit untuk menggunakan tingkat yang berbeda; nilai yang Anda berikan akan menggantikan default.
Pada Claude Opus 5, thinking tidak dapat dinonaktifkan pada effort xhigh atau max: permintaan yang mengatur thinking: {"type": "disabled"} pada tingkat tersebut akan mengembalikan error 400. Lihat Effort dengan thinking.
Saat menjalankan Claude Opus 5 pada effort xhigh atau max, atur max_tokens yang besar agar model memiliki ruang untuk berpikir dan bertindak di seluruh subagent dan pemanggilan alat. Memulai dari 64k token dan menyesuaikan dari sana adalah default yang wajar.
Effort adalah kontrol utama untuk menukar antara kecerdasan, latensi, dan biaya pada Claude Fable 5. Mulai dengan high, default, untuk sebagian besar tugas, gunakan xhigh untuk beban kerja yang paling sensitif terhadap kemampuan, dan turunkan ke medium atau low untuk pekerjaan rutin. Pengaturan effort yang lebih rendah pada Claude Fable 5 tetap berkinerja baik dan sering kali melampaui performa xhigh pada model sebelumnya. Pada high dan xhigh, atur max_tokens yang besar: ini adalah batas keras pada total output, thinking ditambah teks respons. Lihat Kontrol biaya.
Kurangi effort jika suatu tugas selesai tetapi memakan waktu lebih lama dari yang diperlukan, atau jika Anda menginginkan gaya kerja yang lebih cepat dan lebih interaktif. Rekomendasi yang sama berlaku untuk Claude Mythos 5. Untuk panduan yang lebih lengkap, lihat Prompting Claude Fable 5.
Saat menggunakan alat, parameter effort memengaruhi baik penjelasan di sekitar pemanggilan alat maupun pemanggilan alat itu sendiri. Tingkat effort yang lebih rendah cenderung:
Tingkat effort yang lebih tinggi mungkin:
Parameter thinking mengontrol apakah Claude berpikir dalam blok pemikiran sebelum menjawab; parameter effort mengontrol seberapa banyak upaya yang Claude curahkan untuk keseluruhan respons, yang dalam mode adaptif mencakup seberapa sering dan seberapa dalam Claude berpikir. Jangan meneruskan adaptive sebagai nilai effort: adaptive adalah mode berpikir, bukan tingkat effort.
Pada tingkat effort yang lebih tinggi, Claude berpikir pada sebagian besar permintaan dan dengan lebih panjang; pada tingkat yang lebih rendah, Claude dapat melewati thinking sepenuhnya untuk masalah yang lebih sederhana. Lihat Thinking dan effort untuk panduan lengkap tentang bagaimana kedua kontrol ini bekerja bersama.
Pada Claude Opus 4.5, satu-satunya model khusus pemikiran diperpanjang yang mendukung effort, ini bekerja bersama budget_tokens: atur tingkat effort untuk tugas Anda, lalu atur anggaran token thinking berdasarkan seberapa banyak kedalaman penalaran yang dibutuhkan tugas tersebut.
Untuk ketersediaan thinking per model, lihat tabel konfigurasi per model. Effort bekerja dengan atau tanpa thinking; lihat Cara kerja effort.
output_config.effort adalah pengaturan tingkat permintaan: setiap permintaan membawa nilainya sendiri, jadi untuk menjalankan bagian percakapan selanjutnya pada tingkat effort yang berbeda, atur nilai baru pada permintaan berikutnya. Tingkat effort berlaku untuk seluruh permintaan. Karena effort membentuk prompt yang dirender, mengubahnya di antara permintaan tidak mempertahankan prefiks yang di-cache dari giliran sebelumnya; jika Anda mengandalkan caching prompt di sepanjang sesi yang panjang, pilih tingkat effort di awal dan pertahankan konstan.
high, tetapi titik awal yang tepat bergantung pada model dan beban kerja Anda.Berikan Claude anggaran token advisory untuk seluruh loop agentic guna membantu model mengatur diri sendiri pada tugas agentic yang panjang.
Pahami adaptive thinking, di mana Claude memutuskan kapan dan seberapa banyak untuk berpikir, dan arahkan dengan effort dan prompting.
Pahami cara kerja thinking, kapan Claude berpikir secara default, dan bagaimana thinking berinteraksi dengan effort.
| Supported models |
|
|---|---|
| Supported platforms |
|
Was this page helpful?
| Tugas yang lebih sederhana yang membutuhkan kecepatan terbaik dan biaya terendah, seperti subagent |
client = anthropic.Anthropic()
response = client.messages.create(
model="claude-opus-5",
max_tokens=4096,
messages=[
{
"role": "user",
"content": "Analyze the trade-offs between microservices and monolithic architectures",
}
],
output_config={"effort": "medium"},
)
for block in response.content:
if block.type == "text":
print(block.text)