Troubleshoot installation and login

Jika instalasi gagal atau Anda tidak dapat masuk, temukan kesalahan Anda di bawah. Untuk masalah runtime setelah Claude Code berfungsi, lihat Troubleshooting. Untuk masalah konfigurasi seperti pengaturan tidak diterapkan atau hooks tidak berfungsi, lihat Debug your configuration.

Temukan kesalahan Anda

Cocokkan pesan kesalahan atau gejala yang Anda lihat dengan perbaikan:

Apa yang Anda lihat	Solusi
`command not found: claude` atau `'claude' is not recognized`	Perbaiki PATH Anda
`syntax error near unexpected token '<'`	Install script returns HTML
`curl: (56) Failure writing output to destination`	Periksa konektivitas atau gunakan installer alternatif
`Killed` selama instalasi di Linux	Tambahkan swap space untuk server dengan memori rendah
`TLS connect error` atau `SSL/TLS secure channel`	Perbarui sertifikat CA
`Failed to fetch version` atau tidak dapat menjangkau server download	Periksa pengaturan jaringan dan proxy
`irm is not recognized` atau `&& is not valid`	Gunakan perintah yang tepat untuk shell Anda
`'bash' is not recognized as the name of a cmdlet`	Gunakan perintah installer Windows
`Claude Code on Windows requires git-bash`	Instal atau konfigurasi Git Bash
`Claude Code does not support 32-bit Windows`	Buka Windows PowerShell, bukan entri x86
`Error loading shared library`	Binary variant yang salah untuk sistem Anda
`Illegal instruction`	Ketidakcocokan arsitektur atau instruction set CPU
`cannot execute binary file: Exec format error` di WSL	WSL1 native-binary regression
PowerShell installer selesai tetapi `claude` tidak ditemukan atau menunjukkan versi lama	Restart terminal Anda dan verifikasi PATH
`dyld: cannot load`, `dyld: Symbol not found`, atau `Abort trap` di macOS	Binary incompatibility
`Invoke-Expression: Missing argument in parameter list`	Install script returns HTML
`App unavailable in region`	Claude Code tidak tersedia di negara Anda. Lihat supported countries.
`unable to get local issuer certificate`	Konfigurasi sertifikat CA perusahaan
`OAuth error` atau `403 Forbidden`	Perbaiki authentication
`Could not load the default credentials` atau `Could not load credentials from any providers`	Bedrock, Vertex, atau Foundry credentials
`ChainedTokenCredential authentication failed` atau `CredentialUnavailableError`	Bedrock, Vertex, atau Foundry credentials
`API Error: 500`, `529 Overloaded`, `429`, atau 4xx dan 5xx errors lainnya yang tidak tercantum di atas	Lihat Error reference

Jika masalah Anda tidak tercantum, lakukan pemeriksaan diagnostik di bawah untuk mempersempit penyebabnya.

Jika Anda lebih suka melewati terminal sepenuhnya, Claude Code Desktop app memungkinkan Anda menginstal dan menggunakan Claude Code melalui antarmuka grafis. Unduh untuk macOS atau Windows dan mulai coding tanpa setup command-line apa pun.

Jalankan pemeriksaan diagnostik

Periksa konektivitas jaringan

Installer mengunduh dari downloads.claude.ai. Verifikasi Anda dapat menjangkaunya:

curl -sI https://downloads.claude.ai/claude-code-releases/latest

Baris HTTP/2 200 berarti Anda menjangkau server. Jika Anda tidak melihat output, Could not resolve host, atau connection timeout, jaringan Anda memblokir koneksi. Penyebab umum:

Corporate firewalls atau proxies memblokir downloads.claude.ai
Pembatasan jaringan regional: coba VPN atau jaringan alternatif
Masalah TLS/SSL: perbarui sertifikat CA sistem Anda, atau periksa apakah HTTPS_PROXY dikonfigurasi

Jika Anda berada di belakang corporate proxy, atur HTTPS_PROXY dan HTTP_PROXY ke alamat proxy Anda sebelum menginstal. Tanyakan tim IT Anda untuk URL proxy jika Anda tidak mengetahuinya, atau periksa pengaturan proxy browser Anda. Contoh ini mengatur kedua variabel proxy, kemudian menjalankan installer melalui proxy Anda:

macOS/Linux
Windows PowerShell

export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
curl -fsSL https://claude.ai/install.sh | bash

$env:HTTP_PROXY = 'http://proxy.example.com:8080'
$env:HTTPS_PROXY = 'http://proxy.example.com:8080'
irm https://claude.ai/install.ps1 | iex

Verifikasi PATH Anda

