Cara Menggunakan Claude Haiku 5.5 di Claude Code dan sebagai Model Sub-agen Anda

Untuk menggunakan Claude Haiku 5.5 di Claude Code, perbarui ke v2.1.293 atau yang lebih baru dengan claude update, lalu mulai sesi dengan claude --model claude-haiku-5-5 atau jalankan /model claude-haiku-5-5 di dalamnya. Keuntungan yang lebih besar bagi kebanyakan orang adalah menjalankannya sebagai subagen: letakkan model: haiku di file subagen dan biarkan Sonnet 5.5 atau Opus 5.5 menyerahkan pencarian, eksekusi pengujian, dan ringkasan kepadanya. Dengan kunci API, biayanya $0.10/$0.50 per juta token input/output untuk prompt hingga 100K token, dan $0.50/$2.50 di atas itu.

Di bawah ini: pengaturan, jebakan alias haiku, upaya, file subagen, langkah harga 100K, dan kapan Sonnet atau Opus harus memimpin. Untuk model itu sendiri, baca apa itu Claude Haiku 5.5. Jika kode Anda memanggil API, Apidog menyimpan skenario pengujian yang dapat dijalankan subagen Haiku untuk Anda.

Claude Haiku 5.5 di Claude Code Sekilas

Langkah 1: Perbarui Claude Code

Haiku 5.5 memerlukan Claude Code v2.1.293 atau yang lebih baru. Entri changelog menyebutnya "sekarang model Haiku default pada Anthropic API."

claude update

Claude Code tidak tersedia di paket Gratis. Pengguna gratis dapat memilih Haiku 5.5 di aplikasi Claude.ai, tetapi Claude Code memerlukan paket Pro, Max, Team, Enterprise atau kunci API Anthropic. Berdasarkan claude.com/pricing, Pro berharga $17 per bulan jika ditagih setiap tahun atau $20 setiap bulan, dan Max mulai dari $100.

Langkah 2: Pilih Haiku 5.5 sebagai model utama Anda

claude --model claude-haiku-5-5

Dalam sesi yang berjalan, /model claude-haiku-5-5 melakukan hal yang sama. Jika pengaturan model yang Anda simpan adalah haiku, sesi yang disimpan di Haiku 4.5 akan dilanjutkan di Haiku 5.5.

Alias haiku hanya berarti Haiku 5.5 pada Anthropic API

Pada penyedia cloud mana pun, /model haiku dan model: haiku dalam file subagen akan memberi Anda Haiku 4.5. Sebaliknya, sematkan ID lengkapnya di sana: claude-haiku-5-5 di Google Cloud dan Claude Platform di AWS, nama deployment Anda di Foundry, dan ID profil inferensi seperti us.anthropic.claude-haiku-5-5 di Amazon Bedrock. Atau arahkan aliasnya ke sana dengan ANTHROPIC_DEFAULT_HAIKU_MODEL (Langkah 5).

Langkah 3: Pilih tingkat upaya

Haiku 5.5 adalah Haiku pertama dengan kontrol upaya: low, medium, high, xhigh, dan max, dimulai dari medium di Claude Code.

claude --model claude-haiku-5-5 --effort high

Dalam sebuah sesi, /effort low menyimpan level untuk model saat ini. Panduan prompt Anthropic menyarankan low untuk tugas alat pendek dan permintaan volume tinggi, medium untuk sebagian besar pekerjaan, dan high untuk tugas agen yang lebih panjang. Simpan xhigh dan max untuk pekerjaan di mana evaluasi Anda menunjukkan peningkatan.

Berpikir tetap aktif. Anda tidak bisa mematikannya di Haiku 5.5 di Claude Code; alwaysThinkingEnabled: false dan MAX_THINKING_TOKENS=0 tidak berpengaruh. (API Pesan mentah dapat menonaktifkannya pada high atau di bawahnya.) Kurangi upaya saat Anda menginginkan token berpikir yang lebih sedikit.

Langkah 4: Jalankan Haiku 5.5 sebagai subagen

Anthropic mengatakan Haiku 5.5 "sangat cocok dengan Opus 5.5 dan Sonnet 5.5 sebagai subagen untuk pekerjaan coding." Subagen adalah file Markdown dengan frontmatter YAML di .claude/agents/ (proyek) atau ~/.claude/agents/ (semua proyek). Hanya name dan description yang diperlukan, dan dokumen subagen menerima sonnet, opus, haiku, fable, ID model lengkap, atau inherit untuk model. Panduan subagen kami mencakup cakupan dan alat.

Ganti Explore dengan penjelajah murah

