Claude Code Mengaktifkan Mode Tim! Agent Teams yang Harus Anda Gunakan!

Claude Code kembali meluncurkan fitur besar: Agent Teams, yang dapat dipahami sebagai versi yang sangat ditingkatkan dari Sub Agents~ Berikut adalah perbandingan antara Agent Teams dan Subagents:

Saya sudah "menggunakannya dulu"! (Sangat menyenangkan! Sangat menyenangkan! Sangat menyenangkan!)

Syarat untuk mengaktifkan Agent Teams: 
1. Perbarui Claude Code ke versi terbaru (claude update) 

2. Tambahkan baris ini di settings.json:

"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" 

3. Restart Claude Code~  

4. Lalu gunakan bahasa alami untuk meminta Claude Code membuat Agent Teams (tentu saja, jelaskan dengan jelas apa yang harus dilakukan Agent Teams)  

Selain itu, model lain tidak memengaruhi kerja Agent Teams (saya menggunakan KIMi for coding)

Lebih lanjut tentang Agent Teams lihat di bawah (artikel resmi oleh Anthropic)!

Agent Teams memungkinkan Anda mengoordinasikan beberapa instans Claude Code untuk bekerja bersama. Satu sesi sebagai pemimpin, mengoordinasikan pekerjaan, membagi tugas, dan menyatukan hasil. Anggota tim bekerja secara independen, masing-masing dalam jendela konteksnya sendiri, dan dapat berkomunikasi langsung satu sama lain.

Berbeda dengan subagen (Subagents) yang berjalan dalam sesi tunggal dan hanya melaporkan ke agen utama), Anda dapat berinteraksi langsung dengan setiap anggota tim, tanpa melalui pemimpin.

Dokumen ini mencakup:

• • Kapan menggunakan Agent Teams, termasuk kasus penggunaan terbaik dan perbandingan dengan subagen

• • Memulai tim

• • Mengontrol anggota tim, termasuk mode tampilan, pembagian tugas, dan delegasi

• • Praktik terbaik untuk kerja paralel

Kapan Menggunakan Agent Teams

Agent Teams paling efektif dalam tugas di mana eksplorasi paralel memberikan nilai tambah nyata. Kasus penggunaan terkuat meliputi:

• • Penelitian dan Tinjauan —— Beberapa anggota dapat menyelidiki aspek berbeda dari masalah secara bersamaan, lalu berbagi dan menantang temuan satu sama lain

• • Modul atau Fitur Baru —— Anggota tim dapat memiliki bagian independen masing-masing, tanpa saling mengganggu

• • Debugging dengan Hipotesis Bersaing —— Anggota tim menguji teori berbeda secara paralel, menemukan jawaban lebih cepat

• • Koordinasi Lintas Lapisan —— Perubahan yang melintasi front-end, back-end, dan pengujian, masing-masing ditangani oleh anggota tim berbeda

Agent Teams meningkatkan biaya koordinasi (Berani gunakan Opus4.6 untuk membuka Agent Teams?🤣), meningkatkan konsumsi token secara signifikan dibandingkan sesi tunggal. Mereka bekerja terbaik ketika kelompok dapat beroperasi secara independen. Untuk tugas berurutan, pengeditan file yang sama, atau pekerjaan dengan banyak dependensi, sesi tunggal atau subagen lebih efektif.

Perbandingan dengan Subagen

Agent Teams dan subagen memungkinkan Anda bekerja secara paralel, tetapi dengan cara operasi berbeda. Pilih berdasarkan apakah pekerja perlu berkomunikasi satu sama lain:

Subagen

Agent Teams

Konteks

Jendela konteks sendiri; hasil dikembalikan ke pemanggil

Jendela konteks sendiri; sepenuhnya independen

Komunikasi

Hanya melaporkan hasil ke agen utama

Anggota tim saling mengirim pesan langsung

Koordinasi

Agen utama mengelola semua pekerjaan