Jika instalasi berhasil tetapi Anda mendapatkan error command not found atau not recognized saat menjalankan claude, direktori instalasi tidak ada di PATH Anda. Shell Anda mencari program di direktori yang tercantum di PATH, dan installer menempatkan claude di ~/.local/bin/claude di macOS/Linux atau %USERPROFILE%\.local\bin\claude.exe di Windows. Periksa apakah direktori instalasi ada di PATH Anda dengan membuat daftar entri PATH dan memfilter untuk local/bin:

macOS/Linux
Windows PowerShell
Windows CMD

echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"

Jika ini mencetak /Users/you/.local/bin atau /home/you/.local/bin, direktori ada di PATH Anda dan Anda dapat melompat ke Check for conflicting installations. Jika tidak ada output, tambahkan ke konfigurasi shell Anda.Untuk Zsh, default di macOS:

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

Untuk Bash, default di sebagian besar distribusi Linux:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Atau, tutup dan buka kembali terminal Anda.Verifikasi perbaikan berhasil:

claude --version

$env:PATH -split ';' | Select-String '\.local\\bin'

Jika tidak ada output, tambahkan direktori instalasi ke User PATH Anda:

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

Restart terminal Anda agar perubahan berlaku.Verifikasi perbaikan berhasil:

claude --version

echo %PATH% | findstr /i "local\bin"

Jika tidak ada output, buka System Settings, buka Environment Variables, dan tambahkan %USERPROFILE%\.local\bin ke variabel User PATH Anda. Restart terminal Anda.Verifikasi perbaikan berhasil:

claude --version

Periksa instalasi yang bertentangan

Beberapa instalasi Claude Code dapat menyebabkan ketidakcocokan versi atau perilaku yang tidak terduga. Periksa apa yang terinstal:

macOS/Linux
Windows PowerShell

Buat daftar semua binary claude yang ditemukan di PATH Anda:

which -a claude

Jika ini tidak mencetak apa pun, tidak ada claude di PATH Anda. Kembali ke Verify your PATH.Periksa tiga lokasi tempat binary claude dapat berasal. ~/.local/bin/claude adalah native installer, ~/.claude/local/ adalah legacy local npm install yang dibuat oleh versi Claude Code yang lebih lama, dan npm global list menunjukkan instalasi -g:

ls -la ~/.local/bin/claude

ls -la ~/.claude/local/

npm -g ls @anthropic-ai/claude-code 2>/dev/null

Buat daftar semua binary claude yang ditemukan di PATH Anda:

where.exe claude

Periksa apakah native installer menempatkan binary:

Test-Path "$env:USERPROFILE\.local\bin\claude.exe"

Jika Anda menemukan beberapa instalasi, pertahankan hanya satu. Native install di ~/.local/bin/claude di macOS/Linux atau %USERPROFILE%\.local\bin\claude.exe di Windows direkomendasikan. Hapus yang lainnya: Uninstall npm global install:

npm uninstall -g @anthropic-ai/claude-code

Hapus legacy local npm install:

rm -rf ~/.claude/local

Di Windows, gunakan PowerShell:

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\local"

Hapus instalasi Homebrew di macOS. Jika Anda menginstal cask claude-code@latest, ganti nama itu:

brew uninstall --cask claude-code

Hapus instalasi WinGet di Windows:

winget uninstall Anthropic.ClaudeCode

Periksa izin direktori

Installer memerlukan akses tulis ke ~/.local/bin/ dan ~/.claude/ di macOS dan Linux. Di Windows lokasi instalasi berada di bawah %USERPROFILE%, yang dapat ditulis oleh pengguna Anda secara default, jadi bagian ini jarang berlaku di sana. Periksa apakah direktori dapat ditulis:

test -w ~/.local/bin && echo "writable" || echo "not writable"
test -w ~/.claude && echo "writable" || echo "not writable"

Jika direktori mana pun tidak dapat ditulis, buat direktori instalasi dan atur pengguna Anda sebagai pemilik:

sudo mkdir -p ~/.local/bin
sudo chown -R $(whoami) ~/.local

Verifikasi binary berfungsi

Jika claude --version mencetak versi tetapi claude crash atau hang pada startup, jalankan pemeriksaan ini untuk mempersempit penyebabnya. Jika claude --version mengatakan command not found, buka Verify your PATH terlebih dahulu; perintah di bawah mengasumsikan claude ada di PATH Anda. Konfirmasi binary ada dan dapat dieksekusi:

ls -la "$(command -v claude)"

Di Windows, gunakan PowerShell:

Get-Command claude | Select-Object Source

Di Linux, periksa shared libraries yang hilang. Jika ldd menunjukkan library yang hilang, Anda mungkin perlu menginstal paket sistem. Di Alpine Linux dan distribusi berbasis musl lainnya, lihat Alpine Linux setup.

