Sebagian besar pengguna Claude Code tahu
folder .claude/
keberadaannya, tetapi tidak pernah membukanya secara nyata. Insinyur AI Akshay baru-baru ini menyusun panduan lengkap yang menjelaskan fungsi setiap file dalam folder ini, serta bagaimana pengaturan agar Claude bekerja sepenuhnya sesuai keinginan Anda.
Dua folder, bukan satu
Pertama-tama perlu mengklarifikasi sebuah kesalahpahaman umum:
folder .claude/
ada dua, bukan satu.
Level proyek (proyek Anda/.claude/): menyimpan pengaturan bersama tim, dikirim ke Git, agar semua orang mendapatkan aturan dan perintah yang konsisten
Level global (~/.claude/): preferensi pribadi dan pengaturan lintas proyek, hanya mempengaruhi mesin Anda sendiri
CLAUDE.md: salah satu file terpenting
Setiap kali memulai sesi kerja Claude Code, hal pertama yang dilakukan Claude adalah membaca
CLAUDE.md
, dan memuatnya ke dalam prompt sistem (system prompt), serta terus mematuhi instruksi di dalamnya selama percakapan berlangsung.
Isi yang harus ditulis:
Perintah build, test, lint (seperti npm run test)
Keputusan arsitektur penting
Catatan yang tidak mencolok (misalnya “TypeScript strict mode diaktifkan, variabel yang tidak digunakan akan error”)
Standar penamaan, gaya penanganan error
Isi yang tidak seharusnya ditulis: aturan yang cocok untuk pengaturan linter, dokumen lengkap, penjelasan teori yang panjang
Akshay menyarankan agar CLAUDE.md dibatasi tidak lebih dari 200 baris—melebihi panjang ini, tingkat kepatuhan perintah Claude sebenarnya akan menurun karena konsumsi konteks yang terlalu besar.
folder rules/ : modulasi perintah, cocok untuk pengembangan tim
Ketika CLAUDE.md semakin membengkak,
folder .claude/rules/
adalah solusinya. Setiap file Markdown mewakili satu fokus, misalnya code-style.md, testing.md, api-conventions.md, dan Claude akan secara otomatis membaca semua file tersebut.
Lebih hebat lagi adalah “aturan rentang jalur” (path scope rules): dengan menambahkan metadata YAML di awal file aturan, aturan tersebut hanya akan dimuat saat Claude memproses file di jalur tertentu, sehingga menghindari aturan yang tidak relevan memenuhi konteks.
folder commands/ : perintah garis miring kustom
Setiap file Markdown di
.claude/commands/
akan menjadi sebuah perintah garis miring. review.md cocok untuk /project:review, fix-issue.md cocok untuk /project:fix-issue.
Fungsi paling praktis adalah menggunakan sintaks
!
untuk menjalankan perintah shell dan menyisipkan outputnya—misalnya secara otomatis mengambil git diff dan menyuntikkannya ke prompt, sehingga Claude benar-benar “melihat” perubahan kode Anda. Perintah pribadi yang ditempatkan di ~/.claude/commands/ dapat digunakan di semua proyek.
skills/ dan agents/ : pemicu aktif vs. sub-agen yang ditentukan
Perbedaan inti antara Skills dan agents terletak pada cara pemicunya:
Skills: Claude secara otomatis memutuskan berdasarkan isi percakapan apakah akan memanggil skill, tanpa perlu memasukkan perintah secara manual. Setiap skill memiliki direktori sendiri dan file SKILL.md, serta dapat menyertakan file pendukung.
Agents: Mendefinisikan kepribadian sub-agen profesional, dengan prompt sistem, izin alat, dan pengaturan model yang terpisah. Saat tugas kompleks, Claude akan spawn sebuah konteks terisolasi agar agen dapat menjalankan, menghindari agar sesi utama tidak penuh token.
Kolom
tools
pada agents dapat membatasi ruang lingkup perilaku sub-agen—misalnya, agen audit keamanan hanya perlu izin baca, dan tidak boleh menulis. Kolom
model
memungkinkan Anda memilih model yang lebih ringan untuk tugas fokus, menghemat biaya.
settings.json: daftar putih dan daftar hitam izin
file
.claude/settings.json
mengontrol operasi yang diizinkan atau dilarang oleh Claude:
allow list: langsung jalankan tanpa konfirmasi (misalnya npm run *, git *)
deny list: blokir total (misalnya rm -rf *, membaca .env)
Operasi yang tidak ada dalam daftar: Claude akan menanyakan apakah akan melanjutkan
Pengaturan pribadi dapat disimpan di
.claude/settings.local.json
, otomatis diabaikan oleh gitignore, dan tidak akan dikirim ke repositori.
Dari mana harus mulai?
Saran langkah awal praktis dari Akshay: jalankan
/init
untuk menghasilkan CLAUDE.md awal, tambahkan pengaturan dasar di settings.json, lalu buat satu atau dua perintah kustom yang paling sering digunakan—sisanya secara bertahap ditambahkan sesuai kebiasaan penggunaan.
Inti dari pemahaman ini adalah:
folder .claude/
adalah protokol yang memberi tahu Claude “siapa Anda, apa proyeknya, aturan apa yang harus diikuti”. Semakin jelas pengaturannya, semakin sedikit waktu yang dihabiskan untuk mengoreksi Claude.
Artikel ini menjelaskan lengkap tentang folder .claude/: pusat kendali Claude Code, analisis lengkap CLAUDE.md, perintah, skill, dan izin yang pertama kali muncul di ABMedia.
