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:

# Pertama, simpan daftar paket global yang ada untuk migrasi nanti
npm list -g --depth=0 > ~/npm-global-packages.txt

# Buat direktori untuk paket global Anda
mkdir -p ~/.npm-global

# Konfigurasi npm untuk menggunakan jalur direktori baru
npm config set prefix ~/.npm-global

# Catatan: Ganti ~/.bashrc dengan ~/.zshrc, ~/.profile, atau file yang sesuai untuk shell Anda
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc

# Terapkan pengaturan PATH baru
source ~/.bashrc

# Sekarang instal ulang Claude Code di lokasi baru
npm install -g @anthropic-ai/claude-code

# Opsional: Instal ulang paket global sebelumnya di lokasi baru
# Lihat ~/npm-global-packages.txt dan instal paket yang ingin Anda pertahankan

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:
  1. Saat reboot, tahan SHIFT untuk mengakses menu GRUB

  2. Pilih “Advanced options for Ubuntu/Debian”

  3. Pilih opsi recovery mode

  4. Pilih “Drop to root shell prompt”

  5. Mount ulang filesystem sebagai writable:

    mount -o remount,rw /
    
  6. Perbaiki izin:

    # Pulihkan kepemilikan root
    chown -R root:root /usr
    chmod -R 755 /usr
    
    # Pastikan /usr/local dimiliki oleh pengguna Anda untuk paket npm
    chown -R YOUR_USERNAME:YOUR_USERNAME /usr/local
    
    # Set setuid bit untuk binary penting
    chmod u+s /usr/bin/sudo
    chmod 4755 /usr/bin/sudo
    chmod u+s /usr/bin/su
    chmod u+s /usr/bin/passwd
    chmod u+s /usr/bin/newgrp
    chmod u+s /usr/bin/gpasswd
    chmod u+s /usr/bin/chsh
    chmod u+s /usr/bin/chfn
    
    # Perbaiki konfigurasi sudo
    chown root:root /usr/libexec/sudo/sudoers.so
    chmod 4755 /usr/libexec/sudo/sudoers.so
    chown root:root /etc/sudo.conf
    chmod 644 /etc/sudo.conf
    
  7. Instal ulang paket yang terpengaruh (opsional tetapi direkomendasikan):

    # Simpan daftar paket yang terinstal
    dpkg --get-selections > /tmp/installed_packages.txt
    
    # Instal ulang
    awk '{print $1}' /tmp/installed_packages.txt | xargs -r apt-get install --reinstall -y
    
  8. Reboot:

    reboot
    
Metode Pemulihan Live USB Alternatif:

Jika mode pemulihan tidak berfungsi, Anda dapat menggunakan live USB:

  1. Boot dari live USB (Ubuntu, Debian, atau distribusi Linux apa pun)

  2. Temukan partisi sistem Anda:

    lsblk
    
  3. Mount partisi sistem Anda:

    sudo mount /dev/sdXY /mnt  # ganti sdXY dengan partisi sistem aktual Anda
    
  4. Jika Anda memiliki partisi boot terpisah, mount juga:

    sudo mount /dev/sdXZ /mnt/boot  # jika diperlukan
    
  5. Chroot ke sistem Anda:

    # Untuk Ubuntu/Debian:
    sudo chroot /mnt
    
    # Untuk sistem berbasis Arch:
    sudo arch-chroot /mnt
    
  6. 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:

  1. Jalankan /logout untuk keluar 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 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:

  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

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

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

  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