Langsung ke konten utama
Tim agent bersifat eksperimental dan dinonaktifkan secara default. Aktifkan dengan menambahkan CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS ke settings.json atau environment Anda. Tanpa variabel tersebut, tidak ada tim yang diatur pada awal session, tidak ada direktori tim yang ditulis, dan Claude tidak menspawn atau mengusulkan rekan tim. Tim agent memiliki keterbatasan yang diketahui seputar session resumption, koordinasi tugas, dan perilaku shutdown.
Tim agent memungkinkan Anda mengoordinasikan beberapa instance Claude Code yang bekerja bersama. Satu session bertindak sebagai team lead, mengoordinasikan pekerjaan, menugaskan tugas, dan mensintesis hasil. Rekan tim bekerja secara independen, masing-masing dalam context window-nya sendiri, dan berkomunikasi langsung satu sama lain. Tidak seperti subagents, yang berjalan dalam satu session dan hanya dapat melaporkan kembali ke agent utama, Anda juga dapat berinteraksi dengan rekan tim individual secara langsung tanpa melalui lead.
Halaman ini menjelaskan tim agent per v2.1.178. Dengan CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS diatur, menspawn rekan tim tidak lagi memerlukan langkah setup, dan cleanup terjadi secara otomatis ketika session keluar. Sebelum v2.1.178, Anda meminta Claude untuk membuat dan memberi nama tim terlebih dahulu, dan Claude menggunakan tools TeamCreate dan TeamDelete untuk mengaturnya dan menghapusnya. Kedua tools tidak lagi ada. Input team_name pada tool Agent diterima tetapi diabaikan, dan field team_name dalam hook payloads TaskCreated, TaskCompleted, dan TeammateIdle membawa nama yang diturunkan dari session dan sudah usang.

​
Kapan menggunakan tim agent

Tim agent paling efektif untuk tugas di mana eksplorasi paralel menambah nilai nyata. Lihat contoh use case untuk skenario lengkap. Use case terkuat adalah:
  • Penelitian dan review: beberapa rekan tim dapat menyelidiki aspek berbeda dari masalah secara bersamaan, kemudian berbagi dan menantang temuan satu sama lain
  • Modul atau fitur baru: rekan tim dapat masing-masing memiliki bagian terpisah tanpa saling mengganggu
  • Debugging dengan hipotesis bersaing: rekan tim menguji teori berbeda secara paralel dan berkumpul pada jawaban lebih cepat
  • Koordinasi lintas-layer: perubahan yang mencakup frontend, backend, dan tests, masing-masing dimiliki oleh rekan tim berbeda
Tim agent menambah overhead koordinasi dan menggunakan token secara signifikan lebih banyak daripada satu session. Mereka bekerja paling baik ketika rekan tim dapat beroperasi secara independen. Untuk tugas sekuensial, edit file yang sama, atau pekerjaan dengan banyak dependensi, satu session atau subagents lebih efektif.

​
Bandingkan dengan subagents

Baik tim agent maupun subagents memungkinkan Anda memparalelkan pekerjaan, tetapi mereka beroperasi berbeda. Pilih berdasarkan apakah pekerja Anda perlu berkomunikasi satu sama lain:
Diagram membandingkan arsitektur subagent dan tim agent. Subagents dihasilkan oleh agent utama, melakukan pekerjaan, dan melaporkan hasil kembali. Tim agent berkoordinasi melalui daftar tugas bersama, dengan rekan tim berkomunikasi langsung satu sama lain.
SubagentsTim agent
ContextContext window sendiri; hasil kembali ke pemanggilContext window sendiri; sepenuhnya independen
KomunikasiMelaporkan hasil kembali ke agent utama sajaRekan tim saling mengirim pesan secara langsung
KoordinasiAgent utama mengelola semua pekerjaanDaftar tugas bersama dengan self-coordination
Terbaik untukTugas terfokus di mana hanya hasil yang pentingPekerjaan kompleks yang memerlukan diskusi dan kolaborasi
Biaya tokenLebih rendah: hasil diringkas kembali ke context utamaLebih tinggi: setiap rekan tim adalah instance Claude terpisah
Gunakan subagents ketika Anda membutuhkan pekerja cepat dan terfokus yang melaporkan kembali. Gunakan tim agent ketika rekan tim perlu berbagi temuan, menantang satu sama lain, dan berkoordinasi sendiri.

