Sepuluh masalah ini menyumbang mayoritas besar tiket dukungan instalasi dan autentikasi yang terkait dengan Claude Code. Setiap entri mencakup perbaikan paling andal.
1. claude: command not found tepat setelah instalasi.
Penginstal menambahkan claude ke PATH Anda, tetapi shell saat ini belum mengambilnya. Buka terminal baru, atau jalankan source ~/.zshrc (atau ~/.bashrc). Di Windows, tutup dan buka kembali PowerShell.
2. npm install gagal dengan EACCES / izin ditolak.
Ini biasanya berarti instalasi dijalankan dengan sudo, atau direktori npm global Anda dimiliki root. Jangan gunakan sudo. Sebagai gantinya, gunakan penginstal asli (curl -fsSL https://claude.ai/install.sh | bash), atau perbaiki awalan npm dengan npm config set prefix ~/.npm-global dan tambahkan direktori bin itu ke PATH Anda.
3. "Versi Node tidak didukung" atau crash senyap saat peluncuran.
Claude Code memerlukan Node 18 atau lebih baru. Periksa versi Anda dengan node -v. Jika lebih lama, instal versi saat ini melalui nvm install --lts, atau gunakan penginstal asli, yang menggabungkan runtime-nya sendiri dan menghindari masalah ini sepenuhnya.
4. WSL: claude menjalankan Node Windows alih-alih Node Linux.
PATH Windows bocor ke WSL dan menimpa nvm. Tambahkan node Linux Anda ke PATH di ~/.bashrc: export PATH="$HOME/.nvm/versions/node/$(nvm current)/bin:$PATH"
5. Penginstal macet atau gagal di belakang jaringan perusahaan.
Host unduhan (storage.googleapis.com) kemungkinan diblokir. Atur proxy Anda terlebih dahulu dengan export HTTPS_PROXY=http://proxy.example.com:port, kemudian jalankan kembali penginstal. Jika itu tidak mungkin, minta tim IT Anda untuk paket offline.
6. SELF_SIGNED_CERT_IN_CHAIN atau kesalahan TLS lainnya.
Perusahaan Anda menyuntikkan sertifikat miliknya sendiri. Arahkan Node ke bundel CA perusahaan: export NODE_EXTRA_CA_CERTS=/path/to/company-ca.pem Tambahkan ke profil shell Anda agar tetap ada.
7. /login membuka browser tetapi terminal tidak pernah selesai ("Menunggu autentikasi…").
Ini biasanya berarti callback localhost diblokir, yang umum terjadi melalui SSH jarak jauh, di devcontainer, atau di belakang firewall ketat. Gunakan alur manual sebagai gantinya: salin URL yang dicetak di terminal, selesaikan login di browser apa pun, kemudian tempel kode yang dikembalikan kembali ke terminal.
8. "Tidak diautentikasi" meskipun Anda menetapkan ANTHROPIC_API_KEY.
Ada tiga penyebab umum: kunci diekspor di shell yang berbeda (jalankan echo $ANTHROPIC_API_KEY untuk memeriksa), Claude Code belum diberitahu untuk mempercayai kunci ini (itu meminta sekali pada penggunaan pertama; sampai Anda menyetujui, ANTHROPIC_API_KEY mengambil alih dari sesi OAuth apa pun hanya setelah persetujuan itu), atau kunci adalah kunci Konsol tetapi organisasi Anda memerlukan login SSO sebagai gantinya.
9. Bedrock / Vertex: "Tidak dapat memuat kredensial."
Claude Code menggunakan SDK penyedia standar, jadi perbaikannya sama dengan alat CLI AWS/GCP apa pun. Untuk Bedrock, konfirmasi aws sts get-caller-identity berfungsi dan AWS_REGION diatur ke wilayah tempat model Anda diaktifkan. Untuk Vertex, konfirmasi gcloud auth application-default login telah dijalankan dan bahwa ANTHROPIC_VERTEX_PROJECT_ID dan CLOUD_ML_REGION diatur.
10. Itu diinstal dan diautentikasi, tetapi setiap permintaan mengalami kesalahan 403 / "model tidak tersedia."
Akun Anda ada tetapi tidak memiliki akses ke model yang diminta Claude Code. Untuk kursi Enterprise, konfirmasi bahwa kursi Anda aktif di pengaturan admin organisasi Anda. Di Bedrock atau Vertex, konfirmasi bahwa model Claude tertentu diaktifkan di wilayah atau proyek itu. Sebagai solusi cepat, jalankan /model dan pilih model yang Anda tahu memiliki akses.
Masih terjebak?
Jalankan claude doctor dari shell normal Anda (bukan dari dalam sesi Claude). Ini mencetak laporan diagnostik yang dapat Anda lampirkan ke tiket dukungan. Untuk daftar lengkap masalah yang diketahui, lihat panduan pemecahan masalah.