ldd "$(command -v claude)" | grep "not found"

Konfirmasi binary dapat dieksekusi:

claude --version

Masalah instalasi umum

Ini adalah masalah instalasi yang paling sering dihadapi dan solusinya.

Install script returns HTML instead of a shell script

Saat menjalankan perintah install, Anda mungkin melihat salah satu error ini:

bash: line 1: syntax error near unexpected token `<'
bash: line 1: `<!DOCTYPE html>'

Di PowerShell, masalah yang sama muncul sebagai:

Invoke-Expression: Missing argument in parameter list.

Ini berarti URL instalasi mengembalikan halaman HTML alih-alih script instalasi. Jika halaman HTML mengatakan “App unavailable in region,” Claude Code tidak tersedia di negara Anda. Lihat supported countries. Sebaliknya, ini dapat terjadi karena masalah jaringan, routing regional, atau gangguan layanan sementara. Solusi:

Gunakan metode instalasi alternatif: Di macOS, instal melalui Homebrew:
```
brew install --cask claude-code
```
Di Windows, instal melalui WinGet:
```
winget install Anthropic.ClaudeCode
```
Coba lagi setelah beberapa menit: masalahnya sering bersifat sementara. Tunggu dan coba perintah asli lagi.

`command not found: claude` after installation

Instalasi selesai tetapi claude tidak berfungsi. Error yang tepat bervariasi menurut platform:

Platform	Pesan error
macOS	`zsh: command not found: claude`
Linux	`bash: claude: command not found`
Windows CMD	`'claude' is not recognized as an internal or external command`
PowerShell	`claude : The term 'claude' is not recognized as the name of a cmdlet`

Ini berarti direktori instalasi tidak ada di path pencarian shell Anda. Lihat Verify your PATH untuk perbaikan di setiap platform.

`curl: (56) Failure writing output to destination`

Perintah curl ... | bash mengunduh script dan menyalurkannya ke Bash untuk dieksekusi. Error ini berarti koneksi putus sebelum script selesai diunduh. Penyebab umum termasuk gangguan jaringan, download diblokir di tengah aliran, atau batas sumber daya sistem. Solusi:

Periksa stabilitas jaringan: Binary Claude Code dihosting di downloads.claude.ai. Uji bahwa Anda dapat menjangkaunya:
```
curl -sI https://downloads.claude.ai/claude-code-releases/latest
```
Baris HTTP/2 200 berarti Anda menjangkau server dan kegagalan asli mungkin bersifat intermiten; coba ulang perintah install. Jika Anda melihat Could not resolve host atau connection timeout, jaringan Anda memblokir download.

Coba metode instalasi alternatif: Di macOS:

brew install --cask claude-code

Di Windows:

winget install Anthropic.ClaudeCode

TLS or SSL connection errors

Error seperti curl: (35) TLS connect error, schannel: next InitializeSecurityContext failed, atau PowerShell’s Could not establish trust relationship for the SSL/TLS secure channel menunjukkan kegagalan TLS handshake. Solusi:

Perbarui sertifikat CA sistem Anda: Di Ubuntu/Debian:
```
sudo apt-get update && sudo apt-get install ca-certificates
```
Di macOS, curl sistem menggunakan Keychain trust store; memperbarui macOS itu sendiri memperbarui root certificates.

Di Windows, aktifkan TLS 1.2 di PowerShell sebelum menjalankan installer:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
irm https://claude.ai/install.ps1 | iex

Periksa gangguan proxy atau firewall: corporate proxies yang melakukan TLS inspection dapat menyebabkan error ini, termasuk unable to get local issuer certificate dan SELF_SIGNED_CERT_IN_CHAIN. Untuk langkah instalasi, arahkan curl ke bundle CA perusahaan Anda dengan --cacert:
```
curl --cacert /path/to/corporate-ca.pem -fsSL https://claude.ai/install.sh | bash
```
Untuk Claude Code itu sendiri setelah diinstal, atur NODE_EXTRA_CA_CERTS sehingga permintaan API mempercayai bundle yang sama:
```
export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca.pem
```
Tanyakan tim IT Anda untuk file sertifikat jika Anda tidak memilikinya. Anda juga dapat mencoba koneksi langsung untuk mengkonfirmasi proxy adalah penyebabnya.
Di Windows, lewati pemeriksaan revokasi sertifikat jika Anda melihat CRYPT_E_NO_REVOCATION_CHECK (0x80092012) atau CRYPT_E_REVOCATION_OFFLINE (0x80092013). Ini berarti curl menjangkau server tetapi jaringan Anda memblokir pencarian revokasi sertifikat, yang umum di belakang firewall perusahaan. Tambahkan --ssl-revoke-best-effort ke perintah install:
```
curl --ssl-revoke-best-effort -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
```
Atau, instal dengan winget install Anthropic.ClaudeCode, yang menghindari curl sepenuhnya.

