Claude.md Ternyata Sepenting Ini, Sudah Tahu Cara Buatnya?

Kalau setiap sesi baru Claude Code terasa seperti harus briefing dari nol, ada solusinya. Claude.md adalah file Markdown berisi instruksi permanen yang dibaca Claude Code untuk memahami proyek dan aturan kerjamu. Di artikel ini, kamu akan mengenal fungsinya, struktur ideal, hingga cara membuat Claude.md.

1 Apa Itu Claude.md?
2 Apa Fungsi Claude.md?
3 Kenapa Claude.md Penting untuk Pengguna Claude Code?
- 3.1 Konteks membuat output lebih konsisten
- 3.2 Mengurangi context rot
4 Isi Claude.md yang Ideal
5 Cara Membuat Claude.md, Langkah demi Langkah
- 5.1 Template Claude.md siap pakai
6 Tips agar Claude.md Tidak Malah Jadi Beban
7 Kesimpulan

Apa Itu Claude.md?

Bayangkan kamu merekrut developer baru untuk mengerjakan proyek yang sudah berjalan. Sebelum mulai coding, tentu kamu perlu menjelaskan: proyeknya apa, teknologi yang digunakan, struktur foldernya bagaimana, standar coding-nya seperti apa, dan bagian mana yang tidak boleh disentuh sembarangan.

Nah, file Claude.md kurang lebih berfungsi seperti briefing tersebut untuk Claude Code.

Secara teknis, CLAUDE.md adalah file Markdown yang berisi konteks dan aturan untuk Claude Code. File ini dapat ditempatkan di root proyek sehingga instruksinya menjadi konteks yang digunakan saat Claude bekerja pada proyek tersebut. Claude Code juga mendukung instruksi pada level global maupun direktori tertentu.

Di sinilah, kamu mulai melihat ada perbedaan fungsi CLAUDE.md dengan perbedaannya prompt biasa.

Prompt biasanya hanya permintaan untuk satu tugas, misalnya, “Buatkan endpoint login menggunakan Express.” Sementara CLAUDE.md berisi aturan yang ingin kamu pertahankan sepanjang pekerjaan, seperti “Gunakan TypeScript strict mode” atau “Jangan menambahkan dependency tanpa persetujuan.”

Sederhananya:

File	Fungsi utama
`CLAUDE.md`	Konteks dan aturan kerja untuk Claude Code
`skill.md`	Instruksi untuk skill atau kemampuan tertentu
`AGENTS.md`	File instruksi yang digunakan oleh tool/agent yang mendukung format tersebut
`llms.txt`	Indeks terkurasi agar AI lebih mudah menemukan dokumentasi

llms.txt, misalnya, ditujukan sebagai indeks Markdown berisi tautan menuju dokumentasi yang relevan bagi AI. Jadi fungsinya bukan sebagai aturan kerja agen dalam sebuah repository.

Sementara itu, CLAUDE.md lebih dekat dengan file konfigurasi Claude Code untuk konteks proyek.

Apa Fungsi Claude.md?

Fungsi utamanya adalah memastikan Claude tidak bekerja tanpa konteks.

Setidaknya ada empat hal yang bisa kamu masukkan:

Konteks proyek: tujuan aplikasi, teknologi, arsitektur, dan batasan.
Konvensi coding: gaya penamaan, format file, framework, hingga aturan testing.
Aturan perilaku: hal yang wajib dilakukan dan hal yang dilarang.
Peta proyek: struktur direktori, command penting, serta dokumentasi yang perlu dirujuk.

Contohnya, daripada setiap kali mengatakan “jangan pakai semicolon”, kamu cukup menuliskannya sekali:

## Code Conventions
– Use TypeScript strict mode
– No semicolons
– Use named exports
– File names use kebab-case

Claude kemudian memiliki konteks tersebut ketika bekerja dalam proyek.

Ini yang membuat CLAUDE.md lebih dari sekadar catatan. Dalam praktiknya, file tersebut menjadi semacam system prompt tingkat proyek yang memberi Claude konteks awal sebelum kamu memberikan tugas spesifik.

Kenapa Claude.md Penting untuk Pengguna Claude Code?

Tanpa CLAUDE.md, kamu mungkin menghabiskan beberapa pesan pertama hanya untuk menjelaskan hal-hal yang sebenarnya berulang.

“Database pakai PostgreSQL.”
“Jangan ubah migration lama.”
“Test dulu sebelum implementasi.”
“Folder service ada di /src/services.”

Besok membuka sesi baru? Jelaskan lagi.

Di sinilah manfaat terbesar instruksi permanen terasa.

Konteks membuat output lebih konsisten

Kualitas jawaban AI coding assistant sangat dipengaruhi oleh konteks yang tersedia. Prompt engineering membantu kamu membuat instruksi individual yang lebih baik, sedangkan context engineering berfokus pada bagaimana informasi relevan disiapkan agar model dapat bekerja dengan konteks yang tepat.

CLAUDE.md berada di lapisan konteks tersebut.

Jadi, kamu tidak hanya membuat prompt yang lebih bagus. Kamu sedang membangun lingkungan kerja agar Claude memahami “cara bekerja” di proyekmu sejak awal.

Mengurangi context rot

Dalam sesi AI yang panjang, informasi awal bisa semakin sulit dipertahankan secara efektif ketika konteks bertambah. Fenomena ini sering disebut context rot.

Dengan memulai sesi menggunakan CLAUDE.md yang ringkas dan relevan, aturan penting kembali tersedia sejak awal. Hasilnya, risiko Claude melenceng dari konvensi proyek dapat ditekan.

Ada manfaat lain yang tidak kalah penting: file ini bisa disimpan bersama repository. Artinya, seluruh tim dapat menggunakan aturan proyek yang sama, bukan mengandalkan ingatan masing-masing developer.

Isi Claude.md yang Ideal

Tidak ada satu format yang wajib untuk semua proyek. Namun, struktur berikut cukup praktis untuk dijadikan template Claude.md.

#1. Ringkasan proyek

Berikan gambaran teknis dalam beberapa kalimat.

## Project Overview
A B2B invoicing application for small businesses.
Backend: Node.js + Express.
Frontend: React + Tailwind.
Database: PostgreSQL.
Authentication: JWT with refresh tokens.

Tidak perlu menulis sejarah perusahaan atau dokumentasi panjang. Claude membutuhkan konteks yang membantu pengambilan keputusan teknis.

#2. Perintah penting

Masukkan command yang sering digunakan.

## Commands
– `npm install` → install dependencies
– `npm run dev` → start development server
– `npm test` → run tests
– `npm run build` → production build

#3. Konvensi dan standar kode

Bagian ini biasanya sangat berguna karena langsung memengaruhi kode yang dihasilkan.

## Code Conventions
– Use TypeScript strict mode
– No semicolons
– Use named exports only
– Variables use camelCase
– Database columns use snake_case

#4. Aturan perilaku

Tulis aturan secara spesifik dan dapat ditindaklanjuti.

## Rules
– Always write tests for new features
– Never modify executed migrations
– Do not install dependencies without asking
– Ask when requirements are unclear
– Prefer existing utilities over creating duplicates

Bandingkan dengan aturan seperti “selalu berhati-hati saat mengubah database”. Kedengarannya bagus, tetapi terlalu abstrak. “Jangan mengubah migration yang sudah dijalankan” jauh lebih jelas.

#5. Struktur folder

Claude tidak perlu daftar setiap file. Cukup berikan peta penting.

## Structure
– `/src/api` → API routes
– `/src/services` → business logic
– `/src/db` → database queries
– `/src/components` → React components
– `/tests` → automated tests

6. Dokumentasi resmi

Kalau ada dokumentasi yang wajib dijadikan rujukan, cantumkan lokasinya.

## References
– API documentation: `/docs/api.md`
– Architecture notes: `/docs/architecture.md`

Dengan pendekatan ini, CLAUDE.md menjadi briefing singkat, bukan ensiklopedia proyek.

Cara Membuat Claude.md, Langkah demi Langkah

Sekarang masuk ke bagian yang paling praktis.

1. Buka folder proyek di Claude Code.
Pastikan kamu berada di repository yang ingin diberi instruksi.

2. Buat CLAUDE.md di root proyek.
Kamu bisa membuatnya secara manual menggunakan editor favorit. Claude Code juga menyediakan /init untuk membantu menganalisis repository dan menghasilkan konfigurasi awal.

