Kalau kalian sudah mulai pakai Claude Code secara rutin, pasti pernah ngerasain satu hal yang agak ganggu.

Setiap kali mulai sesi baru, kalian harus jelasin lagi dari awal. Ini project apa. Teknologinya apa. Bagian mana yang jangan disentuh. Apa yang lagi dikerjain sekarang.

Capek.

Padahal konteks itu nggak berubah. Projectnya sama. Aturannya sama. Cuma sesinya yang baru.

Di sinilah CLAUDE.md masuk.

Apa itu CLAUDE.md

CLAUDE.md adalah file teks biasa yang kalian taruh di root project kalian. Namanya harus persis begitu: CLAUDE.md.

Begitu Claude Code dibuka di folder yang ada CLAUDE.md-nya, dia otomatis baca file itu duluan sebelum kalian mulai ngobrol.

Artinya, semua informasi yang kalian tulis di sana langsung jadi bagian dari konteks awal. Tanpa perlu kalian jelasin manual setiap sesi.

Isi CLAUDE.md yang berguna

Nggak semua hal perlu masuk ke CLAUDE.md. Yang paling berguna biasanya:

Deskripsi singkat project. Ini project apa, tujuannya apa, dipakai siapa. Dua tiga kalimat sudah cukup.

Stack teknologi. Framework apa, bahasa apa, database apa. Biar Claude nggak nebak nebak atau kasih saran yang nggak nyambung.

Konvensi yang penting. Penamaan variabel, struktur folder, pola yang kalian pakai konsisten. Kalau ada aturan khusus di project kalian, tulis di sini.

Area yang sensitif. Folder atau file yang harus diperhatikan. Misalnya: jangan ubah config produksi langsung, atau file auth.js punya banyak dependensi, hati hati.

Tujuan jangka pendek. Kalau kalian lagi fokus ke satu bagian tertentu minggu ini, tulis juga. Ini bantu Claude kasih respons yang lebih relevan.

Contoh CLAUDE.md sederhana

Project ini adalah dashboard internal untuk tim operasional.
Stack: Next.js, TypeScript, PostgreSQL, Prisma ORM.

Konvensi:
- Komponen di /components, page di /app
- API routes di /app/api
- Pakai kebab-case untuk nama file
- Jangan hardcode config, pakai .env

Area sensitif:
- /app/api/billing: jangan ubah tanpa review
- /lib/db.ts: schema connection, hati-hati

Fokus sekarang: benerin flow export laporan di /app/reports

Itu sudah lebih dari cukup untuk bikin sesi pertama Claude jauh lebih nyambung.

Yang berubah setelah punya CLAUDE.md

Paling terasa waktu mulai sesi baru.

Sebelumnya, kalian mungkin butuh dua tiga pesan dulu buat briefing sebelum Claude bisa bantu dengan baik. Setelah ada CLAUDE.md, sesi langsung bisa mulai dari titik yang lebih produktif.

Claude sudah tahu konteks dasarnya. Kalian nggak perlu jelasin dari nol. Tinggal masuk ke inti masalah yang mau dikerjain hari itu.

Ini kecil kelihatannya. Tapi kalau kalian kerja tiap hari, efeknya terasa.

CLAUDE.md bukan sekali buat

Anggap CLAUDE.md sebagai dokumen hidup.

Waktu ada konvensi baru yang mulai kalian pakai, update. Waktu ada area sensitif baru, tambahkan. Waktu fokus projectnya bergeser, sesuaikan bagian tujuan jangka pendeknya.

CLAUDE.md yang jarang diupdate lama lama jadi nggak akurat. Dan konteks yang nggak akurat bisa lebih menyesatkan daripada nggak ada konteks sama sekali.

Jadi luangkan sedikit waktu buat jaga file ini tetap relevan. Nggak perlu panjang. Yang penting isinya masih mencerminkan kondisi project kalian sekarang.

Penutup

CLAUDE.md adalah salah satu cara paling simpel untuk bikin kolaborasi dengan Claude Code lebih efisien dari waktu ke waktu.

Bukan fitur canggih. Bukan setup yang ribet. Cuma file teks yang kalian tulis sekali, lalu dirawat sedikit demi sedikit.

Dan hasilnya, setiap sesi baru kalian mulai dari posisi yang lebih baik daripada sebelumnya.

Di tulisan berikutnya, kita bahas situasi yang juga sering bikin frustrasi: cara masuk ke codebase yang belum pernah kalian sentuh sama sekali.