Skip to main content
Ketika Claude mengabaikan instruksi atau fitur yang Anda konfigurasi tidak muncul, penyebabnya biasanya adalah file tidak dimuat, dimuat dari lokasi berbeda dari yang Anda harapkan, atau file lain menggantinya. Panduan ini menunjukkan cara memeriksa apa yang benar-benar dimuat oleh Claude Code sehingga Anda dapat mempersempit mana yang berlaku. Untuk masalah instalasi, autentikasi, dan konektivitas, lihat Troubleshoot installation and login sebagai gantinya.

​
Lihat apa yang dimuat ke dalam context

Perintah /context menampilkan semua yang menempati jendela context untuk sesi saat ini, dipecah berdasarkan kategori: system prompt, system tools, MCP tools, custom subagents dengan sumber masing-masing dimuat dari, file memory, skills, dan pesan percakapan. Jalankan terlebih dahulu untuk mengonfirmasi apakah CLAUDE.md, rules, atau deskripsi skill Anda ada sama sekali. Bagian skills dalam /context juga mencakup bundled skills, yang tidak dicantumkan oleh /skills. Untuk detail tentang kategori tertentu, lanjutkan dengan perintah khusus: Jika file memori hilang dari rincian /context, periksa lokasinya terhadap bagaimana file CLAUDE.md dimuat. File CLAUDE.md subdirektori dimuat sesuai permintaan, bukan pada awal sesi, sehingga tidak muncul dalam rincian tersebut. Jika /context mengonfirmasi file dimuat tetapi Claude masih tidak mengikuti instruksi tertentu, masalahnya kemungkinan adalah cara instruksi ditulis daripada apakah itu dimuat. CLAUDE.md bekerja dengan baik untuk jenis panduan yang akan Anda berikan kepada rekan kerja baru, seperti konvensi proyek, perintah build, dan di mana file berada. Kepatuhan menurun ketika instruksi cukup samar untuk diinterpretasikan dengan berbagai cara, ketika dua file memberikan arahan yang bertentangan, atau ketika file telah tumbuh cukup panjang sehingga aturan individual mendapat perhatian lebih sedikit. Tulis instruksi yang efektif mencakup pola spesifisitas, ukuran, dan struktur yang menjaga kepatuhan tetap tinggi.
CLAUDE.md dan permissions menyelesaikan masalah yang berbeda. CLAUDE.md memberi tahu Claude bagaimana proyek Anda bekerja sehingga membuat keputusan yang baik. Permissions dan hooks memberlakukan batas terlepas dari apa yang Claude putuskan. Gunakan CLAUDE.md untuk “kami melakukannya dengan cara ini di sini.” Gunakan permissions atau hooks untuk batas keamanan dan apa pun yang tidak boleh terjadi, di mana Anda membutuhkan jaminan daripada panduan.

​
Periksa pengaturan yang diselesaikan

Pengaturan menggabungkan di seluruh cakupan terkelola, pengguna, proyek, dan lokal. Pengaturan terkelola berlaku terlebih dahulu ketika ada. Di antara sisanya, cakupan yang lebih dekat menggantikan yang lebih luas dalam urutan lokal, kemudian proyek, kemudian pengguna. Beberapa pengaturan juga dapat diatur oleh flag baris perintah atau variabel lingkungan, yang bertindak sebagai lapisan penggantian lain. Ketika pengaturan tidak tampak berlaku, nilai yang Anda atur biasanya ditimpa oleh cakupan lain atau variabel lingkungan. Untuk menemukan file pengaturan yang tidak valid, jalankan claude doctor dari terminal Anda. Ini mencetak diagnostik instalasi dan pengaturan baca-saja tanpa memulai sesi. Untuk pemeriksaan lengkap yang juga mengusulkan perbaikan dan meminta persetujuan sebelum menerapkannya, jalankan /doctor di dalam sesi. Jalankan /status untuk melihat sumber pengaturan mana yang aktif, termasuk apakah pengaturan terkelola berlaku. Untuk memahami cakupan mana yang digunakan Claude Code untuk kunci tertentu, lihat Prioritas pengaturan.

​
Periksa server MCP

Jalankan /mcp untuk melihat setiap server yang dikonfigurasi, status koneksinya, dan apakah Anda telah menyetujuinya untuk proyek saat ini. Server dapat didefinisikan dengan benar tetapi masih tidak menyediakan alat untuk beberapa alasan umum:
  • Server berscopeproyek di .mcp.json memerlukan persetujuan satu kali. Jika prompt ditutup, server tetap dinonaktifkan sampai Anda menyetujuinya dari /mcp.
  • Server yang gagal dimulai ditampilkan sebagai gagal di /mcp. Jalur file relatif di command atau args adalah penyebab yang sering, karena mereka diselesaikan terhadap direktori tempat Anda meluncurkan Claude Code daripada lokasi .mcp.json.
  • Server yang menampilkan sebagai terhubung tetapi mencantumkan alat nol telah dimulai dengan sukses tetapi tidak mengembalikan daftar alat. Pilih Reconnect dari /mcp. Jika hitungan tetap nol, jalankan claude --debug=mcp dan baca stderr server dalam log debug di ~/.claude/debug/<session-id>.txt.
Untuk lokasi konfigurasi dan aturan cakupan, lihat MCP.

​
Periksa hooks

