Prompt Claude Code: Cara Nulis yang Beneran Kepake

Minggu lalu saya coba minta Claude Code bikinin script sederhana buat bersihin data CSV. Hasil pertamanya ngawur total, bukan karena Claude-nya nggak paham coding, tapi karena prompt saya sendiri yang nggak jelas. Baru setelah saya kasih konteks lebih detail, mulai dari format data sampai output yang saya mau, hasilnya langsung jauh lebih rapi.

Dari situ saya sadar, masalah utama orang pakai AI coding assistant kayak Claude Code bukan soal tool-nya kurang canggih. Masalahnya di cara kita ngomong ke dia. Prompt Claude Code yang bagus itu bukan soal panjang atau pendek, tapi soal seberapa jelas kita menjelaskan apa yang sebenarnya kita butuhkan. Di bawah ini saya mau bahas beberapa hal yang saya pelajari soal ini, mulai dari kenapa konteks penting, struktur prompt yang biasanya work, sampai kesalahan yang sering bikin hasilnya jauh dari ekspektasi.

Kenapa Konteks Lebih Penting daripada Instruksi

Banyak orang mikir prompt Claude Code itu soal nyusun perintah yang tepat, kayak mantra ajaib yang kalau diketik dengan benar langsung menghasilkan kode sempurna. Realitanya nggak begitu. Claude Code, sama seperti model AI lainnya, bekerja berdasarkan informasi yang kita berikan. Kalau informasinya minim, hasilnya juga akan generic atau bahkan salah arah.

Saya sering lihat orang nulis prompt kayak "buatkan fungsi untuk validasi email" tanpa menyebutkan bahasa programming yang dipakai, framework yang digunakan, atau aturan validasi spesifik yang dibutuhkan. Hasilnya mungkin benar secara teknis, tapi nggak nyambung sama codebase yang sedang kita kerjakan. Ini bukan salah Claude Code, ini karena kita belum kasih dia cukup konteks project untuk bisa nebak apa yang sebenarnya kita mau.

Makanya sebelum mikirin struktur kalimat prompt yang keren, saya biasanya mulai dengan pertanyaan sederhana ke diri sendiri dulu. Apa yang sebenarnya saya coba selesaikan? Informasi apa yang Claude Code perlu tahu supaya jawabannya relevan? Kalau dua hal ini sudah jelas di kepala saya, baru saya mulai menyusun kalimatnya.

Struktur Prompt yang Biasanya Work

Setelah beberapa kali eksperimen, saya menemukan satu pola yang cukup konsisten membantu. Prompt Claude Code yang efektif biasanya punya tiga elemen: tujuan akhir, batasan atau constraint teknis, dan format output yang diharapkan.

Tujuan akhir itu maksudnya kita jelaskan apa yang ingin dicapai, bukan cuma langkah teknisnya. Misalnya, bukan cuma "buat function sorting", tapi "saya butuh function yang bisa sorting data user berdasarkan tanggal registrasi, karena akan dipakai di dashboard admin." Informasi tambahan ini bikin Claude Code bisa nyesuaikan pendekatan yang lebih pas.

Batasan teknis juga penting disebutkan, entah itu bahasa programming, versi library, atau standar coding yang dipakai tim. Terakhir, soal format output, apakah kita mau full code, penjelasan step by step, atau cuma pseudocode dulu untuk direview. Ketiga elemen ini kalau disebutkan dengan jelas, biasanya bikin hasil pertama sudah cukup dekat sama yang kita butuhkan, tanpa harus revisi berkali-kali.

Kesalahan yang Sering Bikin Hasilnya Meleset

Salah satu kesalahan paling sering saya lihat, dan pernah saya lakukan sendiri, adalah asumsi bahwa Claude Code otomatis paham konteks project kita. Padahal setiap sesi chat biasanya mulai dari nol, kecuali kita kasih tahu detailnya lagi atau memang sedang dalam satu sesi yang berkelanjutan.

Kesalahan lain adalah minta terlalu banyak hal sekaligus dalam satu prompt panjang. Saya pernah coba minta Claude Code sekaligus refactor kode, tambahin fitur baru, dan tulis unit test dalam satu instruksi. Hasilnya berantakan, karena dia harus membagi fokus ke banyak hal sekaligus dan akhirnya nggak ada yang benar-benar maksimal.

Yang saya pelajari, lebih baik pecah jadi beberapa langkah kecil. Selesaikan satu bagian dulu, review hasilnya, baru lanjut ke bagian berikutnya. Ini mirip kayak kerja sama junior developer, kita nggak langsung kasih semua requirement sekaligus tanpa checkpoint. Iterasi bertahap ini justru lebih cepat secara keseluruhan, meskipun kelihatannya lebih lambat di awal.

Kapan Prompt Claude Code Perlu Disesuaikan Lagi

Nggak semua prompt yang works di satu situasi otomatis works di situasi lain. Kalau kita kerja di project besar dengan banyak file dan dependency, prompt yang simpel biasanya nggak cukup. Kita perlu kasih tahu struktur folder, relasi antar file, atau bahkan potongan kode yang relevan supaya Claude Code bisa kasih saran yang benar-benar nyambung.

Sebaliknya, untuk task kecil kayak bikin script one-off atau eksperimen cepat, prompt yang terlalu detail malah bikin proses jadi lambat. Di situasi kayak ini saya biasanya langsung to the point, coba dulu, lihat hasilnya, baru refine kalau memang perlu.

Intinya, prompt Claude Code yang baik itu adaptif, bukan template yang sama dipakai untuk semua kondisi. Kita perlu baca situasi dulu: seberapa kompleks masalahnya, seberapa besar risikonya kalau salah, dan seberapa banyak konteks yang memang relevan untuk dibagikan. Semakin sering kita latihan menyesuaikan ini, semakin cepat juga kita nemuin pola yang pas buat kebutuhan kerja kita sendiri.

Belajar nyusun prompt Claude Code yang baik itu sebenarnya latihan berpikir lebih jelas soal apa yang kita mau, bukan sekadar hafal template. Semakin kita paham konteks kerjaan sendiri, semakin mudah juga menyampaikan itu ke Claude Code dengan cara yang bisa dia proses dengan baik. Coba mulai dari satu task kecil yang sering kamu kerjakan, lalu perhatikan pola prompt apa yang paling sering menghasilkan output berguna.