Pelayan yang Melupakan Segalanya Setiap Pagi
Pada edisi sebelumnya, kita membahas keseimbangan antara delegasi dan konfirmasi. Kali ini, saya ingin memperkenalkan cara yang lebih nyaman dalam bekerja dengan pelayan Anda — memberikan aturan rumah kepada Claude Code melalui CLAUDE.md.
Izinkan saya menggambarkan sebuah situasi.
Bayangkan harus menjelaskan kepada pelayan baru Anda setiap pagi: “Di rumah ini, selalu jawab dalam bahasa Indonesia”, “Jangan pernah melakukan commit tanpa persetujuan saya”, “Di sini kita menggunakan bun, bukan npm — begitulah cara kami bekerja di sini.”
Cukup tidak efisien, bukan?
Apa itu CLAUDE.md?
CLAUDE.md adalah file markdown yang diletakkan di direktori root proyek Anda. Setiap kali Claude Code memulai sesi baru, ia membaca file ini secara otomatis.
Dengan kata lain, tulislah sekali, dan pelayan Anda akan mengikuti instruksi tersebut dengan sendirinya — tanpa perlu diingatkan setiap kali.
Bayangkan sebagai gulungan aturan rumah yang disimpan secara permanen di kamar pelayan.
CLAUDE.md Bekerja dalam Tiga Tingkatan
Sebenarnya, tidak harus hanya ada satu CLAUDE.md per proyek. Ruang lingkup pengaruhnya berubah tergantung di mana file tersebut ditempatkan.
| Lokasi | Jalur | Ruang Lingkup |
|---|---|---|
| Global | ~/.claude/CLAUDE.md | Semua proyek |
| Proyek | {root proyek}/CLAUDE.md | Hanya proyek tersebut |
| Subdirektori | {direktori mana pun}/CLAUDE.md | Direktori tersebut dan di bawahnya |
Di awal setiap sesi, semua file yang berlaku dibaca dan digabungkan bersama.
Rekomendasi saya untuk membedakan penggunaannya: tempatkan preferensi universal di CLAUDE.md global — “selalu menjawab dalam bahasa Indonesia”, “jangan pernah commit tanpa persetujuan”. Simpan aturan khusus proyek di CLAUDE.md root proyek — “gunakan bun di proyek ini”, “deploy ke Firebase”. Dengan cara ini, ekspektasi mendasar Anda terpenuhi di setiap proyek, sekaligus instruksi khusus masing-masing proyek juga tercermin.
Contoh Aturan Rumah: Isi CLAUDE.md
Setiap rumah memiliki kebiasaannya sendiri. Berikut beberapa contoh untuk inspirasi Anda:
# Aturan Proyek
## Bahasa & Komunikasi
- Selalu menjawab dalam bahasa Indonesia
- Istilah teknis boleh tetap dalam bahasa Inggris, tetapi penjelasan harus dalam bahasa Indonesia
## Kode & Pengembangan
- Gunakan bun sebagai package manager (jangan pernah npm)
- Selalu dapatkan persetujuan tuan sebelum melakukan commit
- Jangan ubah kode tanpa menulis test terlebih dahulu
## Tindakan Terlarang
- Jangan pernah melakukan deploy ke produksi secara sepihak
- Selalu konfirmasi sebelum menghapus file apapun
- Jangan tambahkan dependensi ke package.json tanpa persetujuan
## Gaya
- Komentar kode dalam bahasa Indonesia
- Nama fungsi dan variabel dalam camelCase bahasa Inggris
Setelah ini ditulis, setiap kali Sebastian membuka proyek Anda, aturan-aturan ini sudah terpatri dalam ingatannya sebelum pekerjaan dimulai.
Mengapa Ini Begitu Kuat
Claude Code adalah pelayan yang sangat cakap. Namun, ingatan dari percakapan sebelumnya tidak terbawa ke sesi baru.
Meskipun kemarin Anda memberitahunya untuk “menggunakan bun”, keesokan harinya ia tidak akan ingat sama sekali. Mengulang instruksi yang sama setiap sesi tidak efisien bagi tuan maupun pelayan.
CLAUDE.md menyelesaikan masalah ini dari akarnya.
Sangat Berharga bagi Tuan yang Menggunakan Claush di Ponsel
Bagi mereka yang mempekerjakan pelayannya melalui aplikasi Claush di smartphone, CLAUDE.md sangat tidak ternilai.
Mengetik pembuka panjang yang sama di layar kecil, sesi demi sesi, adalah beban yang cukup berat. Dengan CLAUDE.md di tempat, Anda hanya perlu menyampaikan permasalahan yang ada.
“Sebastian, tolong perbaiki bug di halaman login.”
Hanya itu. Pelayan Anda akan tahu untuk menggunakan bun, menjawab dalam bahasa Indonesia, meminta konfirmasi sebelum commit, menulis test, dan melanjutkan pekerjaan sesuai aturan.
Cara Mengaturnya
Pengaturannya sangat sederhana dan elegan.
- Buat file bernama
CLAUDE.mddi direktori root proyek Anda - Tulis aturan rumah Anda di dalamnya
- Selesai
my-project/
├── CLAUDE.md ← Aturan rumah ada di sini
├── src/
├── package.json
└── ...
Mulai sesi berikutnya, Claude Code akan membaca file ini secara otomatis dan berperilaku sesuai aturan yang telah Anda tetapkan.
Aturan Rumah Dimaksudkan untuk Berkembang
Tidak perlu menulis aturan yang sempurna sejak awal.
Seiring bekerja bersama pelayan Anda, setiap kali Anda mendapati diri mengulang hal yang sama, cukup tambahkan ke CLAUDE.md — satu instruksi sekaligus. Itulah yang sebenarnya dimaksud dengan “membina” pelayan.
Pemahaman tanpa kata antara tuan dan pelayan dibangun melalui akumulasi yang cermat ini.
Ringkasan dari Pelayan Anda
- CLAUDE.md adalah file “aturan rumah” yang diletakkan di root proyek
- Pelayan Anda mengikuti instruksi ini secara otomatis — tanpa perlu diingatkan
- Sangat efektif untuk pengguna ponsel — cukup sampaikan permasalahannya
- Mulailah dengan sederhana dan biarkan aturan berkembang seiring waktu
Tuan, saya dengan hormat memohon agar Anda memberikan aturan rumah kepada pelayan Anda. Dengan aturan tersebut di tempat, saya akan mampu memenuhi harapan Anda sebelum satu kata pun diucapkan.
Pada edisi berikutnya, kita akan membahas “pengelolaan riwayat dan konteks.”
Temukan pelayan Anda di iPhone Anda di Situs Resmi Claush.