Skip to main content
Claude Code membaca instruksi, pengaturan, skills, subagents, dan memory dari direktori proyek Anda dan dari ~/.claude di direktori home Anda. Commit file proyek ke git untuk membagikannya dengan tim Anda; file di ~/.claude adalah konfigurasi pribadi yang berlaku di semua proyek Anda. Di Windows, ~/.claude diselesaikan menjadi %USERPROFILE%\.claude. Jika Anda menetapkan CLAUDE_CONFIG_DIR, setiap jalur ~/.claude di halaman ini berada di bawah direktori itu sebagai gantinya. Sebagian besar pengguna hanya mengedit CLAUDE.md dan settings.json. Jika repositori Anda sudah memiliki AGENTS.md untuk agen coding lainnya, Claude Code dapat membacanya sendiri atau bersama CLAUDE.md. Sisa direktori bersifat opsional: tambahkan skills, rules, atau subagents sesuai kebutuhan Anda.

Jelajahi direktori

Klik file di pohon untuk melihat apa yang dilakukan masing-masing, kapan dimuat, dan contohnya.

Yang tidak ditampilkan

Explorer mencakup file yang Anda buat dan edit. Beberapa file terkait berada di tempat lain: ~/.claude juga menyimpan data yang ditulis Claude Code saat Anda bekerja: transkrip, riwayat prompt, snapshot file, cache, dan log. Lihat application data di bawah.

Pilih file yang tepat

Berbagai jenis kustomisasi berada di file yang berbeda. Gunakan tabel ini untuk menemukan di mana perubahan harus dilakukan.

Referensi file

Tabel ini mencantumkan setiap file yang dicakup penjelajah. File dengan cakupan proyek berada di repo Anda di bawah .claude/ (atau di akar untuk CLAUDE.md, .mcp.json, dan .worktreeinclude). File dengan cakupan global berada di ~/.claude/ dan berlaku di semua proyek.
Beberapa hal dapat mengganti apa yang Anda masukkan dalam file ini:Lihat prioritas pengaturan untuk urutan lengkapnya.
Klik nama file untuk membuka node itu di penjelajah di atas.

Bidang frontmatter menurut file

Skills, command files, subagents, output styles, dan rules membaca konfigurasi mereka dari YAML frontmatter di bagian atas file, dan masing-masing menerima set bidang tersendiri. Tabel ini mencantumkan nama bidang untuk setiap file dan menautkan ke referensi yang menjelaskannya. Agents yang dikirimkan dalam plugin menghormati subset dari bidang subagent.

Troubleshoot konfigurasi

Jika pengaturan, hook, atau file tidak berlaku, lihat Debug konfigurasi Anda untuk perintah inspeksi dan tabel pencarian berdasarkan gejala.

Data aplikasi

Selain konfigurasi yang Anda buat, ~/.claude menyimpan data yang Claude Code tulis selama sesi. File-file ini adalah plaintext. Apa pun yang melewati alat ditulis ke transkrip di disk: konten file, output perintah, teks yang ditempel.

Dibersihkan secara otomatis

Claude Code menghapus file di jalur di bawah ini setelah mereka lebih tua dari cleanupPeriodDays, selama dapat dengan aman menentukan periode retensi. Default adalah 30 hari dan minimum adalah 1; mengatur 0 gagal dengan kesalahan validasi. Cutoff usia yang sama berlaku untuk penghapusan otomatis worktrees yatim piatu. File sesi di sessions/, memori otomatis, dan transkrip Claude Desktop dan Cowork masing-masing mengikuti aturan retensi mereka sendiri:
  • sessions/: menyimpan satu file kecil per sesi yang berjalan, digunakan untuk mendeteksi sesi bersamaan dan crash. Ini bukan bagian dari sweep berbasis usia: Claude Code menghapus setiap file saat sesinya keluar dan menghapus sisa crash saat peluncuran berikutnya.
  • Memori otomatis: sweep tidak menghapus file memori di direktori memori otomatis proyek, projects/<project>/memory/. Claude Code menghapus direktori itu hanya jika telah kosong selama seluruh periode retensi. Sebelum v2.1.228, sweep memperlakukan folder di dalam direktori memori sebagai data sesi dan dapat menghapus file lama di bawahnya.
  • Transkrip Claude Desktop dan Cowork: Claude Code menyimpan transkrip sesi yang Anda mulai atau lanjutkan terakhir di Claude Desktop atau Cowork pada usia apa pun. Untuk memberikan transkrip ini batas usia, atur desktopSessionCleanupPeriodDays. Saat pengaturan terkelola menetapkan cleanupPeriodDays, Claude Code menghapus transkrip ini setelah periode itu sebagai gantinya. Memerlukan Claude Code v2.1.248 atau lebih baru; versi sebelumnya menghapusnya setelah cleanupPeriodDays.
