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. Sebaliknya, gunakan penginstal curl, 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 curl, 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 di depan 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://your-proxy: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 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), Anda sebelumnya menjalankan /login dan sesi OAuth mengambil alih (jalankan /logout terlebih dahulu), 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 GOOGLE_CLOUD_PROJECT diatur.
10. Itu diinstal dan diautentikasi, tetapi setiap permintaan error dengan 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 spesifik 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.