​
Aktifkan tim agent

Tim agent dinonaktifkan secara default. Aktifkan dengan mengatur variabel environment CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS ke 1, baik di environment shell Anda atau melalui settings.json:
settings.json
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

​
Mulai tim agent pertama Anda

Setelah mengaktifkan tim agent, jelaskan tugas dan rekan tim yang Anda inginkan dalam bahasa alami. Claude menelurkan mereka dan mengoordinasikan pekerjaan berdasarkan prompt Anda. Contoh ini bekerja dengan baik karena tiga peran independen dan dapat mengeksplorasi masalah tanpa menunggu satu sama lain: 
Saya merancang alat CLI yang membantu developer melacak komentar TODO di seluruh
codebase mereka. Buat tiga rekan tim untuk mengeksplorasi ini dari sudut berbeda:
satu pada UX, satu pada arsitektur teknis, satu memainkan devil's advocate.
Dari sana, Claude mengisi daftar tugas bersama, menelurkan rekan tim untuk setiap perspektif, membuat mereka mengeksplorasi masalah, dan mensintesis temuan ketika selesai. Panel lead mencantumkan rekan tim di panel agent di bawah input prompt. Dari panel:
  • Panah atas dan bawah: pilih rekan tim
  • Enter: buka transkrip rekan tim yang dipilih dan kirim pesan langsung kepadanya
  • Escape: hentikan giliran saat ini rekan tim yang dipilih
Mulai dari v2.1.181, baris rekan tim yang idle bersembunyi setelah 30 detik dan muncul kembali pada giliran berikutnya. Rekan tim tetap berjalan dan dapat dialamatkan saat tersembunyi. Jika Anda ingin setiap rekan tim di split pane-nya sendiri, lihat Pilih mode tampilan.

​
Kontrol tim agent Anda

Beri tahu lead apa yang Anda inginkan dalam bahasa alami. Ini menangani koordinasi tim, penugasan tugas, dan delegasi berdasarkan instruksi Anda.

​
Pilih mode tampilan

Tim agent mendukung dua mode tampilan:
  • In-process: semua rekan tim berjalan di dalam terminal utama Anda. Gunakan tombol panah atas dan bawah di panel agent untuk memilih rekan tim, kemudian tekan Enter untuk melihatnya dan ketik untuk mengirim pesan kepadanya secara langsung. Bekerja di terminal apa pun, tidak ada setup tambahan yang diperlukan.
  • Split panes: setiap rekan tim mendapat pane-nya sendiri. Anda dapat melihat output semua orang sekaligus dan klik ke dalam pane untuk berinteraksi secara langsung. Memerlukan tmux, atau iTerm2.
