Cara Membangun Workflow Claude Otomatis

Ada sebuah pepatah yang merangkum arah perkembangan pengodean berbasis agen (agentic coding): tujuannya bukan prompt yang lebih baik, melainkan alur kerja yang berjalan tanpa Anda harus mengawasinya. Kebanyakan orang menggunakan Claude seperti mereka menggunakan jendela obrolan. Anda mengetik, Anda menunggu, Anda membaca, Anda mengetik lagi. Itu berhasil, tetapi membatasi keluaran Anda hanya pada satu agen yang Anda awasi secara aktif. Para insinyur yang benar-benar memanfaatkan Claude membangun sesuatu yang lain: alur kerja yang dimulai sesuai jadwal atau pemicu, melakukan pekerjaan, memeriksa hasilnya sendiri, dan hanya memberitahu manusia ketika sesuatu memerlukan keputusan.

tombol

TL;DR

Alur kerja Claude yang berjalan tanpa Anda memerlukan lima bagian: spesifikasi tertulis yang tepat, eksekusi tanpa kepala (non-interaktif), gerbang verifikasi deterministik yang memutuskan lulus atau gagal, pagar pembatas yang ketat (daftar izin, iterasi terbatas, batas biaya, sakelar pemutus), dan serah terima yang memberi tahu manusia atau melakukan eskalasi saat terjadi kegagalan. Mode tanpa kepala Claude Code (claude -p), SDK Agen Claude, kait (hooks), dan penjadwal (cron atau launchd) menyediakan kelima hal tersebut. Agen bukanlah bagian yang berisiko. Menjalankannya tanpa pengawasan tanpa gerbang dan pagar pembataslah yang berisiko. Bangun itu dulu, lalu lepaskan tangan Anda.

Mengapa “berjalan tanpa Anda” adalah tujuan sebenarnya

Obrolan yang diawasi memiliki batasan yang ketat: Anda. Setiap iterasi menunggu manusia membaca keluaran dan memutuskan apa selanjutnya. Model menghasilkan dalam hitungan detik, lalu menganggur selama beberapa menit saat Anda beralih konteks. Anda adalah hambatan dalam sistem yang seharusnya cepat.

Alur kerja tanpa pengawasan menghilangkan batasan tersebut. Agen bekerja, sebuah skrip memeriksanya, kegagalan secara otomatis kembali, dan Anda hanya campur tangan di batas-batasnya. Manfaatnya bukan hanya kecepatan. Ini adalah paralelisme. Setelah alur kerja berjalan tanpa pengawasan, Anda dapat meningkatkan skala dengan menambahkan alur kerja, bukan dengan mengetik lebih cepat. Itu adalah lompatan yang sama yang kami bahas dalam alur kerja dinamis Claude Code, di mana satu sesi menyebar ke banyak agen paralel.

Namun, “berjalan tanpa Anda” meningkatkan risikonya. Agen yang diawasi yang melakukan pengeditan yang buruk akan ketahuan saat Anda membaca perbedaannya. Agen tanpa pengawasan akan melakukan *commit*, menjalankan langkah berikutnya, dan terus berjalan. Jadi, disiplin bergeser dari pembuatan prompt ke desain sistem: Anda membangun mesin yang harus benar, terbatas, dan dapat diamati saat tidak ada yang melihat. Tulisan Anthropic tentang membangun agen yang efektif menyampaikan hal yang sama. Keuntungan berasal dari lingkungan di sekitar model, bukan dari satu pesan yang lebih cerdas.

Lima bagian yang dibutuhkan setiap alur kerja tanpa pengawasan

Lewati salah satu dari ini dan alur kerja akan melakukan hal yang salah dengan percaya diri atau tidak pernah berhenti.

