Jelajahi direktori .claude

Tempat Claude Code membaca CLAUDE.md, settings.json, hooks, skills, commands, subagents, workflows, rules, dan auto memory. Jelajahi direktori .claude di proyek Anda dan ~/.claude di direktori home Anda.

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 agent coding lainnya, Claude Code dapat membacanya sebagai pengganti 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.

[!NOTE]

Beberapa hal dapat mengganti apa yang Anda masukkan dalam file ini:

• Pengaturan terkelola yang diterapkan oleh organisasi Anda diutamakan daripada setiap file pengaturan dan nilai --settings, dengan pengecualian di bawah Prioritas pengaturan
• Bendera CLI seperti --permission-mode atau --settings mengganti settings.json untuk sesi itu
• Beberapa variabel lingkungan memiliki prioritas di atas pengaturan yang setara, tetapi ini bervariasi: periksa referensi variabel lingkungan untuk masing-masing

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.

• 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 salah satu kasus berikut:

  • Pengaturan terkelola menetapkan cleanupPeriodDays
  • Konfigurasi HIPAA berlaku untuk sesi Anda

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.

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

• .credentials.json: kredensial login Anda
• agent-memory/: memori subagent
• jobs/ dan daemon/: status sesi latar belakang

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:

claude purge ~/work/my-repo --dry-run

Rencana mencantumkan setiap item yang cocok dan alasan dimasukkannya:

Purge plan for /home/user/work/my-repo:

  dir:    /home/user/.claude/projects/-home-user-work-my-repo
           project transcripts (.jsonl) and memory/
  config: projects["/home/user/work/my-repo"]
           project entry in ~/.claude.json (trust, history, MCP servers)
  filter: /home/user/.claude/history.jsonl
           12 prompt(s) typed in this project

shell-snapshots/ are not project-scoped and will not be touched
backups/ may still contain this project entry in old .claude.json snapshots (/home/user/.claude/backups); at most 5 are kept and they rotate out automatically
Dry run: 3 item(s) would be deleted.

Hapus dengan satu prompt konfirmasi:

claude purge ~/work/my-repo

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:

claude purge ~/work/my-repo --yes

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.

Sumber daya terkait

• Kelola memory Claude: tulis dan atur CLAUDE.md, rules, dan auto memory
• Konfigurasi settings: atur izin, hooks, variabel lingkungan, dan default model
• Buat skills: bangun prompt dan workflow yang dapat digunakan kembali
• Konfigurasi subagents: tentukan agen khusus dengan konteks mereka sendiri