Pemecahan Masalah
Temukan solusi untuk masalah umum dengan instalasi dan penggunaan Claude Code.
Masalah instalasi umum
Masalah izin Linux
Saat menginstal Claude Code dengan npm, Anda mungkin mengalami kesalahan izin jika prefix global npm Anda tidak dapat ditulis oleh pengguna (misalnya /usr
, atau /usr/local
).
Solusi yang direkomendasikan: Buat prefix npm yang dapat ditulis pengguna
Pendekatan teraman adalah mengonfigurasi npm untuk menggunakan direktori dalam folder home Anda:
Solusi ini direkomendasikan karena:
- Menghindari modifikasi izin direktori sistem
- Membuat lokasi yang bersih dan khusus untuk paket npm global Anda
- Mengikuti praktik terbaik keamanan
Pemulihan Sistem: Jika Anda telah menjalankan perintah yang mengubah kepemilikan dan izin file sistem atau serupa
Jika Anda sudah menjalankan perintah yang mengubah izin direktori sistem (seperti sudo chown -R $USER:$(id -gn) /usr && sudo chmod -R u+w /usr
) dan sistem Anda sekarang rusak (misalnya, jika Anda melihat sudo: /usr/bin/sudo must be owned by uid 0 and have the setuid bit set
), Anda perlu melakukan langkah-langkah pemulihan.
Metode Pemulihan Ubuntu/Debian:
-
Saat reboot, tahan SHIFT untuk mengakses menu GRUB
-
Pilih “Advanced options for Ubuntu/Debian”
-
Pilih opsi recovery mode
-
Pilih “Drop to root shell prompt”
-
Mount ulang filesystem sebagai writable:
-
Perbaiki izin:
-
Instal ulang paket yang terpengaruh (opsional tetapi direkomendasikan):
-
Reboot:
Metode Pemulihan Live USB Alternatif:
Jika mode pemulihan tidak berfungsi, Anda dapat menggunakan live USB:
-
Boot dari live USB (Ubuntu, Debian, atau distribusi Linux apa pun)
-
Temukan partisi sistem Anda:
-
Mount partisi sistem Anda:
-
Jika Anda memiliki partisi boot terpisah, mount juga:
-
Chroot ke sistem Anda:
-
Ikuti langkah 6-8 dari metode pemulihan Ubuntu/Debian di atas
Setelah memulihkan sistem Anda, ikuti solusi yang direkomendasikan di atas untuk menyiapkan prefix npm yang dapat ditulis pengguna.
Masalah auto-updater
Jika Claude Code tidak dapat memperbarui secara otomatis, ini mungkin karena masalah izin dengan direktori prefix global npm Anda. Ikuti solusi yang direkomendasikan di atas untuk memperbaikinya.
Jika Anda lebih suka menonaktifkan auto-updater, Anda dapat
mengatur variabel lingkungan DISABLE_AUTOUPDATER
ke 1
Izin dan autentikasi
Prompt izin berulang
Jika Anda terus-menerus menyetujui perintah yang sama, Anda dapat mengizinkan alat tertentu
untuk berjalan tanpa persetujuan menggunakan perintah /permissions
. Lihat dokumentasi Permissions.
Masalah autentikasi
Jika Anda mengalami masalah autentikasi:
- Jalankan
/logout
untuk keluar sepenuhnya - Tutup Claude Code
- Restart dengan
claude
dan selesaikan proses autentikasi lagi
Jika masalah berlanjut, coba:
Ini menghapus informasi autentikasi tersimpan Anda dan memaksa login bersih.
Performa dan stabilitas
Penggunaan CPU atau memori tinggi
Claude Code dirancang untuk bekerja dengan sebagian besar lingkungan pengembangan, tetapi mungkin mengonsumsi sumber daya yang signifikan saat memproses codebase besar. Jika Anda mengalami masalah performa:
- Gunakan
/compact
secara teratur untuk mengurangi ukuran konteks - Tutup dan restart Claude Code di antara tugas-tugas besar
- Pertimbangkan untuk menambahkan direktori build besar ke file
.gitignore
Anda
Perintah hang atau freeze
Jika Claude Code tampak tidak responsif:
- Tekan Ctrl+C untuk mencoba membatalkan operasi saat ini
- Jika tidak responsif, Anda mungkin perlu menutup terminal dan restart
Tombol ESC tidak berfungsi di terminal JetBrains (IntelliJ, PyCharm, dll.)
Jika Anda menggunakan Claude Code di terminal JetBrains dan tombol ESC tidak menghentikan agen seperti yang diharapkan, ini kemungkinan karena bentrokan keybinding dengan shortcut default JetBrains.
Untuk memperbaiki masalah ini:
- Pergi ke Settings → Tools → Terminal
- Klik hyperlink “Configure terminal keybindings” di sebelah “Override IDE Shortcuts”
- Dalam keybinding terminal, gulir ke bawah ke “Switch focus to Editor” dan hapus shortcut tersebut
Ini akan memungkinkan tombol ESC berfungsi dengan benar untuk membatalkan operasi Claude Code alih-alih ditangkap oleh aksi “Switch focus to Editor” PyCharm.
Mendapatkan bantuan lebih lanjut
Jika Anda mengalami masalah yang tidak tercakup di sini:
- Gunakan perintah
/bug
dalam Claude Code untuk melaporkan masalah langsung ke Anthropic - Periksa repositori GitHub untuk masalah yang diketahui
- Jalankan
/doctor
untuk memeriksa kesehatan instalasi Claude Code Anda