tmux memiliki keterbatasan yang diketahui pada sistem operasi tertentu dan secara tradisional bekerja paling baik di macOS. Menggunakan tmux -CC di iTerm2 adalah entrypoint yang disarankan ke tmux.
Default adalah "in-process". Sebelum v2.1.179 default adalah "auto", jadi session yang ditingkatkan yang sebelumnya membuka split panes sekarang tetap dalam satu terminal kecuali Anda menetapkan mode secara eksplisit. Atur "auto" untuk mengaktifkan split panes ketika Anda sudah berjalan di dalam session tmux, atau ketika terminal Anda adalah iTerm2 dengan CLI it2 yang terinstal, jatuh kembali ke in-process sebaliknya. Pengaturan "tmux" mengaktifkan mode split-pane dan auto-detects apakah akan menggunakan tmux atau iTerm2 berdasarkan terminal Anda. Mulai dari v2.1.186, atur "iterm2" untuk menggunakan iTerm2 native split panes secara eksplisit. Mode ini memerlukan it2 CLI dan menampilkan error dengan perintah install jika it2 hilang. Prompt setup yang menawarkan untuk menginstal it2 atau beralih ke tmux muncul di bawah "auto" atau "tmux" ketika terminal Anda adalah iTerm2 dan tmux tersedia sebagai fallback. Untuk mengganti default, atur teammateMode di ~/.claude/settings.json: 
{
  "teammateMode": "auto"
}
Untuk menetapkan mode untuk satu session, teruskan sebagai flag: 
claude --teammate-mode auto
Mode split-pane memerlukan baik tmux atau iTerm2 dengan it2 CLI. Untuk menginstal secara manual:
  • tmux: instal melalui package manager sistem Anda. Lihat tmux wiki untuk instruksi spesifik platform.
  • iTerm2: instal it2 CLI, kemudian aktifkan Python API di iTerm2 → Settings → General → Magic → Enable Python API.

​
Tentukan rekan tim dan model

Claude memutuskan jumlah rekan tim untuk dihasilkan berdasarkan tugas Anda, atau Anda dapat menentukan dengan tepat apa yang Anda inginkan: 
Spawn 4 teammates to refactor these modules in parallel. Use Sonnet for
each teammate.
Rekan tim tidak mewarisi pilihan /model lead secara default. Untuk mengubah model yang digunakan ketika prompt tidak menentukan satu, atur Default teammate model di /config. Pilih Default (leader’s model) untuk membuat rekan tim mengikuti model saat ini lead. Rekan tim mewarisi effort level lead. Dalam mode split-pane ini berlaku dari v2.1.186; versi sebelumnya tidak meneruskan effort session lead ke rekan tim split-pane.

​
Perlukan persetujuan rencana untuk rekan tim

Untuk tugas kompleks atau berisiko, Anda dapat memerlukan rekan tim untuk merencanakan sebelum mengimplementasikan. Rekan tim bekerja dalam mode rencana read-only sampai lead menyetujui pendekatan mereka: 
Spawn an architect teammate to refactor the authentication module.
Require plan approval before they make any changes.
Ketika rekan tim selesai merencanakan, mereka mengirim permintaan persetujuan rencana ke lead. Lead meninjau rencana dan baik menyetujuinya atau menolaknya dengan umpan balik. Jika ditolak, rekan tim tetap dalam mode rencana, merevisi berdasarkan umpan balik, dan mengirimkan kembali. Setelah disetujui, rekan tim keluar dari mode rencana dan mulai implementasi. Lead membuat keputusan persetujuan secara otonom. Untuk mempengaruhi penilaian lead, berikan kriteria dalam prompt Anda, seperti “hanya setujui rencana yang mencakup test coverage” atau “tolak rencana yang memodifikasi skema database.”

​
Berbicara dengan rekan tim secara langsung

Setiap rekan tim adalah session Claude Code penuh dan independen. Anda dapat mengirim pesan ke rekan tim mana pun secara langsung untuk memberikan instruksi tambahan, mengajukan pertanyaan lanjutan, atau mengalihkan pendekatan mereka.
  • Mode in-process: gunakan tombol panah atas dan bawah di panel agent untuk memilih rekan tim, kemudian tekan Enter untuk melihat sessionnya dan ketik untuk mengirim pesan kepadanya. Tekan x pada rekan tim yang dipilih untuk menghentikannya. Tekan Ctrl+T untuk toggle daftar tugas.
  • Mode split-pane: klik ke dalam pane rekan tim untuk berinteraksi dengan session mereka secara langsung. Setiap rekan tim memiliki tampilan penuh dari terminal mereka sendiri.

​
Tetapkan dan klaim tugas

