Pemecahan Masalah Kode Galat Claude Code

Penyebab umum: Direktori instalasi tidak ada di PATH, atau shell saat ini belum memuat ulang konfigurasinya.

Solusi: Buka terminal baru, atau tambahkan direktori instalasi Claude Code ke PATH lalu muat ulang konfigurasi shell Anda.

export PATH="$PATH:$HOME/.local/bin"
source ~/.zshrc

Penyebab umum: Versi Node berada di bawah persyaratan resmi, atau WSL memanggil Node di sisi Windows.

Solusi: Tingkatkan versi Node, atau gunakan native installer resmi. Di WSL, pastikan path dengan which node / which npm agar berasal dari lingkungan Linux.

node -v
which node
which npm

Penyebab umum: Direktori npm global dimiliki oleh root, atau instalasi sebelumnya dengan sudo meninggalkan izin yang berantakan.

Solusi: Jangan menginstal Claude Code dengan sudo. Ubah prefix npm ke direktori pengguna, atau gunakan native installer.

npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"

Penyebab umum: Callback OAuth dari browser tidak sampai ke CLI lokal - umum terjadi pada remote SSH, devcontainer, firewall ketat, atau callback localhost yang diblokir.

Solusi: Pastikan browser dan CLI di mesin yang sama dapat saling terhubung. Bila perlu, logout, mulai ulang Claude Code, lalu selesaikan autentikasi lagi.

/logout
# 关闭 Claude Code 后重新运行
claude

Penyebab umum: Proxy perusahaan atau gateway keamanan menyisipkan CA self-signed yang tidak dipercaya Node secara default.

Solusi: Minta bundle CA perusahaan dari tim IT dan tentukan lewat NODE_EXTRA_CA_CERTS.

export NODE_EXTRA_CA_CERTS=/path/to/company-ca.pem

Penyebab umum: Variabel proxy salah dikonfigurasi, protokol proxy tidak didukung, NO_PROXY menimpa domain tujuan, atau firewall perusahaan memblokir akses.

Solusi: Claude Code memakai variabel lingkungan proxy HTTP/HTTPS standar; dokumentasi menyatakan proxy SOCKS tidak didukung. Uji ulang dulu dengan HTTPS_PROXY.

export HTTPS_PROXY=http://proxy.example.com:8080
echo $HTTPS_PROXY
echo $NO_PROXY

Penyebab umum: Organisasi belum mengaktifkan Claude Code, allowlist perusahaan tidak mencakup jalur keluar saat ini, ada pembatasan akun/wilayah/kebijakan, atau proxy ditolak.

Solusi: Untuk akun pribadi, pastikan dulu wilayah yang didukung dan status akun; untuk akun perusahaan, minta admin memeriksa izin Claude Code, SSO, allowlist IP, dan aturan firewall.

Penyebab umum: Permintaan terlalu sering, konkurensi terlalu tinggi, atau paket akun maupun organisasi telah mencapai batas laju.

Solusi: Kurangi konkurensi di lapisan luar, hentikan loop percobaan ulang, dan tunggu hingga batas direset. Jangan membungkus Claude Code dengan banyak worker untuk memaksa kecepatan.

Penyebab umum: API key berasal dari shell yang berbeda, key Console bentrok dengan sesi OAuth, atau organisasi mewajibkan login SSO.

Solusi: Periksa apakah ANTHROPIC_API_KEY diatur di shell saat ini. Akun perusahaan sebaiknya mengikuti alur login Console/SSO yang diwajibkan admin.

echo $ANTHROPIC_API_KEY