~/.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:
- 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-modeatau--settingsmenggantisettings.jsonuntuk sesi itu - Beberapa variabel lingkungan memiliki prioritas di atas pengaturan yang setara, tetapi ini bervariasi: periksa referensi variabel lingkungan untuk masing-masing
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 daricleanupPeriodDays, 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 membiarkanseed-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 setelahcleanupPeriodDays. Claude Code menghapus transkrip ini setelahcleanupPeriodDayssebagai gantinya dalam kasus-kasus seperti berikut:- Pengaturan terkelola menetapkan
cleanupPeriodDays - Konfigurasi HIPAA berlaku untuk sesi Anda
- Pengaturan terkelola menetapkan
- Mode bare: saat Anda menjalankan
claude -pdengan--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_sweepmencantumkan setiap konfigurasi yang menjedanya. Saat penyebabnya adalah file pengaturan yang tidak dapat dibaca atau diuraikan, atau kesalahan pengaturan dengancleanupPeriodDaysataudesktopSessionCleanupPeriodDaysditetapkan,/statusmenampilkan peringatan sampai Anda memperbaiki penyebabnya.
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$TMPDIRsaat 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
enableArtifacttidak diatur kefalse
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 Andaagent-memory/: memori subagentjobs/dandaemon/: 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
cleanupPeriodDaysuntuk mempersingkat berapa lama Claude Code menyimpan transkrip - Atur
desktopSessionCleanupPeriodDaysuntuk memberikan transkrip Claude Desktop dan Cowork batas usia juga - Atur variabel lingkungan
CLAUDE_CODE_SKIP_PROMPT_HISTORYuntuk melewati penulisan transkrip dan riwayat prompt dalam mode apa pun. Dalam mode non-interaktif, Anda dapat sebagai gantinya meneruskan--no-session-persistencebersama-p, atau aturpersistSession: falsedalam Agent SDK TypeScript; SDK Python tidak memiliki opsi setara. - Gunakan aturan izin untuk menolak pembacaan file kredensial
Hapus data lokal
Jalankanclaude purge untuk menghapus status yang Claude Code simpan untuk satu proyek. Ini menghapus:
- Transkrip dan memori otomatis di bawah
projects/ - Entri
tasks/,debug/, danfile-history/per-sesi - Baris prompt yang cocok di
history.jsonl - Entri proyek di
~/.claude.json
~/.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:
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
--allalih-alih jalur untuk membersihkan status untuk setiap proyek sekaligus, yang menghapushistory.jsonlsepenuhnya daripada memfilternya. - Teruskan
-iuntuk melangkah melalui rencana penghapusan satu item pada satu waktu.
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