Bagaimana Claude mengingat proyek Anda

Berikan Claude instruksi persisten dengan file CLAUDE.md atau AGENTS.md, dan biarkan Claude mengumpulkan pembelajaran secara otomatis dengan auto memory.

Setiap sesi Claude Code dimulai dengan context window yang segar. Dua mekanisme membawa pengetahuan lintas sesi:

• File CLAUDE.md: instruksi yang Anda tulis untuk memberikan Claude konteks persisten. Claude juga dapat membaca file AGENTS.md repositori, sendiri atau bersama CLAUDE.md
• Auto memory: catatan yang Claude tulis sendiri berdasarkan koreksi dan preferensi Anda

Halaman ini mencakup cara untuk:

• Menulis dan mengorganisir file CLAUDE.md
• Menggunakan AGENTS.md yang sudah ada sebagai instruksi proyek Anda, sendiri atau bersama CLAUDE.md
• Membatasi aturan ke tipe file tertentu dengan .claude/rules/
• Mengonfigurasi auto memory agar Claude membuat catatan secara otomatis
• Troubleshoot ketika instruksi tidak diikuti

CLAUDE.md vs auto memory

Claude Code memiliki dua sistem memori yang saling melengkapi. Keduanya dimuat di awal setiap percakapan. Claude memperlakukan mereka sebagai konteks, bukan konfigurasi yang diberlakukan. Untuk memblokir suatu tindakan terlepas dari apa yang Claude putuskan, gunakan hook PreToolUse sebagai gantinya. Semakin spesifik dan ringkas instruksi Anda, semakin konsisten Claude mengikutinya.

Gunakan file CLAUDE.md ketika Anda ingin memandu perilaku Claude. Auto memory memungkinkan Claude belajar dari koreksi Anda tanpa usaha manual.

Subagents juga dapat mempertahankan auto memory mereka sendiri. Lihat konfigurasi subagent untuk detail.

File CLAUDE.md

File CLAUDE.md adalah file markdown yang memberikan instruksi persisten kepada Claude untuk proyek, alur kerja pribadi Anda, atau seluruh organisasi Anda. Anda menulis file ini dalam teks biasa; Claude membacanya di awal setiap sesi. Jika repositori Anda menggunakan AGENTS.md sebagai gantinya, lihat AGENTS.md.

Kapan menambahkan ke CLAUDE.md

Perlakukan CLAUDE.md sebagai tempat Anda menuliskan apa yang sebaliknya akan Anda jelaskan kembali. Tambahkan ke dalamnya ketika:

• Claude membuat kesalahan yang sama untuk kedua kalinya
• Tinjauan kode menangkap sesuatu yang seharusnya Claude ketahui tentang basis kode ini
• Anda mengetik koreksi atau klarifikasi yang sama ke dalam chat yang Anda ketik di sesi terakhir
• Anggota tim baru akan membutuhkan konteks yang sama untuk produktif

Pertahankan itu untuk fakta yang harus Claude pegang di setiap sesi: perintah build, konvensi, tata letak proyek, aturan "selalu lakukan X". Jika entri adalah prosedur multi-langkah atau hanya penting untuk satu bagian dari basis kode, pindahkan ke skill atau aturan dengan cakupan path sebagai gantinya. Ringkasan ekstensi mencakup kapan menggunakan setiap mekanisme.

Pilih di mana menempatkan file CLAUDE.md

File CLAUDE.md dapat berada di beberapa lokasi, masing-masing dengan cakupan berbeda. Tabel di bawah mencantumnya dalam urutan pemuatan, dari cakupan terluas hingga paling spesifik, sehingga instruksi proyek muncul dalam konteks setelah instruksi pengguna.

File CLAUDE.md dan CLAUDE.local.md dalam hierarki direktori di atas direktori kerja dimuat saat peluncuran. File di subdirektori dimuat sesuai permintaan ketika Claude membaca file di direktori tersebut. Lihat Bagaimana file CLAUDE.md dimuat untuk urutan resolusi lengkap.

Untuk proyek besar, Anda dapat memecah instruksi menjadi file khusus topik menggunakan aturan proyek. Aturan memungkinkan Anda membatasi instruksi ke jenis file atau subdirektori tertentu.

Siapkan CLAUDE.md proyek

CLAUDE.md proyek dapat disimpan di ./CLAUDE.md atau ./.claude/CLAUDE.md. Buat file ini dan tambahkan instruksi yang berlaku untuk siapa pun yang bekerja pada proyek: perintah build dan test, standar pengkodean, keputusan arsitektur, konvensi penamaan, dan alur kerja umum. Instruksi ini dibagikan dengan tim Anda melalui kontrol versi, jadi fokus pada standar tingkat proyek daripada preferensi pribadi. Untuk mengonfirmasi file dimuat, jalankan /context dalam sesi dan periksa daftar di bawah Memory files.

Tulis instruksi yang efektif

File CLAUDE.md dimuat ke jendela konteks di awal setiap sesi, mengonsumsi token bersama percakapan Anda. Visualisasi jendela konteks menunjukkan di mana CLAUDE.md dimuat relatif terhadap sisa konteks startup. Karena mereka adalah konteks daripada konfigurasi yang ditegakkan, cara Anda menulis instruksi mempengaruhi seberapa andal Claude mengikutinya. Instruksi yang spesifik, ringkas, dan terstruktur dengan baik bekerja paling baik.