Claude Code melewati sweep berbasis usia dalam kasus-kasus ini:
  • Mode bare: saat Anda menjalankan claude -p dengan --bare, Claude Code tidak menjalankan sweep dalam sesi itu.
  • Sweep dijeda: jika Claude Code tidak dapat dengan aman menentukan periode retensi, itu menjeda sweep pembersihan retensi; acara retention_sweep mencantumkan setiap konfigurasi yang menjeda itu. Saat penyebabnya adalah file pengaturan yang tidak dapat dibaca atau diuraikan, atau kesalahan pengaturan dengan cleanupPeriodDays atau desktopSessionCleanupPeriodDays yang secara eksplisit ditetapkan, Claude Code juga menampilkan peringatan di /status sampai Anda memperbaiki kesalahan pengaturan. Saat pengaturan terkelola menyediakan cleanupPeriodDays, Claude Code menjalankan sweep pada nilai terkelola dalam kedua kasus.

Direktori scratchpad sesi

Scratchpad adalah direktori per-sesi yang Claude Code berikan kepada Claude untuk file sementara: hasil antara, skrip pembantu, dan draft yang tidak termasuk dalam proyek Anda. Saat Claude mengatakan itu menyimpan sesuatu “ke scratchpad”, file ada di sana. Claude menggunakannya alih-alih /tmp, dan dapat membuat, mengedit, dan membaca file di dalamnya tanpa prompt izin. Scratchpad berada di bawah direktori temp Claude Code daripada ~/.claude. Temukan jalur sesi saat ini untuk platform Anda:
  • macOS: /private/tmp/claude-<uid>/<project>/<session-id>/scratchpad/
  • Linux: /tmp/claude-<uid>/<project>/<session-id>/scratchpad/, atau bentuk yang sama di bawah $TMPDIR saat sistem Anda menetapkan satu
  • Windows: %TEMP%\claude\<project>\<session-id>\scratchpad\
<project> adalah jalur direktori kerja Anda dengan setiap karakter selain huruf dan angka diganti dengan -, seperti -Users-you-my-project. Jika Anda menetapkan CLAUDE_CODE_TMPDIR, pohon bergerak di bawah direktori itu sebagai gantinya. Hooks menerima jalur sesi saat ini sebagai scratchpad_dir. File scratchpad bertahan selama transkrip sesi: sweep retensi menghapus direktori saat menghapus transkrip, dan claude project purge tidak menyentuh direktori temp. Karena direktori berada di bawah lokasi temp sistem, sistem operasi Anda juga dapat menghapusnya, seperti saat restart. Untuk menyimpan sesuatu yang Claude tulis di sana, minta Claude untuk memindahkannya ke proyek Anda. Sesi memiliki scratchpad hanya saat semua ini berlaku:
  • Anda masuk dengan akun claude.ai daripada kunci API
  • Sesi menggunakan API Anthropic, bukan Amazon Bedrock, Agent Platform Google Cloud, atau Microsoft Foundry
  • enableArtifact tidak diatur ke false

Disimpan sampai Anda menghapusnya

Sweep pembersihan retensi tidak menghapus jalur di bawah ini. Claude Code menyimpannya sampai Anda menghapusnya, terlepas dari dua cache yang dihapusnya saat Anda keluar. File lain muncul tergantung pada fitur mana yang Anda gunakan. Cache dan file kunci aman untuk dihapus. Simpan file status ini:

Penyimpanan plaintext

Transkrip dan riwayat tidak dienkripsi saat istirahat. Izin file OS adalah satu-satunya perlindungan. Jika alat membaca file .env atau perintah mencetak kredensial, nilai itu ditulis ke projects/<project>/<session>.jsonl. Untuk mengurangi paparan:
  • Turunkan cleanupPeriodDays untuk mempersingkat berapa lama Claude Code menyimpan transkrip
  • Atur desktopSessionCleanupPeriodDays untuk memberikan transkrip Claude Desktop dan Cowork batas usia juga
  • Atur variabel lingkungan CLAUDE_CODE_SKIP_PROMPT_HISTORY untuk melewati penulisan transkrip dan riwayat prompt dalam mode apa pun. Dalam mode non-interaktif, Anda dapat sebagai gantinya meneruskan --no-session-persistence bersama -p, atau atur persistSession: false dalam Agent SDK TypeScript; SDK Python tidak memiliki opsi setara.
  • Gunakan aturan izin untuk menolak pembacaan file kredensial

Hapus data lokal

Jalankan claude project purge untuk menghapus status yang Claude Code simpan untuk satu proyek. Ini menghapus:
  • Transkrip dan memori otomatis di bawah projects/
  • Entri tasks/, debug/, dan file-history/ per-sesi
  • Baris prompt yang cocok di history.jsonl
  • Entri proyek di ~/.claude.json
Gambar yang Anda tempel atau lampirkan dalam sesi proyek dan scratchpad setiap sesi disimpan di bawah direktori temp Claude Code daripada ~/.claude, jadi purge tidak menghapusnya. Sweep retensi masih menghapus gambar setelah mereka lebih tua dari cleanupPeriodDays; scratchpad sesi yang dimurnikan tetap ada sampai Anda menghapusnya atau sistem operasi Anda menghapus direktori temp. Perintah mencetak rencana penghapusan lengkap dan meminta konfirmasi sebelum menghapus apa pun. Contoh di bawah menggunakan ~/work/my-repo sebagai placeholder. Gantilah dengan jalur ke proyek Anda. Jika tidak ada status yang cocok dengan jalur, perintah mencetak kesalahan dan keluar dengan status 1. Pratinjau rencana tanpa menghapus apa pun:
Rencana mencantumkan setiap item yang cocok dan alasan dimasukkannya:
Hapus dengan satu prompt konfirmasi:
Perintah mencetak rencana yang sama, kemudian menanyakan Delete 3 item(s) for /home/user/work/my-repo? This cannot be undone. [y/N] dan menghapus hanya jika Anda menjawab y. Abaikan jalur untuk memilih proyek dari daftar interaktif. Lewati prompt konfirmasi untuk digunakan dalam skrip:
Teruskan --all alih-alih jalur untuk membersihkan status untuk setiap proyek sekaligus, yang menghapus history.jsonl sepenuhnya daripada memfilternya. Teruskan -i untuk melangkah melalui rencana penghapusan satu item pada satu waktu. Perintah membiarkan shell-snapshots/ dan backups/ sendirian karena tidak termasuk dalam cakupan proyek, dan memperingatkan tentang mereka dalam output rencana. Anda juga dapat menghapus salah satu jalur data aplikasi di atas dengan tangan, terlepas dari file status untuk disimpan. Sesi baru tidak terpengaruh. Tabel di bawah menunjukkan apa yang Anda hilangkan untuk sesi masa lalu. Jangan hapus ~/.claude.json, ~/.claude/settings.json, atau ~/.claude/plugins/: file-file itu menyimpan auth, preferensi, dan plugin terinstal Anda.