Daftar tugas bersama mengoordinasikan pekerjaan di seluruh tim. Lead membuat tugas dan rekan tim mengerjakannya. Tugas memiliki tiga status: pending, in progress, dan completed. Tugas juga dapat bergantung pada tugas lain: tugas pending dengan dependensi yang tidak terselesaikan tidak dapat diklaim sampai dependensi tersebut selesai. Lead dapat menugaskan tugas secara eksplisit, atau rekan tim dapat self-claim:
  • Lead menugaskan: beri tahu lead tugas mana yang diberikan kepada rekan tim mana
  • Self-claim: setelah menyelesaikan tugas, rekan tim mengambil tugas unassigned, unblocked berikutnya sendiri
Klaim tugas menggunakan file locking untuk mencegah race conditions ketika beberapa rekan tim mencoba mengklaim tugas yang sama secara bersamaan.

​
Matikan rekan tim

Untuk mengakhiri session rekan tim dengan baik, rujuk dengan nama. Misalnya, dengan rekan tim bernama researcher: 
Ask the researcher teammate to shut down
Lead mengirim permintaan shutdown. Rekan tim dapat menyetujui, keluar dengan baik, atau menolak dengan penjelasan. Direktori bersama tim dibersihkan secara otomatis ketika session berakhir, jadi tidak ada langkah pembersihan terpisah. Lihat Architecture untuk direktori mana yang dihapus dan mana yang bertahan untuk session yang dilanjutkan.

​
Terapkan quality gates dengan hooks

Gunakan hooks untuk menerapkan aturan ketika rekan tim menyelesaikan pekerjaan atau tugas dibuat atau diselesaikan:
  • TeammateIdle: berjalan ketika rekan tim akan idle. Keluar dengan kode 2 untuk mengirim umpan balik dan membuat rekan tim tetap bekerja.
  • TaskCreated: berjalan ketika tugas sedang dibuat. Keluar dengan kode 2 untuk mencegah pembuatan dan mengirim umpan balik.
  • TaskCompleted: berjalan ketika tugas ditandai selesai. Keluar dengan kode 2 untuk mencegah penyelesaian dan mengirim umpan balik.

​
Bagaimana tim agent bekerja

Bagian ini mencakup arsitektur dan mekanik di balik tim agent. Jika Anda ingin mulai menggunakannya, lihat Kontrol tim agent Anda di atas.

​
Bagaimana Claude memulai tim agent

Tim agent terbentuk ketika rekan tim pertama dihasilkan, dengan sesi utama bertindak sebagai pemimpin. Ada dua cara rekan tim dihasilkan:
  • Anda meminta rekan tim: berikan Claude tugas yang menguntungkan dari pekerjaan paralel dan secara eksplisit minta rekan tim. Claude menghasilkannya berdasarkan instruksi Anda.
  • Claude mengusulkan rekan tim: jika Claude menentukan tugas Anda akan menguntungkan dari pekerjaan paralel, mungkin menyarankan untuk menghasilkan rekan tim. Anda mengonfirmasi sebelum melanjutkan.
Dalam kedua kasus, Anda tetap mengendalikan. Claude tidak akan menghasilkan rekan tim tanpa persetujuan Anda.

​
Arsitektur

Tim agent terdiri dari:
KomponenPeran
Team leadSesi Claude Code utama yang menghasilkan rekan tim dan mengoordinasikan pekerjaan
Rekan timInstance Claude Code terpisah yang masing-masing bekerja pada tugas yang ditugaskan
Daftar tugasDaftar item pekerjaan bersama yang diklaim dan diselesaikan rekan tim
MailboxSistem pesan untuk komunikasi antar agent
Lihat Pilih mode tampilan untuk opsi konfigurasi tampilan. Pesan rekan tim tiba di lead secara otomatis. Sistem mengelola dependensi tugas secara otomatis. Ketika rekan tim menyelesaikan tugas yang tugas lain bergantung padanya, tugas yang diblokir membuka tanpa intervensi manual. Tim dan tugas disimpan secara lokal dengan nama yang diturunkan dari sesi. Nama adalah session- diikuti oleh delapan karakter pertama dari session ID:
  • Konfigurasi tim: ~/.claude/teams/{team-name}/config.json
  • Daftar tugas: ~/.claude/tasks/{team-name}/
