Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
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. 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.
Apa yang tidak ditampilkan
Penjelajah mencakup file yang Anda buat dan edit. Beberapa file terkait berada di tempat lain:
| File | Lokasi | Tujuan |
|---|
managed-settings.json | Tingkat sistem, bervariasi menurut OS | Pengaturan yang diberlakukan perusahaan yang tidak dapat Anda ganti. Lihat pengaturan yang dikelola server. |
CLAUDE.local.md | Akar proyek | Preferensi pribadi Anda untuk proyek ini, dimuat bersama CLAUDE.md. Buat secara manual dan tambahkan ke .gitignore. |
| Plugin yang diinstal | ~/.claude/plugins | Marketplace yang dikloning, versi plugin yang diinstal, dan data per-plugin, dikelola oleh perintah claude plugin. Versi yatim piatu dihapus 7 hari setelah pembaruan atau penghapusan plugin. Lihat plugin caching. |
~/.claude juga menyimpan data yang ditulis Claude Code saat Anda bekerja: transkrip, riwayat prompt, snapshot file, cache, dan log. Lihat data aplikasi di bawah.
Pilih file yang tepat
Berbagai jenis kustomisasi berada di file yang berbeda. Gunakan tabel ini untuk menemukan di mana perubahan harus dilakukan.
| Anda ingin | Edit | Cakupan | Referensi |
|---|
| Berikan Claude konteks proyek dan konvensi | CLAUDE.md | proyek atau global | Memory |
| Izinkan atau blokir tool call tertentu | settings.json permissions atau hooks | proyek atau global | Permissions, Hooks |
| Jalankan skrip sebelum atau sesudah tool call | settings.json hooks | proyek atau global | Hooks |
| Atur variabel lingkungan untuk sesi | settings.json env | proyek atau global | Settings |
| Simpan penggantian pribadi di luar git | settings.local.json | proyek saja | Settings scopes |
Tambahkan prompt atau kemampuan yang Anda panggil dengan /name | skills/<name>/SKILL.md | proyek atau global | Skills |
| Tentukan subagent khusus dengan tools-nya sendiri | agents/*.md | proyek atau global | Subagents |
| Hubungkan tools eksternal melalui MCP | .mcp.json | proyek saja | MCP |
| Ubah cara Claude memformat respons | output-styles/*.md | proyek atau global | Output styles |
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
- 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. | File | Cakupan | Commit | Apa yang dilakukan | Referensi |
|---|
CLAUDE.md | Proyek dan global | ✓ | Instruksi dimuat setiap sesi | Memory |
rules/*.md | Proyek dan global | ✓ | Instruksi dengan cakupan topik, opsional gated path | Rules |
settings.json | Proyek dan global | ✓ | Izin, hooks, variabel env, default model | Settings |
settings.local.json | Proyek saja | | Penggantian pribadi Anda, auto-gitignored | Settings scopes |
.mcp.json | Proyek saja | ✓ | Server MCP yang dibagikan tim | MCP scopes |
.worktreeinclude | Proyek saja | ✓ | File yang diabaikan untuk disalin ke worktrees baru | Worktrees |
skills/<name>/SKILL.md | Proyek dan global | ✓ | Prompt yang dapat digunakan kembali dipanggil dengan /name atau auto-invoked | Skills |
commands/*.md | Proyek dan global | ✓ | Prompt file tunggal; mekanisme yang sama dengan skills | Skills |
output-styles/*.md | Proyek dan global | ✓ | Bagian prompt sistem khusus | Output styles |
agents/*.md | Proyek dan global | ✓ | Definisi subagent dengan prompt dan tools mereka sendiri | Subagents |
agent-memory/<name>/ | Proyek dan global | ✓ | Memory persisten untuk subagents | Persistent memory |
~/.claude.json | Global saja | | Status aplikasi, OAuth, toggle UI, server MCP pribadi | Global config |
projects/<project>/memory/ | Global saja | | Auto memory: catatan Claude untuk dirinya sendiri di seluruh sesi | Auto memory |
keybindings.json | Global saja | | Pintasan keyboard khusus | Keybindings |
themes/*.json | Global saja | | Tema warna khusus | Custom themes |
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 ditulis Claude Code selama sesi. File-file ini adalah plaintext. Apa pun yang melewati tool mendarat di transkrip di disk: konten file, output perintah, teks yang ditempel.
Dibersihkan secara otomatis
File di jalur di bawah dihapus saat startup setelah berusia lebih dari cleanupPeriodDays. Default adalah 30 hari.
Jalur di bawah ~/.claude/ | Konten |
|---|
projects/<project>/<session>.jsonl | Transkrip percakapan lengkap: setiap pesan, tool call, dan tool result |
projects/<project>/<session>/subagents/ | Transkrip percakapan Subagent, dihapus bersama transkrip sesi induk saat berusia |
projects/<project>/<session>/tool-results/ | Output tool besar yang tumpah ke file terpisah |
file-history/<session>/ | Snapshot pra-edit file yang diubah Claude, digunakan untuk checkpoint restore |
plans/ | File rencana yang ditulis selama plan mode |
debug/ | Log debug per-sesi, ditulis hanya saat Anda memulai dengan --debug atau menjalankan /debug |
paste-cache/, image-cache/ | Konten paste besar dan gambar yang dilampirkan |
session-env/ | Metadata lingkungan per-sesi |
tasks/ | Daftar tugas per-sesi yang ditulis oleh task tools |
shell-snapshots/ | Lingkungan shell yang ditangkap digunakan oleh Bash tool. Dihapus saat keluar dengan bersih. Sweep membersihkan yang tertinggal setelah crash. |
backups/ | Salinan ~/.claude.json dengan stempel waktu yang diambil sebelum migrasi konfigurasi |
feedback-bundles/ | Arsip transkrip yang disunting ditulis oleh /feedback pada penyedia pihak ketiga, untuk dikirim ke tim akun Anthropic Anda |
Disimpan sampai Anda menghapusnya
Jalur berikut tidak tercakup oleh pembersihan otomatis dan bertahan selamanya.
Jalur di bawah ~/.claude/ | Konten |
|---|
history.jsonl | Setiap prompt yang Anda ketik, dengan timestamp dan jalur proyek. Digunakan untuk recall panah atas. |
stats-cache.json | Hitungan token dan biaya agregat yang ditampilkan oleh /usage |
remote-settings.json | Salinan cache dari pengaturan yang dikelola server untuk organisasi Anda. Hanya ada saat organisasi Anda telah mengonfigurasinya. Disegarkan pada setiap peluncuran. |
todos/ | Daftar tugas per-sesi warisan. Tidak lagi ditulis oleh versi saat ini; aman untuk dihapus. |
Penyimpanan plaintext
Transkrip dan riwayat tidak dienkripsi saat istirahat. Izin file OS adalah satu-satunya perlindungan. Jika tool membaca file .env atau perintah mencetak kredensial, nilai itu ditulis ke projects/<project>/<session>.jsonl. Untuk mengurangi paparan:
- Turunkan
cleanupPeriodDays untuk mempersingkat berapa lama transkrip disimpan
- 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 meneruskan --no-session-persistence bersama -p, atau atur persistSession: false di Agent SDK.
- 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:
- 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
Perintah mencetak rencana penghapusan lengkap dan meminta konfirmasi sebelum menghapus apa pun.
Pratinjau rencana tanpa menghapus apa pun:
claude project purge ~/work/my-repo --dry-run
claude project purge ~/work/my-repo
claude project purge ~/work/my-repo --yes
--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. Keluar dengan status 1 jika tidak ada status yang cocok dengan jalur yang diberikan.
Anda juga dapat menghapus salah satu jalur data aplikasi di atas dengan tangan. Sesi baru tidak terpengaruh. Tabel di bawah menunjukkan apa yang Anda hilangkan untuk sesi masa lalu.
| Hapus | Anda kehilangan |
|---|
~/.claude/projects/ | Resume, continue, dan rewind untuk sesi masa lalu |
~/.claude/history.jsonl | Recall prompt panah atas |
~/.claude/file-history/ | Checkpoint restore untuk sesi masa lalu |
~/.claude/stats-cache.json | Total historis yang ditampilkan oleh /usage |
~/.claude/remote-settings.json | Tidak ada. Diambil kembali pada peluncuran berikutnya. |
~/.claude/debug/, ~/.claude/plans/, ~/.claude/paste-cache/, ~/.claude/image-cache/, ~/.claude/session-env/, ~/.claude/tasks/, ~/.claude/shell-snapshots/, ~/.claude/backups/ | Tidak ada yang menghadap pengguna |
~/.claude/todos/ | Tidak ada. Direktori warisan tidak ditulis oleh versi saat ini. |
~/.claude.json, ~/.claude/settings.json, atau ~/.claude/plugins/: file-file itu menyimpan auth, preferensi, dan plugin yang diinstal Anda.
Sumber daya terkait
