SpyBara
Go Premium

workflows.md 2026-09-08 20:00 UTC to 2026-09-09 22:58 UTC

This page contains 152 additions and 62 deletions.

2026
Wed 9 22:58 Sat 12 03:02 Fri 18 23:58 Tue 22 23:59 Fri 25 23:58

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.

Alur kerja dinamis adalah skrip JavaScript yang mengorkestrasi banyak subagen sekaligus. 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.

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.

1

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?
2

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.

3

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.

4

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.

Ketika agen verifikasi tidak dapat memeriksa klaim, seperti setelah batas laju atau kesalahan API, laporan mencantumkan klaim tersebut sebagai tidak terverifikasi daripada menghitungnya sebagai dibantah.

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

/deep-research berjalan hanya ketika Anda menjalankannya.

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.

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 atau ← Kembali satu level. Dalam v2.1.203 hingga v2.1.205, ← tidak melangkah keluar dari fase atau agen; gunakan Esc pada versi tersebut
j / k Gulir dalam detail agen ketika meluap
f Filter daftar agen di fase yang dipilih berdasarkan status. Tekan lagi untuk siklus
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:

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.

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. Kata kunci hanya memilih cara Claude menyusun pekerjaan: panggilan alat agen menerima pemeriksaan izin yang sama dan sandboxing seperti panggilan alat lainnya dalam sesi.

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.

Hilangkan atau matikan kata kunci

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.

Tempat kata kunci bekerja

Kata kunci adalah opt-in hanya dalam prompt yang Anda ketik sendiri: di prompt interaktif, di panel ekstensi IDE, di klien Remote Control, atau di aplikasi Agent SDK yang memberi stempel pada input keyboard Anda dengan origin sebagai { kind: "human" }. Ini tidak memulai alur kerja ketika mencapai sesi dengan cara lain:

  • prompt yang dilewatkan dengan -p
  • prompt yang dikirim aplikasi Agent SDK tanpa memberi stempel sebagai input manusia
  • prompt tugas terjadwal
  • payload webhook atau komentar pull request yang disalurkan ke percakapan

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

Untuk memulai sesi dengan ultracode sudah aktif, luncurkan dengan claude --effort ultracode. Memerlukan Claude Code v2.1.203 atau lebih baru.

Untuk mengaktifkannya saat Anda memilih model, pindahkan penggeser upaya pemilih /model ke ultracode dengan tombol panah. Sesuaikan tingkat upaya mencantumkan rute yang mengaktifkan 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.

/effort ultracode berlangsung untuk sesi saat ini; untuk memiliki setiap sesi dimulai dengan itu, atur pengaturan ultracode. 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. Claude Code menawarkan opsi ini ketika Anda menjalankan alur kerja bundel, disimpan, atau plugin berdasarkan nama, bukan untuk skrip yang Claude tulis untuk tugas saat ini.
  • 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
Auto Peluncuran pertama saja. Setiap Yes mencatat persetujuan dalam pengaturan pengguna Anda, dan peluncuran nanti dimulai tanpa meminta. Dilewati sepenuhnya ketika ultracode aktif
Manual, accept edits Setiap run, kecuali Anda telah memilih Yes, and don't ask again untuk alur kerja itu di proyek ini
Bypass permissions Claude Code tidak meminta Anda. Run dimulai segera
claude -p, Agent SDK Claude Code tidak meminta Anda

Di claude -p dan Agent SDK, Claude Code tidak pernah menampilkan prompt ini. Ini menjalankan panggilan alat Workflow melalui evaluasi izin yang sama seperti sisa sesi, jadi aturan deny, aturan ask, dan mode dontAsk berlaku untuk peluncuran seperti yang berlaku untuk setiap panggilan alat. Untuk membiarkan alur kerja dimulai dalam run ini, gunakan salah satu dari ini:

  • Aturan izin: Workflow dalam aturan allow Anda menyetujui setiap alur kerja, dan Workflow(<name>) menyetujui satu alur kerja yang disimpan berdasarkan nama.
  • Mode izin auto: classifier meninjau panggilan dan dapat menyetujuinya.
  • Mode bypass permissions: Claude Code menyetujui panggilan.
  • Hook PreToolUse: hook yang mengembalikan allow untuk panggilan menyetujuinya.
  • Host Anda: --permission-prompt-tool menyetujuinya, atau, dengan Agent SDK, callback canUseTool atau hook PermissionRequest menyetujuinya.

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.

