Edisi Markdown

AI-translated from English; not yet reviewed by a fluent editor.

# Delegasikan satu tugas pemrograman Claude Code dari Opus ke Haiku dan verifikasi hasilnya

> Alur kerja Claude Code berdasarkan dokumentasi untuk mengirim satu perubahan kode terbatas dari agen induk Opus ke subagen Haiku proyek, memeriksa model dan diff yang sebenarnya, serta menafsirkan penggunaan tanpa mengasumsikan penghematan.

By BIG CHANGE Editorial

Published: 2026-10-20T10:17:38.691Z
Updated: 2026-10-20T10:17:38.691Z
Canonical: https://bigchange.ai/blog/claude-code-opus-haiku-subagent-coding-guide

![Conceptual charcoal illustration of a reviewer using a laptop trackpad beside a generic two-column code diff with one orange changed section.](https://bigchange.ai/api/media/file/opus-haiku-diff-review-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE.

Claude Code dapat memberikan model dan alat tersendiri kepada subagen proyek, sementara percakapan utama menangani perencanaan dan peninjauan. Untuk satu perubahan repositori yang diizinkan, agen induk Opus dapat mengirim langkah implementasi terbatas ke Haiku. Hasil yang berguna adalah perubahan kode yang telah diperiksa dan catatan model yang benar-benar dijalankan. Pengaturan model yang lebih murah saja tidak membuktikan penghematan.

## Perubahan utama

- **Apa yang berubah:** Berkas agen proyek dapat meminta `model: haiku` untuk pekerja pemrograman bernama tertentu sementara sesi induk menggunakan Opus.
- **Mengapa penting:** Agen induk dapat meninjau tugas pekerja yang lebih kecil, tetapi pengembang tetap menentukan apakah diff memenuhi pemeriksaan penerimaan semula.
- **Yang perlu diperhatikan:** Penggantian model, kebijakan organisasi, izin, peninjauan, dan percobaan ulang dapat mengubah model yang sebenarnya serta total penggunaan. Verifikasi semuanya sebelum mengklaim manfaat biaya.

## Mulai dari tugas yang sudah menjadi tanggung jawab Anda

Anda memerlukan repositori Git yang Anda kelola, izin mengubahnya, akses Claude Code ke kedua keluarga model, dan satu perubahan yang diizinkan dengan cakupan cukup kecil untuk dinilai melalui diff. Catat commit awal, berkas atau perilaku yang termasuk cakupan, perintah penerimaan yang sudah ada, serta arti hasil lulus. Gunakan checkout bersih untuk pelaksanaan. Perintah harus berasal dari proyek Anda; panduan ini tidak dapat memberikan pengujian bermakna untuk repositori yang tidak diketahui.

Periksa `claude --version`, penyedia dan skema penagihan Anda, serta pembatasan model yang berlaku sebelum memulai. Pada Anthropic API, alias saat ini `opus` dan `haiku` mengarah ke Opus 5.5 (`claude-opus-5-5`) dan Haiku 5.5 (`claude-haiku-5-5`); pasangan ini memerlukan Claude Code v2.1.293 atau lebih baru. Penyedia lain dapat memetakan alias yang sama ke generasi sebelumnya. Kebijakan organisasi `availableModels` dapat memblokir atau mengganti pilihan. Gunakan `/model` pada sesi utama dan catat model induk persis seperti yang ditampilkan. Tentukan anggaran yang diizinkan dan periksa kontrol akun atau penyedia yang sebenarnya; instruksi kepada model tidak menjamin batas pengeluaran. [Dokumentasi konfigurasi model Anthropic](https://code.claude.com/docs/en/model-config) menjelaskan pemetaan dan pembatasan saat ini.

## 1. Tetapkan pekerja Haiku proyek

Buat berkas dengan nama unik seperti `.claude/agents/bounded-code-worker.md` di dalam proyek, tinjau berkas tersebut, lalu mulai agen induk Opus dengan `claude --model opus` atau pilih Opus menggunakan `/model`. Contoh ini adalah definisi pekerja, bukan tugas pengujian:

```markdown
---
name: bounded-code-worker
description: Implements one explicitly bounded, authorized repository change and reports the diff and checks for parent review.
model: haiku
tools: Read, Glob, Grep, Edit, Bash
permissionMode: default
---
```

Tambahkan instruksi sistem dalam bahasa biasa berikut tepat setelah penutup `---` dalam berkas agen: Implementasikan hanya tugas dan cakupan berkas yang diberikan induk. Sebelum menyunting, periksa kode terkait dan pemeriksaan penerimaan yang disebutkan. Jika tugas, izin, atau masukan wajib tidak tersedia, berhenti dan laporkan kekurangannya. Buat perubahan relevan sekecil mungkin. Jalankan pemeriksaan semula jika diizinkan; laporkan perintah dan hasilnya secara tepat. Kembalikan daftar berkas yang diubah, tujuan diff, kegagalan tersisa, dan pekerjaan yang tidak dapat diverifikasi. Jangan membuat commit, menerbitkan, melakukan deployment, atau memperluas tugas tanpa wewenang tegas.

Daftar `tools` menyediakan alat; daftar itu **tidak** membatasi pembacaan atau perintah shell hanya ke jalur yang disebutkan. Periksa izin proyek dan organisasi yang berlaku, terutama akses shell, sebelum mendelegasikan. Pertahankan induk dalam mode izin Manual/default untuk prosedur ini: dokumentasi Anthropic menyatakan bahwa induk dalam mode `acceptEdits`, `auto`, atau `bypassPermissions` mengganti pengaturan pekerja `permissionMode`. Jika ini berkas pertama dalam direktori agents yang baru dibuat, mulai ulang Claude Code bila agen tidak muncul. [Manual subagen](https://code.claude.com/docs/en/sub-agents) menjelaskan kontrol tersebut.

Pengaturan opsional `isolation: worktree` memberikan checkout terpisah kepada pekerja. Titik awal yang didokumentasikan adalah branch bawaan repositori, yang mungkin berbeda dari commit induk saat ini. Bandingkan revisi awal tersebut dengan dasar tugas yang Anda catat sebelum memakai atau membandingkan perubahannya. Checkout bersih yang diizinkan tetap diperlukan untuk pemeriksaan penerimaan semula.

## 2. Delegasikan, periksa, lalu terima atau tolak

Berikan instruksi kepada induk yang terhubung dengan tugas nyata, menggunakan batas berkas dan perintah pemeriksaan Anda sendiri:

> Rencanakan perubahan yang diizinkan ini secara singkat. Delegasikan hanya implementasi yang disebutkan kepada `bounded-code-worker`. Pertahankan kriteria penerimaan semula dan peninjauan akhir pada dirimu. Setelah pekerja kembali, tunjukkan diff serta hasil pemeriksaannya secara tepat. Jangan menerima atau memperluas perubahan sampai saya meninjaunya.

Selagi pekerja berjalan, buka `/tasks` dan catat model yang ditampilkan pada barisnya. Itulah pemeriksaan saat berjalan; kata `haiku` dalam berkas agen atau instruksi hanyalah permintaan. Claude Code v2.1.242 atau lebih baru menampilkan model yang berjalan di sana. Tugas latar belakang yang selesai tetap berada dalam `/tasks` selama sekitar 30 detik, jadi segera periksa dan simpan transkripnya. Jika baris itu terlewat, tandai verifikasi model sebagai belum lengkap alih-alih menyimpulkannya dari berkas.

Baca diff yang sebenarnya, periksa setiap berkas yang diubah, dan jalankan sendiri perintah penerimaan **semula** dalam checkout yang Anda kelola. Tambahkan pemeriksaan terarah bila perubahan memerlukannya. Terima hasil hanya jika perilaku, cakupan, dan pemeriksaan sesuai dengan tugas. Jika pekerja berhenti lebih awal atau mengembalikan pekerjaan sebagian, periksa perubahannya sebelum melanjutkan atau memperbaiki. Jika memakai worktree terpisah, tinjau perubahan tersebut sebelum memasukkannya ke checkout utama.

Untuk pendekatan terkait dalam memeriksa satu kegagalan repositori dengan asisten AI, lihat [panduan perbaikan dan verifikasi AI Goal](https://bigchange.ai/blog/ai-goal-failing-repository-check-guide) kami. Alur itu tidak mengatur delegasi Opus ke Haiku yang digunakan di sini.

Jika `/tasks` menampilkan model berbeda atau peringatan penggantian, periksa argumen model dalam pemanggilan, frontmatter agen, `CLAUDE_CODE_SUBAGENT_MODEL`, dan daftar model terkelola. Dalam Claude Code saat ini, model pemanggilan didahulukan daripada frontmatter, lalu nilai bawaan lingkungan, kemudian model induk; sebelum v2.1.251, pengaturan lingkungan didahulukan. `CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1` (v2.1.257+) dapat mengganti definisi, dan hook mod yang terpasang `agent.spawn` dapat mengganti model pemanggilan. Perbaiki sumber penggantian yang sebenarnya atau hentikan pelaksanaan. Jangan memberi label Haiku pada hasil yang bukan dari Haiku.

## 3. Catat penggunaan tanpa mengarang penghematan

Ambil pembacaan `/usage` sebelum dan sesudah sesi terkendali ini. Catat token masukan, keluaran, dan cache per model, estimasi biaya yang ditampilkan, penyedia atau paket, diff yang diterima, hasil pemeriksaan semula, serta peninjauan atau pengerjaan ulang yang dibutuhkan. Blok Session menggabungkan seluruh sesi per model; ini bukan tagihan tepat untuk pekerja bernama tersebut. Persentase atribusi paket adalah perkiraan riwayat hari atau minggu setempat, bukan pengukuran tugas tunggal ini. Untuk akun API, Claude Console menjadi sumber penagihan resmi. Pada langganan, estimasi dolar sesi bukan tambahan tagihan. Tandai tampilan penggunaan terakhir yang diketahui sebagai data usang.

Untuk mengklaim delegasi menghemat uang pada **tugas ini**, bandingkan dengan pelaksanaan satu model yang diizinkan secara terpisah dari revisi awal bersih yang sama, dengan tugas dan kriteria penerimaan yang sama. Hitung perencanaan dan peninjauan induk, panggilan pekerja, percobaan ulang, dan seluruh pengerjaan ulang; bandingkan hanya hasil yang diterima. Satu pasang pelaksanaan tetap merupakan pengamatan khusus tugas tersebut. Tanpa dasar pembanding seperti itu, laporkan jalur model dan hasil kode yang telah diverifikasi; penghematan tidak diketahui. [Panduan biaya Anthropic](https://code.claude.com/docs/en/costs) menjelaskan tampilan penggunaan dan batas penagihan.

Prosedur ini berdasarkan dokumentasi saat ini, bukan pelaksanaan Claude Code oleh BIG CHANGE atau pengukuran suatu tugas. Jangan kirim kode atau rahasia yang belum disetujui organisasi untuk penyedia yang dikonfigurasi. Jalur di sini menggunakan pilihan Opus dan Haiku bawaan Claude Code; penyedia model lain memerlukan gateway atau alur orkestrasi yang ditetapkan secara terpisah beserta pemeriksaannya sendiri.

## Sumber dan bacaan lanjutan

- [Anthropic, Membuat subagen khusus](https://code.claude.com/docs/en/sub-agents) — berkas agen proyek, prioritas model, `/tasks`, izin, dan perilaku worktree. Manual terkini diperiksa pada 20 Oktober 2026; dokumen ini menjelaskan fitur, bukan hasil contoh panduan yang belum dijalankan.
- [Anthropic, Konfigurasi model](https://code.claude.com/docs/en/model-config) — alias saat ini, perbedaan penyedia, persyaratan versi, dan kontrol model terkelola. Konfirmasikan versi terpasang dan penyedia saat penggunaan.
- [Anthropic, Mengelola biaya secara efektif](https://code.claude.com/docs/en/costs) — `/usage`: kolom, estimasi, dan langganan dibandingkan penagihan API. Ini tidak membuktikan penghematan untuk tugas tersebut.
- [Anthropic, Mengatur izin](https://code.claude.com/docs/en/permissions) — aturan izin alat yang berlaku dan perlu diperiksa sebelum menjalankan pekerja yang mengubah kode.

## Sources

- [Membuat subagen khusus — Dokumentasi Claude Code](https://code.claude.com/docs/en/sub-agents) — Manual utama produk untuk berkas agen proyek, frontmatter, prioritas dan penggantian model, pembacaan /tasks, pewarisan izin, dan perilaku worktree. Ini tidak memverifikasi tugas atau penghematan yang belum dijalankan dalam panduan ini.
- [Konfigurasi model — Dokumentasi Claude Code](https://code.claude.com/docs/en/model-config) — Sumber utama alias dan ID Opus serta Haiku saat ini pada Anthropic API, perbedaan pemetaan penyedia, versi minimum, dan pembatasan availableModels terkelola. Pembaca harus memeriksa pemetaan lokal yang sebenarnya.
- [Mengelola biaya secara efektif — Dokumentasi Claude Code](https://code.claude.com/docs/en/costs) — Menjelaskan kolom token sesi dan estimasi /usage, atribusi paket lokal, tampilan usang, langganan dibandingkan penagihan API, dan Console sebagai sumber penagihan resmi. Ini tidak menghasilkan tagihan tepat untuk pekerja bernama atau penghematan tugas yang terukur.
- [Mengatur izin — Dokumentasi Claude Code](https://code.claude.com/docs/en/permissions) — Menjelaskan aturan izin shell dan berkas yang berlaku bagi pekerja pengubah kode. Daftar alat subagen saja bukan batas jalur sistem berkas.