Ukuran: targetkan di bawah 200 baris per file CLAUDE.md. File yang lebih panjang mengonsumsi lebih banyak konteks dan mengurangi kepatuhan. Jika instruksi Anda berkembang besar, gunakan aturan dengan cakupan path sehingga instruksi hanya dimuat ketika Claude bekerja dengan file yang cocok. Anda juga dapat membagi konten menjadi impor untuk organisasi, meskipun file yang diimpor masih dimuat dan memasuki jendela konteks saat peluncuran.

Struktur: gunakan header markdown dan bullet untuk mengelompokkan instruksi terkait. Claude memindai struktur dengan cara yang sama seperti pembaca: bagian yang terorganisir lebih mudah diikuti daripada paragraf padat.

Spesifisitas: tulis instruksi yang cukup konkret untuk diverifikasi. Sebagai contoh:

• "Gunakan indentasi 2 spasi" daripada "Format kode dengan benar"
• "Jalankan npm test sebelum commit" daripada "Uji perubahan Anda"
• "Handler API berada di src/api/handlers/" daripada "Jaga file tetap terorganisir"

Konsistensi: jika dua aturan saling bertentangan, Claude mungkin memilih satu secara sewenang-wenang. Tinjau file CLAUDE.md Anda, file CLAUDE.md bersarang di subdirektori, dan .claude/rules/ secara berkala untuk menghapus instruksi yang ketinggalan zaman atau bertentangan. Dalam monorepo, gunakan claudeMdExcludes untuk melewati file CLAUDE.md dari tim lain yang tidak relevan dengan pekerjaan Anda.

Impor file tambahan

File CLAUDE.md dapat mengimpor file tambahan menggunakan sintaks @path/to/import. File yang diimpor diperluas dan dimuat ke konteks saat peluncuran bersama CLAUDE.md yang mereferensikannya.

Jalur relatif dan absolut diizinkan. Jalur relatif diselesaikan relatif terhadap file yang berisi impor, bukan direktori kerja. File yang diimpor dapat secara rekursif mengimpor file lain, dengan kedalaman maksimal empat hop.

Penguraian impor melewati rentang kode Markdown dan blok kode yang dibatasi. Untuk menyebutkan jalur di CLAUDE.md Anda tanpa mengimpornya, bungkus dalam backtick: menulis `@README` membuat teks literal, sementara @README di luar backtick mengimpor file.

Untuk menarik README, package.json, dan panduan alur kerja, referensikan dengan sintaks @ di mana saja di CLAUDE.md Anda:

Lihat @README untuk ringkasan proyek dan @package.json untuk perintah npm yang tersedia untuk proyek ini.

# Instruksi Tambahan
- alur kerja git @docs/git-instructions.md

Untuk preferensi pribadi per-proyek yang tidak boleh diperiksa ke kontrol versi, buat CLAUDE.local.md di akar proyek. Ini dimuat bersama CLAUDE.md dan diperlakukan dengan cara yang sama. Tambahkan CLAUDE.local.md ke .gitignore Anda sehingga tidak dikomit. Dengan CLAUDE_CODE_NEW_INIT=1 diatur, menjalankan /init dan memilih opsi pribadi melakukan ini untuk Anda.

Jika Anda bekerja di beberapa git worktrees dari repositori yang sama, CLAUDE.local.md yang diabaikan git hanya ada di worktree tempat Anda membuatnya. Untuk berbagi instruksi pribadi di seluruh worktrees, impor file dari direktori home Anda sebagai gantinya:

# Preferensi Individu
- @~/.claude/my-project-instructions.md

Bagaimana file CLAUDE.md dimuat

Claude Code memuat CLAUDE.md dan CLAUDE.local.md dari direktori kerja saat ini dan setiap direktori di atasnya. Jalankan Claude Code di foo/bar/ dan itu memuat instruksi dari foo/bar/CLAUDE.md, foo/CLAUDE.md, dan file CLAUDE.local.md apa pun di sampingnya.

Semua file yang ditemukan digabungkan ke dalam konteks daripada menimpa satu sama lain. Di seluruh pohon direktori, konten diurutkan dari akar sistem file ke bawah ke direktori kerja Anda. Untuk contoh foo/bar/, foo/CLAUDE.md muncul dalam konteks sebelum foo/bar/CLAUDE.md, jadi instruksi lebih dekat ke tempat Anda meluncurkan Claude dibaca terakhir. Dalam setiap direktori, CLAUDE.local.md ditambahkan setelah CLAUDE.md, jadi catatan pribadi Anda adalah hal terakhir yang Claude baca di tingkat itu.

Claude juga menemukan file CLAUDE.md dan CLAUDE.local.md di subdirektori di bawah direktori kerja saat ini. Daripada memuat mereka saat peluncuran, mereka disertakan ketika Claude membaca file di subdirektori tersebut.

Jika Anda bekerja di monorepo besar di mana file CLAUDE.md tim lain diambil, gunakan claudeMdExcludes untuk melewatinya. Untuk tata letak lengkap file CLAUDE.md akar dan per-direktori serta aturan, lihat Monorepo dan repositori besar.

Komentar HTML tingkat blok (<!-- maintainer notes -->) dalam file CLAUDE.md dilepas sebelum konten disuntikkan ke konteks Claude. Gunakan mereka untuk meninggalkan catatan untuk pengelola manusia tanpa menghabiskan token konteks pada mereka. Komentar di dalam blok kode dipertahankan. Ketika Anda membuka file CLAUDE.md langsung dengan alat Read, komentar tetap terlihat.

Muat dari direktori tambahan

Bendera --add-dir memberikan Claude akses ke direktori tambahan di luar direktori kerja utama Anda. Secara default, file CLAUDE.md dari direktori ini tidak dimuat.

Untuk juga memuat file memori dari direktori tambahan, atur variabel lingkungan CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD:

CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir ../shared-config

Bentuk inline menetapkan variabel untuk peluncuran itu saja di Bash atau Zsh. Untuk menjaganya tetap aktif untuk setiap sesi, tambahkan ke blok env di ~/.claude/settings.json seperti yang ditunjukkan dalam Atur variabel lingkungan.

Ini memuat CLAUDE.md, .claude/CLAUDE.md, .claude/rules/*.md, dan CLAUDE.local.md dari direktori tambahan. CLAUDE.local.md dilewati jika Anda mengecualikan local dari --setting-sources.

Atur aturan dengan `.claude/rules/`

Untuk proyek yang lebih besar, Anda dapat mengatur instruksi menjadi beberapa file menggunakan direktori .claude/rules/. Ini membuat instruksi modular dan lebih mudah bagi tim untuk dipertahankan. Aturan juga dapat dibatasi ke jalur file tertentu, sehingga mereka hanya dimuat ke konteks ketika Claude bekerja dengan file yang cocok, mengurangi kebisingan dan menghemat ruang konteks.

Siapkan aturan

Tempatkan file markdown di direktori .claude/rules/ proyek Anda. Setiap file harus mencakup satu topik, dengan nama file deskriptif seperti testing.md atau api-design.md. Semua file .md ditemukan secara rekursif, sehingga Anda dapat mengatur aturan ke dalam subdirektori seperti frontend/ atau backend/:

your-project/
├── .claude/
│   ├── CLAUDE.md           # Instruksi proyek utama
│   └── rules/
│       ├── code-style.md   # Pedoman gaya kode
│       ├── testing.md      # Konvensi pengujian
│       └── security.md     # Persyaratan keamanan

Aturan tanpa frontmatter paths dimuat saat peluncuran dengan prioritas yang sama seperti .claude/CLAUDE.md.

Aturan proyek dilewati jika Anda mengecualikan project dari --setting-sources. Sebelum v2.1.211, aturan yang dimuat sesuai permintaan, termasuk aturan dengan cakupan path dan aturan di direktori .claude/rules/ bersarang, dimuat bahkan ketika project dikecualikan.

Aturan khusus path

Aturan dapat dibatasi ke file tertentu menggunakan frontmatter YAML dengan bidang paths. Aturan bersyarat ini hanya berlaku ketika Claude bekerja dengan file yang cocok dengan pola yang ditentukan.

---
paths:
  - "src/api/**/*.ts"
---

# Aturan Pengembangan API

- Semua endpoint API harus menyertakan validasi input
- Gunakan format respons kesalahan standar
- Sertakan komentar dokumentasi OpenAPI

Aturan tanpa bidang paths dimuat tanpa syarat dan berlaku untuk semua file. Aturan dengan cakupan path dipicu ketika Claude membaca file yang cocok dengan pola, bukan pada setiap penggunaan alat. Mulai dari v2.1.198, pencocokan juga berfungsi ketika Claude mencapai file melalui jalur symlink ke direktori proyek, misalnya dalam checkout yang disymlink.

Gunakan pola glob dalam bidang paths untuk mencocokkan file berdasarkan ekstensi, direktori, atau kombinasi apa pun:

Anda dapat menentukan beberapa pola dan menggunakan ekspansi brace untuk mencocokkan beberapa ekstensi dalam satu pola:

---
paths:
  - "src/**/*.{ts,tsx}"
  - "lib/**/*.ts"
  - "tests/**/*.test.ts"
---

Setiap grup brace mengalikan jumlah pola yang diperluas: src/*.{ts,tsx} diperluas menjadi dua pola, dan {a,b}/{c,d}/*.{ts,tsx} menjadi delapan. Untuk menjaga ekspansi terbatas, seluruh daftar paths aturan berbagi satu anggaran 1.000 pola yang diperluas dan 4 MiB, dan pola tanpa brace tidak dihitung terhadapnya.

Claude Code menggunakan pola apa pun yang akan melampaui anggaran yang tidak diperluas, dan brace literal mereka tidak cocok dengan file apa pun. Sebelum v2.1.217, nilai paths dengan banyak grup brace menghentikan atau menghancurkan CLI saat startup.

Sintaks Glob memperlakukan [ sebagai awal ekspresi bracket seperti [abc]. Pola dengan [ yang tidak dapat dibaca sebagai ekspresi bracket, seperti photos [2024/**, tidak valid: itu tidak cocok dengan file apa pun, dan pola lain aturan terus bekerja. Untuk mencocokkan [ literal dalam nama file, lepaskan sebagai photos \[2024/**. Sebelum v2.1.207, satu pola tidak valid membuat alat Read gagal untuk setiap file aturan dievaluasi terhadap, daripada tidak cocok dengan apa pun.

Referensi frontmatter aturan

Konfigurasi aturan dengan frontmatter YAML antara penanda --- di bagian atas file. paths adalah satu-satunya bidang yang Claude Code baca dari aturan; bidang lain diabaikan tanpa kesalahan. Claude Code menghapus frontmatter sebelum memuat aturan ke dalam konteks.

Jika YAML antara penanda tidak diuraikan, Claude Code mengabaikan frontmatter dan memuat aturan seolah-olah tidak memiliki paths. Jalankan claude --debug untuk melihat kesalahan penguraian.

Bagikan aturan di seluruh proyek dengan symlink

Direktori .claude/rules/ mendukung symlink, sehingga Anda dapat mempertahankan set aturan bersama dan menautkannya ke beberapa proyek. Symlink melingkar terdeteksi dan ditangani dengan baik.

Claude Code memperlakukan symlink yang targetnya berada di luar direktori kerja Anda seperti impor eksternal. Aturan yang ditautkan tidak dimuat sampai Anda menyetujui impor eksternal untuk proyek, dan setelah itu hanya yang tanpa bidang paths yang dimuat. Claude Code meminta persetujuan itu hanya ketika file memori proyek mengimpor file di luar direktori kerja dengan @path, bukan untuk symlink saja. Untuk memuat aturan bersama tanpa persetujuan itu, simpan di ~/.claude/rules/, di mana mereka berlaku untuk setiap proyek di mesin Anda.

Contoh ini menautkan direktori bersama dan file individual:

ln -s ~/shared-claude-rules .claude/rules/shared
ln -s ~/company-standards/security.md .claude/rules/security.md

Aturan tingkat pengguna

Aturan pribadi di ~/.claude/rules/ berlaku untuk setiap proyek di mesin Anda. Gunakan untuk preferensi yang bukan khusus proyek:

~/.claude/rules/
├── preferences.md    # Preferensi pengkodean pribadi Anda
└── workflows.md      # Alur kerja pilihan Anda

Claude Code memuat aturan tingkat pengguna sebelum aturan proyek, jadi aturan proyek muncul lebih lambat dalam konteks Claude daripada aturan pengguna. Tidak ada set yang menimpa yang lain: jika aturan pengguna dan aturan proyek bertentangan, Claude mungkin mengikuti salah satu, jadi jaga keduanya konsisten.

Kelola CLAUDE.md untuk tim besar

Untuk organisasi yang menerapkan Claude Code di seluruh tim, Anda dapat memusatkan instruksi dan mengontrol file CLAUDE.md mana yang dimuat.

Terapkan CLAUDE.md di seluruh organisasi

Organisasi dapat menerapkan CLAUDE.md yang dikelola secara terpusat yang berlaku untuk semua pengguna di mesin. File ini tidak dapat dikecualikan oleh pengaturan individual.

Kunci claudeMd memungkinkan Anda menempatkan konten CLAUDE.md terkelola langsung di dalam managed-settings.json daripada menerapkan file terpisah.

Cakupan: setiap sesi Claude Code di mesin, di setiap repositori. Untuk panduan khusus repositori, komit CLAUDE.md proyek sebagai gantinya.

Prioritas: sama dengan file CLAUDE.md terkelola. Dimuat sebelum CLAUDE.md pengguna dan proyek.

Di mana itu dihormati: pengaturan terkelola dan kebijakan saja. Menetapkan claudeMd dalam pengaturan pengguna, proyek, atau lokal tidak berpengaruh.

Contoh di bawah menambahkan instruksi perilaku langsung dalam file pengaturan terkelola:

{
  "claudeMd": "Selalu jalankan `make lint` sebelum commit.\nJangan pernah push langsung ke main."
}

CLAUDE.md terkelola dan pengaturan terkelola melayani tujuan berbeda. Gunakan pengaturan untuk penegakan teknis dan CLAUDE.md untuk panduan perilaku:

Aturan pengaturan ditegakkan oleh klien terlepas dari apa yang Claude putuskan untuk dilakukan. Instruksi CLAUDE.md membentuk perilaku Claude tetapi bukan lapisan penegakan keras.

Kecualikan file CLAUDE.md tertentu

Dalam monorepo besar, file CLAUDE.md leluhur mungkin berisi instruksi yang tidak relevan dengan pekerjaan Anda. Pengaturan claudeMdExcludes memungkinkan Anda melewati file tertentu berdasarkan jalur atau pola glob.

Contoh ini mengecualikan CLAUDE.md tingkat atas dan direktori aturan dari folder induk. Tambahkan ke .claude/settings.local.json sehingga pengecualian tetap lokal ke mesin Anda:

{
  "claudeMdExcludes": [
    "**/monorepo/CLAUDE.md",
    "/home/user/monorepo/other-team/.claude/rules/**"
  ]
}

Pola dicocokkan dengan jalur file absolut menggunakan sintaks glob. Anda dapat mengonfigurasi claudeMdExcludes di lapisan pengaturan apa pun: pengguna, proyek, lokal, atau kebijakan terkelola. Array digabungkan di seluruh lapisan.

Untuk mengecualikan file aturan yang Anda jangkau melalui symlink, apakah file atau direktorinya adalah tautan, tulis pola terhadap jalur mana pun: jalur file di bawah .claude/rules/ atau target tautannya. Pola yang cocok dengan jalur mana pun mengecualikan file. Sebelum v2.1.239, hanya pola yang cocok dengan target tautan yang mengecualikan file.

File CLAUDE.md kebijakan terkelola tidak dapat dikecualikan. Ini memastikan instruksi di seluruh organisasi selalu berlaku terlepas dari pengaturan individual.

AGENTS.md

Claude Code dapat membaca AGENTS.md sebagai instruksi proyek Anda, sehingga repositori yang sudah diatur untuk agen pengkodean lain berfungsi tanpa menambahkan CLAUDE.md, impor, atau pengaturan. Tabel ini menunjukkan apa yang Claude baca secara default untuk setiap kombinasi file instruksi di repositori Anda:

Untuk mengubah default, misalnya untuk membuat Claude selalu membaca kedua file, membaca hanya CLAUDE.md, atau membaca hanya instruksi yang dikelola organisasi Anda, ubah pengaturan Project instructions.

When Claude Code reads AGENTS.md

Secara default, Claude membaca AGENTS.md hanya ketika Anda tidak memiliki CLAUDE.md di direktori kerja Anda atau di atasnya. Berikut adalah file Anda mana yang dihitung untuk pemeriksaan itu:

• Dihitung, sehingga Claude membacanya alih-alih AGENTS.md: CLAUDE.md, .claude/CLAUDE.md, atau CLAUDE.local.md di direktori kerja Anda atau direktori apa pun di atasnya
• Tidak dihitung, dan terus dimuat bersama AGENTS.md: ~/.claude/CLAUDE.md Anda, CLAUDE.md yang dikelola organisasi Anda, dan file .claude/rules/

Ketika tidak ada yang dihitung, berikut adalah apa yang Claude baca dan bagaimana Anda dapat mengetahuinya:

• Pada awal sesi: setiap AGENTS.md dan .claude/AGENTS.md di direktori kerja Anda dan direktori di atasnya. Dalam sesi interaktif Anda melihat baris seperti no CLAUDE.md found; AGENTS.md loaded: /home/you/repo/AGENTS.md dalam percakapan
• Saat Claude bekerja di subdirektori: AGENTS.md subdirektori, ketika Claude membuka file di sana dengan alat Read dan subdirektori itu tidak memiliki salah satu dari tiga file CLAUDE.md miliknya sendiri
• Di dalam setiap AGENTS.md: impor @path diperluas, pola claudeMdExcludes berlaku, dan subagen yang melewati instruksi proyek melewati file-file ini juga
• Tidak dibaca: AGENTS.local.md, AGENTS.override.md, atau apa pun di bawah direktori .agents/

Choose which instruction files load

Untuk mengubah file mana yang Claude baca, ketik /config dalam sesi Claude Code untuk membuka panel pengaturan, kemudian atur Project instructions ke salah satu nilai berikut:

Anda juga dapat mengatur nilai dalam file pengaturan alih-alih /config. Tambahkan di bawah ID plugin agents-md bawaan dalam pluginConfigs, di ~/.claude/settings.json, file --settings, atau managed settings. Claude Code mengabaikannya dalam file pengaturan proyek dan lokal. Contoh ini membuat Claude membaca kedua file:

{
  "pluginConfigs": {
    "agents-md@builtin": {
      "options": { "instructionFiles": "claude-md-and-agents-md" }
    }
  }
}

Perubahan Anda berlaku dari pesan berikutnya yang Anda kirim dan di setiap sesi baru.

When AGENTS.md support is unavailable

Dalam sesi ini Claude membaca file CLAUDE.md saja, dan Project instructions tidak muncul di panel pengaturan /config:

• Anda menggunakan versi Claude Code sebelum v2.1.277
• Sesi Anda tidak mengambil bendera fitur dari Anthropic, misalnya karena Anda menggunakan Amazon Bedrock atau penyedia pihak ketiga lainnya, atau Anda menonaktifkan telemetri. Bagian tertaut memiliki daftar lengkap
• Ini adalah sesi pertama Anda setelah Anda menginstal atau meningkatkan ke versi dengan dukungan AGENTS.md. Claude membaca AGENTS.md dari sesi berikutnya Anda
• Anda menonaktifkan plugin agents-md bawaan di /plugin

Untuk memberikan Claude AGENTS.md Anda dalam sesi ini, impor dari CLAUDE.md.

Where AGENTS.md differs from CLAUDE.md

AGENTS.md yang Claude baca melalui pengaturan Project instructions berbeda dari CLAUDE.md di tempat-tempat ini:

Remove an earlier AGENTS.md workaround

Jika Anda menyiapkan Claude Code untuk membaca AGENTS.md sebelum melakukannya sendiri, berikut adalah apa yang harus dilakukan dengan setiap pengaturan umum:

• CLAUDE.md yang berisi @AGENTS.md: Anda dapat meninggalkannya. Menyimpan impor tidak pernah membuat Claude membaca AGENTS.md dua kali, nilai Project instructions apa pun yang Anda gunakan. Hapus CLAUDE.md jika tidak menyimpan apa pun yang lain, atau simpan jika beberapa sesi Anda tidak dapat memuat AGENTS.md secara langsung.
• CLAUDE.md yang memberi tahu Claude dalam kata-kata untuk membaca AGENTS.md: Claude melihat AGENTS.md hanya jika memutuskan untuk membuka file. Hapus CLAUDE.md sehingga Claude membaca AGENTS.md secara langsung, atau ganti kalimat dengan impor @AGENTS.md.
• CLAUDE.md yang symlink ke AGENTS.md: tidak ada, atau hapus symlink. Bagaimanapun Claude membaca konten sekali.
• Hook SessionStart yang mencetak AGENTS.md: hapus itu. Setelah Claude membaca AGENTS.md secara langsung, hook menambahkan salinan kedua ke konteks.

Share one file with other coding tools

Ketika Claude tidak membaca AGENTS.md Anda secara langsung, Anda masih dapat menyimpannya sebagai satu file yang dibagikan setiap alat dengan menempatkan impor @AGENTS.md dalam CLAUDE.md di sebelahnya. Lakukan ini ketika proyek Anda juga memiliki CLAUDE.md, ketika Anda telah mengatur Project instructions ke claude-md, atau dalam sesi yang tidak dapat memuat AGENTS.md. Tambahkan instruksi khusus Claude apa pun di bawah impor, dan Claude membaca file yang diimpor terlebih dahulu, kemudian sisanya:

@AGENTS.md

## Claude Code

Use plan mode for changes under `src/billing/`.

Jika Anda tidak memerlukan konten khusus Claude, symlink juga berfungsi:

ln -s AGENTS.md CLAUDE.md

Perintah tidak mencetak output pada kesuksesan. Sebelum Anda memilih symlink daripada impor, periksa batasan ini:

• Pengeditan: Claude membaca CLAUDE.md melalui tautan, tetapi alat Edit dan Write menolak untuk menulis melalui symlink, dan penolakan mengarahkan Claude untuk mengedit target tautan, AGENTS.md, sebagai gantinya
• Windows: jika Anda atau siapa pun yang mengkloning repositori bekerja di Windows, gunakan impor @AGENTS.md sebagai gantinya. Membuat symlink di sana memerlukan hak istimewa Administrator atau Mode Pengembang, dan Git memeriksa symlink yang berkomitmen sebagai file teks biasa kecuali core.symlinks diaktifkan, yang meninggalkan klon itu dengan CLAUDE.md satu baris sebagai pengganti instruksi Anda

Dengan salah satu pendekatan, jalankan /context dalam sesi berikutnya Anda dan konfirmasi CLAUDE.md muncul di bawah Memory files.

Migrate instructions from other tools

Menjalankan /init membaca file instruksi alat lain dan menggabungkan bagian yang relevan ke dalam CLAUDE.md yang dihasilkan:

• Aturan Cursor di .cursor/rules/ atau .cursorrules
• Aturan Copilot di .github/copilot-instructions.md
• Dengan CLAUDE_CODE_NEW_INIT=1 diatur: AGENTS.md, .devin/rules/, .windsurf/rules/ atau .windsurfrules, dan .clinerules

Anda juga dapat menjalankan /import untuk membawa konfigurasi agen pengkodean yang didukung ke Claude Code, yang menambahkan salinan satu kali file instruksi seperti AGENTS.md ke CLAUDE.md yang cocok dan membawa server MCP, perintah, subagen, dan skills. Memerlukan Claude Code v2.1.213 atau lebih baru.

Auto memory

Auto memory memungkinkan Claude mengumpulkan pengetahuan lintas sesi tanpa Anda menulis apa pun. Saat bekerja, Claude menyimpan empat jenis catatan untuk dirinya sendiri. Claude mencatat jenisnya sebagai bidang type dalam frontmatter file memori:

• user: peran Anda, keahlian, dan preferensi kerja
• feedback: koreksi yang Anda berikan kepada Claude dan pendekatan yang Anda konfirmasi
• project: pekerjaan yang sedang berlangsung, tenggat waktu, dan keputusan yang tidak dapat Claude turunkan dari kode atau riwayat git
• reference: tempat menemukan informasi di luar proyek, seperti pelacak masalah atau dasbor

Claude melewati apa pun yang dapat diturunkan dari basis kode, seperti arsitektur, jalur file, atau perbaikan debugging. Itu juga melewati apa pun yang sudah dikatakan file CLAUDE.md Anda.

Claude tidak menyimpan sesuatu setiap sesi. Itu memutuskan apa yang layak diingat berdasarkan apakah informasi akan berguna dalam percakapan masa depan.

Aktifkan atau nonaktifkan auto memory

Auto memory aktif secara default. Untuk mengalihkannya, buka /memory dalam sesi dan gunakan toggle auto memory, yang menyimpan autoMemoryEnabled ke pengaturan pengguna Anda di ~/.claude/settings.json. Untuk mematikannya untuk satu proyek, atur autoMemoryEnabled dalam pengaturan proyek itu:

{
  "autoMemoryEnabled": false
}

Untuk menonaktifkan auto memory melalui variabel lingkungan, atur CLAUDE_CODE_DISABLE_AUTO_MEMORY=1.

Lokasi penyimpanan

Setiap proyek mendapatkan direktori memori sendiri di ~/.claude/projects/<project>/memory/. Jalur <project> berasal dari repositori git, jadi semua worktrees dan subdirektori dalam repo yang sama berbagi satu direktori auto memory. Di luar repo git, root proyek digunakan sebagai gantinya.

Jika Anda menetapkan CLAUDE_CODE_PROJECT_DIR_NAME di samping CLAUDE_CONFIG_DIR, Claude Code menggunakan nama itu sebagai direktori <project> di bawah <config dir>/projects/ sebagai gantinya, di mana pun repositori apa pun yang Anda luncurkan, jadi proyek yang diluncurkan dengan direktori konfigurasi itu berbagi satu direktori auto memory. Memerlukan Claude Code v2.1.234 atau lebih baru.

Untuk menyimpan auto memory di lokasi berbeda, atur autoMemoryDirectory dalam settings.json Anda. Itu dibaca dari cakupan pengaturan apa pun: pengguna, proyek, lokal, kebijakan, atau --settings.

{
  "autoMemoryDirectory": "~/my-custom-memory-dir"
}

Nilai harus berupa jalur absolut atau dimulai dengan ~/.

Ketika Anda menetapkannya dalam .claude/settings.json atau .claude/settings.local.json proyek, Claude Code menghormatinya di bawah aturan kepercayaan ruang kerja yang sama dengan hooks dalam file pengaturan. Sementara permissions.blockReadsOutsideWorkingDirectories aktif, Claude Code tidak memuat auto memory dari direktori yang dipilih oleh file pengaturan yang disediakan repositori dan tidak menyimpan apa pun ke dalamnya, di mana pun direktori itu berada.

Direktori berisi indeks MEMORY.md dan satu file topik per memori:

~/.claude/projects/<project>/memory/
├── MEMORY.md           # Indeks, satu baris per memori, dimuat ke dalam setiap sesi
├── user_role.md        # Satu memori
├── feedback_testing.md # Satu memori
└── ...                 # File topik lainnya yang Claude buat

MEMORY.md bertindak sebagai indeks direktori memori. Claude membaca dan menulis file di direktori ini sepanjang sesi Anda, menggunakan MEMORY.md untuk melacak apa yang disimpan di mana.