Subagen yang dihasilkan alur kerja menggunakan aturan izin Anda, dan Claude Code memilih mode izin mereka berdasarkan aturan di bawah mode izin mana yang dijalankan subagen. Untuk menghindari prompt pada run yang panjang, tambahkan alat yang dibutuhkan agen ke aturan allow Anda sebelum memulai.

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. Jika Anda menetapkan CLAUDE_CONFIG_DIR, lokasi ini adalah direktori workflows/ di bawah jalur itu.

Dialog simpan menunjukkan jalur yang diselesaikan untuk lokasi pribadi.

Tekan Enter untuk menyimpan. Alur kerja berjalan sebagai /<name> di sesi mendatang dari lokasi mana pun.

Claude Code memeriksa lokasi simpan untuk symlink sebelum menulis, dan menampilkan kesalahan daripada menulis melalui satu. Apa yang diperiksa tergantung pada tempat Anda menyimpan:

  • Lokasi proyek: Claude Code menolak jika .claude, .claude/workflows, atau file target adalah symlink.
  • Lokasi pribadi: Claude Code hanya menolak jika file target itu sendiri adalah symlink, jadi direktori ~/.claude yang dikelola oleh alat dotfiles masih berfungsi.

Sebelum v2.1.216, Claude Code mengikuti tautan, yang dapat menempatkan file di luar lokasi yang Anda pilih.

Dalam monorepo dengan beberapa direktori .claude/, Anda dapat menyimpan alur kerja di samping paket yang mereka terapkan. 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.

Distribusikan alur kerja dalam plugin

Untuk berbagi alur kerja di seluruh tim atau repositori, sertakan dalam plugin. Tempatkan skrip dalam direktori workflows/ di akar plugin, atau arahkan ke lokasi berbeda dengan field manifes workflows.

Alur kerja plugin diberi namespace oleh nama plugin. Plugin yang disebut acme-tools yang berisi skrip yang meta.name adalah release-audit berjalan sebagai /acme-tools:release-audit.

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.

Contoh prompt alur kerja

Alur kerja paling cocok ketika tugas lebih besar daripada yang dapat dipegang satu agen dalam konteks, atau ketika langkah yang sama perlu berjalan di banyak item. Prompt di bawah menunjukkan bentuk umum. Masing-masing meminta Claude untuk menulis dan menjalankan alur kerja untuk tugas itu; Anda tidak menulis skrip sendiri.

Audit banyak file untuk masalah yang sama

Sebarkan satu agen per file, lalu kumpulkan dan verifikasi temuan.

use a workflow to audit every route handler under src/routes/ for missing authentication checks, and adversarially verify each finding before reporting it

Terus memperbaiki sampai pemeriksaan lulus

Jalankan pemeriksa, perbaiki apa yang gagal, dan ulangi sampai lulus atau berhenti membuat kemajuan.

use a workflow to run npx tsc --noEmit and keep fixing the reported errors until the type check passes or two rounds in a row make no progress

Migrasi banyak file secara paralel

Temukan file untuk migrasi, ubah masing-masing dalam salinan terisolasi sehingga edit tidak bertentangan, dan verifikasi setiap hasil.

use a workflow to migrate every component under src/components/ from JavaScript to TypeScript, working on each file in its own isolated copy

Tinjau setiap file yang berubah dan tulis satu ringkasan

Jalankan peninjau per file, lalu serahkan semua temuan ke satu agen yang mengurutkan dan menghilangkan duplikat.

use a workflow to review every file changed in this PR for correctness issues, then merge the per-file findings into one ranked summary

Teliti topik di banyak sumber

Sebarkan pembaca di seluruh changelog, masalah, dan dokumen, lalu sintesis. Alur kerja /deep-research bundel melakukan ini; Anda juga dapat menjelaskan versi yang lebih sempit.

use a workflow to research how our three competitors handle rate limiting: read their public docs and recent changelog entries in parallel, then compare the approaches

Temukan masalah sampai daftar berhenti tumbuh

