Halaman ini mencakup masalah kinerja, stabilitas, dan pencarian setelah Claude Code berjalan. Untuk masalah lainnya, mulai dengan halaman yang sesuai dengan tempat Anda terjebak: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.
| Gejala | Buka |
|---|---|
command not found, instalasi gagal, masalah PATH, EACCES, kesalahan TLS | Troubleshoot installation and login |
Loop login, kesalahan OAuth, 403 Forbidden, “organization disabled”, kredensial Bedrock/Vertex/Foundry | Troubleshoot installation and login |
| Pengaturan tidak diterapkan, hooks tidak berfungsi, server MCP tidak dimuat | Debug your configuration |
API Error: 5xx, 529 Overloaded, 429, kesalahan validasi permintaan | Error reference |
model not found atau you may not have access to it | Error reference |
| Ekstensi VS Code tidak terhubung atau tidak mendeteksi Claude | VS Code integration |
| Plugin JetBrains atau IDE tidak terdeteksi | JetBrains integration |
| CPU atau memori tinggi, respons lambat, hang, pencarian tidak menemukan file | Performance and stability di bawah |
/doctor di dalam Claude Code untuk pemeriksaan otomatis instalasi, pengaturan, server MCP, dan penggunaan konteks Anda. Jika claude tidak akan memulai sama sekali, jalankan claude doctor dari shell Anda sebagai gantinya.
Performance and stability
Bagian-bagian ini mencakup masalah yang terkait dengan penggunaan sumber daya, responsivitas, dan perilaku pencarian.High CPU or memory usage
Claude Code dirancang untuk bekerja dengan sebagian besar lingkungan pengembangan, tetapi dapat mengonsumsi sumber daya signifikan saat memproses codebase besar. Jika Anda mengalami masalah kinerja:- Gunakan
/compactsecara teratur untuk mengurangi ukuran konteks - Tutup dan mulai ulang Claude Code di antara tugas-tugas besar
- Pertimbangkan menambahkan direktori build besar ke file
.gitignoreAnda
/heapdump untuk menulis snapshot heap JavaScript dan rincian memori ke ~/Desktop. Di Linux tanpa folder Desktop, file ditulis ke direktori home Anda.
Rincian menunjukkan resident set size, JS heap, array buffers, dan memori native yang tidak terhitung, yang membantu mengidentifikasi apakah pertumbuhan ada di objek JavaScript atau di kode native. Untuk memeriksa retainers, buka file .heapsnapshot di Chrome DevTools di bawah Memory → Load. Lampirkan kedua file saat melaporkan masalah memori di GitHub.
Auto-compaction stops with a thrashing error
Jika Anda melihatAutocompact is thrashing: the context refilled to the limit..., automatic compaction berhasil tetapi file atau output alat segera mengisi ulang jendela konteks beberapa kali berturut-turut. Claude Code berhenti mencoba ulang untuk menghindari pemborosan panggilan API pada loop yang tidak membuat kemajuan.
Untuk pulih:
- Minta Claude membaca file yang terlalu besar dalam potongan yang lebih kecil, seperti rentang baris tertentu atau fungsi, alih-alih seluruh file
- Jalankan
/compactdengan fokus yang menjatuhkan output besar, misalnya/compact keep only the plan and the diff - Pindahkan pekerjaan file besar ke subagent sehingga berjalan di jendela konteks terpisah
- Jalankan
/clearjika percakapan sebelumnya tidak lagi diperlukan
Command hangs or freezes
Jika Claude Code tampak tidak responsif:- Tekan Ctrl+C untuk mencoba membatalkan operasi saat ini
- Jika tidak responsif, Anda mungkin perlu menutup terminal dan memulai ulang
claude --resume di direktori yang sama untuk melanjutkan sesi.
Search and discovery issues
Jika Search tool,@file mentions, custom agents, atau custom skills tidak menemukan file, binary ripgrep bundel mungkin tidak berjalan di sistem Anda. Instal paket ripgrep platform Anda dan beri tahu Claude Code untuk menggunakannya sebagai gantinya:
- macOS
- Ubuntu/Debian
- Alpine
- Arch
- Windows
USE_BUILTIN_RIPGREP=0 di environment Anda.
Slow or incomplete search results on WSL
Penalti kinerja pembacaan disk saat bekerja lintas filesystem di WSL dapat menghasilkan kecocokan yang lebih sedikit dari yang diharapkan saat menggunakan Claude Code di WSL. Pencarian masih berfungsi, tetapi mengembalikan hasil lebih sedikit daripada di filesystem native./doctor akan menunjukkan Search sebagai OK dalam kasus ini.- Kirimkan pencarian yang lebih spesifik: kurangi jumlah file yang dicari dengan menentukan direktori atau jenis file: “Search for JWT validation logic in the auth-service package” atau “Find use of md5 hash in JS files”.
-
Pindahkan proyek ke filesystem Linux: jika memungkinkan, pastikan proyek Anda berada di filesystem Linux (
/home/) daripada filesystem Windows (/mnt/c/). - Gunakan Windows native sebagai gantinya: pertimbangkan menjalankan Claude Code secara native di Windows alih-alih melalui WSL, untuk kinerja filesystem yang lebih baik.
Get more help
Jika Anda mengalami masalah yang tidak tercakup di sini:- Jalankan
/doctoruntuk memeriksa kesehatan instalasi, validitas pengaturan, konfigurasi MCP, dan penggunaan konteks dalam satu kali jalan - Gunakan perintah
/feedbackdalam Claude Code untuk melaporkan masalah langsung ke Anthropic - Periksa GitHub repository untuk masalah yang diketahui
- Tanyakan Claude secara langsung tentang kemampuan dan fiturnya. Claude memiliki akses bawaan ke dokumentasinya.