Claude Code menghasilkan keduanya secara otomatis saat startup sesi dan memperbarui mereka saat rekan tim bergabung, idle, atau pergi. Direktori konfigurasi tim dihapus ketika sesi berakhir. Direktori daftar tugas tetap ada secara lokal dan tidak pernah diunggah, jadi sesi yang dilanjutkan menyimpan tugas mereka. Retensi diatur oleh cleanupPeriodDays yang sama yang sudah Anda kontrol untuk transkrip sesi. Konfigurasi tim menyimpan status runtime seperti session IDs dan tmux pane IDs, jadi jangan mengeditnya dengan tangan atau pre-author: perubahan Anda ditimpa pada update status berikutnya. Untuk mendefinisikan peran rekan tim yang dapat digunakan kembali, gunakan subagent definitions sebagai gantinya. Konfigurasi tim berisi array members dengan nama setiap rekan tim, agent ID, dan tipe agent. Rekan tim dapat membaca file ini untuk menemukan anggota tim lainnya. Tidak ada padanan tingkat proyek dari konfigurasi tim. File seperti .claude/teams/teams.json di direktori proyek Anda tidak dikenali sebagai konfigurasi; Claude memperlakukannya sebagai file biasa.

​
Gunakan subagent definitions untuk rekan tim

Ketika menghasilkan rekan tim, Anda dapat mereferensikan tipe subagent dari subagent scope apa pun: proyek, pengguna, plugin, atau CLI-defined. Ini memungkinkan Anda mendefinisikan peran sekali, seperti security-reviewer atau test-runner, dan menggunakannya kembali baik sebagai subagent yang didelegasikan maupun sebagai rekan tim agent team. Untuk menggunakan subagent definition, sebutkan berdasarkan nama ketika meminta Claude untuk menghasilkan rekan tim: 
Hasilkan rekan tim menggunakan tipe agent security-reviewer untuk mengaudit modul auth.
Rekan tim menghormati allowlist tools definisi itu dan model, dan body definisi ditambahkan ke system prompt rekan tim sebagai instruksi tambahan daripada menggantinya. Team coordination tools seperti SendMessage dan task management tools selalu tersedia untuk rekan tim bahkan ketika tools membatasi tools lain.
Field frontmatter skills dan mcpServers dalam subagent definition tidak diterapkan ketika definisi itu berjalan sebagai rekan tim. Rekan tim memuat skills dan MCP servers dari pengaturan proyek dan pengguna Anda, sama seperti session reguler.

​
Izin

Rekan tim dimulai dengan pengaturan izin lead. Jika lead berjalan dengan --dangerously-skip-permissions, semua rekan tim juga demikian. Setelah dihasilkan, Anda dapat mengubah mode rekan tim individual, tetapi Anda tidak dapat mengatur mode per-rekan tim pada waktu spawn. Ketika satu agent mengirim agent lain pesan melalui SendMessage, agent penerima diberitahu bahwa itu berasal dari sesi Claude lain, bukan dari Anda. Rekan tim tidak dapat menyetujui prompt izin atau memberikan persetujuan atas nama Anda, dan rekan tim yang ditolak tindakannya tidak dapat menyampaikannya ke rekan tim lain untuk melewati pemeriksaan. Dalam auto mode, classifier memperlakukan klaim persetujuan yang disalurkan dari agent lain sebagai input yang tidak dipercaya daripada konfirmasi dari Anda. Prompt izin rekan tim naik ke sesi lead, jadi setujui mereka di sana sendiri.

​
Context dan komunikasi