Auto memory adalah mesin-lokal. Semua worktrees dan subdirektori dalam repositori git yang sama berbagi satu direktori auto memory. File tidak dibagikan di seluruh mesin atau lingkungan cloud.

Claude Code menghapus transkrip sesi lama setelah periode retensi cleanupPeriodDays, tetapi mengecualikan file memori di direktori memori dari pembersihan retensi itu. MEMORY.md dan file topik tetap ada sampai Anda atau Claude mengedit atau menghapusnya.

Bagaimana cara kerjanya

200 baris pertama MEMORY.md, atau 25KB pertama, mana pun yang lebih dulu, dimuat di awal setiap percakapan. Konten di luar batas itu tidak dimuat saat awal sesi. Claude membuat MEMORY.md ringkas dengan memindahkan catatan terperinci ke file topik terpisah.

Setelah Claude menulis ke MEMORY.md, Claude Code mengukur file terhadap batas baca 200 baris dan 25KB. Jika file mendekati batas, Claude Code mengingatkan Claude untuk mempersingkatnya: simpan satu baris per entri, pindahkan detail ke file topik, dan gabungkan atau lepaskan entri yang sudah usang. Jika file melampaui batas, penulisan masih berhasil, tetapi Claude Code mengembalikan kesalahan yang memberi tahu Claude untuk menulis ulang indeks, karena semua yang melampaui batas dijatuhkan pada beban berikutnya.

Batas ini hanya berlaku untuk MEMORY.md. Claude Code memuat file CLAUDE.md hingga 4 MiB sepenuhnya dan melewati file yang lebih besar. File yang lebih pendek menghasilkan kepatuhan yang lebih baik.

Claude Code tidak memuat file topik seperti user_role.md atau feedback_testing.md saat startup. Claude membacanya sesuai permintaan menggunakan alat file standarnya ketika membutuhkan informasi.

Auto memory percakapan utama tidak dimuat ke dalam subagents; pengecualiannya adalah fork, yang mewarisi percakapan induk dan prompt sistem. Auto memory subagent sendiri, diaktifkan dengan bidang memory subagent, adalah direktori terpisah.

Claude membaca dan menulis file memori selama sesi Anda. Ketika Anda melihat pesan seperti "Saved 2 memories" atau "Recalled 2 memories" di antarmuka Claude Code, Claude secara aktif memperbarui atau membaca dari ~/.claude/projects/<project>/memory/.

Ketika Claude menulis file memori yang dimulai dengan frontmatter YAML, Claude Code mencatat waktu penulisan dalam bidang frontmatter modified sebagai stempel waktu ISO 8601. Stempel waktu menunjukkan seberapa terkini faktanya, baik untuk Anda maupun untuk Claude ketika membacanya kembali. File apa pun yang memiliki frontmatter mendapatkan bidang saat Claude menulis ulang, termasuk file yang dibuat di versi sebelumnya; Claude Code tidak pernah menambahkan frontmatter ke file yang tidak memilikinya. Bidang modified memerlukan Claude Code v2.1.214 atau lebih baru.

Audit dan edit memori Anda

File auto memory adalah markdown biasa yang dapat Anda edit atau hapus kapan saja. Jalankan /memory untuk menelusuri dan membuka file memori dari dalam sesi.

Lihat dan edit dengan `/memory`

Perintah /memory mencantumkan file CLAUDE.md, CLAUDE.local.md, dan file memory lainnya di seluruh cakupan pengguna dan proyek, termasuk entri CLAUDE.md pengguna dan proyek untuk file yang belum ada. Ini juga memungkinkan Anda mengalihkan auto memory aktif atau mati dan menyediakan opsi untuk membuka folder auto memory. Pilih file apa pun untuk membukanya di editor Anda; memilih file yang belum ada akan membuatnya terlebih dahulu. Untuk memeriksa file mana yang benar-benar dimuat ke dalam sesi saat ini, jalankan /context.

Editor GUI seperti VS Code membuka file di jendela terpisah, dan Anda dapat terus menggunakan sesi saat file terbuka. Sebelum v2.1.216, /memory menunggu Anda menutup file sebelum merespons. Editor terminal seperti Vim mengambil alih terminal sampai Anda keluar.

Ketika Anda meminta Claude untuk mengingat sesuatu, seperti "selalu gunakan pnpm, bukan npm" atau "ingat bahwa tes API memerlukan instans Redis lokal," Claude menyimpannya ke auto memory. Untuk menambahkan instruksi ke CLAUDE.md sebagai gantinya, minta Claude secara langsung, seperti "tambahkan ini ke CLAUDE.md," atau edit file sendiri melalui /memory.

Troubleshoot memory issues

Ini adalah masalah paling umum dengan CLAUDE.md dan auto memory, bersama dengan langkah-langkah untuk men-debug mereka.

Claude isn't following my CLAUDE.md

Konten CLAUDE.md disampaikan sebagai pesan pengguna setelah prompt sistem, bukan sebagai bagian dari prompt sistem itu sendiri. Claude membacanya dan mencoba mengikutinya, tetapi tidak ada jaminan kepatuhan ketat, terutama untuk instruksi yang samar atau bertentangan.

Untuk men-debug:

• Jalankan /context dan periksa daftar di bawah Memory files untuk memverifikasi file CLAUDE.md dan CLAUDE.local.md Anda dimuat. Jika file CLAUDE.md tidak ada di sana, Claude tidak dapat melihatnya. Gunakan /memory untuk membuka dan mengedit file.
• Periksa bahwa CLAUDE.md yang relevan berada di lokasi yang dimuat untuk sesi Anda (lihat Choose where to put CLAUDE.md files).
• Buat instruksi lebih spesifik. "Gunakan indentasi 2 spasi" bekerja lebih baik daripada "format kode dengan baik."
• Cari instruksi yang bertentangan di seluruh file CLAUDE.md. Jika dua file memberikan panduan berbeda untuk perilaku yang sama, Claude mungkin memilih satu secara sembarangan.

Jika instruksi adalah sesuatu yang harus berjalan pada titik tertentu, seperti sebelum setiap commit atau setelah setiap pengeditan file, tulislah sebagai hook sebagai gantinya. Hooks dieksekusi sebagai perintah shell pada peristiwa siklus hidup tetap dan berlaku terlepas dari apa yang Claude putuskan untuk lakukan.

Untuk instruksi yang Anda inginkan di tingkat prompt sistem, gunakan --append-system-prompt. Anda meneruskannya saat peluncuran, jadi lebih cocok untuk skrip dan otomasi daripada penggunaan interaktif. Untuk cara kerjanya saat Anda melanjutkan percakapan, lihat System prompt flags in resumed conversations.

My AGENTS.md isn't loading

Jika repositori Anda memiliki AGENTS.md dan Claude tampaknya tidak tahu apa yang dikatakannya, penyebab biasanya adalah CLAUDE.md di suatu tempat di jalur proyek. Secara default Claude membaca AGENTS.md hanya ketika Anda tidak memiliki CLAUDE.md atau CLAUDE.local.md di direktori kerja Anda atau di atasnya. Periksa ini secara berurutan:

1. Cari CLAUDE.md, .claude/CLAUDE.md, atau CLAUDE.local.md di direktori kerja Anda atau direktori apa pun di atasnya, selain ~/.claude/CLAUDE.md. Jika Anda menemukan satu, Claude membacanya sebagai gantinya dari AGENTS.md kecuali Anda menetapkan Project instructions ke claude-md-and-agents-md.
2. Jalankan claude --version dan konfirmasi v2.1.277 atau lebih baru.
3. Periksa apakah sesi Anda adalah sesi yang tidak dapat memuat AGENTS.md, seperti sesi di penyedia pihak ketiga atau dengan telemetri dinonaktifkan.
4. Ketik /config dalam sesi Anda untuk membuka panel pengaturan dan konfirmasi Project instructions tidak diatur ke claude-md atau managed-only. Jika Anda tidak melihat pengaturan di sana sama sekali, sesi Anda adalah sesi yang tidak dapat memuat AGENTS.md.

Untuk memeriksa apakah Claude membaca AGENTS.md Anda, jalankan /memory dan cari jalurnya dalam daftar.

Sebelum v2.1.280, /memory dan /context tidak mencantumkan AGENTS.md yang Claude baca secara langsung. Pada versi tersebut, tanyakan kepada Claude apa yang dikatakan instruksi proyeknya sebagai gantinya.

Jika Anda ingin menyimpan CLAUDE.md yang Anda temukan, atau sesi Anda tidak dapat memuat AGENTS.md, tambahkan CLAUDE.md di sebelah AGENTS.md Anda yang mengimpornya.

I don't know what auto memory saved

Jalankan /memory dan pilih folder auto memory untuk menelusuri apa yang telah disimpan Claude. Semuanya adalah markdown biasa yang dapat Anda baca, edit, atau hapus.

My CLAUDE.md is too large

File di atas 200 baris mengonsumsi lebih banyak konteks dan dapat mengurangi kepatuhan. Claude Code melewati file di atas 4 MiB. Gunakan path-scoped rules untuk memuat instruksi hanya ketika Claude bekerja dengan file yang cocok, atau pangkas konten yang tidak diperlukan dalam setiap sesi. Memisahkan ke dalam impor @path membantu organisasi tetapi tidak mengurangi konteks, karena file yang diimpor dimuat saat peluncuran.

/doctor checkup mengusulkan pemangkasan untuk CLAUDE.md yang diperiksa: ia memotong konten yang dapat Claude turunkan dari codebase, seperti tata letak direktori, daftar dependensi, dan ikhtisar arsitektur, dan menyimpan jebakan, rasional, dan konvensi yang berbeda dari default alat. Pemeriksaan pemangkasan memerlukan Claude Code v2.1.206 atau lebih baru.

Instructions seem lost after `/compact`

CLAUDE.md root proyek bertahan dari pemadatan: setelah /compact, Claude membaca ulang dari disk dan menyuntikkannya kembali ke dalam sesi. File CLAUDE.md bersarang di subdirektori dan aturan dengan frontmatter paths: dimuat ulang saat Claude membaca file yang mereka terapkan.

Jika instruksi hilang setelah pemadatan, itu diberikan hanya dalam percakapan, berada di CLAUDE.md bersarang yang belum dimuat ulang, atau merupakan aturan yang dibatasi jalur yang belum cocok dengan file sejak itu. Tambahkan instruksi percakapan ke CLAUDE.md untuk membuatnya bertahan. Lihat What survives compaction untuk rincian lengkap.

Lihat Write effective instructions untuk panduan tentang ukuran, struktur, dan spesifisitas.

Sumber daya terkait

• Debug konfigurasi Anda: diagnosis mengapa CLAUDE.md atau pengaturan tidak berlaku
• Skills: paket alur kerja yang dapat diulang yang dimuat sesuai permintaan
• Settings: konfigurasi perilaku Claude Code dengan file pengaturan
• Memori subagent: biarkan subagents mempertahankan auto memory mereka sendiri