Claude Code Subagents dan Tim Agen: Panduan Praktis

Anda telah melihat kata "subagents," "Tim Agen," "orkestrasi," dan bertanya-tanya apakah Anda melewatkan sesuatu. Jawaban singkatnya: untuk sebagian besar tugas Anda, tidak. Tetapi untuk pekerjaan besar, ya, dan itu layak untuk dipahami.

Mari kita jelaskan tanpa jargon.

Apa sebenarnya subagent itu

Subagent adalah asisten khusus dengan konteksnya sendiri, promptnya sendiri, dan izin alatnya sendiri.

Ketika agen utama menghadapi sub-tugas yang terdefinisi dengan baik, ia mendelegasikannya ke subagent. Subagent tersebut bekerja dalam jendela konteksnya sendiri, melakukan tugasnya, dan hanya mengembalikan hasilnya. Agen utama tidak mendapatkan seluruh riwayat yang mengotori konteksnya, ia mendapatkan kesimpulannya.

Itulah intinya: menjaga konteks agen utama tetap bersih. Alih-alih satu agen tenggelam dalam 50.000 token pencarian file, Anda memiliki subagent yang melakukan pencarian dan melaporkan kembali tiga baris yang berguna.

Anda mendeklarasikan subagents Anda di folder .claude/agents/ proyek Anda. Masing-masing memiliki nama, deskripsi yang menjelaskan kapan harus menggunakannya, dan prompt sistem.

---
name: test-writer
description: Gunakan ketika tes perlu ditulis atau diperbaiki
---
Anda menulis tes. Anda bertujuan untuk cakupan kasus tepi,
bukan jalur bahagia. Anda tidak pernah menyentuh kode produksi.

Tim Agen, langkah berikutnya

Tim Agen adalah orkestrator multi-agen yang dibangun ke dalam Claude Code. Masih eksperimental, dinonaktifkan secara default, tetapi merupakan titik masuk yang solid.

Idenya: agen utama membagi tugas besar, mendelegasikan setiap bagian ke agen spesialis (dengan model, prompt, alatnya sendiri), para spesialis bekerja secara paralel pada sistem file bersama, dan hasilnya mengalir kembali ke agen utama.

Jika "mendelegasikan ke spesialis" terdengar seperti subagents, itu normal. Tim Agen adalah ide tersebut yang didorong hingga menjalankan beberapa agen benar-benar secara paralel, bukan hanya satu demi satu.

Selain yang bawaan, ada orkestrator pihak ketiga seperti Multiclaude dan Gas Town. Mereka berpendapat, yang membuat mereka menjadi titik awal yang baik ketika Anda memulai: mereka memutuskan untuk Anda sampai Anda membangun kebiasaan Anda sendiri.

Kapan Anda membutuhkannya (dan kapan tidak)

Mari kita perjelas: orkestrasi multi-agen tidak berguna untuk 95% tugas yang dibantu agen. Untuk sebagian besar pekerjaan harian Anda, satu agen lebih cepat dan lebih sederhana.

Saat ini, multi-agen masih merupakan cara yang mahal dan eksperimental untuk menangani proyek besar.

Anda membutuhkannya ketika:

• Proyek terbagi menjadi bagian-bagian yang benar-benar independen yang menyentuh file yang berbeda.
• Satu jendela konteks tidak dapat menampung semuanya.
• Anda ingin memparallelkan refaktor yang luas atau migrasi seluruh repositori.

Anda tidak membutuhkannya untuk perbaikan bug, fitur terfokus, atau apa pun yang muat dalam satu kepala.

Perangkapnya adalah memutar tim "sepuluh agen" untuk sesuatu yang dapat dilakukan satu agen dalam lima menit. Anda membayar dalam token dan kompleksitas untuk paralelisme yang tidak pernah diminta oleh tugas tersebut.

Masalah sebenarnya: visibilitas

Inilah yang tidak cukup dibicarakan. Saat Anda menjalankan beberapa subagents atau Tim Agen, Anda kehilangan jejak.

Seorang pemimpin mendelegasikan ke lima spesialis. Yang mana yang sedang bekerja? Yang mana yang selesai? Yang mana yang menunggu keputusan? Di terminal, Anda melihat dinding teks yang bergulir, dan Anda tidak bisa tahu siapa yang melakukan apa.

Di sinilah dasbor visual mengubah segalanya. AgentsRoom menunjukkan setiap agen dan setiap subagent sebagai ubin tersendiri, dengan statusnya dijelaskan. Anda melihat delegasi terjadi, Anda melihat siapa yang menunggu balasan Anda, Anda melihat siapa yang mengalami crash. Dinding teks menjadi peta yang dapat dibaca.

Tanpa tampilan itu, orkestrasi multi-agen tetap menjadi demo yang mengesankan yang tidak dapat dikelola sehari-hari. Dengan itu, ia menjadi alat yang benar-benar Anda gunakan.

Dari mana memulai

Jangan langsung melompat ke tim delapan agen.

Mulailah dengan satu atau dua subagents untuk tugas yang tepat dan berulang: satu yang menulis tes, satu yang mencari basis kode. Anda akan segera merasakan keuntungan pada konteks agen utama Anda.

Setelah mekanisme itu terasa alami, aktifkan Tim Agen untuk pekerjaan yang terbagi dengan jelas. Perhatikan siapa yang melakukan apa, setujui rencana sebelum eksekusi, dan berhenti saat tinjauan menjadi hambatan Anda.

Multi-agen memberi penghargaan kepada orang-orang yang menyusun sebelum mereka meluncurkan. Bukan kepada mereka yang meluncurkan agen terbanyak.