Setiap rekan tim memiliki context window-nya sendiri. Ketika dihasilkan, rekan tim memuat konteks proyek yang sama seperti session reguler: CLAUDE.md, MCP servers, dan skills. Mereka juga menerima spawn prompt dari lead. Riwayat percakapan lead tidak terbawa. Bagaimana rekan tim berbagi informasi:
  • Pengiriman pesan otomatis: ketika rekan tim mengirim pesan, mereka dikirimkan secara otomatis ke penerima. Lead tidak perlu polling untuk update.
  • Notifikasi idle: ketika rekan tim selesai dan berhenti, mereka secara otomatis memberi tahu lead.
  • Daftar tugas bersama: semua agent dapat melihat status tugas dan mengklaim pekerjaan yang tersedia.
  • Pesan rekan tim: kirim pesan ke satu rekan tim spesifik berdasarkan nama. Untuk menjangkau semua orang, kirim satu pesan per penerima.
Lead menugaskan setiap rekan tim nama ketika menghasilkannya, dan rekan tim mana pun dapat mengirim pesan ke yang lain berdasarkan nama itu. Untuk mendapatkan nama yang dapat diprediksi yang dapat Anda referensikan dalam prompt kemudian, beri tahu lead apa yang harus dipanggil setiap rekan tim dalam instruksi spawn Anda.

​
Penggunaan token

Tim agent menggunakan token secara signifikan lebih banyak daripada satu session. Setiap rekan tim memiliki context window-nya sendiri, dan penggunaan token skala dengan jumlah rekan tim aktif. Untuk penelitian, review, dan pekerjaan fitur baru, token tambahan biasanya berharga. Untuk tugas rutin, satu session lebih cost-effective. Lihat biaya token tim agent untuk panduan penggunaan.

​
Contoh use case

Contoh-contoh ini menunjukkan bagaimana tim agent menangani tugas di mana eksplorasi paralel menambah nilai.

​
Jalankan code review paralel

Seorang reviewer tunggal cenderung tertarik pada satu jenis masalah pada satu waktu. Membagi kriteria review menjadi domain independen berarti keamanan, kinerja, dan test coverage semuanya mendapat perhatian menyeluruh secara bersamaan. Prompt menugaskan setiap rekan tim lensa yang berbeda sehingga mereka tidak tumpang tindih: 
Spawn three teammates to review PR #142:
- One focused on security implications
- One checking performance impact
- One validating test coverage
Have them each review and report findings.
Setiap reviewer bekerja dari PR yang sama tetapi menerapkan filter berbeda. Lead mensintesis temuan di ketiga setelah mereka selesai.

​
Investigasi dengan hipotesis bersaing

Ketika akar penyebab tidak jelas, satu agent cenderung menemukan satu penjelasan yang masuk akal dan berhenti mencari. Prompt melawan ini dengan membuat rekan tim secara eksplisit adversarial: pekerjaan setiap orang bukan hanya menyelidiki teori mereka sendiri tetapi menantang yang lain. 
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.
Struktur debat adalah mekanisme kunci di sini. Investigasi sekuensial menderita dari anchoring: setelah satu teori dieksplorasi, investigasi berikutnya bias terhadapnya. Dengan beberapa investigator independen secara aktif mencoba membantah satu sama lain, teori yang bertahan jauh lebih mungkin menjadi akar penyebab sebenarnya.

​
Best practices

​
Berikan rekan tim konteks yang cukup

Rekan tim memuat konteks proyek secara otomatis, termasuk CLAUDE.md, MCP servers, dan skills, tetapi mereka tidak mewarisi riwayat percakapan lead. Lihat Context dan komunikasi untuk detail. Sertakan detail spesifik tugas dalam spawn prompt: 
Spawn a security reviewer teammate with the prompt: "Review the authentication module
at src/auth/ for security vulnerabilities. Focus on token handling, session
management, and input validation. The app uses JWT tokens stored in
httpOnly cookies. Report any issues with severity ratings."

​
Pilih ukuran tim yang sesuai

Tidak ada batas keras pada jumlah rekan tim, tetapi batasan praktis berlaku:
  • Biaya token skala linear: setiap rekan tim memiliki context window-nya sendiri dan mengkonsumsi token secara independen. Lihat biaya token tim agent untuk detail.
  • Overhead koordinasi meningkat: lebih banyak rekan tim berarti lebih banyak komunikasi, koordinasi tugas, dan potensi konflik
  • Diminishing returns: di luar titik tertentu, rekan tim tambahan tidak mempercepat pekerjaan secara proporsional
