Orkestrasi subagen dalam skala besar dengan alur kerja dinamis
Alur kerja dinamis mengorkestrasi banyak subagen dari skrip yang ditulis Claude dan dapat Anda jalankan kembali. Gunakan untuk audit basis kode, migrasi besar, dan penelitian lintas-periksa.
{/* plan-availability: feature=workflows plans=pro,max,team,enterprise providers=all */}
Alur kerja dinamis adalah skrip JavaScript yang mengorkestrasi subagen dalam skala besar. Claude menulis skrip untuk tugas yang Anda jelaskan, dan runtime menjalankannya di latar belakang sementara sesi Anda tetap responsif.
Gunakan alur kerja ketika tugas memerlukan lebih banyak agen daripada yang dapat dikoordinasikan satu percakapan, atau ketika Anda ingin orkestrasi dikodifikasi sebagai skrip yang dapat Anda baca dan jalankan kembali. Contohnya termasuk penyapuan bug di seluruh basis kode, migrasi 500 file, pertanyaan penelitian yang memerlukan sumber untuk diperiksa silang satu sama lain, dan rencana sulit yang layak dirancang dari beberapa sudut pandang independen sebelum Anda berkomitmen pada satu.
Halaman ini mencakup cara untuk:
- Memutuskan kapan menggunakan alur kerja daripada subagen atau skills
- Menjalankan alur kerja bundel dengan
/deep-research - Membiarkan Claude menulis alur kerja untuk tugas Anda dan menyimpannya
- Memahami cara alur kerja berjalan dan mengelola run
Kapan menggunakan alur kerja
Subagen, skills, tim agen, dan alur kerja semuanya dapat menjalankan tugas multi-langkah. Perbedaannya adalah siapa yang memegang rencana:
| Subagen | Skills | Tim agen | Alur kerja | |
|---|---|---|---|---|
| Apa itu | Pekerja Claude yang dihasilkan | Instruksi yang diikuti Claude | Agen utama yang mengawasi sesi rekan | Skrip yang dijalankan runtime |
| Siapa yang memutuskan apa yang berjalan selanjutnya | Claude, giliran demi giliran | Claude, mengikuti prompt | Agen utama, giliran demi giliran | Skrip |
| Di mana hasil antara tinggal | Jendela konteks Claude | Jendela konteks Claude | Daftar tugas bersama | Variabel skrip |
| Apa yang dapat diulang | Definisi pekerja | Instruksi | Definisi tim | Orkestrasi itu sendiri |
| Skala | Beberapa tugas yang didelegasikan per giliran | Sama dengan subagen | Segelintir rekan yang berjalan lama | Puluhan hingga ratusan agen per run |
| Gangguan | Memulai ulang giliran | Memulai ulang giliran | Rekan kerja terus berjalan | Dapat dilanjutkan dalam sesi yang sama |
Alur kerja memindahkan rencana ke dalam kode. Dengan subagen, skills, dan tim agen, Claude adalah orkestrator: ia memutuskan giliran demi giliran apa yang akan dihasilkan atau ditugaskan selanjutnya, dan setiap hasil mendarat di jendela konteks. Skrip alur kerja memegang loop, percabangan, dan hasil antara itu sendiri, jadi konteks Claude hanya memegang jawaban akhir.
Memindahkan rencana ke dalam kode juga memungkinkan alur kerja menerapkan pola kualitas yang dapat diulang, bukan hanya menjalankan lebih banyak agen: ia dapat memiliki agen independen yang secara adversarial meninjau temuan satu sama lain sebelum dilaporkan, atau merancang rencana dari beberapa sudut dan menimbangnya satu sama lain, sehingga Anda mendapatkan hasil yang lebih dapat dipercaya daripada satu kali jalan.
Jalankan alur kerja bundel
Cara tercepat untuk melihat alur kerja dalam tindakan adalah menjalankan /deep-research, alur kerja bawaan yang disertakan Claude Code untuk menyelidiki pertanyaan di banyak sumber. Anda akan melihat agen bekerja melalui serangkaian fase di latar belakang sementara sesi Anda tetap bebas, dan dapatkan satu laporan di akhir daripada transkrip giliran demi giliran.
Jalankan alur kerja
Jalankan /deep-research dengan pertanyaan yang ingin Anda selidiki. Ini menyebarkan pencarian web di beberapa sudut, mengambil dan memeriksa silang sumber yang ditemukannya, dan mensintesis laporan yang dikutip.
/deep-research What changed in the Node.js permission model between v20 and v22?
Izinkan alur kerja
Claude Code menanyakan apakah akan mengizinkan alur kerja. Pilih Yes untuk melanjutkan. Prompt yang tepat tergantung pada mode izin Anda. Lihat Setujui rencana sebelum berjalan untuk opsi per-mode.
Tonton kemajuan
Run dimulai di latar belakang. Jalankan /workflows, gunakan tombol panah untuk memilih run, dan tekan Enter untuk membuka tampilan kemajuannya:
/workflows
Tampilan menunjukkan setiap fase dengan jumlah agen, total token, dan waktu yang telah berlalu. Bor ke dalam fase apa pun untuk melihat agennya dan apa yang masing-masing temukan. Lihat Tonton run untuk set kontrol lengkap.
Anda juga dapat menonton dari panel tugas di bawah kotak input: ringkasan kemajuan satu baris muncul di sana saat run sedang berjalan. Tekan panah bawah untuk fokus, lalu Enter untuk memperluas.
Baca laporan
Ketika run selesai, laporan mendarat di sesi Anda. Ini mengutip sumber setiap klaim berasal, dengan klaim yang tidak bertahan pemeriksaan silang sudah disaring.
Untuk menjalankan alur kerja untuk tugas Anda sendiri, biarkan Claude menulis satu, dan setelah run melakukan apa yang Anda inginkan, Anda dapat menyimpannya sebagai perintah Anda sendiri.
Alur kerja bundel
Claude Code menyertakan /deep-research sebagai alur kerja bawaan:
| Perintah | Apa yang dilakukannya |
|---|---|
/deep-research <question> |
Menyebarkan pencarian web pada pertanyaan di beberapa sudut, mengambil dan memeriksa silang sumber yang ditemukannya, memilih setiap klaim, dan mengembalikan laporan yang dikutip dengan klaim yang tidak bertahan pemeriksaan silang disaring. Memerlukan alat WebSearch tersedia |
Alur kerja yang Anda simpan sendiri menjadi perintah dengan cara yang sama dan muncul dalam / autocomplete bersama yang bundel.
Tonton run
Alur kerja berjalan di latar belakang, jadi sesi tetap responsif sementara agen bekerja. Jalankan /workflows kapan saja untuk membuat daftar alur kerja yang sedang berjalan dan selesai, lalu pilih satu untuk membuka tampilan kemajuannya.
/workflows
Tampilan kemajuan menunjukkan setiap fase dengan jumlah agen, total token, dan waktu yang telah berlalu. Footer mencantumkan kunci untuk setiap tindakan:
| Kunci | Tindakan |
|---|---|
↑ / ↓ |
Pilih fase atau agen |
Enter atau → |
Bor ke dalam fase yang dipilih, lalu ke agen untuk membaca prompt, panggilan alat terbaru, dan hasilnya |
Esc |
Kembali satu level |
j / k |
Gulir dalam detail agen ketika meluap |
p |
Jeda atau lanjutkan run |
x |
Hentikan agen yang dipilih, atau hentikan seluruh alur kerja ketika fokus ada di run |
r |
Mulai ulang agen yang sedang berjalan yang dipilih |
s |
Simpan skrip run sebagai perintah |
Biarkan Claude menulis alur kerja
Anda dapat membiarkan Claude menulis alur kerja untuk tugas Anda dengan dua cara:
- Minta alur kerja dalam prompt Anda dengan kata kunci
ultracode, dan Claude menulis satu untuk tugas tersebut. - Biarkan Claude memutuskan dengan ultracode: atur
/effort ultracodedan Claude merencanakan alur kerja untuk setiap tugas substansial dalam sesi.
Anda juga dapat menjalankan perintah alur kerja yang sudah ada: alur kerja bundel seperti /deep-research, atau satu yang telah Anda simpan.
Minta alur kerja dalam prompt Anda
Untuk menjalankan satu tugas sebagai alur kerja tanpa mengubah tingkat upaya sesi, sertakan kata kunci ultracode dalam prompt Anda. Meminta dengan kata-kata Anda sendiri, misalnya "gunakan alur kerja" atau "jalankan alur kerja", juga berfungsi: Claude memperlakukan permintaan langsung sebagai opt-in yang sama. Sebelum v2.1.160 kata kunci pemicu literal adalah workflow; permintaan bahasa alami berfungsi di kedua versi.
ultracode: audit every API endpoint under src/routes/ for missing auth checks
Claude Code menyoroti kata kunci dalam input Anda dan Claude menulis skrip alur kerja untuk tugas daripada mengerjakannya giliran demi giliran. Jika Anda tidak bermaksud memulai alur kerja, tekan Option+W di macOS atau Alt+W di Windows dan Linux untuk menghilangkan sorotan untuk prompt ini, atau tekan backspace saat kursor berada tepat setelah kata kunci yang disorot. Untuk menghentikan kata kunci agar tidak memicu sama sekali, matikan pemicu kata kunci Ultracode di /config.
Jika run melakukan apa yang Anda inginkan, Anda dapat menyimpannya sebagai perintah setelahnya.
Jika Anda sudah memiliki orchestrator yang dibangun dengan cara lain, seperti folder prompt subagen atau skill yang menyebarkan pekerjaan, Anda dapat menunjukkan Claude ke sana dan meminta alur kerja yang melakukan hal yang sama.
Biarkan Claude memutuskan dengan ultracode
Ultracode adalah pengaturan Claude Code yang menggabungkan upaya reasoning xhigh dengan orkestrasi alur kerja otomatis. Dengan itu aktif, Claude merencanakan alur kerja untuk setiap tugas substansial daripada menunggu Anda untuk meminta.
/effort ultracode
Dengan ultracode aktif, Claude memutuskan kapan tugas memerlukan alur kerja. Satu permintaan dapat berubah menjadi beberapa alur kerja berturut-turut: satu untuk memahami kode, satu untuk membuat perubahan, dan satu untuk memverifikasinya. Ini berlaku untuk setiap tugas dalam sesi, jadi setiap permintaan menggunakan lebih banyak token dan memakan waktu lebih lama daripada pada tingkat upaya yang lebih rendah.
Ultracode berlangsung untuk sesi saat ini dan disetel ulang ketika Anda memulai yang baru. Turun kembali dengan /effort high ketika Anda kembali ke pekerjaan rutin. Ini tersedia di model yang mendukung upaya xhigh effort; di model lain menu /effort tidak menawarkannya.
Setujui rencana sebelum berjalan
Di CLI, prompt per-run menunjukkan fase yang direncanakan dan opsi ini:
- Yes, run it: mulai run
- Yes, and don't ask again for
<name>in<path>: mulai, dan lewati prompt ini untuk alur kerja ini di proyek ini dari sekarang - View raw script: baca skrip sebelum memutuskan
- No: batal
Ctrl+G membuka skrip di editor Anda. Tab memungkinkan Anda menyesuaikan prompt sebelum run dimulai.
Apakah Anda melihat prompt ini tergantung pada mode izin Anda:
| Mode izin | Kapan Anda diminta |
|---|---|
| Default, accept edits | Setiap run, kecuali Anda telah memilih Yes, and don't ask again untuk alur kerja itu di proyek ini |
| Auto | Peluncuran pertama saja. Setiap Yes mencatat persetujuan dalam pengaturan pengguna Anda, dan peluncuran nanti dimulai tanpa meminta. Dilewati sepenuhnya ketika ultracode aktif |
Bypass permissions, claude -p, Agent SDK |
Tidak pernah. Run dimulai segera |
Di aplikasi Desktop, kartu persetujuan menunjukkan nama alur kerja, daftar fase, dan peringatan penggunaan token, dengan tindakan Once, Always, dan Deny. Tampilan kemajuan muncul di panel tugas Latar Belakang.
Mode izin Anda hanya mengontrol prompt peluncuran di atas. Subagen yang dihasilkan alur kerja selalu berjalan dalam mode acceptEdits dan mewarisi allowlist alat Anda, terlepas dari mode sesi Anda. Edit file disetujui secara otomatis.
Perintah shell, pengambilan web, dan alat MCP yang tidak ada dalam allowlist Anda masih dapat meminta Anda di tengah run. Untuk menghindari ini pada run yang panjang, tambahkan perintah yang dibutuhkan agen ke allowlist Anda sebelum memulai.
Di claude -p dan Agent SDK tidak ada orang untuk diminta, jadi panggilan alat mengikuti aturan izin yang dikonfigurasi tanpa konfirmasi interaktif.
Simpan alur kerja untuk digunakan kembali
Ketika Claude menulis alur kerja untuk tugas yang akan Anda ulangi, Anda dapat menyimpan skrip run itu sebagai perintah. Proses seperti tinjauan yang Anda jalankan di setiap cabang kemudian menjalankan orkestrasi yang sama setiap kali.
Jalankan /workflows, pilih run yang ingin Anda simpan, dan tekan s. Dalam dialog simpan, Tab beralih antara dua lokasi simpan:
.claude/workflows/di proyek Anda: dibagikan dengan semua orang yang mengkloning repo~/.claude/workflows/di direktori home Anda: tersedia di setiap proyek, hanya terlihat oleh Anda
Tekan Enter untuk menyimpan. Alur kerja berjalan sebagai /<name> di sesi mendatang dari lokasi mana pun.
{/* min-version: 2.1.178 */}Mulai dari v2.1.178, menyimpan ke lokasi proyek menulis ke direktori .claude/workflows/ terdekat yang sudah ada antara direktori kerja Anda dan akar repositori, atau ke akar repositori jika belum ada. Alur kerja proyek juga dimuat dari setiap .claude/workflows/ di sepanjang jalur itu, dan ketika lebih dari satu mendefinisikan nama yang sama Claude Code menjalankan yang terdekat dengan direktori kerja.
Jika alur kerja proyek dan alur kerja pribadi berbagi nama, yang proyek berjalan.
Teruskan input ke alur kerja yang disimpan
Alur kerja yang disimpan dapat menerima input melalui parameter args. Skrip membacanya sebagai global bernama args. Gunakan ini untuk menyediakan pertanyaan penelitian, daftar jalur target, atau objek konfigurasi pada waktu pemanggilan daripada mengedit skrip untuk setiap run.
Prompt berikut menjalankan alur kerja yang disimpan dengan daftar nomor masalah:
> Run /triage-issues on issues 1024, 1025, and 1030
Claude meneruskan daftar sebagai data terstruktur, sehingga skrip dapat memanggil metode array dan objek pada args secara langsung tanpa menguraikannya terlebih dahulu. Jika args dihilangkan, global adalah undefined di dalam skrip.
Cara alur kerja berjalan
Runtime alur kerja menjalankan skrip di lingkungan terisolasi, terpisah dari percakapan Anda. Hasil antara tetap dalam variabel skrip daripada mendarat di konteks Claude.
Setiap run menulis skripnya ke file di bawah direktori sesi Anda di ~/.claude/projects/. Claude menerima jalur saat run dimulai, jadi Anda dapat memintanya. Anda dapat membuka file tersebut untuk membaca orkestrasi yang ditulis Claude, membandingkannya dengan skrip run sebelumnya, atau mengeditnya dan meminta Claude untuk meluncurkan kembali dari versi yang telah diedit.
Runtime melacak hasil setiap agen saat run berlangsung, yang membuat run dapat dilanjutkan dalam sesi yang sama.
Perilaku dan batas
Runtime menerapkan batasan berikut:
| Batasan | Mengapa |
|---|---|
| Tidak ada input pengguna di tengah run | Hanya prompt izin agen yang dapat menjeda run. Untuk persetujuan antara tahap, jalankan setiap tahap sebagai alur kerja sendiri |
| Tidak ada akses filesystem atau shell langsung dari alur kerja itu sendiri | Agen membaca, menulis, dan menjalankan perintah. Skrip mengoordinasikan agen |
| Hingga 16 agen bersamaan, lebih sedikit di mesin dengan inti CPU terbatas | Membatasi penggunaan sumber daya lokal |
| 1.000 agen total per run | Mencegah loop yang melarikan diri |
Kelola run
Setelah run dimulai, Anda mengelolanya dari tampilan /workflows, atau dengan memperluas baris kemajuannya di panel tugas di bawah kotak input.
Lanjutkan setelah jeda
Jika Anda menghentikan run, Anda dapat melanjutkannya: agen yang sudah selesai mengembalikan hasil cache mereka, dan sisanya berjalan langsung. Lanjutkan run yang dijeda dari /workflows dengan memilihnya dan menekan p, atau minta Claude untuk meluncurkan kembali alur kerja dengan skrip yang sama.
Lanjutkan bekerja dalam sesi Claude Code yang sama. Jika Anda keluar dari Claude Code saat alur kerja sedang berjalan, sesi berikutnya memulai alur kerja segar.
Biaya
Alur kerja menghasilkan banyak agen, jadi satu run dapat menggunakan token yang jauh lebih bermakna daripada menyelesaikan tugas yang sama dalam percakapan. Run dihitung terhadap penggunaan paket Anda dan batas laju seperti sesi lainnya.
Untuk mengukur pengeluaran sebelum berkomitmen pada tugas besar, jalankan alur kerja pada irisan kecil terlebih dahulu: satu direktori alih-alih seluruh repo, atau pertanyaan sempit alih-alih yang luas. Tampilan /workflows menunjukkan penggunaan token setiap agen saat run berlangsung, dan Anda dapat menghentikan run di sana kapan saja tanpa kehilangan pekerjaan yang selesai. agent caps runtime membatasi berapa banyak agen yang dapat dihasilkan satu run, yang membatasi biaya skrip yang lari.
Setiap agen dalam alur kerja menggunakan model sesi Anda kecuali skrip merutekan tahap ke yang berbeda. Untuk mengontrol biaya model:
- Periksa
/modelsebelum run besar jika Anda biasanya beralih ke model yang lebih kecil untuk pekerjaan rutin - Minta Claude untuk menggunakan model yang lebih kecil untuk tahap yang tidak memerlukan yang terkuat ketika Anda menjelaskan tugas
Matikan alur kerja
Alur kerja tersedia di CLI, aplikasi Desktop, ekstensi IDE, mode non-interaktif dengan claude -p, dan Agent SDK. Pengaturan disable yang sama berlaku di setiap permukaan.
Untuk mematikan alur kerja untuk diri sendiri:
- Matikan Dynamic workflows di
/config. Bertahan di seluruh sesi. - Atur
"disableWorkflows": truedi~/.claude/settings.json. Bertahan di seluruh sesi. - Atur
CLAUDE_CODE_DISABLE_WORKFLOWS=1. Dibaca saat startup, jadi berlaku di mana pun Anda mengaturnya.
Untuk mematikan alur kerja untuk seluruh organisasi Anda, atur "disableWorkflows": true di pengaturan yang dikelola server, atau gunakan toggle di halaman pengaturan admin Claude Code.
Ketika alur kerja dinonaktifkan, perintah alur kerja bundel tidak tersedia, kata kunci ultracode tidak lagi memicu run, dan ultracode dihapus dari menu /effort.
Sumber daya terkait
- Jalankan agen secara paralel: bandingkan subagen, tampilan agen, tim agen, dan alur kerja
- Buat subagen kustom: primitif pekerja yang diorkestrasikan alur kerja
- Kelola biaya: bagaimana run multi-agen dihitung terhadap batas penggunaan