Alur kerja dinamis memerlukan Claude Code v2.1.154 atau lebih baru dan tersedia di semua paket berbayar, dengan akses API Anthropic, dan di Amazon Bedrock, Google Cloud’s Agent Platform, dan Microsoft Foundry. Di Pro, aktifkan dari baris Dynamic workflows di
/config.Kapan menggunakan alur kerja
Subagen, skills, tim agen, dan alur kerja semuanya dapat menjalankan tugas multi-langkah. Perbedaannya adalah siapa yang memegang rencana:
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.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 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.
/workflows, gunakan tombol panah untuk memilih run, dan tekan Enter untuk membuka tampilan kemajuannya: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.Mulai dari v2.1.196, 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.
Alur kerja bundel
Claude Code menyertakan/deep-research sebagai alur kerja bawaan:
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.
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.
/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 kunciultracode 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.
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 reasoningxhigh dengan orkestrasi alur kerja otomatis. Dengan itu aktif, Claude merencanakan alur kerja untuk setiap tugas substansial daripada menunggu Anda untuk meminta.
claude --effort ultracode. Memerlukan Claude Code v2.1.203 atau lebih baru.
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:
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. Jika Anda menetapkanCLAUDE_CONFIG_DIR, lokasi ini adalah direktoriworkflows/di bawah jalur itu.
~/.claude/workflows/ bahkan ketika CLAUDE_CONFIG_DIR ditetapkan; file masih disimpan di bawah direktori yang dikonfigurasi.
Tekan Enter untuk menyimpan. Alur kerja berjalan sebagai /<name> di sesi mendatang dari lokasi mana pun.
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.
Teruskan input ke alur kerja yang disimpan
Alur kerja yang disimpan dapat menerima input melalui parameterargs. 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:
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.Terus memperbaiki sampai pemeriksaan lulus
Jalankan pemeriksa, perbaiki apa yang gagal, dan ulangi sampai lulus atau berhenti membuat kemajuan.Migrasi banyak file secara paralel
Temukan file untuk migrasi, ubah masing-masing dalam salinan terisolasi sehingga edit tidak bertentangan, dan verifikasi setiap hasil.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.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.
Temukan masalah sampai daftar berhenti tumbuh
Terus cari dalam putaran dan berhenti ketika putaran baru tidak menemukan apa pun yang baru.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:
await tingkat atas. agent() menghasilkan satu subagen dan pipeline() menjalankan satu per item dalam daftar. Jika Anda ingin mengedit skrip dengan tangan, minta Claude untuk memandu Anda melalui perubahan, atau lihat entri alat Workflow dalam referensi Agent SDK untuk set opsi lengkap.
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.
Runtime melacak hasil setiap agen saat run berlangsung, yang membuat run dapat dilanjutkan dalam sesi yang sama.
Perilaku dan batas
Runtime menerapkan batasan berikut: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. Agen yang masih berjalan saat Anda menghentikan tidak disimpan dan dimulai ulang saat dilanjutkan, jadi alur kerja yang menyebarkan pekerjaan di banyak agen kecil mempertahankan lebih banyak kemajuan daripada satu agen panjang. 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. Untuk menjaga setiap run tetap lebih kecil secara default, tetapkan panduan ukuran di /config.
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. Memerlukan Claude Code v2.1.203 atau lebih baru.
Peringatan bersifat informatif: tidak menghentikan atau membatasi run. Dua pengaturan berubah ketika Anda melihatnya:
- Jika Anda menetapkan panduan ukuran, jumlah agen panduan menggantikan ambang batas 25 agen.
- Sesi dengan ultracode aktif tidak menampilkan peringatan, karena mengaktifkan ultracode sudah memilih Anda untuk run besar.
CLAUDE_CODE_SUBAGENT_MODEL diatur, yang mengesampingkan keduanya. 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
Tetapkan panduan ukuran
Pengaturan Dynamic workflow size di/config menjaga alur kerja yang ditulis Claude tetap dalam skala yang lebih kecil secara default. Claude Code mengirimkan pengaturan ke Claude sebagai saran, jadi prompt yang meminta skala berbeda masih akan menggantinya. Memerlukan Claude Code v2.1.202 atau lebih baru.
Setiap nilai menetapkan jumlah agen yang ditargetkan Claude dalam skrip yang ditulisnya.
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 denganclaude -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.
"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