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 gunakan sudo)

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:

# Install versi stabil (default)
curl -fsSL https://claude.ai/install.sh | bash

# Install versi terbaru
curl -fsSL https://claude.ai/install.sh | bash -s latest

# Install nomor versi spesifik
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

Windows PowerShell:

# Install versi stabil (default)
irm https://claude.ai/install.ps1 | iex

# Install versi terbaru
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) latest

# Install nomor versi spesifik
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58

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:

claude migrate-installer

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:

which claude  # Seharusnya menunjukkan alias ke ~/.claude/local/claude

Di Windows:

where claude  # Seharusnya menunjukkan path ke executable claude

Verifikasi instalasi:

claude doctor # Periksa kesehatan 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:

  1. Jalankan /logout untuk sign out sepenuhnya
  2. Tutup Claude Code
  3. Restart dengan claude dan selesaikan proses autentikasi lagi

Jika masalah berlanjut, coba:

rm -rf ~/.config/claude-code/auth.json
claude

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:

  1. Gunakan /compact secara teratur untuk mengurangi ukuran konteks
  2. Tutup dan restart Claude Code di antara tugas-tugas besar
  3. Pertimbangkan untuk menambahkan direktori build besar ke file .gitignore Anda

Command hang atau freeze

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 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:

  1. Pergi ke Settings → Tools → Terminal
  2. Klik hyperlink “Configure terminal keybindings” di sebelah “Override IDE Shortcuts”
  3. 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:

  1. Gunakan perintah /bug dalam Claude Code untuk melaporkan masalah langsung ke Anthropic
  2. Periksa repositori GitHub untuk masalah yang diketahui
  3. Jalankan /doctor untuk memeriksa kesehatan instalasi Claude Code Anda
  4. Tanya Claude langsung tentang kemampuan dan fitur-fiturnya - Claude memiliki akses built-in ke dokumentasinya