Spesifikasi yang tepat. Deskripsi tertulis tentang apa yang dianggap selesai yang dibaca agen di awal setiap eksekusi. Spesifikasi yang samar menghasilkan pekerjaan yang samar. “Perbaiki API” gagal; “titik akhir POST /orders mengembalikan 201, memvalidasi badan permintaan terhadap skema, menolak bidang yang hilang dengan 422” berhasil.
Eksekusi tanpa kepala (headless). Claude harus berjalan tanpa campur tangan manusia di keyboard. Itu berarti mode non-interaktif, bukan antarmuka obrolan.
Gerbang verifikasi. Pemeriksaan deterministik yang mengembalikan lulus atau gagal dengan alasan konkret: pengujian, pemeriksaan tipe, validasi skema, pengujian kontrak. Inilah yang memungkinkan alur kerja memutuskan bahwa itu benar-benar selesai daripada hanya menerima perkataan model.
Pagar pembatas. Daftar izin (permission allowlists), jumlah iterasi maksimum, batas biaya, pencatatan (logging), dan sakelar pemutus (kill switch). Ini mencegah eksekusi yang membingungkan menyebabkan kerusakan saat Anda tidur.
Serah terima (handoff). Ketika alur kerja selesai atau menyerah, ia memberitahu seseorang. Sebuah pemberitahuan, draf untuk ditinjau, peringatan kegagalan. Keheningan bukanlah kesuksesan.

Tiga poin di tengah adalah bagian di mana sebagian besar pengaturan masih lemah. Mari kita bangun masing-masing dengan alat yang diberikan Claude kepada Anda.

Blok bangunan Claude

Mode tanpa kepala (claude -p)

Mode cetak Claude Code menjalankan prompt secara non-interaktif dan kemudian keluar. Ini adalah dasar dari setiap alur kerja tanpa pengawasan. Anda memberinya tugas, membatasi alatnya, menangkap keluarannya, dan melanjutkan.

claude -p "Implement the orders endpoint per spec.md, then run the test suite" \
  --allowedTools "Edit,Write,Bash" \
  --output-format json \
  >> run.log 2>&1

Bendera `--allowedTools` lebih penting dari yang terlihat. Dalam antarmuka obrolan, Anda menyetujui setiap tindakan secara manual. Dalam mode tanpa kepala, tidak ada yang menyetujui, jadi daftar izin adalah satu-satunya kontrol Anda atas apa yang dapat disentuh agen. Mulailah dengan batasan yang sempit dan perluas hanya ketika Anda mempercayai eksekusi tersebut. Set bendera lengkap ada di dokumentasi Claude Code.

SDK Agen Claude

Ketika perintah shell tidak cukup, SDK Agen Claude memungkinkan Anda mengendalikan Claude secara terprogram dari Python atau TypeScript. Anda mendapatkan perulangan dalam kode: kirim tugas, alirkan hasilnya, periksa panggilan alat, putuskan apakah akan melanjutkan. Beginilah cara Anda membungkus aliran kontrol yang sebenarnya di sekitar agen.

import { query } from "@anthropic-ai/claude-agent-sdk";

const MAX_ITERATIONS = 8;
let feedback = "";

for (let attempt = 0; attempt < MAX_ITERATIONS; attempt++) {
  for await (const msg of query({
    prompt: `${task}\n\nPrevious failures:\n${feedback}`,
    options: { allowedTools: ["Edit", "Write", "Bash"] },
  })) {
    // stream/log messages as the agent works
  }

  const gate = runVerification();      // your deterministic check
  if (gate.passed) break;              // done
  feedback = gate.failures;            // the next prompt writes itself
}

Tanda tangan (signatures) yang tepat ada di dokumen, tetapi bentuknya adalah intinya: sebuah perulangan yang menjalankan kembali agen dengan kegagalan terakhir sebagai prompt berikutnya. Jika Anda memutuskan antara membuat perulangan sendiri dan opsi yang di-hosting, perbandingan kami tentang agen terkelola vs SDK Agen menjelaskan kapan masing-masing masuk akal.

Kait (Hooks) untuk pagar pembatas deterministik

Kait menjalankan perintah Anda sendiri pada titik-titik tetap dalam siklus hidup Claude, tanpa melibatkan model. Ini adalah cara Anda menegakkan aturan yang tidak bisa dielakkan agen. Ingin suite pengujian berjalan setelah setiap pengeditan file? Kait `PostToolUse` melakukannya secara deterministik.

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [{ "type": "command", "command": "npm test --silent" }]
      }
    ]
  }
}

Karena kait adalah kode biasa, bukan permintaan ke model, ia selalu terpicu. Itu adalah properti yang Anda inginkan untuk pagar pembatas dalam eksekusi tanpa pengawasan. Agen tidak bisa memutuskan untuk melewatkannya.

Penjadwal untuk memicu eksekusi

Alur kerja yang berjalan tanpa Anda memerlukan sesuatu untuk memulainya tanpa Anda. Di server itu adalah cron; di Mac itu adalah launchd. Bagaimanapun, Anda akan memicu perintah tanpa kepala (headless) sesuai jadwal.

# every weekday at 7am: run the maintenance workflow, log everything
0 7 * * 1-5  cd /srv/api && claude -p "$(cat tasks/nightly-maintenance.md)" \
  --allowedTools "Edit,Bash" >> logs/run-$(date +\%F).log 2>&1

Itulah inti dari pengaturan otonom: penjadwal memicu Claude tanpa kepala, agen bekerja sesuai spesifikasi, kait (hooks) dan gerbang menjaganya tetap jujur, dan log memberi tahu Anda apa yang terjadi.

Rancang perulangan, bukan prompt

Inilah pola pikir yang mengikat semuanya. Berhentilah bertanya “apa yang harus saya katakan kepada Claude?” Mulailah bertanya “perulangan apa yang akan membuat Claude memberi tahu dirinya sendiri?” Agen adalah generator yang cepat tanpa memiliki rasa yang dapat diandalkan apakah itu benar. Perulanganlah yang memberikan rasa itu melalui gerbang. Kami mendalami hal ini di berhenti membuat prompt agen pengodean Anda, bangun perulangan saja, dan ini adalah ide yang menopang pekerjaan tanpa pengawasan: kepercayaan diri model tidak lagi penting, hanya putusan gerbanglah yang penting.

Ini juga mengapa spesifikasi yang jelas mengalahkan prompt yang cerdas. Spesifikasi yang sama mendorong setiap iterasi dan berfungsi ganda sebagai dokumentasi. Sebuah file design.md atau AGENTS.md yang menangkap maksud, batasan, dan definisi selesai memberikan agen target yang stabil pada setiap eksekusi, daripada Anda menjelaskan ulang konteks setiap saat.

Contoh yang dikerjakan: pemeliharaan API tanpa pengawasan

Mari kita buat lebih konkret. Katakanlah Anda menginginkan alur kerja yang menjaga sekumpulan titik akhir API tetap sinkron dengan spesifikasi OpenAPI mereka, berjalan setiap pagi, dan tidak pernah mengirimkan titik akhir yang rusak. Berikut adalah bentuknya.

Spesifikasi. Kontrak berada dalam file OpenAPI; perilaku berada dalam kasus uji. Agen membaca keduanya di awal eksekusi.
Pemicu. Sebuah cron job pukul 7 pagi memicu Claude tanpa kepala dengan tugas pemeliharaan.
Buat. Agen merekonsiliasi implementasi dengan spesifikasi: menambahkan titik akhir yang hilang, memperbaiki bentuk respons yang tidak cocok, memperketat validasi.
Gerbang. Alur kerja menjalankan suite pengujian API terhadap layanan yang berjalan. Asersi status, validasi skema JSON pada setiap respons, pemeriksaan kontrak terhadap spesifikasi. Kegagalan kembali dalam bentuk terstruktur: “Diharapkan 422 untuk `customer_id` yang hilang, didapat 500.” “Bidang respons `total` adalah string, skema mengatakan angka.”
Loop atau eskalasi. Gerbang merah? Kegagalan terstruktur menjadi prompt berikutnya dan agen menambal celah spesifik, hingga batas iterasi. Hijau? Ini membuka draf PR. Habis percobaan? Ini mengajukan peringatan dengan kegagalan terakhir dan berhenti.
Serah terima. Seorang manusia mendapatkan PR yang bersih untuk ditinjau atau laporan kegagalan yang tepat. Jangan pernah melakukan commit secara diam-diam.

