Skip to main content
Halaman ini mencakup masalah kinerja, stabilitas, dan pencarian setelah Claude Code berjalan. Untuk masalah lainnya, mulai dengan halaman yang sesuai dengan tempat Anda terjebak: Jika Anda tidak yakin mana yang berlaku, jalankan /doctor di dalam Claude Code untuk pemeriksaan otomatis instalasi, pengaturan, ekstensi, dan penggunaan konteks Anda; ini mengusulkan perbaikan yang dapat diterapkan setelah Anda mengonfirmasi. Jika claude tidak akan memulai sama sekali, jalankan claude doctor dari shell Anda sebagai gantinya. Jalankan /mcp untuk memeriksa status server MCP.

​
Kinerja dan stabilitas

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:
  1. Gunakan /compact secara teratur untuk mengurangi ukuran konteks
  2. Tutup dan mulai ulang Claude Code di antara tugas-tugas besar
  3. Pertimbangkan menambahkan direktori build besar ke file .gitignore Anda
  4. Mulai ulang dengan claude --safe-mode untuk memeriksa apakah plugin, server MCP, atau hook adalah sumbernya. Ini menonaktifkan semua kustomisasi untuk sesi; jika penggunaan turun, lihat Debug your configuration untuk menemukan yang mana
Jika penggunaan memori tetap tinggi setelah langkah-langkah ini, jalankan /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 native memory 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; rinciannya adalah file yang berakhir dengan -diagnostics.json.
File .heapsnapshot berisi setiap string dalam proses. Jangan lampirkan ke masalah publik atau bagikan. Lampirkan hanya file -diagnostics.json saat melaporkan masalah memori di GitHub. File tersebut berisi statistik memori dan tidak ada konten percakapan atau kredensial.

​
Large tables are cut off in the terminal

Tabel Markdown dengan lebih dari 200 baris merender 200 baris pertamanya diikuti dengan baris … N more rows not shown. Hanya tampilan yang dibatasi: tabel lengkap tetap dalam percakapan, dan /copy menyalin setiap baris. Untuk tabel yang terlalu besar untuk dibaca di terminal, minta Claude untuk menulisnya ke file sebagai gantinya. Sebelum v2.1.208, Claude Code merender setiap baris, jadi melanjutkan sesi yang berisi tabel yang sangat besar dapat terhenti saat merender ulang.

​
Auto-compaction stops with a thrashing error

Jika Anda melihat Autocompact 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:
  1. Minta Claude membaca file yang terlalu besar dalam potongan yang lebih kecil, seperti rentang baris tertentu atau fungsi, alih-alih seluruh file
  2. Jalankan /compact dengan fokus yang menjatuhkan output besar, misalnya /compact keep only the plan and the diff
  3. Pindahkan pekerjaan file besar ke subagent sehingga berjalan di jendela konteks terpisah
  4. Jalankan /clear jika percakapan sebelumnya tidak lagi diperlukan

​
Command hangs or freezes

Jika Claude Code tampak tidak responsif:
  1. Tekan Ctrl+C untuk mencoba membatalkan operasi saat ini
  2. Jika tidak responsif, Anda mungkin perlu menutup terminal dan memulai ulang
Memulai ulang tidak kehilangan percakapan Anda. Jalankan claude --resume di direktori yang sama untuk melanjutkan sesi.

​
Garbled or corrupted text in an editor’s integrated terminal

Jika karakter ditampilkan sebagai kotak, smear, atau glyph yang salah saat menjalankan Claude Code di terminal terintegrasi VS Code, Cursor, atau Devin Desktop, GPU renderer terminal kemungkinan adalah penyebabnya. Jalankan /terminal-setup di dalam Claude Code untuk mengatur terminal.integrated.gpuAcceleration ke "off", atau atur secara manual di pengaturan editor Anda dan muat ulang jendela. Lihat Terminal configuration untuk pengaturan lain yang ditulis /terminal-setup.

​
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:
Kemudian atur 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.
claude doctor menunjukkan Search sebagai OK dalam kasus ini.
Solusi:
  1. 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”.
  2. Pindahkan proyek ke filesystem Linux: jika memungkinkan, pastikan proyek Anda berada di filesystem Linux (/home/) daripada filesystem Windows (/mnt/c/).
  3. Gunakan Windows native sebagai gantinya: pertimbangkan menjalankan Claude Code secara native di Windows alih-alih melalui WSL, untuk kinerja filesystem yang lebih baik.

​
Dapatkan bantuan lebih lanjut

Jika Anda mengalami masalah yang tidak tercakup di sini:
  1. Jalankan /doctor untuk memeriksa kesehatan instalasi dan /mcp untuk memeriksa status server MCP
  2. Gunakan perintah /feedback dalam Claude Code untuk melaporkan masalah langsung ke Anthropic
  3. Periksa GitHub repository untuk masalah yang diketahui
  4. Tanyakan Claude secara langsung tentang kemampuan dan fiturnya. Claude memiliki akses bawaan ke dokumentasinya.