Jalankan /hooks untuk mencantumkan setiap hook yang terdaftar untuk sesi saat ini, dikelompokkan berdasarkan acara. Jika hook yang Anda tentukan tidak muncul, Claude Code tidak memuatnya. Periksa penyebab berikut:
  • Hook didefinisikan dalam file mandiri. Hooks berada di bawah kunci "hooks" dalam file pengaturan.
  • Nilai matcher adalah array, bukan string tunggal. Claude Code mencantumkan entri tersebut sebagai pengaturan yang tidak valid saat Anda memulai sesi interaktif dan di claude doctor. Jika array berada di bawah PreToolUse atau PermissionRequest, hook lain dari file tersebut juga tidak ada yang dimuat.
Jika hook muncul tetapi tidak aktif, matcher adalah penyebab yang biasa. Periksa matcher untuk kesalahan berikut:
  • Bidang matcher adalah string tunggal yang menggunakan | untuk mencocokkan beberapa nama alat, misalnya "Edit|Write". Pemisah , setara, jadi "Edit,Write" mencocokkan alat yang sama. Sebelum v2.1.191, koma jatuh ke evaluasi regex dan matcher tidak pernah cocok, jadi gunakan | jika Anda belum berada di v2.1.191.
  • Nama alat yang salah eja menghasilkan matcher yang tidak mencocokkan apa pun, jadi hook gagal diam-diam.
Saat Anda mengedit settings.json, perubahan berlaku dalam sesi yang berjalan setelah penundaan stabilitas file singkat, bahkan jika Anda membuat file atau folder .claude/ proyek itu sendiri setelah sesi dimulai. Anda tidak perlu memulai ulang. Sebelum v2.1.257, Claude Code tidak mendeteksi edit dalam folder .claude/ yang dibuat setelah sesi dimulai. Jika /hooks masih menampilkan definisi lama beberapa detik setelah Anda menyimpan, jalankan /hooks lagi untuk menyegarkan tampilan. Jika /hooks menampilkan hook tetapi masih tidak aktif, langkah berikutnya adalah menonton evaluasi hook secara langsung. Mulai sesi dengan claude --debug dan picu panggilan alat. Log debug mencatat setiap acara, matcher mana yang diperiksa, dan kode keluar dan output hook. Lihat Debug hooks untuk format log dan troubleshooting hooks untuk pola kegagalan umum.

​
Uji terhadap konfigurasi bersih

Mulai dengan claude --safe-mode, yang meluncurkan sesi dengan kustomisasi Anda dinonaktifkan, termasuk:
  • CLAUDE.md
  • Skills, plugin, dan hook
  • Server MCP
  • Perintah dan agent kustom
  • Gaya output kustom
  • Pintasan keyboard kustom
Autentikasi, pemilihan model, tool bawaan, dan izin berfungsi secara normal. Jika masalah hilang dalam safe mode, Anda telah mempersempit penyebabnya ke salah satu item yang Anda nonaktifkan. Untuk menemukannya, gunakan pemeriksaan untuk item tersebut, seperti Lihat apa yang dimuat ke dalam konteks, Periksa server MCP, atau Periksa hook. Safe mode masih menerapkan hook terkelola dan kebijakan pengaturan dari organisasi Anda. Plugin, skill, CLAUDE.md, dan server MCP terkelola dimatikan. Jika masalah berlanjut dalam safe mode, atau pengaturan Anda sendiri mencurigakan, mulai sesi tanpa konfigurasi Anda sendiri sama sekali dan periksa apakah masalahnya tetap muncul.
1

Buat direktori kosong dan pindah ke dalamnya

Di shell Anda, tanpa sesi Claude Code yang sedang berjalan, buat direktori tersebut dan pindah ke dalamnya:
2

Mulai Claude Code dengan direktori konfigurasi bersih

Dari shell yang sama, atur CLAUDE_CONFIG_DIR ke direktori baru sebagai pengganti ~/.claude, dan berikan --setting-sources user untuk mematikan konfigurasi proyek seperti .claude/settings.json, CLAUDE.md, dan .mcp.json:
Variabel ini berlaku untuk satu peluncuran ini saja.
Pada peluncuran pertama, Anda akan melalui layar pengaturan pertama kali lagi, yang menandakan bahwa direktori konfigurasi bersih sedang berlaku. Pengaturan terkelola masih berlaku, dan konektor masih dimuat jika Anda masuk dengan akun claude.ai.
3

Reproduksi masalahnya

Ulangi apa yang memicu masalah di sesi bersih:
  • Masalah hilang: penyebabnya ada di konfigurasi pengguna atau proyek Anda. Salin ~/.claude.json dan file-file di ~/.claude ke ~/claude-clean/config satu per satu. Jika tidak ada yang memunculkan kembali masalahnya, buka direktori proyek Anda di shell yang sama dan mulai Claude Code tanpa --setting-sources user. Di Bash atau Zsh, jalankan CLAUDE_CONFIG_DIR=~/claude-clean/config claude. Di PowerShell, variabelnya masih diatur, jadi jalankan claude.
  • Masalah berlanjut: penyebabnya ada di luar konfigurasi pengguna dan proyek Anda. Jalankan /status di sesi untuk memeriksa pengaturan terkelola, periksa shell Anda untuk environment variable, kemudian lihat Troubleshooting.

​
Periksa penyebab umum

Sebagian besar kejutan konfigurasi dapat dilacak kembali ke serangkaian kecil aturan lokasi dan sintaks. Periksa ini sebelum menganggap bug: Untuk referensi lengkap pada setiap permukaan konfigurasi, lihat halaman khusus: