Menyusul peluncuran /goal oleh Codex pada April 2026, Anthropic juga merilis perintah dengan nama yang sama melalui Claude Code 2.1.139 pada bulan Mei. Ini adalah alur kerja baru yang membuat Claude "tidak akan berhenti sebelum target tercapai": selama Anda menuliskan kondisi penyelesaian dalam percakapan, Claude akan secara otomatis meminta model kecil yang cepat untuk menilai apakah target telah tercapai setelah setiap putaran. Jika belum, Claude akan melanjutkan ke putaran berikutnya hingga kondisi terpenuhi, baru kemudian mengembalikan kendali kepada Anda.
Artikel ini akan menjelaskan secara sistematis 6 poin utama mode goal pada Claude Code, termasuk mekanisme kerja siklus evaluator, perbedaan dengan /loop dan Stop hook, cara penulisan kondisi yang efektif, 3 jenis mode (interaktif / -p / Remote Control), serta risiko dan praktik terbaiknya.
Nilai Inti: Setelah membaca artikel ini, Anda akan mampu menyerahkan tugas jangka panjang seperti migrasi kode tim, pembersihan issue, dan penerimaan dokumen kepada mode goal Claude Code untuk diselesaikan secara otomatis dalam 10 menit, serta mengetahui kapan harus beralih ke alur kerja otonom lainnya.
Poin Utama Mode Claude Code goal
Sebelum memulai, mari kita pahami 6 fakta kunci tentang mode goal Claude Code. Keenam poin ini menentukan apakah kondisi yang Anda tulis dapat dieksekusi dengan benar, dan apakah Anda harus menggunakan /goal alih-alih alur kerja otonom lainnya.
| Poin | Konten | Dampak |
|---|---|---|
| Format Perintah | /goal <kondisi> |
Diatur langsung dalam percakapan, tidak perlu file konfigurasi |
| Evaluator | Model kecil Haiku yang cepat (default) | Menilai penyelesaian oleh "model lain", independen dari model yang bekerja |
| Cakupan | Sesi saat ini (session-scoped) | Tidak memengaruhi sesi lain, lebih cocok untuk tugas sementara |
| Irama Pemicu | Evaluasi segera setelah setiap putaran | Berhenti saat selesai, jika belum selesai akan memulai putaran baru |
| Batas Kondisi | Maksimal 4000 karakter | Dapat menampung kriteria penerimaan yang mendetail |
| Cara Keluar | Evaluasi lulus / /goal clear / Ctrl+C |
Tiga jalur keluar, kombinasi aktif + pasif |
Banyak pengguna yang baru pertama kali melihat /goal akan teringat pada perintah loop biasa, namun pada dasarnya ini adalah cara Anthropic membungkus Stop hook berbasis prompt menjadi perintah pintas tingkat sesi. Penempatan mendasar ini membuatnya sangat berbeda dari otomatisasi gaya cron tradisional.
Jika tim Anda belum pernah menggunakan mekanisme Hook tingkat lanjut dari Claude Code, Anda bisa mencoba API Claude Sonnet / Opus / Haiku melalui platform APIYI (apiyi.com) terlebih dahulu untuk membiasakan diri dengan ekosistem perangkat Anthropic, sebelum beralih ke mode goal pada Claude Code agar lebih mahir.
Penjelasan Mekanisme Kerja Mode Goal pada Claude Code
Untuk menggunakan /goal dengan benar, Anda harus memahami apa yang terjadi di setiap putaran. Dokumentasi resmi mendeskripsikan mekanisme ini sebagai "menambahkan evaluator setelah setiap putaran". Terdengar sederhana, namun detailnya menentukan batasan kemampuan fitur ini.
Model Bahasa Besar bertugas melakukan pekerjaan, sementara model yang lebih kecil dan cepat bertugas menentukan penyelesaian. Keuntungan pembagian tugas ini adalah evaluator tetap netral dan menggunakan daya komputasi yang lebih murah untuk mengambil keputusan. Kekurangannya, evaluator hanya bisa membaca apa yang telah ditampilkan oleh Model Bahasa Besar dalam percakapan, dan tidak bisa melihat status sistem file atau perintah eksternal yang sebenarnya.
Proses penilaian setelah setiap putaran dapat dibagi menjadi 4 langkah:
- Pengemasan Konteks: Mengirimkan kondisi saat ini dan seluruh transkrip percakapan ke evaluator.
- Keputusan Model: Evaluator mengembalikan jawaban ya/tidak beserta alasannya.
- Perutean: Jika tidak, alasan dikirim kembali ke Model Bahasa Besar sebagai panduan untuk melanjutkan pekerjaan. Jika ya, target akan dihapus secara otomatis dan ditandai sebagai selesai.
- Penyegaran Indikator: Indikator
◎ /goal activepada UI akan terus menampilkan tiga metrik: waktu yang berlalu, jumlah putaran, dan jumlah token.
Saat menulis kondisi, ingatlah batasan langkah ke-1: evaluator hanya melihat transkrip, jadi kondisi harus berupa "hal yang dapat dibuktikan oleh Model Bahasa Besar dalam percakapan". Misalnya, "npm test dengan kode keluar 0" adalah kondisi yang baik karena Model Bahasa Besar akan menjalankan tes dan menempelkan hasilnya. Sebaliknya, "tidak ada data kotor di database lingkungan produksi" adalah kondisi yang buruk karena tidak dapat diverifikasi dari percakapan.
Biaya evaluator biasanya dapat diabaikan. Harga per unit seri Haiku jauh lebih murah daripada Sonnet/Opus, dan karena hanya mengevaluasi ringkasan transkrip per putaran, sesi panjang pun hanya menghasilkan konsumsi token yang sedikit. Tim yang ingin menekan biaya evaluator lebih jauh dapat menggunakan APIYI (apiyi.com) untuk mengarahkan model kecil dan cepat Claude Code ke Haiku 4.5 atau Haiku 3.5, serta mengontrol kuota berdasarkan dimensi ruang kerja.
Perbandingan Claude Code Mode Goal dengan Alur Kerja Otonom Lainnya
Claude Code menyediakan 4 mekanisme untuk "menjalankan" percakapan, dan pemula sering kali mencampurnya. Tabel di bawah ini menyelaraskan 4 mekanisme tersebut berdasarkan kondisi pemicu, kondisi berhenti, dan skenario tipikal untuk memudahkan pemilihan.
| Mekanisme | Ritme Pemicu | Kondisi Berhenti | Skenario yang Berlaku |
|---|---|---|---|
/goal |
Terpicu segera setelah putaran sebelumnya selesai | Kondisi yang ditentukan evaluator tercapai | Tugas panjang dengan kriteria penerimaan yang jelas |
/loop |
Terpicu pada interval waktu tetap | Manual oleh pengguna atau ditentukan selesai oleh Claude | Polling berkala, pemeriksaan status |
| Stop hook | Terpicu segera setelah putaran sebelumnya selesai | Ditentukan oleh skrip pengguna atau prompt kustom | Tingkat tim, berlaku lintas sesi |
| Auto mode | Panggilan alat dalam satu putaran | Saat urutan alat dalam putaran berakhir | Mengurangi jendela konfirmasi untuk setiap alat |
Poin utamanya adalah /goal dan Stop hook hampir melakukan hal yang sama, tetapi /goal hanya berlaku untuk sesi saat ini dan dapat dimasukkan sementara di terminal. Stop hook harus ditulis ke dalam file pengaturan, dengan cakupan yang berlaku untuk semua sesi dalam lingkup tersebut, sehingga lebih cocok untuk batasan ketat tingkat tim.
Auto mode dan /goal saling melengkapi sepenuhnya: Auto mode menangani masalah "terus-menerus terganggu oleh konfirmasi alat dalam satu putaran", sementara /goal menangani masalah "perlu beberapa putaran untuk diselesaikan". Dengan menggabungkan kedua mekanisme ini dalam tugas panjang, seluruh proses hampir bisa berjalan tanpa pengawasan. Bagi tim yang tidak menjalankan Claude Code di lingkungan sendiri, Anda dapat terlebih dahulu menguji logika siklus yang sama dengan menghubungkan Claude ke skrip lokal melalui APIYI (apiyi.com), sebelum memutuskan untuk meningkatkan ke alat Claude Code yang lengkap.
3 Elemen Utama Kondisi Efektif Mode /goal pada Claude Code
Kondisi yang ditulis dengan buruk adalah alasan utama mengapa /goal benar-benar gagal. Dokumentasi resmi Anthropic dengan jelas menyatakan bahwa kondisi yang mampu bertahan selama puluhan putaran harus memiliki 3 elemen berikut secara bersamaan.
Pertama adalah titik akhir yang terukur. Titik akhir harus berupa peristiwa yang diskrit dan dapat diamati: kode keluar (exit code) pengujian, jumlah file, sisa item dalam antrean, atau apakah build berhasil (hijau). Indikator yang ambigu akan membuat evaluator terus bolak-balik antara ya/tidak, sehingga menyebabkan /goal terjebak dalam putaran tak terbatas.
Kedua adalah metode verifikasi yang jelas. Kondisi harus menuliskan dengan lugas bagaimana Claude harus membuktikan bahwa titik akhir telah tercapai, misalnya "output npm test mengandung PASS" atau "output git status kosong". Semakin spesifik metode verifikasinya, semakin kecil kemungkinan evaluator tertipu oleh ambiguitas pernyataan.
Ketiga adalah batasan yang tidak boleh diubah. Jika ada file atau konfigurasi tertentu yang harus tetap tidak berubah, laranglah secara langsung dalam kondisi tersebut, misalnya "jangan ubah file apa pun di bawah tests/legacy/". Hal ini mencegah model utama melakukan perubahan destruktif hanya demi "lulus".
Jika ketiga elemen tersebut digabungkan, kondisi /goal yang berkualitas tinggi akan terlihat seperti ini: "semua pengujian di bawah tests/auth lulus, kode keluar npm run lint adalah 0, jangan ubah file apa pun di tests/legacy/, jalankan maksimal 20 putaran". "Jalankan maksimal 20 putaran" di akhir adalah rekomendasi sebagai pengaman (fallback) untuk mencegah /goal berputar tanpa henti dalam situasi ekstrem.
Karena kondisi mendukung hingga 4000 karakter, Anda bisa memasukkan PRD mini ke dalamnya. Jika Anda menggunakan platform APIYI (apiyi.com) untuk melakukan pemanggilan model Claude guna penjadwalan Agen, Anda juga dapat merujuk pada gaya penulisan ini untuk merancang prompt evaluator Anda sendiri, agar kondisi berhenti Agen Anda sama jelas dan terukurnya.
Praktik 3 Mode Operasi /goal pada Claude Code
/goal mendukung tiga cara pemanggilan: interaktif, non-interaktif (-p), dan Remote Control. Menguasai ketiga cara penggunaan ini sangat penting agar Anda benar-benar dapat menerapkannya ke dalam CI, skrip lokal, dan alur kerja kolaborasi jarak jauh.
Memulai dengan Mode Interaktif
# Ketik langsung di sesi Claude Code
/goal all tests in test/auth pass and the lint step is clean, or stop after 20 turns
Setelah diatur, indikator ◎ /goal active akan muncul di UI, menampilkan tiga indikator secara real-time: elapsed (waktu berlalu), turns (putaran), dan tokens. Anda dapat memeriksa status kapan saja dengan memasukkan /goal tanpa parameter, atau memasukkan /goal clear (atau alias stop / off / reset / none / cancel) untuk menghentikan lebih awal.
Mode Non-Interaktif (Cocok untuk CI)
claude -p "/goal CHANGELOG.md has an entry for every PR merged this week, or stop after 15 turns"
Mode -p akan membuat /goal terus berjalan sampai kondisi terpenuhi atau Anda menghentikannya dengan Ctrl+C. Ini sangat cocok untuk dimasukkan ke dalam alur kerja otomatis seperti GitHub Actions, GitLab CI, atau Jenkins Pipeline. Jika Anda melakukan penjadwalan terpadu API Claude melalui APIYI (apiyi.com), Anda juga dapat membungkus mode perulangan yang sama ke dalam skrip milik Anda sendiri, sehingga klien non-Claude Code juga dapat menikmati kemampuan serupa.
Pemulihan Sesi
claude --resume <session-id>
# atau
claude --continue
Saat memulihkan sesi, status goal yang aktif akan ikut terbawa, tetapi tiga penghitung yaitu turns / timer / token akan dimulai kembali dari 0. Fitur ini sangat ramah untuk proses refaktorisasi jangka panjang: Anda tidak perlu khawatir terputus saat mematikan komputer di akhir pekan, cukup lanjutkan di hari Senin.
Lihat templat kondisi target umum (klik untuk membuka)
# Templat 1: Migrasi kode
/goal migrate all usages of legacy_api.* to new_api.* in src/, run npm test until exit 0, do not modify tests/legacy/, or stop after 30 turns
# Templat 2: Pembersihan backlog Issue
/goal close all GitHub issues labeled "needs-triage" by either resolving or relabeling, run gh issue list --label needs-triage and verify the output is empty, or stop after 25 turns
# Templat 3: Penerimaan dokumen desain
/goal implement every acceptance criterion in docs/design.md, prove each by referencing the exact section, do not edit docs/design.md itself, or stop after 40 turns
# Templat 4: Pemisahan file
/goal split src/megafile.ts into modules under src/parts/ where each file is < 300 lines, run npm run typecheck until exit 0, or stop after 20 turns
Risiko dan Praktik Terbaik Mode /goal pada Claude Code
/goal memberikan kendali penuh kepada model, sehingga poin risikonya sangat berbeda dibandingkan perintah tradisional. Tabel berikut merangkum 4 risiko utama yang perlu diperhatikan beserta tindakan mitigasinya.
| Risiko | Kondisi Pemicu | Tindakan Mitigasi |
|---|---|---|
| Biaya tidak terkendali | Salah penilaian evaluator atau kondisi terlalu longgar | Tambahkan batas "or stop after N turns" ke dalam kondisi |
| Halusinasi evaluator | Kondisi tidak bisa diverifikasi dari transkrip | Gunakan kalimat observasi seperti "jalankan perintah X untuk memverifikasi output Y" |
| Perubahan destruktif | Model utama mengubah file yang tidak seharusnya demi mencapai target | Tambahkan batasan "do not modify …" dalam kondisi |
| Penyalahgunaan ruang kerja | Terpicu secara tidak sengaja di lingkungan yang tidak tepercaya | Harus menerima dialog kepercayaan; gunakan disableAllHooks untuk menonaktifkan sekaligus |
Risiko pertama adalah yang paling langsung. Baik Codex maupun Claude Code saat ini tidak memiliki kemampuan bawaan untuk "mengatur batas pengeluaran per target". Jika tugas panjang lepas kendali, penggunaan token bisa melonjak jauh di atas ekspektasi. Cara paling aman adalah menuliskan batas turns langsung ke dalam kondisi, lalu menambahkan peringatan anggaran di tingkat platform.
Menyiapkan model kecil yang stabil untuk evaluator juga sangat krusial. Jika model cepat Anda menggunakan Haiku, maka kecepatan dan biaya evaluasi akan lebih terkendali. Jika menggunakan model yang lebih besar seperti Sonnet, biaya evaluasi untuk seluruh /goal akan meningkat signifikan. Tim pengembang dapat menggunakan platform APIYI (apiyi.com) untuk mengonfigurasi base_url dan kuota khusus untuk Haiku, sehingga biaya evaluator dan model utama dapat dipantau secara terpisah.
Terakhir, perhatikan aspek kepatuhan. /goal bergantung pada sistem Hook Anthropic, yang mengharuskan ruang kerja telah menerima dialog kepercayaan, serta disableAllHooks atau allowManagedHooksOnly tidak diaktifkan. Jika tim Anda menerapkan kebijakan manajemen terpusat yang memblokir Hook, maka /goal juga akan dinonaktifkan, dan perintah akan langsung memberi tahu Anda alasannya alih-alih gagal secara diam-diam.
Pertanyaan Umum
Q1: Apa kelebihan /goal dibandingkan menulis skrip loop while sendiri?
Anda mendapatkan evaluator independen yang digerakkan oleh model. Jika menulis loop while sendiri, Anda harus mendefinisikan kondisi berhenti dan menulis kode untuk memvalidasinya. Dengan /goal, penilaian diserahkan kepada model kecil yang cepat, yang mampu menangani skenario non-programatik seperti "biarkan model membaca percakapan untuk memahami apakah tugas sudah selesai".
Q2: Apakah menggunakan /goal sangat boros token?
Risiko ada, namun bisa dikendalikan. Dua saran: pertama, wajibkan penulisan batas turns dalam kondisi; kedua, kunci evaluator ke model kecil seperti Haiku. Saat mengakses seri Claude melalui APIYI (apiyi.com), Anda bisa mengajukan kuota terpisah untuk evaluator agar pemantauan lebih detail.
Q3: Bagaimana cara memilih antara /goal dan /loop?
Jika tugas memiliki "status selesai" yang jelas, pilih /goal. Jika tugas berupa polling status berkala (misalnya memeriksa progres deployment setiap 10 menit), pilih /loop. Mekanisme dasar keduanya sangat berbeda; mencampurnya justru akan membuat kondisi berhenti menjadi kabur.
Q4: Apakah mode /goal Claude Code bisa digunakan di Indonesia?
Bisa. /goal adalah perintah klien Claude Code, selama klien dapat terhubung ke model yang disediakan Anthropic. Pengembang biasanya mengakses API Claude melalui platform proksi agregasi seperti APIYI (apiyi.com). Setelah lingkungan dikonfigurasi, performa /goal akan sama dengan pengguna di luar negeri.
Q5: Mana yang lebih baik, Codex /goal atau Claude Code /goal?
Keduanya ditujukan untuk alur kerja yang berbeda. Codex /goal menekankan pada "alur kerja persisten" dan bisa dimulai ulang lintas proses. Claude Code /goal bersifat lingkup sesi, namun bisa dilanjutkan di hari berikutnya dengan --resume. Untuk tugas kompleks yang memakan waktu berhari-hari, pilih Codex; untuk tugas iterasi rutin satu atau dua hari, Claude Code lebih praktis.
Ringkasan
Inti dari mode goal pada Claude Code adalah langkah Anthropic untuk membebaskan "loop evaluator" dari file konfigurasi Hook, menjadikannya perintah satu baris yang bisa digunakan kapan saja dalam sesi apa pun. Masalah utama yang diselesaikan adalah: ketika sebuah tugas harus diselesaikan dalam beberapa putaran, namun Anda tidak ingin terus-menerus menekan tombol Enter di terminal, Anda bisa membiarkan model kecil yang cepat bertindak sebagai hakim untuk menentukan kapan Claude benar-benar menyelesaikan pekerjaannya.
Saran implementasi dapat dilakukan dalam tiga langkah: pertama, lengkapi kondisi dengan empat elemen utama yaitu "titik akhir + verifikasi + batasan + batas jumlah putaran (turns)". Selanjutnya, tentukan apakah akan menggunakan mode interactive, -p, atau Remote Control. Terakhir, pisahkan pemantauan kuota evaluator dan model utama melalui platform seperti APIYI (apiyi.com). Dengan cara ini, Anda bisa mendapatkan efisiensi alur kerja otonom tanpa harus kehilangan kendali atas biaya token.
Penulis: Tim Teknis APIYI
Kontak: Dapatkan akses ke seluruh seri model Claude dan dukungan integrasi Claude Code melalui APIYI di apiyi.com
Waktu Pembaruan: 13-05-2026