3. Jalankan /init jika ingin memulai lebih cepat.
Claude dapat membaca struktur proyek, file konfigurasi, dokumentasi, dan command yang tersedia untuk menyusun draft awal. Jangan langsung menganggap hasil /init sudah sempurna. Anggap sebagai draft.

4. Review hasilnya.
Periksa apakah command, struktur folder, framework, dan aturan yang terdeteksi sudah benar.

5. Tambahkan aturan yang tidak bisa ditebak Claude.
Misalnya aturan branch, proses deployment, kebijakan database, atau standar code review tim.

6. Uji di sesi baru.
Coba tugas sederhana. Misalnya minta Claude membuat fitur kecil dan lihat apakah ia mengikuti konvensi yang sudah ditentukan.

7. Update secara berkala.
Kalau kamu sudah dua kali mengoreksi kesalahan yang sama, pertimbangkan memasukkan aturan tersebut ke CLAUDE.md.

Template Claude.md siap pakai

Berikut contoh Claude.md sederhana yang bisa kamu adaptasi:

# Project Instructions
## Project Overview
This is a web application for managing business operations.
Backend: Node.js + Express.
Frontend: React + TypeScript.
Database: PostgreSQL.

## Commands
– `npm install` → install dependencies
– `npm run dev` → start development server
– `npm test` → run tests
– `npm run build` → production build

## Code Conventions
– Use TypeScript strict mode
– No semicolons
– Use named exports
– Use camelCase for variables
– Use kebab-case for file names

## Rules
– Always write tests for new features
– Never modify executed database migrations
– Do not add dependencies without asking
– Reuse existing utilities when possible
– Ask for clarification when requirements are ambiguous

## Structure
– `/src/api` → API routes
– `/src/services` → business logic
– `/src/db` → database layer
– `/src/components` → UI components
– `/tests` → automated tests

## References
– `/docs/architecture.md`
– `/docs/api.md`

Tips agar Claude.md Tidak Malah Jadi Beban

Ada satu kesalahan yang cukup sering terjadi: menganggap semakin panjang CLAUDE.md, semakin pintar Claude.

Justru sebaliknya, file ini ikut menggunakan ruang pada context window. Karena itu, isi CLAUDE.md sebaiknya padat dengan informasi yang benar-benar berguna.

Hindari memasukkan:

Dokumentasi proyek secara penuh.
Potongan kode panjang.
Informasi yang cepat berubah.
Aturan yang saling bertentangan.
Credential, API key, atau data sensitif.
Informasi yang sudah tersedia jelas di dokumentasi lain.

Gunakan prinsip sederhana: kalau informasi tersebut hanya relevan untuk satu tugas, jangan masukkan ke instruksi permanen.

Sebaliknya, kalau kamu berkali-kali harus menjelaskan hal yang sama kepada Claude, kemungkinan besar informasi tersebut layak masuk CLAUDE.md.

Jaga juga struktur tetap modular menggunakan heading dan bullet point. File yang mudah dipindai akan lebih mudah dipelihara ketika proyek berkembang.

Kesimpulan

CLAUDE.md bukan sekadar file Markdown tambahan. Untuk pengguna Claude Code, file ini bisa menjadi fondasi agar AI coding assistant memahami proyek, mengikuti standar, dan mengurangi kebutuhan briefing berulang.

Mulailah dari yang sederhana: konteks proyek, command, konvensi coding, aturan perilaku, struktur folder, dan referensi penting. Setelah itu, evaluasi dari penggunaan nyata. Jika Claude terus mengulangi kesalahan yang sama, tambahkan aturan yang relevan.

Dan kalau Claude Code mulai menjadi bagian dari workflow pengembangan website bisnis kamu, kebutuhan infrastrukturnya juga perlu diperhatikan.

Untuk website yang membutuhkan lingkungan server lebih fleksibel, VPS Murah dari IDwebhost bisa menjadi salah satu opsi untuk dipertimbangkan. Dengan VPS, kamu punya kontrol lebih besar atas resource dan konfigurasi server sesuai kebutuhan website yang terus berkembang.

Jadi, sudah punya CLAUDE.md di project-mu? Kalau belum, sekarang waktu yang pas untuk membuatnya.

Upgrade Server, Bisnis Lebih Kencang!