Mulai dengan 3-5 rekan tim untuk sebagian besar workflow. Ini menyeimbangkan pekerjaan paralel dengan koordinasi yang dapat dikelola. Contoh-contoh dalam panduan ini menggunakan 3-5 rekan tim karena rentang itu bekerja dengan baik di berbagai jenis tugas. Memiliki 5-6 tasks per rekan tim membuat semua orang produktif tanpa context switching yang berlebihan. Jika Anda memiliki 15 tugas independen, 3 rekan tim adalah titik awal yang baik. Skala naik hanya ketika pekerjaan benar-benar menguntungkan dari rekan tim bekerja secara bersamaan. Tiga rekan tim terfokus sering mengungguli lima yang tersebar.

​
Ukuran tugas dengan tepat

  • Terlalu kecil: overhead koordinasi melebihi manfaat
  • Terlalu besar: rekan tim bekerja terlalu lama tanpa check-in, meningkatkan risiko usaha yang terbuang
  • Tepat: unit self-contained yang menghasilkan deliverable yang jelas, seperti fungsi, file test, atau review
Lead memecah pekerjaan menjadi tugas dan menugaskan mereka ke rekan tim secara otomatis. Jika tidak membuat cukup tugas, minta untuk membagi pekerjaan menjadi potongan yang lebih kecil. Memiliki 5-6 tugas per rekan tim membuat semua orang produktif dan memungkinkan lead untuk menugaskan kembali pekerjaan jika seseorang terjebak.

​
Tunggu rekan tim selesai

Kadang-kadang lead mulai mengimplementasikan tugas sendiri alih-alih menunggu rekan tim. Jika Anda memperhatikan ini: 
Tunggu rekan tim Anda menyelesaikan tugas mereka sebelum melanjutkan

​
Mulai dengan penelitian dan review

Jika Anda baru mengenal tim agent, mulai dengan tugas yang memiliki batas yang jelas dan tidak memerlukan penulisan kode: review PR, penelitian library, atau investigasi bug. Tugas-tugas ini menunjukkan nilai eksplorasi paralel tanpa tantangan koordinasi yang datang dengan implementasi paralel.

​
Hindari konflik file

Dua rekan tim mengedit file yang sama menyebabkan overwrites. Pecah pekerjaan sehingga setiap rekan tim memiliki set file berbeda.

​
Monitor dan kemudi

Periksa kemajuan rekan tim, alihkan pendekatan yang tidak berfungsi, dan sintesis temuan saat tiba. Membiarkan tim berjalan tanpa diawasi terlalu lama meningkatkan risiko usaha yang terbuang.

​
Troubleshooting

​
Rekan tim tidak muncul

Jika rekan tim tidak muncul setelah Anda meminta Claude untuk membuat mereka:
  • Dalam mode in-process, rekan tim muncul di panel agen di bawah input prompt. Gunakan tombol panah atas dan bawah untuk memilih satu, kemudian tekan Enter untuk melihatnya.
  • Baris rekan tim yang hilang setelah diam telah disembunyikan, bukan dihentikan. Baris idle menyembunyikan setelah 30 detik dan muncul kembali pada giliran rekan tim berikutnya. Kirim pesan ke rekan tim berdasarkan nama untuk membawanya kembali.
  • Periksa bahwa tugas yang Anda berikan Claude cukup kompleks untuk menjamin rekan tim. Claude memutuskan apakah akan menelurkan mereka berdasarkan tugas.
  • Jika Anda secara eksplisit meminta split panes, pastikan tmux diinstal dan tersedia di PATH Anda: 
    which tmux
  • Untuk iTerm2, verifikasi it2 CLI diinstal dan Python API diaktifkan di preferensi iTerm2.

​
Terlalu banyak permission prompts

