Kalau kamu sudah pakai Claude Code untuk coding sehari-hari, kamu tahu modelnya: kamu kasih instruksi, Claude eksekusi, kamu review. Satu agent, satu konteks.
Tapi skenarionya berubah kalau kamu punya proyek yang kompleks — refactor multi-file sekaligus, test suite yang butuh setup berbeda, atau keputusan arsitektur yang butuh perspektif dari sisi frontend dan backend sekaligus.
Di sinilah Agent Teams masuk.
Dari Solo Agent ke Multi-Agent
Claude Code punya dua cara untuk menjalankan beberapa agent sekaligus: Subagents dan Agent Teams.
Subagents itu yang sudah lama ada. Kamu minta Claude Code untuk spawn agent tambahan yang kerjakan tugas spesifik. Hasilnya di-summarize kembali ke kamu. Ringan, cepat, terstruktur — cocok untuk tugas yang fokus dan hasilnya yang mattered.
Agent Teams adalah fitur baru. Bedanya: setiap teammate punya konteks sendiri, bisa komunikasi langsung satu sama lain, dan mengkoordinasikan diri lewat shared task list. Lebih berat dari sisi token, tapi lebih powerful untuk pekerjaan yang butuh kolaborasi.
Apa Bedanya dengan Subagents?
| Aspek | Subagents | Agent Teams |
|---|---|---|
| Konteks | Jendela sendiri, hasil di-summarize ke caller | Jendela sendiri, sepenuhnya independen |
| Komunikasi | Laporkan hasil ke main agent saja | Pesan langsung antar teammate |
| Koordinasi | Main agent tangani semua kerjaan | Shared task list dengan self-coordination |
| Cocok untuk | Tugas fokus, hasilnya yang penting | Pekerjaan kompleks yang butuh diskusi |
| Biaya token | Lebih rendah | Lebih tinggi (tiap teammate instance terpisah) |
| Setup | Tidak ada (bawaan Claude Code) | Perlu enable environment variable |
| Contoh penggunaan | Code review, analisis file, research | Multi-component features, debates, refactors lintas layer |
Cara Setup Agent Teams
Langkah 1: Enable Feature
Set environment variable di shell kamu:
1export CLAUDE_CODE_TEAM_MODE=trueAtau tambahkan ke settings.json supaya persist di semua sesi:
1{
2 "teamMode": true
3}Langkah 2: Definisikan Tugas dan Struktur Tim
Bicara ke Claude dalam bahasa natural. Specify peran dan scope:
1" Saya punya monorepo Next.js + Express. Kita perlu:
2- 1 teammate untuk setup CI/CD pipeline
3- 1 teammate untuk refactor authentication module
4- Saya sebagai lead untuk mengkoordinasikan"
5
6Tekan Enter, dan lead agent akan membentuk tim dalam 20-30 detik.Langkah 3: Monitor dan Steer
Agent akan mulai bekerja. Kamu bisa:
/team— lihat siapa yang aktif dan status tugas/task {task-id}— cek detail task tertentu- Kirim pesan langsung ke teammate tertentu
- Broadcast ke seluruh tim (的使用小心, biaya naik dengan jumlah teammate)
Cara Kerja Tim
Konfigurasi tim live di lokal:
- Team config:
~/.claude/teams/{team-name}/config.json - Task list:
~/.claude/tasks/{team-name}/
Setiap teammate saat di-spawn akan memuat konteks yang sama: CLAUDE.md, MCP servers, dan skills yang kamu punya. Ini artinya teammate tidak perlu starting from scratch — mereka tahu struktur proyek kamu.
Permission — teammate mulai dengan permission settings dari lead. Kamu bisa ubah mode individual teammate setelah mereka di-spawn, tapi tidak bisa set di awal saat spawn.
Komunikasi:
- Direct messages — ke satu teammate tertentu
- Broadcast — ke seluruh tim (expensive, use sparingly)
- Shared task list — tugas di-assign, di-update, di-mark selesai oleh teammate sendiri
- Idle notifications — teammate kirim notifikasi ke lead kalau lagi idle atau butuh input
Use Case yang Tepat
Gunakan Agent Teams kalau:
- Kamu sedang kerjakan multi-component feature yang butuh koordinasi antar bagian berbeda
- Kamu butuh perspektif berbeda (frontend vs backend vs DevOps) sekaligus
- Kamu mau refactor besar yang menyentuh banyak file sekaligus dan perlu konsistensi
- Kamu mau lakukan "debate" antara dua pendekatan dan biarkan tim pilih yang terbaik
Jangan gunakan Agent Teams kalau:
- Tugasnya sederhana dan fokus — Subagent sudah cukup
- Kamu di lingkungan dengan budget token yang ketat (3 teammate = 3-4x biaya vs sequential)
- Kamu cuma butuh context tambahan (gunakan
/readatau Subagent saja)
Yang Perlu Diperhatikan
Biaya token naik signifikan. Satu teammate menggunakan konteks sendiri. Tiga teammate yang kerja parallel menggunakan roughly 3-4x token dibandingkan satu agent yang kerja sequential. Untuk proyek besar, ini worth it. Untuk tugas trivial, overkill.
Struktur CLAUDE.md penting. Shared context adalah kunci. CLAUDE.md yang well-structured dengan boundary modul, verification commands, dan konteks operasional akan mengurangi biaya per-teammate karena mereka tidak perlu explore codebase sendiri-sendiri.
Komunikasi perlu managed. Broadcast ke seluruh tim itu menggoda, tapi setiap broadcast = semua teammate dipanggil = biaya naik. Gunakan direct messages atau shared task list saja.