Daftar tugas bersama, mengoordinasikan diri sendiri

Paling Cocok Untuk

Tugas fokus yang hanya peduli pada hasil

Pekerjaan kompleks yang memerlukan diskusi dan kolaborasi

Biaya Token

Lebih rendah: hasil dikumpulkan kembali ke konteks utama

Lebih tinggi: setiap anggota adalah instans Claude independen

Gunakan subagen ketika Anda memerlukan pekerja cepat dan fokus untuk melaporkan hasil. Gunakan Agent Teams ketika kelompok perlu berbagi temuan, saling menantang, dan mengoordinasikan diri sendiri.

Mengaktifkan Agent Teams

Agent Teams dinonaktifkan secara default. Aktifkan dengan menyetel variabel lingkungan CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS ke 1, dapat dilakukan di lingkungan shell atau melalui settings.json:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Memulai Agent Team Pertama Anda

Setelah mengaktifkan Agent Teams, beri tahu Claude untuk membuat Agent Team, gunakan bahasa alami untuk mendeskripsikan tugas dan struktur tim yang Anda inginkan. Claude akan membuat tim, menghasilkan anggota, dan mengoordinasikan pekerjaan berdasarkan petunjuk Anda.

Contoh ini bekerja dengan baik karena tiga peran independen, dapat mengeksplorasi masalah tanpa menunggu satu sama lain:

Create an agent team to explore this from different angles: one teammate on UX, one on technical architecture, one playing devil's advocate.
(Buat Agent Team untuk mengeksplorasi dari sudut berbeda: satu bertanggung jawab pada UX, satu pada arsitektur teknis, satu berperan sebagai penantang.)

Dari sana, Claude membuat tim dengan daftar tugas bersama, menghasilkan anggota untuk setiap perspektif, membuat mereka mengeksplorasi masalah, menyatukan temuan, dan mencoba membersihkan tim setelah selesai.

Terminal pemimpin mencantumkan semua anggota dan pekerjaan mereka. Gunakan Shift+Up/Down untuk memilih anggota dan langsung mengirim pesan kepada mereka.

Mengontrol Agent Team Anda

Gunakan bahasa alami untuk memberi tahu pemimpin apa yang Anda inginkan. Ia akan menangani koordinasi tim, pembagian tugas, dan delegasi berdasarkan instruksi Anda.

Memilih Mode Tampilan

Agent Teams mendukung dua mode tampilan:

• • Mode Dalam Proses —— Semua anggota berjalan dalam terminal utama Anda. Gunakan Shift+Up/Down untuk memilih anggota dan langsung mengetik mengirim pesan. Cocok untuk terminal apa pun, tanpa pengaturan tambahan.

• • Mode Layar Terbagi —— Setiap anggota memiliki panel sendiri. Anda dapat melihat output semua orang sekaligus, klik panel untuk interaksi langsung. Membutuhkan tmux atau iTerm2.

Default adalah "auto", menggunakan layar terbagi jika Anda sudah berjalan dalam sesi tmux, jika tidak menggunakan mode dalam proses.

Untuk memaksa mode dalam proses untuk sesi tunggal, berikan tanda:

claude --teammate-mode in-process

Menentukan Anggota dan Model

Claude memutuskan berapa banyak anggota yang dihasilkan berdasarkan tugas Anda, atau Anda dapat menentukan dengan tepat apa yang Anda inginkan:

Create a team with 4 teammates to refactor these modules in parallel. Use Sonnet for each teammate.
(Buat tim dengan 4 anggota untuk merefaktor modul-modul ini secara paralel. Gunakan Sonnet untuk setiap anggota.)

Meminta Persetujuan Rencana Anggota

Untuk tugas kompleks atau berisiko, Anda dapat meminta anggota untuk merencanakan sebelum menerapkan. Anggota bekerja dalam mode rencana baca-saja, hingga pemimpin menyetujui metode mereka:

Spawn an architect teammate to refactor the authentication module. Require plan approval before they make any changes.
(Hasilkan anggota arsitek untuk merefaktor modul otentikasi. Minta persetujuan rencana sebelum mereka membuat perubahan apa pun.)

Ketika anggota menyelesaikan rencana, ia mengirim permintaan persetujuan rencana ke pemimpin. Pemimpin meninjau rencana dan menyetujui atau menolak serta memberikan umpan balik.

Menggunakan Mode Delegasi

Tanpa mode delegasi, pemimpin terkadang mulai menerapkan tugas sendiri, alih-alih menunggu anggota menyelesaikan. Mode delegasi mencegah hal ini dengan membatasi pemimpin hanya pada alat koordinasi. Tekan Shift+Tab untuk beralih ke mode delegasi.

Berbicara Langsung dengan Anggota

Setiap anggota adalah sesi Claude Code lengkap dan independen. Anda dapat langsung mengirim pesan ke anggota mana pun:

• • Mode Dalam Proses: Gunakan Shift+Up/Down untuk memilih anggota, lalu ketik untuk mengirim pesan. Tekan Enter untuk melihat sesi anggota, lalu tekan Escape untuk menghentikan giliran mereka saat ini. Tekan Ctrl+T untuk beralih daftar tugas.

• • Mode Layar Terbagi: Klik panel anggota untuk berinteraksi langsung dengan sesinya.

Membagi dan Mengklaim Tugas

Daftar tugas bersama mengoordinasikan kerja tim. Pemimpin membuat tugas, anggota menyelesaikannya. Tugas memiliki tiga status: tertunda, sedang berjalan, selesai. Tugas juga dapat bergantung pada tugas lain.

Pemimpin dapat menugaskan tugas secara eksplisit, atau anggota dapat mengklaim sendiri setelah menyelesaikan tugas.

Menutup Anggota

Untuk mengakhiri sesi anggota dengan baik:

Ask the researcher teammate to shut down
(Minta anggota peneliti untuk menutup)

Pemimpin mengirim permintaan penutupan. Anggota dapat menyetujui dan keluar dengan baik, atau menolak dan menjelaskan alasannya.

Membersihkan Tim

Setelah selesai, minta pemimpin untuk membersihkan:

Clean up the team
(Bersihkan tim)

Ini menghapus sumber daya tim bersama. Ketika pemimpin menjalankan pembersihan, ia memeriksa anggota yang aktif, dan gagal jika masih ada yang berjalan, jadi tutup mereka terlebih dahulu.

Bagaimana Agent Teams Bekerja

Arsitektur

Agent Team mencakup:

• • Pemimpin: Sesi Claude Code utama yang membuat tim, menghasilkan anggota, dan mengoordinasikan pekerjaan

• • Anggota: Instans Claude Code independen yang masing-masing menangani tugas yang ditugaskan

• • Daftar Tugas: Daftar bersama item pekerjaan yang diklaim dan diselesaikan oleh anggota

• • Kotak Surat: Sistem pesan untuk komunikasi antar agen

Sistem secara otomatis mengelola ketergantungan tugas. Tim dan tugas disimpan secara lokal:

• • Konfigurasi tim: ~/.claude/teams/{team-name}/config.json

• • Daftar tugas: ~/.claude/tasks/{team-name}/

Konteks dan Komunikasi

Setiap anggota memiliki jendela konteks sendiri. Saat dihasilkan, anggota memuat konteks proyek yang sama dengan sesi reguler: CLAUDE.md, server MCP, dan keterampilan. Riwayat percakapan pemimpin tidak diteruskan.

Bagaimana anggota berbagi informasi:

• • Pengiriman Pesan Otomatis: Ketika anggota mengirim pesan, secara otomatis diteruskan ke penerima

• • Notifikasi Menganggur: Ketika anggota selesai dan berhenti, secara otomatis memberi tahu pemimpin