Permintaan izin rekan tim naik ke lead, yang dapat menciptakan gesekan. Pre-approve operasi umum di pengaturan izin Anda sebelum menelurkan rekan tim untuk mengurangi gangguan.

​
Rekan tim berhenti pada errors

Rekan tim dapat berhenti setelah mengalami errors alih-alih pulih. Periksa output mereka dengan memilih rekan tim di panel agen dan menekan Enter dalam mode in-process, atau dengan mengklik pane dalam mode split, kemudian baik:
  • Berikan instruksi tambahan kepada mereka secara langsung
  • Hasilkan rekan tim pengganti untuk melanjutkan pekerjaan

​
Lead shuts down sebelum pekerjaan selesai

Lead dapat memutuskan tim selesai sebelum semua tugas benar-benar selesai. Jika ini terjadi, beri tahu untuk terus. Anda juga dapat memberi tahu lead untuk menunggu rekan tim selesai sebelum melanjutkan jika mulai melakukan pekerjaan alih-alih mendelegasikan.

​
Orphaned tmux sessions

Jika session tmux bertahan setelah sesi Claude Code berakhir, mungkin tidak sepenuhnya dibersihkan. Daftar session dan bunuh yang dibuat oleh tim: 
tmux ls
tmux kill-session -t <session-name>

​
Keterbatasan

Tim agent bersifat eksperimental. Keterbatasan saat ini untuk diketahui:
  • Tidak ada session resumption dengan rekan tim in-process: /resume dan /rewind tidak mengembalikan rekan tim in-process. Setelah melanjutkan session, lead dapat mencoba mengirim pesan ke rekan tim yang tidak lagi ada. Jika ini terjadi, beri tahu lead untuk menelurkan rekan tim baru.
  • Status tugas dapat tertinggal: rekan tim kadang-kadang gagal menandai tugas sebagai selesai, yang memblokir tugas dependen. Jika tugas tampak terjebak, periksa apakah pekerjaan benar-benar selesai dan perbarui status tugas secara manual atau beri tahu lead untuk mendorong rekan tim.
  • Shutdown dapat lambat: rekan tim menyelesaikan permintaan atau tool call saat ini sebelum shutdown, yang dapat memakan waktu.
  • Satu tim per session: sebuah session memiliki tepat satu tim, yang dibatasi pada session tersebut. Anda tidak dapat membuat tim bernama tambahan atau berbagi tim di seluruh session.
  • Tidak ada tim bersarang: rekan tim tidak dapat menelurkan rekan tim mereka sendiri. Hanya lead yang dapat mengelola tim.
  • Lead tetap: session utama adalah lead seumur hidupnya. Anda tidak dapat mempromosikan rekan tim ke lead atau mentransfer kepemimpinan.
  • Izin ditetapkan pada spawn: semua rekan tim dimulai dengan mode izin lead. Anda dapat mengubah mode rekan tim individual setelah spawn, tetapi Anda tidak dapat mengatur mode per-rekan tim pada waktu spawn.
  • Split panes memerlukan tmux atau iTerm2: mode in-process default bekerja di terminal apa pun. Mode split-pane tidak didukung di integrated terminal VS Code, Windows Terminal, atau Ghostty.
CLAUDE.md bekerja secara normal: rekan tim membaca file CLAUDE.md dari direktori kerja mereka. Gunakan ini untuk memberikan panduan spesifik proyek ke semua rekan tim.

​
Langkah berikutnya

Jelajahi pendekatan terkait untuk pekerjaan paralel dan delegasi:
  • Delegasi ringan: subagents menelurkan agent pembantu untuk penelitian atau verifikasi dalam session Anda, lebih baik untuk tugas yang tidak memerlukan koordinasi inter-agent
  • Session paralel manual: Git worktrees memungkinkan Anda menjalankan beberapa session Claude Code sendiri tanpa koordinasi tim otomatis
  • Bandingkan pendekatan: lihat perbandingan subagent vs tim agent untuk rincian side-by-side