Langsung ke konten utama
Claude Code membaca instruksi, pengaturan, skills, subagent, dan memori dari direktori proyek Anda dan dari ~/.claude di direktori home Anda. Lakukan commit file proyek ke git untuk membagikannya kepada tim Anda; file di ~/.claude adalah konfigurasi pribadi yang berlaku di semua proyek Anda. Di Windows, ~/.claude di-resolve ke %USERPROFILE%\.claude. Jika Anda menetapkan CLAUDE_CONFIG_DIR, setiap path ~/.claude di halaman ini berada di bawah direktori tersebut. Hal yang sama berlaku untuk .claude.json, yang jika tidak demikian berada di ~/.claude.json. Sebagian besar pengguna hanya mengedit CLAUDE.md dan settings.json. Jika repositori Anda sudah memiliki AGENTS.md untuk coding agent lain, Claude Code dapat membacanya sebagai pengganti CLAUDE.md. Bagian lain dari direktori ini bersifat opsional: tambahkan skill, aturan, atau subagent 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. Transkrip juga dapat menyimpan apa yang Claude Code kirimkan ke model bersama pesan Anda:
  • System prompt
  • Definisi tool
  • Parameter permintaan
  • File instruksi yang dimuatnya, seperti CLAUDE.md

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.
  • seed-admin/: direktori git sementara yang Claude Code buat saat mengemas repositori Anda untuk ultrareview atau unggahan sesi cloud. Saat unggahan berakhir, atau di sesi berikutnya jika unggahan terputus, Claude Code menghapus direktori unggahan tersebut dan membiarkan seed-admin/ tetap ada.
  • 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. Memerlukan Claude Code v2.1.248 atau lebih baru; versi sebelumnya menghapusnya setelah cleanupPeriodDays. Claude Code menghapus transkrip ini setelah cleanupPeriodDays sebagai gantinya dalam kasus-kasus seperti berikut:
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, Claude Code menjeda sweep; event retention_sweep mencantumkan setiap konfigurasi yang menjedanya. Saat penyebabnya adalah file pengaturan yang tidak dapat dibaca atau diuraikan, atau kesalahan pengaturan dengan cleanupPeriodDays atau desktopSessionCleanupPeriodDays ditetapkan, /status menampilkan peringatan sampai Anda memperbaiki penyebabnya.
Saat pengaturan terkelola menyediakan cleanupPeriodDays, Claude Code menjalankan sweep pada nilai terkelola bahkan saat file pengaturan berprioritas lebih rendah memiliki kesalahan. Untuk memeriksa bahwa mesin di organisasi Anda menjalankan sweep dengan periode retensi yang Anda tetapkan, lihat Periksa sweep retensi.

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. Di Windows, <project> adalah hash 16 karakter dari string tersebut, seperti 73295dabccd14c56. Dalam sesi aplikasi Desktop, nilainya bisa berupa string itu sendiri. Untuk mendapatkan jalur yang tepat, tanyakan kepada Claude. Jika Anda menetapkan CLAUDE_CODE_TMPDIR, pohon bergerak di bawah direktori itu sebagai gantinya. Hook menerima jalur sesi saat ini sebagai scratchpad_dir. File scratchpad bertahan selama transkrip sesi: sweep retensi menghapus direktori saat menghapus transkrip, dan claude 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

Kecuali untuk baris yang menyatakan sebaliknya, sweep pembersihan retensi tidak menghapus jalur di bawah ini, dan Claude Code menyimpannya sampai Anda menghapusnya.

File status untuk disimpan

Tergantung pada fitur mana yang Anda gunakan, ~/.claude/ juga menyimpan file yang tidak dicantumkan oleh tabel di bawah Data aplikasi. Dari file-file tersebut, 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 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. Sebelum v2.1.288, perintahnya adalah claude project purge. 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:
Opsi lainnya:
  • 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. Jika ada yang pernah menjalankan /heapdump di mesin tersebut, hapus juga file .heapsnapshot yang ditulisnya. Heap snapshot berisi percakapan lengkap dan kredensial apa pun yang dipegang proses, dan baik sweep retensi maupun purge tidak menyentuhnya. Anda juga dapat menghapus sendiri salah satu jalur data aplikasi di atas, kecuali file status untuk disimpan. Jangan hapus ~/.claude.json, ~/.claude/settings.json, atau ~/.claude/plugins/: file-file itu menyimpan detail akun, preferensi, dan plugin terinstal Anda.