Catatan Penulis: Panduan langkah demi langkah untuk mengaktifkan dan menggunakan fitur kolaborasi multi-agen Claude 4.6 Agent Teams, menguasai arsitektur Lead + Teammate, alokasi tugas, komunikasi pesan, dan teknik praktisnya.
Saat Claude Opus 4.6 dirilis, fitur Agent Teams (Tim Agen) juga diluncurkan secara bersamaan, memungkinkan beberapa instans Claude bekerja secara paralel layaknya tim pengembangan sungguhan. Banyak pengembang yang penasaran: Bagaimana cara mengaktifkan Agent Teams? Bagaimana cara memicunya? Apa bedanya dengan Subagent? Dan skenario apa yang cocok untuk fitur ini?
Nilai Inti: Setelah membaca artikel ini, Anda akan menguasai alur penggunaan lengkap Agent Teams—mulai dari konfigurasi awal hingga perintah pemicu, dari alokasi tugas hingga kolaborasi tim, sehingga Anda bisa langsung mempraktikkan pemrograman multi-agen.
Apa itu Claude Agent Teams
Agent Teams adalah fitur eksperimental Claude Code (tahap pratinjau riset) yang memungkinkan Anda menjalankan beberapa instans Claude Code yang independen secara bersamaan dalam satu proyek. Mereka berkolaborasi melalui daftar tugas bersama dan sistem pesan.
Penjelasan Sederhana: Agent Teams = satu Lead (ketua tim) + beberapa Teammate (rekan tim), masing-masing bekerja secara mandiri, saling berkomunikasi, dan bersama-sama menyelesaikan tugas yang kompleks.
| Dimensi Perbandingan | Subagent (Sub-agen) | Agent Teams (Tim Agen) |
|---|---|---|
| Metode Komunikasi | Hanya melapor ke Agent utama | Rekan tim bisa berkomunikasi langsung |
| Metode Koordinasi | Agent utama mengatur segalanya | Daftar tugas bersama + klaim mandiri |
| Konteks | Konteks independen, hasil dikembalikan ke pemanggil | Konteks independen, otonomi penuh |
| Skenario Terbaik | Tugas terfokus yang hanya butuh hasil | Tugas kompleks yang butuh diskusi dan kolaborasi |
| Konsumsi Token | Lebih rendah (hasil diringkas ke konteks utama) | Lebih tinggi (setiap rekan tim adalah instans Claude independen) |
Arsitektur Inti Claude Agent Teams
Agent Teams terdiri dari 4 komponen utama:
| Komponen | Tanggung Jawab | Penjelasan |
|---|---|---|
| Lead Agent | Ketua Tim | Sesi Claude Code utama Anda, bertanggung jawab membuat tim, membagi tugas, dan merangkum hasil |
| Teammate | Rekan Tim | Instans Claude Code independen yang masing-masing menjalankan tugas yang diberikan |
| Task List | Daftar Tugas Bersama | Papan tugas yang terlihat oleh semua orang, mendukung klaim, dependensi, dan pelacakan status |
| Mailbox | Sistem Pesan | Saluran komunikasi antar rekan tim, mendukung pesan pribadi dan siaran (broadcast) |
💡 Perbedaan Kunci: Subagent menggunakan mode "laporan bawahan", sedangkan Agent Teams menggunakan mode "kolaborasi tim". Jika tugas Anda membutuhkan diskusi antar beberapa orang, saling menantang argumen, atau memproses modul yang berbeda secara paralel, Agent Teams adalah pilihan yang lebih baik.
Cara Mengaktifkan Claude Agent Teams
Agent Teams secara default dalam kondisi nonaktif, jadi kamu perlu mengaktifkannya secara manual. Berikut adalah 3 cara untuk mengaktifkannya:
Langkah 1: Aktifkan Fitur Eksperimental
Cara A — File Konfigurasi (Direkomendasikan)
Tambahkan kode berikut ke dalam settings.json di Claude Code:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}
Cara B — Variabel Lingkungan (Environment Variables)
# Tambahkan ke .bashrc atau .zshrc
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
Cara C — Sesi Tunggal
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude
Langkah 2: Gunakan Bahasa Alami untuk Memicu Agent Teams
Tidak ada perintah garis miring seperti /agent-teams. Setelah fitur diaktifkan, kamu hanya perlu mendeskripsikan tim yang kamu inginkan dengan bahasa alami:
Buat sebuah agent team untuk meninjau PR #142. Hasilkan tiga peninjau:
- Satu fokus pada celah keamanan
- Satu memeriksa dampak performa
- Satu memverifikasi cakupan pengujian
Biarkan mereka meninjau secara terpisah lalu laporkan temuannya.
Atau lebih sederhana lagi:
Create a team with 4 teammates to refactor these modules in parallel.
Use Sonnet for each teammate.
Claude akan secara otomatis membuat tim, menghasilkan rekan tim, dan membagi tugas. Claude juga mungkin menyarankan secara proaktif untuk membuat tim—jika ia menilai tugasmu cocok untuk dikerjakan secara paralel, namun ia akan meminta konfirmasi darimu terlebih dahulu.
Langkah 3: Pilih Mode Tampilan
| Mode Tampilan | Penjelasan | Lingkungan yang Sesuai |
|---|---|---|
| in-process (default) | Semua rekan tim berjalan di terminal utama | Terminal apa pun, termasuk VS Code |
| tmux | Setiap rekan tim memiliki panel independen | Membutuhkan tmux atau iTerm2 |
| auto | Penentuan otomatis | Jika sudah di dalam tmux maka akan bagi layar (split screen), jika tidak maka in-process |
# Menentukan melalui baris perintah (CLI)
claude --teammate-mode tmux
# Atau atur di settings.json
{
"teammateMode": "tmux"
}
Saran: Untuk penggunaan pertama kali, disarankan menggunakan mode in-process. Setelah terbiasa, baru coba mode bagi layar tmux. Dengan mendapatkan kuota Claude API melalui APIYI (apiyi.com), kamu bisa menguji berbagai konfigurasi Agent Teams secara maksimal di lingkungan lokal.
Panduan Operasional Claude Agent Teams
Pintasan Keyboard Cepat
Saat Agent Teams sedang berjalan, Anda dapat menggunakan pintasan keyboard berikut:
| Pintasan | Fungsi |
|---|---|
| Shift+Up/Down | Mengganti/memilih rekan tim yang berbeda |
| Enter | Melihat detail percakapan rekan tim yang dipilih |
| Escape | Menghentikan operasi rekan tim saat ini |
| Ctrl+T | Mengganti tampilan daftar tugas |
| Shift+Tab | Mengganti mode delegasi (Lead hanya berkoordinasi, tidak melakukan coding) |
Mekanisme Alokasi dan Pengambilan Tugas
Sistem tugas Agent Teams mendukung 3 status dan hubungan ketergantungan:
Status Tugas: pending (menunggu) → in_progress (sedang dikerjakan) → completed (selesai)
Mekanisme Ketergantungan: Tugas dapat diatur dengan ketergantungan blockedBy. Setelah tugas yang menjadi prasyarat selesai, tugas hilir akan terbuka secara otomatis tanpa perlu intervensi manual.
Cara Pengambilan Tugas:
- Penugasan oleh Lead: Memberitahu Lead secara eksplisit untuk memberikan tugas tertentu kepada rekan tim tertentu.
- Pengambilan Mandiri: Rekan tim secara otomatis mengambil tugas berikutnya yang tersedia dan belum dialokasikan setelah menyelesaikan tugas saat ini.
- File Lock untuk Mencegah Kompetisi: Jika beberapa rekan tim mencoba mengambil tugas yang sama secara bersamaan, sistem menggunakan file lock untuk mencegah konflik.
Saran Ukuran Tugas: Praktik terbaik adalah mengalokasikan 5-6 tugas untuk setiap rekan tim. Tugas yang terlalu kecil akan membuat biaya koordinasi lebih besar daripada manfaatnya, sedangkan tugas yang terlalu besar akan membuat rekan tim tidak melaporkan progres dalam waktu lama.
Cara Komunikasi Antar Rekan Tim
| Tipe Komunikasi | Penjelasan | Skenario Penggunaan |
|---|---|---|
| write (pesan pribadi) | Mengirim pesan ke rekan tim tertentu | Koordinasi masalah spesifik |
| broadcast (siaran) | Mengirim pesan ke semua rekan tim | Pengumuman penting (gunakan dengan bijak, biaya meningkat seiring ukuran tim) |
Komunikasi bersifat point-to-point, tidak perlu melalui perantara Lead. Rekan tim mana pun dapat langsung mengirim pesan ke rekan tim lainnya.
Kolaborasi Git dan Menghindari Konflik Berkas
Aturan terpenting dalam Agent Teams: Dua rekan tim yang mengedit berkas yang sama akan menyebabkan penindihan (overwrite).
Strategi pembagian kerja berkas yang direkomendasikan:
# Contoh Pengembangan Fitur Full-stack
Rekan Backend → Bertanggung jawab atas src/api/ dan src/migrations/
Rekan Frontend → Bertanggung jawab atas src/components/
Rekan Test → Bertanggung jawab atas tests/
⚠️ Penting: Rekan tim dalam Agent Teams berbagi direktori kerja yang sama dan tidak menggunakan git worktree secara otomatis. Memastikan setiap rekan tim bertanggung jawab atas kumpulan berkas yang berbeda adalah kunci untuk menghindari konflik.
5 Skenario Praktis Claude Agent Teams
Skenario Satu: Peninjauan Kode Multi-Sudut Pandang
Buat sebuah agent team untuk meninjau PR ini:
- Peninjau Keamanan: Periksa masalah keamanan seperti injeksi, XSS, izin, dll.
- Peninjau Performa: Analisis kueri N+1, kebocoran memori, strategi caching.
- Peninjau Pengujian: Verifikasi cakupan pengujian dan kasus batas (edge cases).
Biarkan mereka meninjau secara terpisah lalu melaporkan temuan mereka.
Mengapa cocok untuk Agent Teams: Ketiga dimensi peninjauan ini sepenuhnya independen, tidak akan menyebabkan konflik berkas, dan dapat dijalankan secara paralel.
Skenario Dua: Pengembangan Modul Baru Secara Paralel
Buat tim untuk membangun sistem notifikasi pengguna:
- Rekan Tim 1: Membangun API backend (src/api/notifications/)
- Rekan Tim 2: Membangun komponen frontend (src/components/notifications/)
- Rekan Tim 3: Menulis pengujian integrasi (tests/notifications/)
Mengapa cocok: Setiap rekan tim bertanggung jawab atas direktori yang berbeda, terisolasi secara alami, dan tinggal digabungkan setelah selesai.
Skenario Tiga: Debugging Hipotesis Kompetitif
Ada bug yang muncul sesekali, buat tim untuk melakukan debug dengan hipotesis yang berbeda:
- Rekan A: Investigasi apakah ini masalah race condition.
- Rekan B: Investigasi apakah ini masalah kebocoran memori.
- Rekan C: Investigasi apakah ini masalah batas waktu (timeout) API pihak ketiga.
Masing-masing memverifikasi hipotesis secara independen dan melaporkannya.
Mengapa cocok: Debugging bergaya kompetisi, beberapa petunjuk diperiksa secara paralel, siapa pun yang menemukan akar masalahnya lebih dulu dialah pemenangnya.
Skenario Empat: Koordinasi Perubahan Lintas Lapisan
Ketika sebuah perubahan mencakup frontend, backend, dan database, Agent Teams memungkinkan ahli di setiap lapisan menjalankan tugasnya masing-masing, sambil mengoordinasikan definisi antarmuka melalui sistem pesan.
Skenario Lima: Riset Eksploratif
Saya sedang merancang alat CLI untuk melacak komentar TODO dalam kode.
Buat sebuah tim untuk mengeksplorasi dari sudut pandang yang berbeda:
- Satu rekan tim bertanggung jawab atas desain pengalaman pengguna (UX).
- Satu rekan tim bertanggung jawab atas arsitektur teknis.
- Satu rekan tim berperan sebagai "devil's advocate" (pihak yang skeptis).
Mengapa cocok: Tabrakan berbagai perspektif, saling menantang asumsi dan kesimpulan satu sama lain.
Claude Agent Teams 与 Subagent 选择指南
| 判断维度 | 选 Subagent | 选 Agent Teams |
|---|---|---|
| 队友需要互相沟通？ | ❌ 不需要 | ✅ 需要 |
| 任务是否可并行？ | 部分可以 | ✅ 高度并行 |
| 是否涉及多文件编辑？ | ✅ 同文件安全 | ⚠️ 需分工避免冲突 |
| 任务复杂度？ | 聚焦单一目标 | 多角度、多模块 |
| Token 预算？ | 💰 更省 | 💸 约 3-7 倍消耗 |
| 是否需要讨论/质疑？ | ❌ | ✅ |
成本参考: 一个 3 人 Agent Teams 团队运行 30 分钟，Token 消耗约为单个会话的 3-4 倍。Plan 模式下约 7 倍。推荐通过 APIYI apiyi.com 灵活管理 Token 预算。
Claude Agent Teams 高级技巧
技巧一：混合模型降低成本
创建一个团队，Lead 使用 Opus，4 个队友使用 Sonnet。
Lead 负责战略决策用 Opus 4.6 保证质量，队友执行具体任务用 Sonnet 控制成本。
技巧二：Plan 审批工作流
生成一个架构师队友来重构认证模块。
要求在修改前先提交方案等待审批。
队友会先进入只读 Plan 模式，完成方案后发送审批请求给 Lead。Lead 批准后队友才开始实施。
技巧三：委派模式防止 Lead 下场
按 Shift+Tab 开启委派模式。这样 Lead 只负责协调和分配任务，不会自己动手写代码。防止 Lead "抢活干"。
技巧四：Quality Gate Hooks
通过 Hook 机制自动把控质量：
TeammateIdle: 队友即将空闲时触发，退出码 2 可以发送反馈让队友继续工作TaskCompleted: 任务标记完成时触发，退出码 2 可以阻止完成并要求修改
Hal-hal yang Perlu Diperhatikan pada Claude Agent Teams
Batasan yang Diketahui
- Tidak Mendukung Pemulihan Sesi: Perintah
/resumedan/rewindtidak akan memulihkan rekan tim (teammates) yang sudah ditutup. - Satu Sesi Satu Tim: Lead hanya bisa mengelola satu tim dalam satu waktu.
- Tidak Mendukung Tim Bertingkat (Nested): Rekan tim tidak bisa membuat tim mereka sendiri.
- Pewarisan Izin: Rekan tim mewarisi mode izin dari Lead, namun izin tersebut dapat disesuaikan secara terpisah setelah rekan tim dibuat.
- Batasan Mode Split-Screen: Mode split-screen tmux tidak mendukung terminal bawaan VS Code, Windows Terminal, dan Ghostty.
- Rekan Tim Crash: Rekan tim yang mengalami crash akan memicu heartbeat timeout selama 5 menit, dan tugasnya dapat diambil alih oleh rekan tim lainnya.
Praktik Terbaik
- Ukuran Tim: Direkomendasikan 2-5 rekan tim. Biasanya, tim dengan 3 anggota bekerja lebih efektif daripada 6 anggota.
- Pembagian Tugas Lebih Penting daripada Jumlah Orang: Tim berisi 3 orang dengan pembagian tugas yang baik jauh lebih baik daripada tim 6 orang dengan pembagian yang buruk.
- Tugas Padat Baca (seperti peninjauan kode atau riset) adalah "sweet spot" atau area keunggulan utama dari Agent Teams.
- Pengeditan Bersamaan yang Padat Tulis masih menjadi tantangan, sehingga memerlukan pembagian file yang sangat ketat antar anggota tim.
Pertanyaan Umum (FAQ)
Q1: Langganan apa yang dibutuhkan untuk menggunakan Agent Teams?
Agent Teams adalah fitur eksperimental dari Claude Code yang memerlukan langganan Claude Max ($100-200/bulan) untuk mendapatkan kuota penggunaan Opus 4.6 yang mencukupi. Pengguna API akan dikenakan biaya sesuai tarif standar Opus 4.6 ($5/$25 per juta token). Anda juga bisa menggunakan platform APIYI (apiyi.com) untuk mendapatkan skema biaya yang lebih fleksibel.
Q2: Apakah Agent Teams hanya bisa menggunakan Opus 4.6?
Tidak. Meskipun Agent Teams dirilis bersamaan dengan Opus 4.6, Anda bisa mencampur penggunaan model. Mode yang direkomendasikan adalah menggunakan Opus 4.6 sebagai Lead untuk pengambilan keputusan strategis, dan menggunakan Sonnet untuk rekan tim dalam mengeksekusi tugas spesifik. Dengan cara ini, Anda bisa menjaga kualitas koordinasi sekaligus mengontrol biaya.
Q3: Apakah Agent Teams bisa digunakan di VS Code?
Bisa, tapi ada batasannya. Terminal bawaan VS Code mendukung mode in-process (semua rekan tim berjalan di terminal yang sama). Namun, mode split-screen tmux tidak tersedia di VS Code, sehingga Anda perlu menggunakan terminal eksternal jika ingin fitur tersebut.
Ringkasan
Poin-poin inti dari Claude 4.6 Agent Teams:
- Cara mengaktifkan: Atur variabel lingkungan
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1, lalu deskripsikan tim Anda menggunakan bahasa alami. - Pola arsitektur: Lead Agent yang mengoordinasi + Teammate Agent yang bekerja secara paralel, berkolaborasi melalui daftar tugas bersama dan sistem pesan.
- Skenario terbaik: Tinjauan kode (code review), pengembangan modul baru secara paralel, debugging hipotesis yang kompetitif, koordinasi lintas lapisan, dan riset eksploratif.
- Prinsip inti: Pembagian tugas lebih penting daripada jumlah orang; 3 rekan tim biasanya memberikan hasil yang lebih baik daripada 6 orang.
- Kontrol biaya: Model hibrida (Lead menggunakan Opus + Rekan tim menggunakan Sonnet) adalah solusi dengan rasio performa-harga terbaik.
Agent Teams membawa pemrograman AI dari era "berjuang sendirian" ke era "kolaborasi tim". Meskipun masih dalam tahap pratinjau riset, fitur ini telah menunjukkan kemampuan pengembangan paralel yang luar biasa.
Kami merekomendasikan penggunaan APIYI (apiyi.com) untuk mendapatkan kuota Claude API. Platform ini menawarkan penagihan yang fleksibel dan dukungan multi-model, memudahkan Anda untuk menguji berbagai konfigurasi Agent Teams.
📚 Referensi
⚠️ Catatan format tautan: Semua tautan luar menggunakan format
Nama Sumber: domain.comagar mudah disalin tetapi tidak dapat diklik secara langsung, guna menghindari hilangnya bobot SEO.
-
Dokumentasi Resmi Claude Code Agent Teams: Panduan lengkap penggunaan Agent Teams
- Tautan:
code.claude.com/docs/en/agent-teams - Keterangan: Dokumentasi resmi yang berisi metode aktivasi, penjelasan arsitektur, dan praktik terbaik.
- Tautan:
-
Blog Teknik Anthropic — Studi Kasus Kompiler C: 16 Claude membangun kompiler C secara paralel
- Tautan:
anthropic.com/engineering/building-c-compiler - Keterangan: Contoh nyata penggunaan Agent Teams dalam skala besar, menghasilkan 100.000 baris kode dari 2000+ sesi.
- Tautan:
-
Addy Osmani — Claude Code Swarms: Analisis mendalam Agent Teams oleh Engineering Lead Google
- Tautan:
addyosmani.com/blog/claude-code-agent-teams - Keterangan: Analisis arsitektur dan saran praktik terbaik.
- Tautan:
-
Pengumuman Rilis Claude Opus 4.6: Catatan rilis resmi
- Tautan:
anthropic.com/news/claude-opus-4-6 - Keterangan: Pengenalan resmi fitur Agent Teams.
- Tautan:
Penulis: Tim APIYI
Diskusi Teknis: Silakan diskusikan pengalaman Anda menggunakan Claude Agent Teams di kolom komentar. Untuk informasi lebih lanjut, kunjungi komunitas teknis APIYI di apiyi.com.
