Kerja Paralel Claude Code: worktree, Agen, dan Workflow

Materi praktis tentang bekerja dengan agen secara paralel: dokumentasi Ailoot.

Panduan ini merangkum pengalaman praktis dan peta penerapan alat. Empat primitif resmi Claude Code, peta penerapannya, serta kerangka anti-hype tentang jumlah agen paralel yang sebenarnya dibutuhkan vibe coder. Semua angka dan kutipan tertaut ke sumber primer dari Anthropic.

Apa itu multiagen di Claude Code, dan mengapa bukan “1000 agen”#

Penyiapan multiagen adalah penyiapan ketika suatu tugas dibagi menjadi beberapa alur kerja independen, masing-masing menangani bagiannya sendiri dan mengembalikan hasil. Contoh paling sederhana: Anda menulis frontend di satu jendela Claude Code dan backend di jendela lain pada mesin yang sama, dengan repositori git yang sama. Itu sudah termasuk multiagen, meskipun kata “orkestrasi” tidak perlu digunakan untuk itu.

Penyiapan yang lebih rumit: dalam satu sesi Claude Code, Anda meluncurkan lima subagent dengan peran berbeda (pengembang frontend, pengembang backend, peninjau keamanan, penguji, penulis dokumentasi), dan masing-masing mengembalikan bagiannya ke percakapan bersama. Pendekatan multiagen ini tetap sama, hanya saja titik kendalinya satu.

Yang lebih rumit lagi: Anda memberi tahu Claude, “lakukan audit keamanan mingguan terhadap semua 500 file di proyek saya,” lalu Claude menulis skrip orkestrator JavaScript. Runtime meluncurkan beberapa lusin agen di latar belakang, masing-masing mengaudit bagiannya sendiri, lalu agen independen saling memeriksa temuan, dan Anda menerima satu laporan. Itulah Dynamic Workflows, yang dirilis Anthropic pada 28 Mei 2026. Rincian fitur selengkapnya ada di panduan terpisah tentang Dynamic Workflows.

Perbedaan antara ketiga skenario ini bukanlah jumlah agennya. Perbedaannya adalah siapa yang menentukan apa yang dikerjakan agen berikutnya. Pada skenario pertama, Anda yang menentukan. Pada skenario kedua, Claude yang memutuskan seiring percakapan berlangsung. Pada skenario ketiga, skrip JavaScript yang ditulis Claude.

Omong-omong, “1000 agen” adalah angka nyata. Itu batas atas untuk satu Dynamic Workflow di Claude Code. Dokumentasi resmi Anthropic menyatakan:

Dengan kata lain, ini adalah perlindungan teknis terhadap perilaku yang tak terkendali, bukan beban kerja yang disarankan. Dalam praktiknya, 95% tugas ditangani oleh 2–8 alur kerja paralel. Jika Anda merencanakan lebih banyak, tanyakan dahulu kepada diri sendiri apa yang akan mereka kerjakan.

4 primitif Claude Code: subagent, skill, tim agen, workflow#

Claude Code memiliki empat primitif resmi untuk membagi satu tugas ke beberapa agen. Anthropic menyatukannya dalam tabel perbandingan di dokumentasi Dynamic Workflows. Berikut perbandingan dalam bahasa sederhana:

Masing-masing primitif ini menyelesaikan masalah yang berbeda. Subagent digunakan untuk mendelegasikan 2–3 pemeriksaan dalam satu tugas. Skill digunakan saat Anda memiliki instruksi siap pakai yang harus diikuti Claude (seperti “lakukan tinjauan PR dengan daftar periksa ini”). Tim agen digunakan saat beberapa bagian produk berada di jendela berbeda dan Anda memerlukan satu koordinator. Workflow digunakan saat tugas terlalu besar untuk satu jendela konteks.

Subagent dibahas secara terperinci dalam panduan Subagent Claude Code 2026. Pohon keputusan untuk “apa yang digunakan untuk tugas tertentu” ada di panduan Skills, Subagents, MCP, Plugins. Panduan ini membahas cara menyusunnya menjadi penyiapan multiagen di atas git worktree.

Tingkat 1: subagent dalam satu sesi—cara termudah untuk memulai#