Terus cari dalam putaran dan berhenti ketika putaran baru tidak menemukan apa pun yang baru.

use a workflow to find flaky tests in this repo: run the suite repeatedly, record which tests fail intermittently, and stop once two rounds in a row find nothing new

Apa yang terlihat seperti skrip yang disimpan

Ketika Anda menyimpan alur kerja, file di .claude/workflows/ memegang blok meta diikuti oleh badan skrip yang mengorkestrasi subagen. Anda biasanya tidak perlu mengeditnya, tetapi di sini adalah bentuk yang kecil sehingga Anda dapat mengenali apa yang dihasilkan Claude:

export const meta = {
  name: 'audit-routes',
  description: 'Audit every route handler for missing auth checks',
}

const found = await agent('List every .ts file under src/routes/.', {
  schema: { type: 'object', required: ['files'], properties: { files: { type: 'array', items: { type: 'string' } } } },
})

const audits = await pipeline(found.files, file =>
  agent(`Audit ${file} for missing authentication checks.`, { label: file }),
)

return audits.filter(Boolean)

Badan adalah JavaScript biasa dengan await tingkat atas. agent() menghasilkan satu subagen, pipeline() menjalankan satu per item dalam daftar, dan parallel() menjalankan serangkaian tugas agen pada waktu yang sama dan menunggu semuanya selesai.

Panggilan agent() diselesaikan ke null jika Anda menghentikannya di tengah-jalan atau mengalami kesalahan API yang tidak dapat dipulihkan. pipeline() menyimpan null itu dalam array hasil, itulah mengapa contoh berakhir dengan .filter(Boolean) untuk menghapus entri tersebut.

Edit skrip yang disimpan

Untuk mengubah alur kerja yang Anda simpan, edit file .js atau minta Claude untuk membuat perubahan. Sebelum Anda mengedit atau meminta, jalankan skill bundel /workflow-authoring untuk memuat referensi penulisan skrip yang digunakan Claude. Skill memerlukan Claude Code v2.1.248 atau lebih baru.

Untuk menjalankan versi yang telah diedit dalam sesi saat ini, jalankan /reload-skills untuk membaca ulang direktori alur kerja, lalu jalankan /<name> lagi.

Claude Code menerapkan aturan ini untuk setiap bagian file ketika memuat dan menjalankan skrip:

  • Blok meta: pertahankan export const meta sebagai pernyataan pertama, dan pertahankan sebagai literal objek biasa dengan name dan description. Jika berisi apa pun selain nilai literal, seperti variabel, panggilan fungsi, atau spread, Claude Code menghapus /<name> dari pelengkapan otomatis /.
  • Badan: selain agent(), pipeline(), dan parallel(), Anda dapat memanggil phase() untuk mengelompokkan agen yang mengikuti di bawah judul dalam tampilan kemajuan, memanggil log() untuk menampilkan pesan di atas fase, dan membaca global args. Jika badan memiliki kesalahan sintaks, Claude Code melaporkannya ketika Anda menjalankan alur kerja.
  • phases: jika Anda mencantumkannya di meta, berikan setiap entri judul yang tepat yang Anda berikan ke phase(). Judul phase() tanpa entri mendapatkan grup kemajuan sendiri.
  • Stempel waktu dan keacakan: Claude Code membuat Date.now(), Math.random(), dan new Date() tanpa argumen melempar di dalam skrip, sehingga peluncuran ulang mengulangi panggilan agent() yang sama. Berikan stempel waktu melalui args sebagai gantinya.

Anda juga dapat mengedit skrip dari satu run tunggal daripada salinan yang disimpan. Lanjutkan setelah jeda mencakup agen mana yang berjalan lagi ketika Anda meluncurkan ulang skrip yang telah diedit. Untuk input alat Workflow, lihat entrinya dalam referensi Agent SDK.

Bagaimana 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.

Claude dapat memulai alur kerja hanya dari file skrip yang sudah diizinkan dibaca oleh sesi. Untuk menjalankan skrip yang disimpan di luar direktori kerja Anda, tambahkan direktorinya terlebih dahulu dengan /add-dir atau aturan izin Read.

Runtime melacak hasil setiap agen saat run berlangsung, yang membuat run dapat dilanjutkan dalam sesi yang sama.

Prompt caching dalam fan-out

Agen dalam run yang sama dapat membaca prompt cache satu sama lain. Dua agen yang berjalan dengan model yang sama, tingkat upaya yang sama, jenis agen yang sama, tools yang sama, skema output yang sama, dan direktori kerja yang sama membangun prefix prompt sistem dan tools yang sama, jadi agen yang dimulai setelah respons sibling yang cocok telah dimulai membaca cache sibling tersebut pada permintaan pertamanya.

Permintaan agen alur kerja berada di luar bucket TTL cache percakapan utama, jadi cachenya bertahan selama lima menit secara default, termasuk pada langganan Claude. Untuk menyimpannya selama satu jam, atur subagentPromptCacheTtl ke 1h. API menagih penulisan cache 1 jam dengan tarif yang lebih tinggi.

Ketika fan-out memulai beberapa agen yang cocok sekaligus, Claude Code menahan semua kecuali yang pertama sampai respons agen pertama dimulai, kemudian melepaskan agen yang ditahan bersama-sama sehingga permintaan pertama mereka membaca prefix bersama daripada masing-masing memproses tanpa cache. Claude Code membatasi penahan pada CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS milidetik, 5000 secara default. Atur ke 0 untuk menonaktifkan penahan.

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
Tidak ada pemuatan modul: skrip yang berisi import() gagal sebelum run dimulai Badan skrip adalah JavaScript biasa. Letakkan pekerjaan yang memerlukan library dalam tugas agen
Hingga 16 agen bersamaan, lebih sedikit ketika Claude Code memiliki lebih sedikit CPU yang tersedia, termasuk di dalam kontainer dengan CPU terbatas Membatasi penggunaan sumber daya lokal
Dalam fan-out, agen yang berbagi prefix prompt-cache agen pertama dimulai hingga 5 detik setelahnya secara default Semua kecuali yang pertama membaca prefix yang di-cache agen pertama daripada masing-masing memproses tanpa cache
Hingga 4.096 item dalam satu panggilan parallel() atau pipeline(): runtime menolak daftar yang lebih panjang dengan kesalahan Batas diam akan menghilangkan bagian dari beban kerja tanpa memberi tahu skrip
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

Lanjutkan run yang dijeda dari /workflows dengan memilihnya dan menekan p. Untuk run yang Anda hentikan, minta Claude untuk meluncurkan kembali alur kerja dengan skrip yang sama. Claude Code memutar ulang run dalam urutan agen dimulai, dan setiap agen baik mengembalikan hasil yang disimpannya atau berjalan lagi:

  • Selesai: mengembalikan hasil yang disimpannya. Agen pertama yang promptnya berbeda dari run sebelumnya, karena Anda mengedit skrip atau agen sebelumnya mengembalikan sesuatu yang berbeda, berjalan lagi, begitu juga setiap agen setelahnya, bahkan yang sudah selesai.
  • Masih berjalan saat Anda menghentikan: dimulai ulang. Menghentikan seluruh run tidak menghitung agen apa pun sebagai gagal.
  • Gagal: berjalan lagi, begitu juga setiap agen yang dimulai setelahnya, bahkan yang sudah selesai. Menghentikan satu agen saja, dengan memilihnya di /workflows dan menekan x, dihitung sebagai gagal.

Kasus terakhir berarti kegagalan di tengah fan-out yang menjalankan ulang pekerjaan yang sudah selesai. Jika skrip memulai A, B, C, dan D dalam urutan itu dan B gagal, meluncurkan ulang mengembalikan A dari cache dan menjalankan B, C, dan D lagi.