Subagen Explore bawaan berjalan pada model percakapan utama, bukan Haiku. Dalam sesi Opus 5.5, setiap pencarian Explore berjalan pada Opus. Subagen pengguna atau proyek bernama Explore akan menimpa yang bawaan dan mempertahankan model-nya sendiri:

---
name: Explore
description: Pencarian codebase cepat hanya-baca. Gunakan untuk menemukan file, simbol, dan situs panggilan tanpa mengedit apa pun.
tools: Read, Grep, Glob
model: haiku
effort: low
---

Anda mencari di codebase dan melaporkan apa yang Anda temukan. Kembalikan jalur file dengan nomor baris dan ringkasan singkat setiap kecocokan. Jangan pernah mengedit file.

Simpan sebagai .claude/agents/Explore.md. Jalankan /tasks saat berfungsi untuk mengonfirmasi model. Pada penyedia cloud, ganti haiku dengan ID lengkap dari Langkah 2.

Paksa setiap subagen menggunakan Haiku

Untuk menjalankan setiap subagen di Haiku, termasuk Explore, atur kedua variabel di blok env file pengaturan:

{
  "env": {
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
    "CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1"
  }
}

CLAUDE_CODE_SUBAGENT_MODEL saja adalah default: bidang model subagen itu sendiri masih menang, dan Explore tidak bergerak.

Langkah 5: Arahkan pekerjaan latar belakang ke Haiku 5.5

ANTHROPIC_DEFAULT_HAIKU_MODEL menetapkan "model yang akan digunakan untuk haiku, atau fungsionalitas latar belakang," seperti meringkas sesi sebelumnya untuk claude --resume. ANTHROPIC_SMALL_FAST_MODEL yang lebih lama sudah tidak digunakan lagi, sesuai dengan referensi variabel lingkungan; ganti jika profil shell Anda masih mengaturnya.

Pada Anthropic API Anda tidak perlu mengatur apa pun. Di Google Cloud, tugas latar belakang defaultnya adalah Sonnet; di Foundry, ke model utama; di Bedrock, ke Sonnet atau model utama. Setelah Haiku 5.5 diaktifkan di akun Anda, sematkan:

# Google Cloud's Agent Platform
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-5-5

# Amazon Bedrock (ID profil inferensi)
export ANTHROPIC_DEFAULT_HAIKU_MODEL=us.anthropic.claude-haiku-5-5

Langkah harga 100K dalam sesi panjang

Harga Haiku 5.5 bergantung pada panjang prompt, dan Claude Code mengirimkan percakapan sebagai prompt pada setiap giliran. Setelah konteks sesi melewati 100K token, setiap permintaan akan ditagih $0.50/$2.50 alih-alih $0.10/$0.50, lima kali lipat tarif prompt pendek. Dokumen tidak menyatakan apakah token yang di-cache dihitung untuk batas tersebut, jadi anggaplah demikian dalam anggaran Anda.

Pemadatan otomatis tidak akan menyelamatkan Anda: Haiku 5.5 secara default melakukan pemadatan sekitar 967K token, sehingga sesi dapat berjalan jauh di atas batas harga terlebih dahulu. Dua kebiasaan yang membantu saat Anda membayar per token:

1. Padatkan lebih awal. /autocompact 100k menetapkan jendela terendah yang diterima Claude Code, sehingga sesi akan memadatkan di dekat batas, bukan di dekat 1M.
2. Dorong pekerjaan besar ke dalam subagen. Subagen memiliki konteksnya sendiri, sehingga log pengujian dan hasil pencarian tetap berada di luar percakapan utama.

Bahkan di atas 100K, $0.50/$2.50 adalah seperempat dari $2/$10 milik Sonnet 5.5. Pada paket berbayar, sesi menggunakan batas penggunaan sebagai gantinya, dan Anthropic belum mempublikasikan bagaimana Haiku 5.5 dihitung terhadap batas tersebut. Rincian harga Haiku 5.5 kami membahas perhitungan tersebut.

Pelanggan Max dan Team: kredit API bulanan baru ($100 di Max 5x, $200 di Max 20x, hingga $500 dikumpulkan di Team) tidak mencakup Claude Code interaktif, sesuai dokumen kredit API Anthropic.

Kapan harus mempertahankan Sonnet 5.5 atau Opus 5.5 sebagai pemimpin

Anthropic mengatakan Sonnet 5.5 dan Opus 5.5 "tetap menjadi pilihan yang lebih baik untuk tugas coding agentik yang kompleks." Pada Terminal-Bench 4.0, yang dijalankan oleh Anthropic di Claude Code dengan upaya maksimal, Haiku 5.5 mencetak 39.2% dibandingkan 70.6% milik Sonnet 5.5. Bagan peluncuran menambahkan biaya per percobaan:

Pada medium, keduanya berharga sekitar sama per percobaan dan Sonnet mencetak skor lebih tinggi. Harga token Haiku tidak berlaku untuk pekerjaan shell yang panjang, jadi jangan menjadikannya pemimpin untuk sesi coding yang sulit.

Penggunaan komputer menceritakan kisah yang berbeda. Pada OSWorld 2.1, Haiku 5.5 pada medium mencetak 53.3% dengan $0.13 per percobaan, sedangkan Sonnet 5.5 pada low mencetak 57.9% dengan $0.68. Rincian benchmark Haiku 5.5 kami memiliki setiap baris, dan panduan Claude Code Sonnet 5.5 mencakup sisi model utama.

Pembagian praktis: Sonnet 5.5 atau Opus 5.5 sebagai model utama, Haiku 5.5 untuk Explore, test runner, pembaca log, dan pengambil dokumen.

Contoh: subagen Haiku yang menjalankan pengujian Apidog Anda

Eksekusi pengujian bertele-tele dan berulang, sangat cocok untuk Haiku. Apidog CLI menjalankan skenario pengujian Apidog yang Anda simpan dari terminal, sehingga subagen dapat menjalankannya dan mengembalikan laporan singkat sementara konteks model utama tetap bersih.

---
name: api-test-runner
description: Menjalankan skenario pengujian Apidog proyek dengan Apidog CLI setelah perubahan endpoint API, lalu melaporkan jumlah lulus dan gagal beserta permintaan yang gagal.
tools: Bash, Read
model: haiku
effort: low
---

Jalankan perintah pengujian Apidog CLI yang didokumentasikan di README repo ini untuk skenario yang mencakup endpoint yang diubah. Laporkan jumlah lulus dan gagal. Untuk setiap kegagalan, berikan nama permintaan, hasil yang diharapkan, dan hasil aktual. Jangan mengedit kode. Jangan mencoba kembali eksekusi yang gagal lebih dari satu kali.

Pengaturan untuk CLI, termasuk otentikasi dan perintah eksekusi, ada di Apidog CLI di Claude Code. Unduh Apidog untuk membangun skenario yang dijalankan subagen.

Migrasi aplikasi dari Haiku 4.5

Jika aplikasi Anda memanggil Haiku 4.5 melalui API, Claude Code dapat memulai migrasinya:

/claude-api migrate this project to claude-haiku-5-5

Harapkan perubahan yang menyebabkan kerusakan: berpikir budget_tokens manual, temperature atau top_p non-default, top_k apa pun, dan pra-pengisian asisten semuanya akan mengembalikan 400 pada Haiku 5.5. Panduan Haiku 5.5 vs Haiku 4.5 mencantumkan setiap perbaikan. Setelah diedit, simpan permintaan lama dan baru sebagai pasangan di Apidog, simpan ANTHROPIC_API_KEY sebagai variabel lingkungan, dan pastikan stop_reason dan usage, sehingga penghentian refusal baru atau lonjakan token akan membuat pengujian gagal alih-alih mencapai produksi.

FAQ

Apakah Haiku 5.5 adalah model default di Claude Code? Tidak. Ini adalah model Haiku default pada Anthropic API, yang berarti alias haiku menunjuk ke sana. Pilih sebagai model utama Anda dengan --model atau /model.

Bisakah saya menggunakan Haiku 5.5 di Claude Code pada paket Gratis? Tidak. Claude Code memerlukan paket berbayar atau kunci API. Pengguna gratis dapat memilih Haiku 5.5 di aplikasi Claude.ai; lihat cara menggunakan Claude Haiku 5.5 secara gratis.

Mengapa model: haiku memberi saya Haiku 4.5? Anda menggunakan Bedrock, Google Cloud, Foundry atau Claude Platform di AWS, atau pada versi sebelum v2.1.293. Sematkan ID lengkapnya atau atur ANTHROPIC_DEFAULT_HAIKU_MODEL.

Bisakah saya mematikan "berpikir" untuk menghemat token? Tidak di Claude Code. Turunkan upaya saja; low adalah pengaturan termurah.

Langkah Anda berikutnya

Jalankan claude update, tambahkan penimpaan Haiku Explore, dan pertahankan model utama Anda saat ini selama seminggu. Kemudian tambahkan subagen test-runner jika proyek Anda memiliki API. Untuk memanggil model dari kode Anda sendiri, mulailah dengan panduan API Haiku 5.5. Apidog gratis untuk memulai dan memberikan pengujian nyata kepada subagen tersebut untuk dijalankan.