~/.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:
- Pengaturan yang dikelola yang digunakan oleh organisasi Anda memiliki prioritas di atas segalanya, terlepas dari 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.
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.- 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 menetapkancleanupPeriodDays, Claude Code menghapus transkrip ini setelah periode itu sebagai gantinya. Memerlukan Claude Code v2.1.248 atau lebih baru; versi sebelumnya menghapusnya setelahcleanupPeriodDays.
- 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, itu menjeda sweep pembersihan retensi; acara
retention_sweepmencantumkan setiap konfigurasi yang menjeda itu. Saat penyebabnya adalah file pengaturan yang tidak dapat dibaca atau diuraikan, atau kesalahan pengaturan dengancleanupPeriodDaysataudesktopSessionCleanupPeriodDaysyang secara eksplisit ditetapkan, Claude Code juga menampilkan peringatan di/statussampai Anda memperbaiki kesalahan pengaturan. Saat pengaturan terkelola menyediakancleanupPeriodDays, 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$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. 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
enableArtifacttidak diatur kefalse
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:
.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 project 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.
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:
--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.
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