Gerbang pada langkah 4 adalah yang membuat keseluruhan proses aman untuk dijalankan tanpa pengawasan. Tanpa itu, agen akan mengedit kode dan melaporkan keberhasilan berdasarkan interpretasinya sendiri, yang justru merupakan cara bagaimana titik akhir yang rusak mencapai produksi. Di sinilah Apidog cocok untuk alur kerja otonom: desain API, skema, server tiruan (mock server), dan pengujian otomatis berada dalam satu ruang kerja, sehingga gerbang dan spesifikasi tetap sinkron secara default. Anda mengarahkan eksekusi ke skenario pengujian Apidog dan agen mendapatkan lulus/gagal yang divalidasi skema setiap iterasi. Server tiruan berfungsi sebagai pengganti dependensi yang tidak aktif, sehingga eksekusi jam 3 pagi tidak terblokir menunggu pihak ketiga yang tidak stabil. Tim yang menghubungkan akses titik akhir agen melalui debugger agen AI Apidog membiarkannya mengakses dan memeriksa titik akhir dengan cara yang sama seperti penguji manusia. Unduh Apidog jika Anda lebih suka membangun gerbang secara visual daripada membuatnya secara manual.

Pagar pembatas yang membuat eksekusi tanpa pengawasan aman

Bagian inilah yang memisahkan alur kerja yang Anda percayai semalaman dari alur kerja yang membangunkan Anda pukul 3 pagi. Agen tanpa pengawasan membutuhkan batasan yang ketat, bukan niat baik.

Daftar izin (permission allowlists) yang sempit. Dalam mode tanpa kepala, daftar izin adalah satu-satunya gerbang Anda atas apa yang dapat dilakukan agen. Berikan alat minimum yang dibutuhkan tugas tersebut. Jangan pernah memberikan akses shell tanpa batas atau perintah destruktif kepada eksekusi tanpa pengawasan tanpa adanya sandbox.
Iterasi terbatas. Batasi perulangan. Eksekusi yang tidak dapat mencapai gerbang hijau dalam N percobaan harus berhenti dan melakukan eskalasi, bukan berputar tanpa henti.
Batas biaya. Perulangan tanpa pengawasan menghabiskan token tanpa disadari manusia. Tetapkan batas pengeluaran dan catat pengeluaran per eksekusi. Perulangan yang tidak konvergen harus melampaui batas dan berhenti. Catatan kami tentang mengurangi biaya token agen berlaku langsung di sini.
Lindungi gerbang. Jauhkan file pengujian dan spesifikasi dari kumpulan file yang boleh diedit agen. Jika agen dapat menulis ulang pengujian agar lolos, Anda telah membangun mesin untuk memalsukan kemajuan.
Sandbox. Jalankan pekerjaan tanpa pengawasan di ruang kerja atau kontainer yang terisolasi, bukan di main. `git worktree` atau cabang sekali pakai membatasi dampak buruk dari eksekusi yang salah.
Pencatatan (Logging) dan sakelar pemutus (kill switch). Catat setiap eksekusi ke log yang benar-benar Anda baca, dan sediakan cara untuk menghentikan pekerjaan di tengah jalan. Anda tidak bisa men-debug apa yang tidak Anda rekam.
Persetujuan manusia di batas-batasnya. “Tanpa Anda” tidak berarti “tanpa siapa pun, selamanya.” Tempatkan seseorang di awal (menyetujui tugas) atau di akhir (menyetujui PR), tetapi tidak dalam perulangan internal. Pola pengkabelan dan mode kegagalan di sini sesuai dengan pengkabelan alat alur kerja berbasis agen.

