Bagaimana Claude mengingat proyek Anda

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
Auto memory: catatan yang Claude tulis sendiri berdasarkan koreksi dan preferensi Anda

Halaman ini mencakup cara untuk:

Menulis dan mengorganisir file 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.

	File CLAUDE.md	Auto memory
Siapa yang menulisnya	Anda	Claude
Apa yang dikandungnya	Instruksi dan aturan	Pembelajaran dan pola
Cakupan	Proyek, pengguna, atau organisasi	Per repositori, dibagikan di seluruh worktrees
Dimuat ke dalam	Setiap sesi	Setiap sesi (200 baris pertama atau 25KB)
Gunakan untuk	Standar pengkodean, alur kerja, arsitektur proyek	Preferensi Anda, koreksi yang Anda berikan kepada Claude, konteks proyek yang Claude tidak dapat turunkan dari kode

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 Claude instruksi persisten untuk proyek, alur kerja pribadi Anda, atau seluruh organisasi Anda. Anda menulis file ini dalam teks biasa; Claude membacanya di awal setiap sesi.

Kapan harus menambahkan ke CLAUDE.md

Perlakukan CLAUDE.md sebagai tempat Anda menulis 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 fakta yang seharusnya 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 bersyarat jalur sebagai gantinya. Gambaran umum 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 yang berbeda. Tabel di bawah mencantumkan mereka dalam urutan pemuatan, dari cakupan terluas hingga paling spesifik, jadi instruksi proyek muncul dalam konteks setelah instruksi pengguna.

Cakupan	Lokasi	Tujuan	Contoh kasus penggunaan	Dibagikan dengan
Kebijakan terkelola	• macOS: `/Library/Application Support/ClaudeCode/CLAUDE.md` • Linux dan WSL: `/etc/claude-code/CLAUDE.md` • Windows: `C:\Program Files\ClaudeCode\CLAUDE.md`	Instruksi di seluruh organisasi yang dikelola oleh IT/DevOps	Standar pengkodean perusahaan, kebijakan keamanan, persyaratan kepatuhan	Semua pengguna dalam organisasi
Instruksi pengguna	`~/.claude/CLAUDE.md`	Preferensi pribadi untuk semua proyek	Preferensi gaya kode, pintasan alat pribadi	Hanya Anda (semua proyek)
Instruksi proyek	`./CLAUDE.md` atau `./.claude/CLAUDE.md`	Instruksi bersama tim untuk proyek	Arsitektur proyek, standar pengkodean, alur kerja umum	Anggota tim melalui kontrol sumber
Instruksi lokal	`./CLAUDE.local.md`	Preferensi pribadi khusus proyek; tambahkan ke `.gitignore`	URL sandbox Anda, data test pilihan	Hanya Anda (proyek saat ini)

File CLAUDE.md dan CLAUDE.local.md dalam hierarki direktori di atas direktori kerja dimuat sepenuhnya 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 tipe 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.

Jalankan /init untuk menghasilkan CLAUDE.md awal secara otomatis. Claude menganalisis basis kode Anda dan membuat file dengan perintah build, instruksi test, dan konvensi proyek yang ditemukannya. Jika CLAUDE.md sudah ada, /init menyarankan perbaikan daripada menimpanya. Perbaiki dari sana dengan instruksi yang Claude tidak akan temukan sendiri.Atur CLAUDE_CODE_NEW_INIT=1 untuk mengaktifkan alur multi-fase interaktif. /init menanyakan artefak mana yang akan diatur: file CLAUDE.md, skills, dan hooks. Kemudian mengeksplorasi basis kode Anda dengan subagent, mengisi celah melalui pertanyaan lanjutan, dan menyajikan proposal yang dapat ditinjau sebelum menulis file apa pun.

Tulis instruksi yang efektif

File CLAUDE.md dimuat ke dalam context window di awal setiap sesi, mengonsumsi token bersama percakapan Anda. Visualisasi context window menunjukkan di mana CLAUDE.md dimuat relatif terhadap sisa startup context. Karena mereka adalah konteks daripada konfigurasi yang diberlakukan, 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 bersyarat jalur sehingga instruksi hanya dimuat ketika Claude bekerja dengan file yang cocok, menghemat ruang konteks. Anda juga dapat membagi konten menjadi impor untuk organisasi, meskipun file yang diimpor masih dimuat dan memasuki context window 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. Misalnya:

“Gunakan indentasi 2 spasi” daripada “Format kode dengan baik”
“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 sembarangan. Tinjau file CLAUDE.md Anda, file CLAUDE.md bersarang di subdirektori, dan file .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 dalam 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 tetap literal, sementara @README di luar backtick mengimpor file. Untuk menarik README, package.json, dan panduan alur kerja, referensikan mereka dengan sintaks @ di mana saja di CLAUDE.md Anda:

Lihat @README untuk gambaran umum 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 ingin Anda periksa ke dalam kontrol versi, buat CLAUDE.local.md di root proyek. Itu 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 seluruh 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

Impor dalam file memori tingkat proyek bersifat eksternal ketika jalurnya diselesaikan di luar direktori kerja Anda, seperti impor direktori home di atas. Pertama kali Claude Code menemukan impor eksternal dalam proyek, itu menampilkan dialog persetujuan yang mencantumkan file. Jika Anda menolak, impor tetap dinonaktifkan dan dialog tidak muncul lagi.Claude Code menampilkan dialog untuk melindungi Anda dari file yang orang lain komit ke proyek bersama. File memori tingkat pengguna, seperti ~/.claude/CLAUDE.md dan ~/.claude/rules/, adalah file yang Anda tulis sendiri. Kecuali dalam sesi Cowork di desktop Anda, Claude Code memuat impor mereka tanpa dialog dan mempercayai mereka seperti sisa konfigurasi pribadi Anda.Dalam sesi Cowork di desktop Anda, Claude Code melewati impor apa pun dalam file tingkat pengguna yang diselesaikan ke jalur di luar direktori kerja sesi dan memuat sisa file. Dalam sesi tersebut, itu juga melewati ~/.claude/CLAUDE.md yang merupakan symlink atau hard link, dan direktori ~/.claude/rules/ yang disymlink atau file aturan yang menunjuk di luar direktori kerja.

AGENTS.md

Claude Code membaca CLAUDE.md, bukan AGENTS.md. Jika repositori Anda sudah menggunakan AGENTS.md untuk agen pengkodean lain, buat CLAUDE.md yang mengimpornya sehingga kedua alat membaca instruksi yang sama tanpa menduplikasinya. Anda juga dapat menambahkan instruksi khusus Claude di bawah impor. Claude memuat file yang diimpor saat awal sesi, kemudian menambahkan sisanya:

CLAUDE.md

@AGENTS.md

## Claude Code

Gunakan plan mode untuk perubahan di bawah `src/billing/`.

Symlink juga berfungsi jika Anda tidak perlu menambahkan konten khusus Claude:

ln -s AGENTS.md CLAUDE.md

Perintah tidak mencetak output saat berhasil. Dalam sesi berikutnya, jalankan /context dan konfirmasi CLAUDE.md muncul di bawah Memory files. Di Windows, membuat symlink memerlukan hak istimewa Administrator atau Developer Mode, jadi gunakan impor @AGENTS.md sebagai gantinya. Menjalankan /init membaca aturan Cursor, di .cursor/rules/ atau .cursorrules, dan aturan Copilot, di .github/copilot-instructions.md, dan menggabungkan bagian yang relevan ke dalam CLAUDE.md yang dihasilkan. Dengan CLAUDE_CODE_NEW_INIT=1 diatur, /init juga membaca AGENTS.md, .devin/rules/, .windsurf/rules/ atau .windsurfrules, dan .clinerules. Anda juga dapat menjalankan /import untuk membawa konfigurasi agen pengkodean yang didukung ke dalam Claude Code, yang menambahkan salinan satu kali file instruksi seperti AGENTS.md ke CLAUDE.md yang cocok dan membawa server MCP, perintah, subagent, dan skills. Memerlukan Claude Code v2.1.213 atau lebih baru.

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 sebelahnya. Semua file yang ditemukan digabungkan ke dalam konteks daripada menimpa satu sama lain. Dalam pohon direktori, konten diurutkan dari root 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 yang lebih dekat dengan 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. Alih-alih memuatnya 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 root dan per-direktori serta aturan, lihat Monorepo dan repo besar. Komentar HTML tingkat blok () dalam file CLAUDE.md dihapus sebelum konten disuntikkan ke dalam konteks Claude. Gunakan mereka untuk meninggalkan catatan bagi pengelola manusia tanpa menghabiskan token konteks pada mereka. Komentar di dalam blok kode dipertahankan. Ketika Anda membuka file CLAUDE.md secara langsung dengan alat Read, komentar tetap terlihat.