Subagent adalah cara paling sederhana untuk membagi tugas. Percakapan utama bertindak sebagai koordinator. Subagent adalah pekerja sementara yang diluncurkan agen utama seiring berjalannya pekerjaan.

Contoh spesifik dari proyek yang diceritakan. Setelah draf pertama panduan selesai, peninjauan diatur seperti ini: Claude menerima permintaan, “luncurkan enam subagent secara paralel—satu memeriksa penanda AI, yang kedua memeriksa kosakata hukum, yang ketiga meninjau suara dan nada, yang keempat memeriksa fakta dengan WebFetch, yang kelima meninjau struktur SEO, dan yang keenam memeriksa keakuratan tautan silang.” Masing-masing mengembalikan laporan, lalu penyuntingan diterapkan.

Secara teknis, ini dilakukan dengan file di .claude/agents/[subagent-name].md yang menjelaskan peran dan alat. Pemanggilan dilakukan melalui alat Agent dalam percakapan utama. Claude memutuskan kapan mengirim permintaan ke subagent.

Cocok digunakan untuk. Tugas yang melibatkan 3–7 pemeriksaan paralel terhadap satu artefak (kode, teks, desain). Setiap pemeriksaan bersifat independen. Hasilnya muat di jendela konteks utama.

Mulai tidak cocok saat. Anda memiliki lebih dari 50 file atau setiap pemeriksaan memerlukan konteks 50K token sendiri, jendela utama akan penuh. Anda memerlukan workflow atau tim agen.

Risiko utama. Setiap subagent mengonsumsi token secara terpisah. Jika Anda meluncurkan enam subagent pada proyek dengan 200 file dan masing-masing membaca ulang semua 200 file, biaya Anda menjadi 6×. Jadi Anda HARUS menentukan secara tepat file mana yang perlu diperiksa subagent. Lihat panduan Ke Mana Token Claude Code Digunakan untuk rinciannya.

Tingkat 2: git worktree—mengisolasi file di antara sesi paralel#

Saat subagent tidak cukup dan Anda memerlukan dua instance Claude Code lengkap di terminal berbeda yang bekerja pada repositori yang sama, masalah klasik muncul. Keduanya mulai mengedit file yang sama; yang satu menyimpan lebih dahulu, lalu yang kedua menimpanya. Seorang klien bertanya kepada tim dukungan minggu lalu, “5 saling menimpa pada saat yang sama.”

Solusinya adalah git worktree. Ini fitur bawaan git yang memungkinkan Anda memiliki beberapa salinan kerja dari repositori yang sama, masing-masing pada cabangnya sendiri, dengan repositori .git yang digunakan bersama. Satu sumber, direktori berbeda di disk, tanpa tumpang tindih file. Mekanismenya dijelaskan secara terperinci di panduan Git worktree di Claude Code.

Perintah untuk penyiapan lima menit:

# From the main project directory
cd ~/projects/my-app

# Create a worktree for feature/auth
git worktree add ../my-app-auth feature/auth

# Create a worktree for feature/billing
git worktree add ../my-app-billing feature/billing

# Open two terminal windows
cd ~/projects/my-app-auth && claude   # first Claude Code
cd ~/projects/my-app-billing && claude # second Claude Code

Setiap salinan berada di cabangnya sendiri. Setiap instance Claude Code menulis ke direktori sendiri. Setelah tugas selesai, jalankan git push dari cabangnya, lalu jalankan git worktree remove ../my-app-auth.

Yang perlu Anda ketahui. Worktree tidak menggandakan node_modules, .venv, atau file lain dalam .gitignore. Jika Anda memerlukan dependensi independen (versi pustaka yang berbeda di setiap cabang), jalankan npm install secara terpisah di direktori baru setelah worktree add.

Jumlah worktree per orang. Berdasarkan survei tim dari 2026, batas praktisnya adalah 4–8 worktree paralel per pengembang. Faktor pembatasnya bukan Claude, melainkan kemampuan seseorang untuk meninjau dan menerima hasil. Jika Anda memiliki 10 worktree, semuanya menunggu untuk ditinjau.

Dalam praktik yang diceritakan, orang biasanya menggunakan 2–3 worktree paralel. Satu worktree utama untuk pekerjaan aktif, satu cadangan untuk hotfix mendesak, dan satu untuk eksperimen (fitur baru yang belum Anda yakini). Lebih banyak tidak diperlukan.

Tingkat 3: tim agen—beberapa jendela, satu agen pemimpin#

Tim agen adalah primitif yang relatif baru. Idenya: satu agen pemimpin menyimpan rencana bersama dalam bentuk daftar tugas, lalu beberapa sesi sejawat di jendela terpisah mengerjakan tugas yang diberikan pemimpin. Semuanya bekerja pada sistem file yang sama dan dapat melihat artefak sementara satu sama lain.

Ini berguna saat tugas terbagi menjadi 3–5 alur kerja besar yang masing-masing berlangsung selama beberapa jam (memigrasikan modul besar, menulis ulang subsistem, melakukan audit keamanan menyeluruh). Dalam kasus itu, agen pemimpin menyimpan rencana dalam satu file tugas bersama pada jalur absolut di luar worktree. Pekerja membaca jalur itu dan melaporkan hasil; hanya pemimpin memperbarui status, sehingga tidak ada penulisan bersaing pada file koordinasi.

Secara teknis, tim agen adalah beberapa jendela yang berjalan di atas git worktree dengan satu titik perencanaan bersama. Dalam praktiknya, 80% orang mengelola tim agen secara manual (seperti uraian worktree di atas) dan tidak menggunakan “kerangka kerja tim” khusus. Itu tidak masalah.

Jika Anda tidak yakin apakah Anda memerlukan kerangka kerja sama sekali, hampir pasti tidak. Gunakan worktree manual dan satu agen pemimpin di direktori utama.

Tingkat 4: Dynamic Workflows—Claude menulis skrip orkestrasi JS#

Ketiga tingkat di atas menyimpan rencana dalam percakapan: di benak agen utama atau di daftar tugas agen pemimpin. Dynamic Workflows memindahkan rencana ke dalam kode. Claude menyatakan tugas sebagai skrip JavaScript, runtime menjalankannya di lingkungan terisolasi, hasil sementara disimpan dalam variabel skrip alih-alih konteks Anda, dan sesi tetap responsif saat agen bekerja di latar belakang.

Contoh spesifik dari dokumentasi resmi. Anda berkata:

ultracode: audit every API endpoint under src/routes/ for missing auth checks

Claude menulis skrip JavaScript dengan logika kira-kira seperti ini: “ambil semua file dari src/routes/, bagi menjadi kelompok yang masing-masing berisi 30 endpoint, jalankan satu agen pada setiap kelompok dengan pemeriksaan yang sama, lalu jalankan dua agen penilai independen terhadap temuan mereka, dan rangkum laporan akhir.” Skrip berjalan. Anda mendapatkan tabel hasil dan daftar endpoint yang pasti perlu ditinjau.

Cocok digunakan untuk.

• Mengaudit seluruh proyek untuk satu masalah (keamanan, pengetikan, API yang usang).
• Migrasi besar (500+ file yang diatur oleh aturan bersama).
• Pertanyaan riset yang perlu diperiksa dari beberapa sudut pandang independen (Anthropic melakukan ini dalam perintah bawaan /deep-research).

Rincian Dynamic Workflows, batasnya, dan cara kerja ultracode ada di panduan terpisah tentang Dynamic Workflows di Claude Code.

JANGAN gunakan saat. Tugasnya bersifat linear dan jelas. Workflow tidak diperlukan untuk tugas seperti “selesaikan komponen ini.” Workflow masuk akal saat tugas terbagi menjadi 10+ subtugas independen dan Anda memerlukan pemeriksaan silang di antaranya.

Batasan utama. Workflow mengonsumsi jauh lebih banyak token daripada sesi biasa. Anthropic merekomendasikan dalam dokumentasinya:

Dengan kata lain, jalankan workflow pertama Anda pada satu direktori, bukan seluruh proyek. Lihat biayanya, lalu putuskan apakah perlu diperluas.

Outcomes: rubrik kriteria dan peninjau independen#

Hal paling berbahaya dalam kerja multiagen adalah memercayai keluaran agen. Setiap agen mengembalikan teks yang tampak seperti pekerjaan selesai. Sebuah kutipan tampak benar, sebuah laporan tampak lengkap, sebuah migrasi tampak selesai. Dengan satu agen, Anda dapat memeriksanya sendiri. Dengan 10 agen, Anda tidak bisa—Anda tidak akan punya waktu.

Anthropic mengatasi masalah ini dengan Outcomes, fitur Managed Agents yang dirilis pada 6 Mei 2026. Idenya sederhana: sesi mendapatkan agen KEDUA (penilai) yang tugasnya hanya memeriksa pekerjaan agen pertama berdasarkan rubrik yang ketat.

Cara kerjanya secara teknis. Anda menulis rubrik—dokumen markdown dengan daftar terperinci tentang arti “selesai,” sumber mana yang harus diperiksa, dan label mana yang harus digunakan. Platform secara otomatis membuat agen penilai dalam jendela konteks baru. Agen itu hanya menerima rubrik dan hasil, tanpa hal lain. Setelah setiap upaya agen utama (penulis), penilai membaca ulang hasil dan menyetujuinya atau mengembalikan daftar terperinci tentang hal yang belum selesai.

Kutipan dari Anthropic Cookbook:

Angka dampak nyata: setelah mengintegrasikan Outcomes ke dalam Claude Managed Agents, tingkat penyelesaian tugas perusahaan AI Harvey meningkat sekitar 6×. Di Wisedocs (dokumentasi medis), waktu yang dihabiskan untuk meninjau dokumen turun sebesar 50%. Angka-angka ini berasal dari pengumuman fitur resmi.

Hal yang relevan untuk vibe coder, bukan perusahaan besar. Outcomes adalah pola, bukan hanya fitur tertentu. Anda dapat membuat agen penilai sendiri dengan menjelaskan kriteria yang sama dalam .claude/agents/grader.md dan meminta agen utama menjalankannya setelah setiap upaya. Ini berfungsi dengan penyiapan multiagen apa pun, bukan hanya Managed Agents.

Aturan utama menulis rubrik dari cookbook adalah menentukan sesuatu yang dapat diverifikasi, bukan sesuatu yang umum. Bukan “periksa apakah brief membahas penagihan,” melainkan “buka brief, temukan bagian tentang penagihan, dan pastikan bagian itu menyebutkan jumlah dalam $ atau persentase pendapatan.” Instruksi pertama memungkinkan penilai membaca sekilas dan mencentang kotak. Instruksi kedua mengharuskannya membuka dokumen dan menemukan angka tertentu.

Antipola: “50 agen mengerjakan hal yang tidak masuk akal”#

Inilah antipola utama multiagen. Seseorang mengetahui bahwa Claude Code dapat menjalankan 16 agen sekaligus dan Dynamic Workflows dapat menjalankan 1000 per proses, lalu mereka duduk dan meluncurkannya. Hasilnya: nol. Konsumsi token: 10× sesi biasa.

Uji sederhana. Ambil selembar kertas dan gambar sebuah kotak untuk setiap agen Anda. Di setiap kotak, tulis:

1. Apa tepatnya yang dikerjakannya (satu kalimat).
2. File mana yang disentuhnya.
3. Apa yang dikembalikannya.
4. Siapa yang memeriksanya.

Jika Anda tidak dapat menjawab salah satunya dalam 30 detik, agen itu tidak seharusnya ada. Aturan ini berlaku di setiap tingkat: subagent, tim agen, Dynamic Workflows.

Antipola kedua adalah menjalankan secara paralel pekerjaan yang seharusnya berurutan. Jika frontend membutuhkan backend lebih dahulu karena membaca skema API, jangan jalankan keduanya secara paralel. Kerjakan backend lebih dahulu, lalu frontend. Tugas hanya boleh dijalankan secara paralel jika independen.