Sebagian besar hal ini bermuara pada satu aturan: agen tanpa pengawasan harus dapat melakukan pekerjaannya dan tidak ada yang lain. Batasi alatnya, batasi perulangannya, isolasi ruang kerjanya, dan buat setiap eksekusi dapat diamati.

Kesalahan umum

Beberapa pola dengan cepat menenggelamkan alur kerja otonom.

Tidak ada gerbang, hanya perasaan. Jika satu-satunya pemeriksaan adalah “agen, apakah Anda sudah selesai?” Anda tidak memiliki alur kerja, Anda memiliki chatbot tanpa pengawasan. Gerbang harus eksternal dari agen.
Satu tugas raksasa. Eksekusi yang diperintahkan untuk “memelihara seluruh layanan” jarang berhasil. Dekomposisikan menjadi tugas-tugas seukuran titik akhir, masing-masing dengan gerbangnya sendiri. Eksekusi kecil selesai; yang besar berantakan.
Izin yang terlalu terbuka. Memberikan setiap alat karena nyaman mengubah bug kecil menjadi insiden besar ketika tidak ada yang mengawasi. Batasi izin dengan ketat.
Keberhasilan diam atau kegagalan diam. Alur kerja yang melakukan commit tanpa memberitahu siapa pun, atau mati tanpa peringatan, lebih buruk daripada tidak ada alur kerja sama sekali. Selalu lakukan serah terima.
Mempercayai laporan diri model. Agen akan mengatakan bahwa ia sudah selesai. Gerbanglah yang memutuskan apakah itu benar. Bangunlah untuk celah antara “terlihat selesai” dan “memang selesai,” karena tanpa pengawasan, tidak ada yang akan menyadarinya.

Lakukan ini dengan benar dan alur kerja Claude akan menyelesaikan pekerjaan yang terbatas dan terverifikasi selama sehari sebelum Anda minum kopi. Lakukan ini dengan salah dan Anda telah mengotomatiskan produksi kode yang percaya diri namun belum teruji. Perbedaannya terletak pada gerbang dan pagar pembatas, bukan pada model. Jika Anda ingin arsitektur yang lebih mendalam, uraian kami tentang desain harness agen mencakup bagaimana bagian-bagiannya cocok dalam skala besar.

Kesimpulan

Membangun alur kerja Claude yang berjalan tanpa Anda lebih sedikit tentang Claude dan lebih banyak tentang sistem yang Anda bungkus di sekelilingnya. Lima bagian menanggung beban: spesifikasi yang tepat, eksekusi tanpa kepala, gerbang verifikasi deterministik, pagar pembatas yang ketat, dan serah terima yang bersih. Lakukan hal-hal ini dengan benar dan model akan menjadi pekerja cepat di dalam mesin yang benar, terbatas, dan dapat diamati saat Anda tidak melihatnya.

Mulailah dengan satu alur kerja. Tulis spesifikasi yang ketat, jalankan tanpa kepala terhadap gerbang verifikasi yang cepat, izinkan alat yang dibutuhkan, batasi iterasi, isolasi ruang kerja, dan buat ia memberi tahu Anda saat selesai atau gagal. Untuk apa pun yang menyentuh API, suite pengujian Anda adalah gerbang yang membuat eksekusi tanpa pengawasan aman, dan Apidog memberi Anda desain, mocking, dan pengujian otomatis dalam satu ruang kerja untuk membangunnya. Unduh, hubungkan gerbang, dan biarkan alur kerja berjalan sementara Anda melakukan hal lain.