• • Daftar Tugas Bersama: Semua agen dapat melihat status tugas dan mengklaim pekerjaan yang tersedia

Penggunaan Token

Agent Teams meningkatkan konsumsi token secara signifikan dibandingkan sesi tunggal. Setiap anggota memiliki jendela konteks sendiri, penggunaan token meningkat dengan jumlah anggota aktif. Untuk penelitian, tinjauan, dan pekerjaan fitur baru, token tambahan biasanya sepadan. Untuk tugas reguler, sesi tunggal lebih hemat biaya.

Contoh Kasus Penggunaan

Menjalankan Tinjauan Kode Paralel

Peninjau tunggal cenderung fokus pada satu jenis masalah sekaligus. Membagi standar tinjauan ke domain independen berarti keamanan, kinerja, dan cakupan pengujian mendapat perhatian menyeluruh secara bersamaan.

Create an agent team to review PR #142. Spawn three reviewers: one focused on security implications, one checking performance impact, one validating test coverage. Have them each review and report findings.
(Buat Agent Team untuk meninjau PR #142. Hasilkan tiga peninjau: satu fokus pada dampak keamanan, satu memeriksa dampak kinerja, satu memvalidasi cakupan pengujian. Buat mereka masing-masing meninjau dan melaporkan temuan.)

Menyelidiki dengan Hipotesis Bersaing

Ketika akar penyebab tidak jelas, agen tunggal cenderung menemukan penjelasan yang tampak masuk akal dan berhenti mencari.

Users report the app exits after one message instead of staying connected. Spawn 5 agent teammates to investigate different hypotheses. Have them talk to each other to try to disprove each other's theories, like a scientific debate. Update the findings doc with whatever consensus emerges.

Praktik Terbaik

Memberikan Konteks yang Cukup untuk Anggota

Anggota secara otomatis memuat konteks proyek, tetapi tidak mewarisi riwayat percakapan pemimpin. Sertakan detail spesifik tugas dalam petunjuk generasi.

Mengatur Ukuran Tugas dengan Tepat

• • Terlalu Kecil: Biaya koordinasi melebihi manfaat

• • Terlalu Besar: Anggota bekerja terlalu lama tanpa pemeriksaan, meningkatkan risiko usaha sia-sia

• • Tepat: Unit mandiri yang menghasilkan hasil jelas

Menunggu Anggota Menyelesaikan

Terkadang pemimpin mulai menerapkan tugas sendiri, alih-alih menunggu anggota menyelesaikan. Jika Anda memperhatikan hal ini:

Wait for your teammates to complete their tasks before proceeding
(Tunggu anggota tim Anda menyelesaikan tugas mereka sebelum melanjutkan)

Menghindari Konflik File

Dua anggota mengedit file yang sama dapat menyebabkan penimpaan. Pisahkan pekerjaan sehingga setiap anggota memiliki kumpulan file berbeda.

Memantau dan Membimbing

Periksa kemajuan anggota, alihkan metode yang tidak bekerja, dan satukan temuan seiring kemajuan.

Keterbatasan

Agent Teams bersifat eksperimental. Keterbatasan saat ini:

• • Anggota dalam proses tidak mendukung pemulihan sesi: /resume dan /rewind tidak akan memulihkan anggota dalam proses

• • Status tugas mungkin tertunda: Anggota terkadang gagal menandai tugas selesai

• • Penutupan mungkin lambat: Anggota menyelesaikan permintaan saat ini sebelum menutup

• • Satu tim per sesi: Satu pemimpin hanya dapat mengelola satu tim sekaligus

• • Tidak mendukung tim bersarang: Anggota tidak dapat menghasilkan tim sendiri

• • Pemimpin tetap: Sesi yang membuat tim adalah pemimpin selama masa hidupnya

• • Layar terbagi membutuhkan tmux atau iTerm2: Tidak mendukung terminal terintegrasi VS Code, Windows Terminal, atau Ghostty