Pemecahan Masalah
Temukan solusi untuk masalah umum dengan instalasi dan penggunaan Claude Code.
Masalah instalasi umum
Masalah instalasi Windows: error di WSL
Anda mungkin mengalami masalah berikut di WSL:
Masalah deteksi OS/platform: Jika Anda menerima error selama instalasi, WSL mungkin menggunakan npm
Windows. Coba:
- Jalankan
npm config set os linux
sebelum instalasi - Install dengan
npm install -g @anthropic-ai/claude-code --force --no-os-check
(JANGAN gunakansudo
)
Error Node tidak ditemukan: Jika Anda melihat exec: node: not found
saat menjalankan claude
, lingkungan WSL Anda mungkin menggunakan instalasi Windows dari Node.js. Anda dapat mengonfirmasi ini dengan which npm
dan which node
, yang seharusnya menunjuk ke path Linux yang dimulai dengan /usr/
bukan /mnt/c/
. Untuk memperbaiki ini, coba install Node melalui package manager distribusi Linux Anda atau melalui nvm
.
Masalah instalasi Linux dan Mac: error permission atau command not found
Saat menginstall Claude Code dengan npm, masalah PATH
dapat mencegah akses ke claude
.
Anda juga mungkin mengalami error permission jika prefix global npm Anda tidak dapat ditulis oleh user (misalnya /usr
, atau /usr/local
).
Solusi yang direkomendasikan: Instalasi Claude Code native
Claude Code memiliki instalasi native yang tidak bergantung pada npm atau Node.js.
Installer Claude Code native saat ini dalam beta.
Gunakan perintah berikut untuk menjalankan installer native.
macOS, Linux, WSL:
Windows PowerShell:
Perintah ini menginstall build Claude Code yang sesuai untuk sistem operasi dan arsitektur Anda dan menambahkan symlink ke instalasi di ~/.local/bin/claude
.
Pastikan bahwa Anda memiliki direktori instalasi di PATH sistem Anda.
Solusi alternatif: Migrasi ke instalasi lokal
Alternatifnya, jika Claude Code dapat berjalan, Anda dapat bermigrasi ke instalasi lokal:
Ini memindahkan Claude Code ke ~/.claude/local/
dan menyiapkan alias di konfigurasi shell Anda. Tidak diperlukan sudo
untuk update di masa depan.
Setelah migrasi, restart shell Anda, lalu verifikasi instalasi Anda:
Di macOS/Linux/WSL:
Di Windows:
Verifikasi instalasi:
Permission dan autentikasi
Prompt permission berulang
Jika Anda terus-menerus menyetujui perintah yang sama, Anda dapat mengizinkan tool tertentu
untuk berjalan tanpa persetujuan menggunakan perintah /permissions
. Lihat dokumentasi Permissions.
Masalah autentikasi
Jika Anda mengalami masalah autentikasi:
- Jalankan
/logout
untuk sign out 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 yang bersih.
Performa dan stabilitas
Penggunaan CPU atau memori tinggi
Claude Code dirancang untuk bekerja dengan sebagian besar lingkungan pengembangan, tetapi dapat 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
Command 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 bekerja di terminal JetBrains (IntelliJ, PyCharm, dll.)
Jika Anda menggunakan Claude Code di terminal JetBrains dan tombol ESC tidak menghentikan agent 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 keybindings terminal, scroll 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 - Tanya Claude langsung tentang kemampuan dan fitur-fiturnya - Claude memiliki akses built-in ke dokumentasinya