Sintaks Impor @path

Satu CLAUDE.md yang terus membesar menjadi sulit dibaca dan menghabiskan token konteks di setiap giliran. Sintaks impor @path memungkinkan Anda memisahkan aturan ke dalam file-file terfokus dan menyertakannya melalui rujukan.

Alih-alih menempelkan 400 baris standar penulisan kode secara langsung, Anda menulis satu baris yang mengimpornya. Hasilnya: file tingkat atas yang ringkas dan tetap mudah dibaca, sementara detailnya berada di modul khusus yang dapat digunakan kembali.

Impor hanyalah satu baris yang diawali @ dan diikuti jalur. Saat Claude Code memuat CLAUDE.md Anda, isi file yang dirujuk disisipkan pada titik tersebut.

Gunakan jalur relatif dari file yang melakukan impor. Contoh di bawah ini menyertakan modul gaya penulisan kode bersama ke dalam memori proyek.

Jalur diselesaikan secara relatif terhadap file yang memuat impor. @./standards/coding-style.md mencari folder standards/ yang berada di sebelah CLAUDE.md Anda.

• @./standards/coding-style.md — subfolder sejajar (paling umum, cocok untuk VCS)
• @../shared/rules.md — direktori induk
• Jaga agar impor tetap berada di dalam repositori sehingga rekan satu tim yang menggandakan proyek memperoleh modul yang sama.

Kelompokkan aturan yang berkaitan ke dalam file-file kecil di bawah direktori standards/, lalu impor masing-masing file. Setiap modul memiliki satu tanggung jawab, sehingga Anda dapat memperbarui aturan pengujian tanpa menyentuh aturan gaya.

Hal ini mencerminkan desain kode yang baik: unit kecil, bernama, dan dapat digabungkan lebih baik daripada satu file raksasa.

CLAUDE.md memiliki beberapa lapisan: tingkat pengguna ~/.claude/CLAUDE.md (pribadi, tidak dibagikan melalui VCS), tingkat proyek ./CLAUDE.md (dibagikan melalui VCS), dan file tingkat direktori yang terbatas pada suatu subpohon.

Impor @path dapat digunakan di dalam tingkat mana pun. Karena file tingkat pengguna tidak dibagikan, rekan satu tim baru tidak akan mengetahuinya — jadi letakkan aturan yang diperlukan seluruh tim di file tingkat proyek (beserta impornya), bukan di file pribadi Anda.

Tujuan utama mengimpor @./standards/coding-style.md dari CLAUDE.md proyek adalah agar jalur dan file tersebut sama-sama berada di VCS. Saat repositori digandakan, standar tersebut ikut terbawa.

Bandingkan dengan aturan yang tersembunyi di ~/.claude/CLAUDE.md: aturan itu hanya ada di mesin Anda. Sesi Claude milik rekan satu tim tidak akan pernah melihatnya. Impor proyek yang modular menjaga panduan tetap konsisten di seluruh tim.

Apa pun yang Anda @import dari CLAUDE.md menjadi bagian dari konteks pada setiap giliran saat file tersebut aktif. Ini sangat baik untuk aturan yang selalu berlaku — konvensi penamaan, format commit, dan ekspektasi peninjauan.

Namun, ini juga berarti setiap baris yang diimpor terus-menerus menghabiskan token. Impor hal-hal yang selalu relevan; untuk aturan yang hanya penting sesekali, tersedia alat yang lebih baik (adegan berikutnya).

Jika aturan hanya berlaku saat mengedit file tertentu, jangan memenuhi konteks yang selalu dimuat dengan aturan tersebut. Gunakan file .claude/rules/ dengan YAML frontmatter.

Pola glob paths membuat aturan dimuat hanya saat Anda mengedit file yang cocok — menghemat konteks dan token dibandingkan CLAUDE.md monolitik yang selalu aktif.

Dua mekanisme yang saling melengkapi:

• Impor @path di CLAUDE.md — untuk aturan yang harus selalu berada dalam konteks (standar seluruh proyek). Memodularisasi file; semuanya tetap dimuat di setiap giliran.
• .claude/rules/ dengan frontmatter paths — untuk aturan yang harus dimuat secara kondisional, hanya saat mengedit file yang cocok. Menghemat token.

Arsitek memilih berdasarkan apakah panduan tersebut berlaku umum atau terbatas pada file tertentu.

Anda dapat mengimpor beberapa modul dari satu CLAUDE.md, dengan memisahkan berbagai perhatian secara rapi. Jadikan file tingkat atas sebagai indeks yang menjelaskan struktur, lalu biarkan setiap impor memuat detailnya.

Karena impor hanyalah rujukan biasa, Anda dapat mengubah urutan, menambahkan, atau menghapus modul tanpa menulis ulang bagian lainnya — inilah manfaat pemeliharaan yang memang ingin diberikan oleh konfigurasi modular.

Anda tidak perlu mengedit file memori secara manual. Perintah /memory mengedit CLAUDE.md, dan perubahan tersebut tetap tersimpan di antara sesi — berguna untuk menambahkan baris @import baru seiring bertambahnya standar Anda.

Simpan modul yang diimpor di bawah VCS agar aturan yang tersimpan dan rujukannya tetap sinkron untuk semua anggota tim.

Inti sari:

• Impor @path (misalnya, @./standards/coding-style.md) memodularkan CLAUDE.md; jalur ditentukan secara relatif terhadap file yang mengimpornya.
• Konten yang diimpor dimuat pada setiap giliran — gunakan untuk aturan universal yang selalu relevan.
• Tempatkan standar bersama di CLAUDE.md tingkat proyek (dibagikan melalui VCS), bukan di tingkat pengguna (~/.claude/, bersifat pribadi dan tidak terlihat oleh anggota tim).
• Untuk aturan yang hanya berlaku pada file tertentu, pilih .claude/rules/ dengan glob frontmatter paths agar konteks dan token lebih hemat.
• /memory mengedit CLAUDE.md dan mempertahankan perubahan antar-sesi.