Muat dari direktori tambahan

Flag --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

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.

Organisir aturan dengan `.claude/rules/`

Untuk proyek yang lebih besar, Anda dapat mengorganisir 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 dalam konteks ketika Claude bekerja dengan file yang cocok, mengurangi kebisingan dan menghemat ruang konteks.

Aturan dimuat ke dalam konteks setiap sesi atau ketika file yang cocok dibuka. Untuk instruksi khusus tugas yang tidak perlu berada dalam konteks sepanjang waktu, gunakan skills sebagai gantinya, yang hanya dimuat ketika Anda menginvokasinya atau ketika Claude menentukan mereka relevan dengan prompt Anda.

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, jadi Anda dapat mengorganisir 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 bersyarat jalur dan aturan di direktori .claude/rules/ bersarang, dimuat bahkan ketika project dikecualikan.

Aturan khusus jalur

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 bersyarat jalur dipicu ketika Claude membaca file yang cocok dengan pola, bukan pada setiap penggunaan alat. Sejak v2.1.198, pencocokan juga berfungsi ketika Claude mencapai file melalui jalur symlink ke direktori proyek, misalnya dalam checkout yang disymlink. Gunakan pola glob di bidang paths untuk mencocokkan file berdasarkan ekstensi, direktori, atau kombinasi apa pun:

Pola	Cocok dengan
`*/.ts`	Semua file TypeScript di direktori apa pun
`src/*/`	Semua file di bawah direktori `src/`
`*.md`	File Markdown di root proyek
`src/components/*.tsx`	Komponen React di direktori tertentu

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-nya 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 apa pun, dan pola lain dari aturan terus bekerja. Untuk mencocokkan [ literal dalam nama file, lepaskan sebagai photos \[2024/**. Sebelum v2.1.207, satu pola yang tidak valid membuat alat Read gagal untuk setiap file yang aturan dievaluasi, alih-alih tidak cocok dengan apa pun. Direktori .claude/rules/ mendukung symlinks, jadi Anda dapat mempertahankan set aturan bersama dan menautkannya ke beberapa proyek. Symlinks diselesaikan dan dimuat secara normal, dan symlinks melingkar terdeteksi dan ditangani dengan anggun. Claude Code memperlakukan symlink yang target-nya 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 symlinks 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

Aturan tingkat pengguna dimuat sebelum aturan proyek, memberikan aturan proyek prioritas lebih tinggi.

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.

Buat file di lokasi kebijakan terkelola

macOS: /Library/Application Support/ClaudeCode/CLAUDE.md
Linux dan WSL: /etc/claude-code/CLAUDE.md
Windows: C:\Program Files\ClaudeCode\CLAUDE.md

Terapkan dengan sistem manajemen konfigurasi Anda

Gunakan MDM, Group Policy, Ansible, atau alat serupa untuk mendistribusikan file di seluruh mesin pengembang. Lihat pengaturan terkelola untuk opsi konfigurasi di seluruh organisasi lainnya.

Kunci claudeMd memungkinkan Anda menempatkan konten CLAUDE.md terkelola langsung di dalam managed-settings.json alih-alih 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": "Always run `make lint` before committing.\nNever push directly to main."
}

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

Kekhawatiran	Konfigurasi dalam
Blokir alat, perintah, atau jalur file tertentu	Pengaturan terkelola: `permissions.deny`
Paksakan isolasi sandbox	Pengaturan terkelola: `sandbox.enabled`
Variabel lingkungan dan perutean penyedia API	Pengaturan terkelola: `env`
Metode autentikasi dan kunci organisasi	Pengaturan terkelola: `forceLoginMethod`, `forceLoginOrgUUID`
Panduan gaya kode dan kualitas	CLAUDE.md terkelola
Pengingat penanganan data dan kepatuhan	CLAUDE.md terkelola
Instruksi perilaku untuk Claude	CLAUDE.md terkelola

Aturan pengaturan diberlakukan 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 agar 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 capai 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.

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. 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 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.

Gunakan hook InstructionsLoaded untuk mencatat dengan tepat file instruksi mana yang dimuat, kapan mereka dimuat, dan mengapa. Ini berguna untuk men-debug aturan khusus jalur atau file yang dimuat malas di subdirektori.

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.

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

Memulai

Konsep Inti

Gunakan Claude Code

Platform dan integrasi

Bagaimana Claude mengingat proyek Anda

CLAUDE.md vs auto memory

File CLAUDE.md

Kapan harus menambahkan ke CLAUDE.md

Pilih di mana menempatkan file CLAUDE.md

Siapkan CLAUDE.md proyek

Tulis instruksi yang efektif

Impor file tambahan

AGENTS.md

Bagaimana file CLAUDE.md dimuat

Muat dari direktori tambahan

Organisir aturan dengan `.claude/rules/`

Siapkan aturan

Aturan khusus jalur

Aturan tingkat pengguna

Kelola CLAUDE.md untuk tim besar

Terapkan CLAUDE.md di seluruh organisasi

Kecualikan file CLAUDE.md tertentu

Auto memory

Aktifkan atau nonaktifkan auto memory

Lokasi penyimpanan

Bagaimana cara kerjanya

Audit dan edit memori Anda

Lihat dan edit dengan `/memory`

Troubleshoot memory issues

Claude isn’t following my CLAUDE.md

I don’t know what auto memory saved

My CLAUDE.md is too large

Instructions seem lost after `/compact`

​CLAUDE.md vs auto memory

​File CLAUDE.md

​Kapan harus menambahkan ke CLAUDE.md

​Pilih di mana menempatkan file CLAUDE.md

​Siapkan CLAUDE.md proyek

​Tulis instruksi yang efektif

​Impor file tambahan

​AGENTS.md

​Bagaimana file CLAUDE.md dimuat

​Muat dari direktori tambahan

​Organisir aturan dengan .claude/rules/

​Siapkan aturan

​Aturan khusus jalur

​Bagikan aturan lintas proyek dengan symlinks

​Aturan tingkat pengguna

​Kelola CLAUDE.md untuk tim besar

​Terapkan CLAUDE.md di seluruh organisasi

​Kecualikan file CLAUDE.md tertentu

​Auto memory

​Aktifkan atau nonaktifkan auto memory

​Lokasi penyimpanan

​Bagaimana cara kerjanya

​Audit dan edit memori Anda

​Lihat dan edit dengan /memory

​Troubleshoot memory issues

​Claude isn’t following my CLAUDE.md

​I don’t know what auto memory saved

​My CLAUDE.md is too large

​Instructions seem lost after /compact

​Sumber daya terkait

CLAUDE.md vs auto memory

File CLAUDE.md

Kapan harus menambahkan ke CLAUDE.md

Pilih di mana menempatkan file CLAUDE.md

Siapkan CLAUDE.md proyek

Tulis instruksi yang efektif

Impor file tambahan

AGENTS.md

Bagaimana file CLAUDE.md dimuat

Muat dari direktori tambahan

Organisir aturan dengan `.claude/rules/`

Siapkan aturan

Aturan khusus jalur

Bagikan aturan lintas proyek dengan symlinks

Aturan tingkat pengguna

Kelola CLAUDE.md untuk tim besar

Terapkan CLAUDE.md di seluruh organisasi

Kecualikan file CLAUDE.md tertentu

Auto memory

Aktifkan atau nonaktifkan auto memory

Lokasi penyimpanan

Bagaimana cara kerjanya

Audit dan edit memori Anda

Lihat dan edit dengan `/memory`

Troubleshoot memory issues

Claude isn’t following my CLAUDE.md

I don’t know what auto memory saved

My CLAUDE.md is too large

Instructions seem lost after `/compact`

Sumber daya terkait