`Failed to fetch version from downloads.claude.ai`

Installer tidak dapat menjangkau server download. Ini biasanya berarti downloads.claude.ai diblokir di jaringan Anda. Solusi:

Uji konektivitas secara langsung:

curl -sI https://downloads.claude.ai/claude-code-releases/latest

Jika di belakang proxy, atur HTTPS_PROXY sehingga installer dapat merutekan melaluinya. Lihat proxy configuration untuk detail.
```
export HTTPS_PROXY=http://proxy.example.com:8080
curl -fsSL https://claude.ai/install.sh | bash
```
Jika di jaringan terbatas, coba jaringan berbeda atau VPN, atau gunakan metode instalasi alternatif: Di macOS:
```
brew install --cask claude-code
```
Di Windows:
```
winget install Anthropic.ClaudeCode
```

Wrong install command on Windows

Jika Anda melihat 'irm' is not recognized, The token '&&' is not valid, atau 'bash' is not recognized as the name of a cmdlet, Anda menyalin perintah install untuk shell atau sistem operasi yang berbeda.

irm not recognized: Anda berada di CMD, bukan PowerShell. Anda memiliki dua opsi: Buka PowerShell dengan mencari “PowerShell” di Start menu, kemudian jalankan perintah install asli:
```
irm https://claude.ai/install.ps1 | iex
```
Atau tetap di CMD dan gunakan CMD installer sebagai gantinya:
```
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
```
&& not valid: Anda berada di PowerShell tetapi menjalankan perintah CMD installer. Gunakan PowerShell installer:
```
irm https://claude.ai/install.ps1 | iex
```
bash not recognized: Anda menjalankan installer macOS/Linux di Windows. Gunakan PowerShell installer sebagai gantinya:
```
irm https://claude.ai/install.ps1 | iex
```

Install killed on low-memory Linux servers

Jika Anda melihat Killed selama instalasi di VPS atau cloud instance:

Setting up Claude Code...
Installing Claude Code native build latest...
bash: line 142: 34803 Killed    "$binary_path" install ${TARGET:+"$TARGET"}

Linux OOM killer menghentikan proses karena sistem kehabisan memori. Claude Code memerlukan setidaknya 4 GB RAM yang tersedia. Solusi:

Tambahkan swap space jika server Anda memiliki RAM terbatas. Swap menggunakan ruang disk sebagai memori overflow, memungkinkan instalasi selesai bahkan dengan RAM fisik rendah. Buat file swap 2 GB dan aktifkan:
```
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
```
Kemudian coba ulang instalasi:
```
curl -fsSL https://claude.ai/install.sh | bash
```
Tutup proses lain untuk membebaskan memori sebelum menginstal.
Gunakan instance yang lebih besar jika memungkinkan. Claude Code memerlukan setidaknya 4 GB RAM.

Install hangs in Docker

Saat menginstal Claude Code di Docker container, menginstal sebagai root ke / dapat menyebabkan hang. Solusi:

Atur working directory sebelum menjalankan installer. Saat dijalankan dari /, installer memindai seluruh filesystem, yang menyebabkan penggunaan memori berlebihan. Mengatur WORKDIR membatasi pemindaian ke direktori kecil:
```
WORKDIR /tmp
RUN curl -fsSL https://claude.ai/install.sh | bash
```
Tingkatkan batas memori Docker jika menggunakan Docker Desktop:
```
docker build --memory=4g .
```

Claude Desktop overrides the `claude` command on Windows

Jika Anda menginstal versi Claude Desktop yang lebih lama, mungkin mendaftarkan Claude.exe di direktori WindowsApps yang mengambil prioritas PATH di atas Claude Code CLI. Menjalankan claude membuka Desktop app alih-alih CLI. Perbarui Claude Desktop ke versi terbaru untuk memperbaiki masalah ini.

Claude Code on Windows requires Git Bash

Claude Code di Windows native memerlukan Git for Windows, yang menyediakan Git Bash untuk menjalankan shell commands. Jika Git tidak terinstal, unduh dari git-scm.com/downloads/win. Selama setup, pilih “Add to PATH.” Restart terminal Anda setelah menginstal. Jika Git sudah terinstal tetapi Claude Code tidak dapat menemukannya, atur path di settings.json file Anda:

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Jika Git Anda diinstal di tempat lain, temukan path dengan menjalankan where.exe git di PowerShell dan gunakan path bin\bash.exe dari direktori itu.

Claude Code does not support 32-bit Windows

Windows menyertakan dua entri PowerShell di Start menu: Windows PowerShell dan Windows PowerShell (x86). Entri x86 berjalan sebagai proses 32-bit dan memicu error ini bahkan di mesin 64-bit. Untuk memeriksa kasus mana yang Anda alami, jalankan ini di jendela yang sama yang menghasilkan error:

[Environment]::Is64BitOperatingSystem

Jika ini mencetak True, sistem operasi Anda baik-baik saja. Tutup jendela, buka Windows PowerShell tanpa suffix x86, dan jalankan perintah install lagi. Jika ini mencetak False, Anda berada di edisi Windows 32-bit. Claude Code memerlukan sistem operasi 64-bit. Lihat system requirements.

Linux musl or glibc binary mismatch

Jika Anda melihat error tentang shared libraries yang hilang seperti libstdc++.so.6 atau libgcc_s.so.1 setelah instalasi, installer mungkin telah mengunduh binary variant yang salah untuk sistem Anda.

Error loading shared library libstdc++.so.6: No such file or directory

Ini dapat terjadi pada sistem berbasis glibc yang memiliki paket cross-compilation musl terinstal, menyebabkan installer salah mendeteksi sistem sebagai musl. Solusi:

Periksa libc mana yang digunakan sistem Anda:
```
ldd --version 2>&1 | head -1
```
Output yang menyebutkan GNU libc atau GLIBC berarti glibc. Output yang menyebutkan musl berarti musl.
Jika Anda berada di glibc tetapi mendapat binary musl, hapus instalasi dan instal ulang. Anda juga dapat secara manual mengunduh binary yang benar menggunakan manifest di https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json. File GitHub issue dengan output ldd --version dan ls /lib/libc.musl*.
Jika Anda benar-benar di musl, seperti Alpine Linux, instal paket yang diperlukan:
```
apk add libgcc libstdc++ ripgrep
```

`Illegal instruction`

Jika menjalankan claude atau installer mencetak Illegal instruction, binary native menggunakan CPU instructions yang processor Anda tidak dukung. Ada dua penyebab yang berbeda. Architecture mismatch. Installer mengunduh binary yang salah, misalnya x86 di server ARM. Periksa dengan uname -m di macOS atau Linux, atau $env:PROCESSOR_ARCHITECTURE di PowerShell. Jika hasilnya tidak cocok dengan binary yang Anda terima, file GitHub issue dengan output. Missing instruction set pada CPU yang lebih lama. Jika arsitektur Anda benar tetapi Anda masih melihat Illegal instruction, CPU Anda mungkin tidak memiliki AVX atau instruction lain yang binary perlukan. Ini mempengaruhi kira-kira processor Intel dan AMD pre-2013. Saat ini tidak ada native-binary workaround; track issue #50384 untuk status, dan sertakan model CPU Anda dari cat /proc/cpuinfo | grep "model name" | head -1 di Linux atau sysctl -n machdep.cpu.brand_string di macOS saat melaporkan. Metode instalasi alternatif mengunduh binary native yang sama dan tidak akan menyelesaikan penyebab apa pun.

`dyld: cannot load` on macOS

Jika Anda melihat dyld: cannot load, dyld: Symbol not found, atau Abort trap: 6 selama instalasi, binary tidak kompatibel dengan versi macOS atau hardware Anda.

dyld: cannot load 'claude-2.1.42-darwin-x64' (load command 0x80000034 is unknown)
Abort trap: 6

Error Symbol not found yang mereferensikan libicucore juga menunjukkan versi macOS Anda lebih lama dari yang binary dukung:

dyld: Symbol not found: _ubrk_clone
  Referenced from: claude-darwin-x64 (which was built for Mac OS X 13.0)
  Expected in: /usr/lib/libicucore.A.dylib

Solusi:

Periksa versi macOS Anda: Claude Code memerlukan macOS 13.0 atau lebih baru. Buka menu Apple dan pilih About This Mac untuk memeriksa versi Anda.
Perbarui macOS jika Anda berada di versi yang lebih lama. Binary menggunakan load commands dan system libraries yang versi macOS yang lebih lama tidak dukung. Metode instalasi alternatif seperti Homebrew mengunduh binary yang sama dan tidak akan menyelesaikan error ini.

`Exec format error` on WSL1

Jika menjalankan claude di WSL mencetak cannot execute binary file: Exec format error, Anda berada di WSL1 dan mengalami native-binary regression yang dikenal yang dilacak di issue #38788. Program headers binary berubah dengan cara yang WSL1’s loader tidak dapat menangani. Perbaikan paling bersih adalah mengonversi distribusi Anda ke WSL2 dari PowerShell:

wsl --set-version <DistroName> 2

Jika Anda perlu tetap di WSL1, panggil binary melalui dynamic linker. Tambahkan fungsi ini ke ~/.bashrc di dalam WSL, ganti path jika direktori home Anda berbeda:

claude() {
  /lib64/ld-linux-x86-64.so.2 "$(readlink -f "$HOME/.local/bin/claude")" "$@"
}

Kemudian jalankan source ~/.bashrc dan coba ulang claude.

npm install errors in WSL

Masalah ini berlaku jika Anda menginstal Claude Code dengan npm install -g di dalam WSL. Jika Anda menggunakan native installer, lewati bagian ini. OS atau platform detection issues. Jika npm melaporkan ketidakcocokan platform selama instalasi, WSL mungkin mengambil Windows npm. Jalankan npm config set os linux terlebih dahulu, kemudian instal dengan npm install -g @anthropic-ai/claude-code --force. Jangan gunakan sudo. exec: node: not found saat menjalankan claude. Lingkungan WSL Anda mungkin menggunakan instalasi Windows Node.js. Konfirmasi dengan which npm dan which node: path yang dimulai dengan /mnt/c/ adalah binary Windows, sementara path Linux dimulai dengan /usr/. Untuk memperbaiki ini, instal Node melalui package manager distribusi Linux Anda atau melalui nvm. nvm version conflicts. Jika Anda memiliki nvm terinstal di WSL dan Windows, beralih versi Node di WSL mungkin rusak karena WSL mengimpor Windows PATH secara default dan Windows nvm mengambil prioritas. Penyebab paling umum adalah nvm tidak dimuat di shell Anda. Tambahkan nvm loader ke ~/.bashrc atau ~/.zshrc:

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

Atau muat di sesi saat ini:

source ~/.nvm/nvm.sh

Jika nvm dimuat tetapi path Windows masih mengambil prioritas, tambahkan path Node Linux Anda secara eksplisit:

export PATH="$HOME/.nvm/versions/node/$(node -v)/bin:$PATH"

Hindari menonaktifkan Windows PATH importing melalui appendWindowsPath = false karena ini merusak kemampuan untuk memanggil Windows executables dari WSL. Demikian pula, hindari menguninstall Node.js dari Windows jika Anda menggunakannya untuk pengembangan Windows.

Permission errors during installation

Jika native installer gagal dengan permission errors, direktori target mungkin tidak dapat ditulis. Lihat Check directory permissions. Jika Anda sebelumnya menginstal dengan npm dan mengalami npm-specific permission errors, beralih ke native installer:

curl -fsSL https://claude.ai/install.sh | bash

Native binary not found after npm install

Paket npm @anthropic-ai/claude-code menarik binary native melalui per-platform optional dependency seperti @anthropic-ai/claude-code-darwin-arm64. Jika menjalankan claude setelah install mencetak Could not find native binary package "@anthropic-ai/claude-code-<platform>", periksa penyebab berikut:

Optional dependencies dinonaktifkan. Hapus --omit=optional dari perintah npm install Anda, --no-optional dari pnpm, atau --ignore-optional dari yarn, dan periksa bahwa .npmrc tidak mengatur optional=false. Kemudian instal ulang. Binary native disampaikan hanya sebagai optional dependency, jadi tidak ada JavaScript fallback jika dilewati.
Platform tidak didukung. Binary prebuilt dipublikasikan untuk darwin-arm64, darwin-x64, linux-x64, linux-arm64, linux-x64-musl, linux-arm64-musl, win32-x64, dan win32-arm64. Claude Code tidak mengirimkan binary untuk platform lain; lihat system requirements.
Corporate npm mirror kehilangan paket platform. Pastikan registry Anda mencerminkan semua delapan paket @anthropic-ai/claude-code-* platform selain paket meta.

Menginstal dengan --ignore-scripts tidak memicu error ini. Langkah postinstall yang menghubungkan binary ke tempat dilewati, jadi Claude Code kembali ke wrapper yang menemukan dan menjalankan binary platform di setiap peluncuran. Ini berfungsi tetapi dimulai lebih lambat; instal ulang dengan scripts diaktifkan untuk eksekusi langsung. Bagian ini mengatasi kegagalan login, OAuth errors, dan masalah token. Saat login gagal dan penyebabnya tidak jelas, re-authentication yang bersih menyelesaikan sebagian besar kasus:

Jalankan /logout untuk sign out sepenuhnya
Tutup Claude Code
Restart dengan claude dan selesaikan proses authentication lagi

Jika browser tidak terbuka secara otomatis selama login, tekan c untuk menyalin OAuth URL ke clipboard Anda, kemudian tempel ke browser secara manual. Ini juga berfungsi saat URL membungkus di seluruh baris di terminal sempit atau SSH dan tidak dapat diklik langsung.

OAuth error: Invalid code

Jika Anda melihat OAuth error: Invalid code. Please make sure the full code was copied, kode login kedaluwarsa atau terpotong selama copy-paste. Solusi:

Tekan Enter untuk coba ulang dan selesaikan login dengan cepat setelah browser terbuka
Ketik c untuk menyalin URL lengkap jika browser tidak terbuka secara otomatis
Jika menggunakan sesi remote/SSH, browser mungkin terbuka di mesin yang salah. Salin URL yang ditampilkan di terminal dan buka di browser lokal Anda sebagai gantinya.

Jika Anda melihat API Error: 403 {"error":{"type":"forbidden","message":"Request not allowed"}} setelah login:

Claude Pro/Max users: verifikasi subscription Anda aktif di claude.ai/settings
Anthropic Console users: konfirmasi akun Anda memiliki role “Claude Code” atau “Developer”. Admins menetapkan ini di Anthropic Console di bawah Settings → Members.
Di belakang proxy: corporate proxies dapat mengganggu permintaan API. Lihat network configuration untuk setup proxy.

This organization has been disabled with an active subscription

Jika Anda melihat API Error: 400 ... "This organization has been disabled" meskipun memiliki subscription Claude aktif, variabel environment ANTHROPIC_API_KEY menimpa subscription Anda. Ini biasanya terjadi saat API key lama dari employer atau project sebelumnya masih diatur di shell profile Anda. Saat ANTHROPIC_API_KEY ada dan Anda telah menyetujuinya, Claude Code menggunakan key itu alih-alih OAuth credentials subscription Anda. Dalam mode non-interactive dengan flag -p, key selalu digunakan saat ada. Lihat authentication precedence untuk urutan resolusi lengkap. Untuk menggunakan subscription Anda sebagai gantinya, unset variabel environment dan hapus dari shell profile Anda:

unset ANTHROPIC_API_KEY
claude

Periksa ~/.zshrc, ~/.bashrc, atau ~/.profile untuk baris export ANTHROPIC_API_KEY=... dan hapus untuk membuat perubahan permanen. Di Windows, periksa PowerShell profile Anda di $PROFILE dan User environment variables Anda untuk ANTHROPIC_API_KEY. Jalankan /status di dalam Claude Code untuk mengkonfirmasi metode authentication mana yang aktif. Browser-based login di WSL2 dapat gagal dengan dua cara: WSL tidak dapat membuka Windows browser Anda, atau terminal tidak akan menerima kode authorization yang ditempel. Jika browser tidak terbuka, atur variabel environment BROWSER ke path Windows browser Anda:

export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
claude

Atau tekan c di login prompt untuk menyalin OAuth URL dan tempel ke Windows browser Anda sendiri. Jika browser terbuka tetapi menempel kode kembali ke terminal tidak melakukan apa pun, binding paste terminal Anda mungkin tidak menjangkau prompt. Coba shortcut paste alternatif terminal Anda, sering kali right-click atau Shift+Insert di Windows Terminal, atau jalankan login di luar UI interaktif:

claude auth login

Fallback ini juga berlaku di Windows native atau terminal apa pun di mana menempel kode ke prompt interaktif gagal.

Not logged in or token expired

Jika Claude Code meminta Anda untuk login lagi setelah sesi, OAuth token Anda mungkin telah kedaluwarsa. Jalankan /login untuk re-authenticate. Jika ini terjadi sering, periksa bahwa jam sistem Anda akurat, karena validasi token bergantung pada timestamp yang benar. Di macOS, login juga dapat gagal saat Keychain terkunci atau passwordnya tidak sinkron dengan password akun Anda, yang mencegah Claude Code menyimpan credentials. Jalankan claude doctor untuk memeriksa akses Keychain. Untuk membuka Keychain secara manual, jalankan security unlock-keychain ~/Library/Keychains/login.keychain-db. Jika membuka tidak membantu, buka Keychain Access, pilih keychain login, dan pilih Edit > Change Password for Keychain “login” untuk menyinkronkannya kembali dengan password akun Anda.

Bedrock, Vertex, or Foundry credentials not loading

Jika Anda mengkonfigurasi Claude Code untuk menggunakan cloud provider dan melihat Could not load credentials from any providers di Bedrock, Could not load the default credentials di Vertex, atau ChainedTokenCredential authentication failed di Foundry, cloud provider CLI Anda mungkin tidak authenticated di shell saat ini. Untuk Bedrock, konfirmasi AWS credentials Anda valid:

aws sts get-caller-identity

Untuk Vertex AI, konfirmasi ANTHROPIC_VERTEX_PROJECT_ID dan CLOUD_ML_REGION diatur di shell Anda, kemudian atur application default credentials:

gcloud auth application-default login

Untuk Microsoft Foundry, konfirmasi ANTHROPIC_FOUNDRY_API_KEY diatur, atau sign in dengan Azure CLI sehingga default credential chain dapat menemukan akun Anda:

az login

Jika credentials berfungsi di terminal Anda tetapi tidak di VS Code atau JetBrains extension, proses IDE mungkin tidak mewarisi environment shell Anda. Atur variabel environment provider di pengaturan IDE itu sendiri, atau luncurkan IDE dari terminal di mana mereka sudah diekspor. Lihat Amazon Bedrock, Google Vertex AI, atau Microsoft Foundry untuk setup provider lengkap.

Still stuck

Jika tidak ada di atas yang menyelesaikan masalah Anda:

Periksa GitHub repository untuk known issues, atau buka yang baru dengan sistem operasi Anda, perintah install yang Anda jalankan, dan output error lengkap
Jika claude --version berfungsi tetapi sesuatu yang lain salah, jalankan claude doctor untuk laporan diagnostik otomatis
Jika Anda dapat memulai sesi, gunakan /feedback di dalam Claude Code untuk melaporkan masalah

Agen

Alat dan plugin

Otomasi

Pemecahan Masalah

Troubleshoot installation and login

Temukan kesalahan Anda

Jalankan pemeriksaan diagnostik

Periksa konektivitas jaringan

Verifikasi PATH Anda

Periksa instalasi yang bertentangan

Periksa izin direktori

Verifikasi binary berfungsi

Masalah instalasi umum

Install script returns HTML instead of a shell script

`command not found: claude` after installation

`curl: (56) Failure writing output to destination`

TLS or SSL connection errors

`Failed to fetch version from downloads.claude.ai`

Wrong install command on Windows

Install killed on low-memory Linux servers

Install hangs in Docker

Claude Desktop overrides the `claude` command on Windows

Claude Code on Windows requires Git Bash

Claude Code does not support 32-bit Windows

Linux musl or glibc binary mismatch

`Illegal instruction`

`dyld: cannot load` on macOS

`Exec format error` on WSL1

npm install errors in WSL

Permission errors during installation

Native binary not found after npm install

OAuth error: Invalid code

This organization has been disabled with an active subscription

Not logged in or token expired

Bedrock, Vertex, or Foundry credentials not loading

Still stuck

Agen

Alat dan plugin

Otomasi

Pemecahan Masalah

Documentation Index

​Temukan kesalahan Anda

​Jalankan pemeriksaan diagnostik

​Periksa konektivitas jaringan

​Verifikasi PATH Anda

​Periksa instalasi yang bertentangan

​Periksa izin direktori

​Verifikasi binary berfungsi

​Masalah instalasi umum

​Install script returns HTML instead of a shell script

​command not found: claude after installation

​curl: (56) Failure writing output to destination

​TLS or SSL connection errors

​Failed to fetch version from downloads.claude.ai

​Wrong install command on Windows

​Install killed on low-memory Linux servers

​Install hangs in Docker

​Claude Desktop overrides the claude command on Windows

​Claude Code on Windows requires Git Bash

​Claude Code does not support 32-bit Windows

​Linux musl or glibc binary mismatch

​Illegal instruction

​dyld: cannot load on macOS

​Exec format error on WSL1

​npm install errors in WSL

​Permission errors during installation

​Native binary not found after npm install

​Login and authentication

​Reset your login

​OAuth error: Invalid code

​403 Forbidden after login

​This organization has been disabled with an active subscription

​OAuth login fails in WSL2

​Not logged in or token expired

​Bedrock, Vertex, or Foundry credentials not loading

​Still stuck

Temukan kesalahan Anda

Jalankan pemeriksaan diagnostik

Periksa konektivitas jaringan

Verifikasi PATH Anda

Periksa instalasi yang bertentangan

Periksa izin direktori

Verifikasi binary berfungsi

Masalah instalasi umum

Install script returns HTML instead of a shell script

`command not found: claude` after installation

`curl: (56) Failure writing output to destination`

TLS or SSL connection errors

`Failed to fetch version from downloads.claude.ai`

Wrong install command on Windows

Install killed on low-memory Linux servers

Install hangs in Docker

Claude Desktop overrides the `claude` command on Windows

Claude Code on Windows requires Git Bash

Claude Code does not support 32-bit Windows

Linux musl or glibc binary mismatch

`Illegal instruction`

`dyld: cannot load` on macOS

`Exec format error` on WSL1

npm install errors in WSL

Permission errors during installation

Native binary not found after npm install

Login and authentication

Reset your login

OAuth error: Invalid code

403 Forbidden after login

This organization has been disabled with an active subscription

OAuth login fails in WSL2

Not logged in or token expired

Bedrock, Vertex, or Foundry credentials not loading

Still stuck