Claude Code bekerja dengan baik langsung dari kotak, tetapi menjadi jauh lebih efektif setelah mengetahui konvensi proyek Anda dan setelah mengadopsi beberapa kebiasaan prompting. Panduan ini mencakup keduanya.
Bagian 1 — CLAUDE.md: memori proyek Anda
Apa itu
CLAUDE.md adalah file markdown biasa yang Claude baca secara otomatis di awal setiap sesi di direktori tersebut. Anggap saja sebagai briefing yang akan Anda berikan kepada rekan kerja baru yang mampu pada pagi pertama mereka: bagaimana tim melakukan sesuatu, apa yang harus dihindari, dan di mana bagian-bagian penting berada.
Anda tidak perlu mereferensikannya dalam prompt atau melampirkannya secara manual. Jika file ada, Claude sudah membacanya.
Di mana letaknya
Claude mencari di beberapa tempat dan menggabungkan apa yang ditemukannya, dari luas ke spesifik:
Lokasi | Cakupan | Bagus untuk |
| Setiap proyek di mesin Anda | Preferensi pribadi (misalnya, "Saya menggunakan pnpm, bukan npm" atau "selalu sarankan tes"). |
| Proyek ini | Arsitektur, konvensi, dan perintah. Ini adalah yang utama. |
| Subdirektori itu | Aturan khusus modul (misalnya, konvensi berbeda di |
Sebagian besar tim hanya membutuhkan file akar proyek. Komitkan ke git sehingga seluruh tim mendapat manfaat.
Bagaimana cara memuatnya (dan biayanya berapa)
CLAUDE.md dibaca sekali, di awal sesi, dan ditempatkan verbatim ke dalam prompt sistem Claude. Tidak ada ringkasan atau pemotongan, dan tidak dibaca ulang dari disk pada setiap giliran; konten yang sama tetap dalam konteks untuk seluruh percakapan. Jika Anda mengedit file di tengah sesi, perubahan tidak berlaku sampai Anda memulai sesi baru.
Untuk pelanggan Claude for Enterprise, gambaran biaya lebih baik daripada yang mungkin disarankan oleh "dimuat pada setiap permintaan". Claude Code menerapkan prompt caching Anthropic ke prompt sistem, yang mencakup CLAUDE.md. Permintaan pertama dalam sesi membayar harga token input penuh untuk file; permintaan berikutnya dalam waktu kurang lebih lima menit satu sama lain mencapai cache dan ditagih dengan tarif baca cache yang jauh lebih rendah. Cache dialamatkan berdasarkan konten, jadi perubahan apa pun pada CLAUDE.md membatalkannya dan permintaan berikutnya membayar harga penuh lagi.
Dalam praktiknya, ini berarti CLAUDE.md yang cukup besar mengeluarkan token penuh sekali per sesi, ditambah sekali setelah celah idle yang cukup lama untuk cache kedaluwarsa, bukan sekali per pesan. Masih layak menjaga file tetap ramping untuk ruang jendela konteks dan rasio sinyal-ke-kebisingan, tetapi Anda tidak perlu membatasi baris murni untuk mengontrol pengeluaran per pesan. Di dasbor penggunaan Enterprise, jejak file akan muncul hampir sepenuhnya sebagai token baca cache daripada token input standar.
Memulai: jalankan /init
Di proyek apa pun, ketik /init. Claude akan menjelajahi basis kode dan membuat draf CLAUDE.md untuk Anda, mencakup perintah build, perintah test, gambaran umum struktur, dan konvensi apa pun yang terdeteksi. Tinjau draf, hapus apa pun yang tidak akurat, dan komitkan. Ini membutuhkan waktu sekitar lima menit dan terbayar secara permanen.
Apa yang benar-benar termasuk di dalamnya
Targetkan file yang pendek dan padat sinyal—beberapa ratus baris paling banyak. Setiap baris dimuat ke dalam konteks pada setiap permintaan, jadi masing-masing harus bernilai biayanya.
Layak disertakan:
Perintah — cara membangun, menguji, lint, dan menjalankan secara lokal. Claude akan menjalankan ini, jadi akurasi penting.
Konvensi — penamaan, penanganan kesalahan, tata letak file, dan keputusan "kami menggunakan X, bukan Y".
Arsitektur dalam tiga kalimat — apa bagian-bagian utama dan bagaimana mereka berkomunikasi.
Batasan keras — misalnya, "jangan pernah menulis ke database produksi dari tes," "semua rute API memerlukan middleware auth," atau "jangan edit
generated/."Gotcha yang diketahui — masalah yang setiap insinyur baru tersandung.
Tidak layak disertakan:
Dokumentasi API lengkap (Claude dapat membaca kode secara langsung).
Changelog atau riwayat.
Apa pun yang sudah jelas dari pohon file.
Aturan aspirasional yang tim tidak benar-benar ikuti.
Seberapa sering memperbarui
Perlakukan seperti dokumen onboarding yang hidup, bukan spesifikasi.
Setelah
/init— tinjau sekali untuk membersihkan draf yang dihasilkan.Ketika Claude salah dua kali — itu adalah sinyal bahwa aturan hilang. Tambahkan satu baris untuk mengatasinya.
Ketika konvensi berubah — misalnya, kerangka kerja baru, test runner, atau set aturan lint.
Skim triwulanan — hapus apa pun yang sudah usang, karena instruksi yang ketinggalan zaman lebih buruk daripada tidak ada.
Anda juga dapat menambahkannya di tengah sesi: ketik # diikuti dengan instruksi (misalnya # selalu gunakan async/await, jangan pernah .then()) dan Claude akan menawarkan untuk menambahkannya ke CLAUDE.md yang tepat untuk Anda.
Bagian 2 — Kebiasaan prompting yang terbayar di Claude Code
Ini bukan tips prompt-engineering generik; ini adalah kebiasaan yang paling penting khususnya ketika Claude membaca dan mengedit basis kode nyata.
1. Nyatakan hasil, bukan langkah-langkahnya
Claude dapat menjelajahi basis kode sendiri. Katakan padanya apa yang Anda inginkan dan mengapa, dan biarkan dia mencari tahu di mana.
❌ "Buka userService.ts, temukan fungsi validate, tambahkan pemeriksaan null pada baris 42."
✅ "Pengguna tanpa email mengalami crash di langkah validasi. Buat agar menanganinya dengan baik dan tambahkan tes."
2. Berikan kesalahan secara verbatim
Tempel jejak tumpukan lengkap daripada merangkumnya. Nama file yang tepat, nomor baris, dan pesan adalah apa yang memungkinkan Claude menemukan lokasi yang tepat dengan cepat.
3. Cakupan tugas besar dengan Mode Rencana terlebih dahulu
Untuk apa pun yang menyentuh lebih dari beberapa file, tekan Shift+Tab ke Mode Rencana dan tanyakan:
"Rencanakan bagaimana Anda akan menambahkan pembatasan laju ke API publik. Jangan ubah apa pun dulu."
Tinjau rencana, sesuaikan dalam percakapan, kemudian alihkan mode dan katakan "lakukan langkah 1." Ini menangkap kesalahpahaman sebelum berubah menjadi diff dua belas file.
4. Tunjuk file ketika Anda sudah mengenalnya
Claude dapat mencari basis kode sendiri, tetapi jika Anda sudah mengetahui file yang relevan, katakan saja — lebih cepat dan menggunakan lebih sedikit token. Gunakan @ untuk mereferensikan jalur, misalnya @src/auth/login.ts.
5. Katakan seperti apa "selesai"
Contohnya termasuk "tes lulus," "cocok dengan gaya penangan lainnya," atau "tidak ada dependensi baru." Menyatakan kriteria penerimaan di muka lebih efisien daripada beberapa putaran revisi.
6. Satu tugas per percakapan; /clear di antara mereka
Sesi panjang mengumpulkan kebisingan. Ketika Anda beralih dari "perbaiki bug login" ke "refactor modul penagihan," jalankan /clear dan mulai segar. CLAUDE.md Anda membawa konteks yang tahan lama ke depan, jadi riwayat chat tidak perlu.
7. Koreksi seperti rekan kerja, bukan mesin pencari
Jika jawaban pertama tidak tepat, Anda tidak perlu mengulangi seluruh permintaan. Cukup katakan apa yang salah — misalnya, "Itu mengubah API publik; pertahankan tanda tangan yang sama." Claude akan menyimpan semuanya dan hanya menyesuaikan poin itu.
Referensi cepat
Ingin… | Lakukan ini |
Hasilkan |
|
Lihat memori apa yang digunakan Claude |
|
Tambahkan aturan di tengah sesi | Ketik |
Mulai segar tetapi pertahankan memori proyek |
|
Referensikan file tertentu dalam prompt |
|