Temukan solusi untuk masalah umum dengan instalasi dan penggunaan Claude Code.
npm
Windows. Coba:
npm config set os linux
sebelum instalasinpm install -g @anthropic-ai/claude-code --force --no-os-check
(JANGAN gunakan sudo
)exec: node: not found
saat menjalankan claude
, lingkungan WSL Anda mungkin menggunakan instalasi Node.js Windows. 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
.
Konflik versi nvm: Jika Anda memiliki nvm yang terinstall di WSL dan Windows, Anda mungkin mengalami konflik versi saat beralih versi Node di WSL. Ini terjadi karena WSL mengimpor PATH Windows secara default, menyebabkan nvm/npm Windows mengambil prioritas atas instalasi WSL.
Anda dapat mengidentifikasi masalah ini dengan:
which npm
dan which node
- jika mereka menunjuk ke path Windows (dimulai dengan /mnt/c/
), versi Windows sedang digunakan~/.bashrc
, ~/.zshrc
, dll.):
appendWindowsPath = false
) karena ini merusak kemampuan untuk dengan mudah memanggil executable Windows dari WSL. Demikian pula, hindari menguninstall Node.js dari Windows jika Anda menggunakannya untuk pengembangan Windows.PATH
mungkin 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
).
~/.local/bin/claude
.
~/.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:
/permissions
. Lihat dokumentasi Permissions.
/logout
untuk sign out sepenuhnyaclaude
dan selesaikan proses autentikasi lagi/compact
secara teratur untuk mengurangi ukuran konteks.gitignore
Anda@file
, agen kustom, dan perintah slash kustom tidak bekerja, install ripgrep
sistem:
USE_BUILTIN_RIPGREP=0
di environment Anda.
/doctor
akan menunjukkan Search sebagai OK dalam kasus ini./home/
) bukan filesystem Windows (/mnt/c/
).
.wslconfig
di direktori user Windows Anda:
wsl --shutdown
dari PowerShell.
prettier
atau skrip formatting kustom pada file markdown yang dihasilkan.
/bug
dalam Claude Code untuk melaporkan masalah langsung ke Anthropic/doctor
untuk memeriksa kesehatan instalasi Claude Code Anda