Anda dapat melanjutkan run dalam sesi Claude Code yang sama. Apa yang terjadi pada alur kerja yang berjalan saat Anda meninggalkan sesi tergantung pada cara Anda pergi:

  • Jika Anda menempatkan sesi di latar belakang, Claude Code memutar ulang run dengan cara yang sama di sesi latar belakang dan melanjutkannya.
  • Jika Anda keluar dari Claude Code saat alur kerja sedang berjalan dan tampilan agen aktif, dialog keluar menawarkan Move to background and exit, yang membawa run dengan cara yang sama. Jika Anda memilih Exit and stop tasks sebagai gantinya, atau opsi tidak ditawarkan, run berhenti dengan sesi. Claude Code menyimpan hasil yang disimpan run di bawah direktori sesi itu di ~/.claude/projects/, jadi sesi yang Anda lanjutkan dengan claude --resume dapat memutar ulangnya saat Anda meminta Claude untuk meluncurkan kembali alur kerja, sementara sesi yang Anda mulai segar tidak memiliki apa pun untuk diputar ulang dan memulai alur kerja dari awal.

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, biasanya tanpa kehilangan pekerjaan yang selesai. Lanjutkan setelah jeda mencakup apa yang disimpan run yang dihentikan. Agent caps runtime membatasi berapa banyak agen yang dapat dihasilkan satu run, yang membatasi biaya skrip yang lari. Untuk menjaga run tetap lebih sedikit agen, pilih panduan ukuran small .

Claude Code juga menandai run yang tumbuh secara tidak biasa besar. Ketika alur kerja menjadwalkan lebih dari 25 agen, atau total token proyeksiannya melampaui 1,5 juta, baris kemajuannya di panel tugas di bawah kotak input menampilkan peringatan Large workflow. Peringatan mengarahkan Anda ke /workflows, di mana Anda dapat menghentikan run.

Peringatan bersifat informatif: tidak menghentikan atau membatasi run. Dua pengaturan berubah saat Anda melihatnya:

  • Jika Anda memilih panduan ukuran sendiri, jumlah agen panduan menggantikan ambang batas 25 agen. Panduan default bawaan meninggalkan ambang batas di 25.
  • Sesi dengan ultracode aktif tidak menampilkan peringatan, karena mengaktifkan ultracode sudah memilih Anda untuk run besar.

Claude Code memilih model agen alur kerja setiap dalam urutan yang sama yang digunakan untuk subagen. Model yang dinamai skrip untuk tahap dihitung sebagai model per-invocation dalam urutan itu. Ketika tidak ada yang lain menetapkan satu, agen berjalan pada model sesi Anda.

Untuk mengontrol biaya model:

  • Periksa /model sebelum 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 saat Anda menjelaskan tugas

Ketika availableModels allowlist organisasi Anda memblokir model yang diminta skrip untuk agen, agen itu berjalan pada model substitusi sebagai gantinya, mengikuti aturan substitusi yang sama seperti subagen. Tampilan kemajuan run di /workflows menampilkan peringatan yang menamai model yang diminta dan disubstitusi.

Tetapkan panduan ukuran

Panduan ukuran memberi tahu Claude berapa banyak agen yang harus ditargetkan saat menulis alur kerja dinamis. Claude Code mengirimkan panduan ke Claude sebagai saran, bukan batas, jadi prompt yang meminta skala berbeda masih menggantinya. Memerlukan Claude Code v2.1.202 atau lebih baru.

Setiap nilai memetakan ke jumlah agen:

Nilai Jumlah agen yang ditargetkan Claude
unrestricted Tidak ada panduan: Claude mengukur alur kerja ke tugas
small Lebih sedikit dari 5 agen
medium Lebih sedikit dari 15 agen
large Lebih sedikit dari 50 agen

Default adalah medium. Sampai Anda memilih nilai, baris /config menampilkan medium (default) dan baris Running in background alur kerja menampilkan medium size (/config). Memerlukan Claude Code v2.1.219 atau lebih baru; versi sebelumnya default ke unrestricted.

Untuk mengubah panduan, pilih nilai untuk pengaturan Dynamic workflow size di /config, atau jalankan /config workflowSizeGuideline=small. Pada v2.1.219 dan lebih baru, Anda juga dapat mengatur kunci workflowSizeGuideline di file pengaturan apa pun; nilai itu mengambil prioritas atas /config, dan Claude Code menyembunyikan baris /config saat file pengaturan menyediakan satu.

Perubahan berlaku pada prompt berikutnya. Agent caps runtime masih berlaku terlepas dari pengaturannya.

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": true di ~/.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, atau gunakan toggle di halaman pengaturan admin Claude Code.

Ketika alur kerja dinonaktifkan, perintah alur kerja bundel dan skill /workflow-authoring tidak tersedia, kata kunci ultracode tidak lagi memicu run, dan ultracode dihapus dari menu /effort.