Jawaban singkat untuk pertanyaan yang paling sering diajukan pembaca tentang topik ini.
Cara kerja subagent Claude Code, cara mendefinisikannya di .claude/agents/, dan kapan mendelegasikan ke konteks terpisah benar-benar sepadan.
Matthews Wong
Software Engineer
Ringkasan Utama
Subagent Claude Code adalah asisten khusus yang didefinisikan sebagai berkas Markdown di .claude/agents/, masing-masing dengan jendela konteks, system prompt, dan tool yang dibatasi sendiri. Subagent memungkinkan sesi utama mendelegasikan pekerjaan fokus seperti review kode atau riset ke konteks terpisah yang hanya mengembalikan ringkasan, sehingga percakapan utama tetap bersih dan biaya terkendali.
Satu sesi Claude Code mengerjakan semuanya dalam satu jendela konteks, dan jendela itulah sumber dayanya yang paling terbatas. Membaca dua puluh berkas untuk menjawab satu pertanyaan membuat kedua puluh berkas itu tetap ada di konteks, mendesak tugas yang sebenarnya Anda pedulikan. Subagent adalah solusi bawaannya: cara menyerahkan sebagian pekerjaan ke asisten terpisah yang berpikir di jendelanya sendiri dan hanya mengembalikan jawabannya.
Panduan ini membahas apa itu subagent sebenarnya, cara membuatnya, kapan delegasi layak dilakukan, dan bagaimana subagent mengubah biaya sebuah sesi. Contohnya memakai Claude Code, tetapi pola delegasi yang sama berlaku untuk semua tool coding agentik yang mendukung sub-tugas terpisah.
Subagent adalah Claude kedua dengan jendela konteks, system prompt, dan izin miliknya sendiri. Ia tidak bisa melihat percakapan utama Anda, dan percakapan utama tidak bisa melihat catatan kerjanya. Sesi induk menjelaskan sebuah tugas, subagent mengerjakannya secara terpisah, dan hanya ringkasan akhir yang kembali. Isolasi itulah intinya: pekerjaan perantara yang besar tidak pernah menyentuh jendela utama.
Setiap subagent adalah berkas Markdown biasa dengan frontmatter YAML. Tiga bidang menangani sebagian besar tugasnya:
Jalur tercepat adalah perintah /agents, yang memandu Anda membuat agen dan menuliskan berkasnya untuk Anda. Anda juga bisa membuat berkasnya secara manual di .claude/agents/security-reviewer.md dalam proyek, atau di bawah direktori home agar tersedia di mana saja. Frontmatter mengatur agennya; badan berkas adalah system prompt-nya.
Sebuah security reviewer minimal yang dibatasi ketat terlihat seperti ini:
---
name: security-reviewer
description: Reviews diffs for auth, injection and secret-handling issues
tools: Read, Grep, Glob
model: haiku
---
You are a security reviewer. Given a diff, report only concrete,
exploitable issues with a file:line and a one-line fix. Do not
comment on style. If you find nothing, say so plainly.Jaga setiap subagent tetap sempit: satu tugas, satu description tajam, dan set tool terkecil yang dibutuhkannya. Agen serba bisa yang kabur akan terpanggil untuk tugas yang salah dan diam-diam menurunkan kualitas semua yang disentuhnya.
Aturan praktisnya sederhana: delegasikan ketika pekerjaan menghasilkan jauh lebih banyak token daripada nilai kesimpulan yang perlu disimpan. Kandidat yang baik punya bentuk itu.
Dalam praktik, sesi utama menjadi orkestrator. Ia merencanakan pekerjaan, memutuskan bagian mana yang didelegasikan, dan menjahit kembali ringkasannya. Tugas Anda adalah menjelaskan setiap tugas yang didelegasikan dengan baik: nyatakan tujuannya, batasannya, dan bentuk keluaran yang Anda inginkan kembali.
Perlakukan prompt delegasi seperti kontrak API. Subagent yang diminta mengembalikan daftar temuan berperingkat dengan rujukan berkas dan baris memberi Anda sesuatu yang bisa ditindaklanjuti; yang diminta tolong review kode saja memberi Anda esai yang lalu harus Anda urai sendiri.
Subagent tidak berbagi memori percakapan utama. Apa pun yang sudah dipelajari induk harus dinyatakan ulang di prompt delegasi, dan subagent tidak bisa berhenti untuk bertanya lanjutan di tengah tugas, jadi berikan semua yang dibutuhkannya di awal atau ia akan menebak.
Subagent adalah tuas pengeluaran yang bekerja dua arah, dan menganggapnya gratis adalah cara tercepat menuju tagihan yang mengejutkan.
Subagent mengubah Claude Code dari satu asisten menjadi tim kecil yang Anda arahkan. Mulailah dengan dua yang benar-benar akan Anda pakai, penjelajah basis kode dan reviewer diff, jaga masing-masing tetap sempit, dan biarkan sesi utama tetap fokus pada tugas alih-alih tenggelam dalam risetnya sendiri.