Antipola ketiga adalah menggunakan multiagen demi kecepatan. Ini hanya berhasil sampai titik tertentu. Jika Anda membagi tugas menjadi empat alur kerja independen, semuanya akan selesai kira-kira dalam waktu yang dibutuhkan satu alur kerja (ditambah sedikit biaya koordinasi). Namun, jika ada 50 alur kerja pada satu mesin, masing-masing berjalan lebih lambat karena berbagi CPU. Batas praktis pada laptop adalah 4–6 instance Claude Code secara bersamaan; setelah itu, pelambatan mulai terjadi.

Berapa biayanya, dan bagaimana menghindari menghabiskan batas penggunaan?#

Pada Mei–Juni 2026, industri menghadapi kenyataan bahwa pengodean dengan AI lebih mahal daripada perkiraan.

Satu sesi obrolan Claude Code biasa biayanya relatif wajar. Aktifkan Dynamic Workflows untuk seluruh repositori, dan tagihannya menjadi 20× lebih tinggi. Dari dokumentasi resmi Anthropic:

Yang perlu dilakukan dalam praktik. Aturan penghematan dari praktik yang diceritakan.

1. Tentukan file untuk setiap agen secara tepat. Bukan “tinjau proyek dan temukan masalah,” melainkan “tinjau src/auth/*.ts dan periksa apakah setiap fungsi memvalidasi userId.” Prompt kedua akan memberi Anda tepat seperti apa pekerjaan yang Anda bayar.

2. Selalu coba workflow pada satu direktori terlebih dahulu. Bukan seluruh src/. Mulailah dengan src/auth/. Jika Anda menyukai hasilnya dan memahami biayanya, barulah terapkan lebih luas.

3. Gunakan /effort high secara default, dan ultracode hanya dengan sengaja. /effort ultracode berarti xhigh ditambah orkestrasi otomatis. Biayanya sangat tinggi. Gunakan saat tugas benar-benar membutuhkan beberapa alur kerja paralel.

4. Alihkan subagent ke model yang lebih kecil jika memungkinkan. Jika Anda memiliki enam subagent yang meninjau satu panduan, agen QA yang memeriksa AI maupun pemeriksa tautan silang tidak memerlukan Opus. Sonnet cukup. Ini mengurangi penggunaan sebesar 3–5×.

Pembahasan terperinci tentang penghematan token ada di panduan Ke Mana Token Claude Code Digunakan dan Cara Tidak Menghabiskan Batas Penggunaan Claude Code.

Mulai dari mana hari ini: daftar periksa 30 menit#

1. Perbarui Claude Code ke v2.1.154+

   Ini versi minimum yang mendukung Dynamic Workflows. Jalankan claude update di terminal.

2. Aktifkan Dynamic Workflows di /config

   Fitur ini dinonaktifkan secara default pada paket Pro. Buka /config, cari baris “Dynamic workflows,” lalu aktifkan. Fitur ini sudah aktif pada paket Max, Team, dan Enterprise.

3. Buat worktree pertama Anda

   Di direktori proyek utama, jalankan git worktree add ../<project>-experiment <branch>. Buka jendela terminal kedua di direktori tersebut. Jalankan claude.

4. Tambahkan daftar tugas bersama

   Gunakan satu jalur absolut di luar semua worktree. tasks.md dalam setiap worktree adalah file terpisah dan tidak otomatis tersinkron. Jadikan sesi pemimpin satu-satunya penulis; pekerja membaca daftar bersama dan melaporkan hasil kepada pemimpin.

   Buat direktori koordinasi dan daftar tugas sekali:

   mkdir -p "$HOME/projects/my-app-coordination"
   printf '%s\n' '# Tasks' '- Auth: assigned to the auth worktree' '- Billing: assigned to the billing worktree' > "$HOME/projects/my-app-coordination/tasks.md"
   

   Pada terminal pertama:

   cd "$HOME/projects/my-app-auth"
   printf 'Shared task list: %s\n' "$HOME/projects/my-app-coordination/tasks.md"
   claude
   

   Pada terminal kedua:

   cd "$HOME/projects/my-app-billing"
   printf 'Shared task list: %s\n' "$HOME/projects/my-app-coordination/tasks.md"
   claude
   

   Dalam kedua sesi, berikan agen jalur absolut lengkap yang sama seperti tercetak di atas: “Baca daftar tugas bersama ini. Kerjakan hanya tugas dan file yang ditugaskan. Jangan edit daftar; laporkan penyelesaian dan penghambat kepada pemimpin, yang memiliki wewenang memperbaruinya.” Pastikan kedua agen dapat membaca file yang tepat itu sebelum bekerja; permintaan izin harus diselesaikan untuk jalur tersebut. Daftar mengoordinasikan status, sedangkan perubahan kode tetap berada dalam worktree terpisah.

5. Bekerjalah dengan cara ini selama seminggu

   Jangan langsung memasang pembungkus GUI. Habiskan seminggu bekerja secara manual dengan dua worktree. Anda akan melihat apa yang kurang; lalu pilih alat untuk mengatasi kendala tertentu.

6. Baru setelah itu aktifkan `/effort ultracode`

   Pilih satu tugas, seperti “temukan semua endpoint API tanpa pemeriksaan autentikasi di src/routes/.” Aktifkan /effort ultracode. Lihat workflow yang ditulis Claude, biayanya, dan hasil yang dihasilkan. Itulah Dynamic Workflow pertama Anda.

Langkah selanjutnya: memori antar-sesi, Code Review, Multi-Agent v2#

Hal-hal yang muncul pada Mei–Juni 2026, dan arah perkembangan multiagen di Claude Code.

Managed Agents dengan Dreaming. Dirilis pada 6 Mei 2026, di Code with Claude. Proses terjadwal yang membaca transkrip masa lalu agen di antara sesi, mengidentifikasi pola berulang, dan memperbarui memorinya. Penyelesaian tugas perusahaan hukum AI Harvey meningkat enam kali lipat, khususnya setelah Dreaming. Masih dalam pratinjau riset.

Outcomes sebagai fitur Managed Agents. Dijelaskan di atas. Tersedia melalui Claude Agent SDK, bukan secara langsung di CLI Claude Code. Anda dapat menerapkan pola yang sama secara manual sekarang juga menggunakan subagent penilai.

Multi-Agent Orchestration v2 di Claude Agent SDK. Agen pemimpin mendelegasikan subagent sendiri dengan menggunakan sistem file bersama. Ini merupakan langkah dari “luncurkan N subagent secara manual” ke “jelaskan tugas, lalu pemimpin memutuskan sendiri kepada siapa tugas didelegasikan dan bagaimana caranya.” Jika Anda baru belajar subagent, jangan khawatirkan v2 dulu. Pelajari pola klasik—“satu agen utama + 3–5 subagent dengan peran berbeda”—lalu beralih ke v2 secara alami dalam 3–6 bulan.

Code Review oleh tim agen. Anthropic mengumumkan fitur di Code with Claude untuk tinjauan kode otomatis saat PR dibuka. Tim agen AI memeriksa diff secara paralel, mencari bug, saling memverifikasi temuan, dan mengurutkannya berdasarkan tingkat keparahan. Tersedia pada paket Team dan Enterprise, belum tersedia pada Pro.

Plugin Marketplace. Diluncurkan pada 23 Mei 2026, pada v2.1.128-136. Beberapa plugin marketplace merupakan penyiapan multiagen siap pakai (parallel-review, security-audit, migration-helper). Anda dapat memasangnya dengan /plugin install <name>@claude-plugins-official dan melihat susunannya—cara yang baik untuk mempelajari cara menulis plugin sendiri.

Multiagen di Claude Code masih tampak seperti sekumpulan primitif dengan tingkat kematangan berbeda. Subagent dan git worktree stabil, teruji, dan berfungsi di mana saja. Tim agen setengah otomatis, setengah manual. Dynamic Workflows masih dalam pratinjau riset dan berubah dengan cepat. Managed Agents v2 hanya untuk perusahaan. Artinya, selama tahun depan, penyiapan optimal bagi vibe coder bukanlah rilis terbaru, melainkan penyiapan minimum yang diperlukan untuk tugas tertentu. Dua worktree dan satu subagent penilai cukup untuk sebulan kerja aktif. Tambahkan kompleksitas hanya saat Anda mulai merasa terkendala.

Penyiapan yang berfungsi untuk vibe coding#

Materi praktis: dokumentasi Ailoot.

Materi dan alat lainnya: Ailoot.