Pemecahan masalah instalasi dan login

Perbaiki kesalahan command not found, PATH, izin, jaringan, dan autentikasi saat menginstal atau masuk ke Claude Code.

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 hook tidak berfungsi, lihat Debug your configuration.

Temukan kesalahan Anda

Cocokkan pesan kesalahan atau gejala yang Anda lihat dengan perbaikan:

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

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

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

Anda menjangkau server jika baris pertama menunjukkan status 200. Anda melihat HTTP/2 200 di macOS dan Linux, dan HTTP/1.1 200 OK dari curl.exe yang disertakan dengan Windows. Hasil lainnya menunjukkan penyebabnya:

• 403: biasanya proxy atau filter jaringan memblokir host, atau Claude Code tidak tersedia di wilayah Anda
• 5xx: biasanya masalah layanan sementara; tunggu beberapa menit dan coba lagi

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:

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.

Installer mendeteksi kasus ini dan melaporkannya di bawah Setup notes: dalam output-nya: Native installation exists but ~/.local/bin is not in your PATH. di macOS dan Linux, atau Native installation exists but C:\Users\you\.local\bin is not in your PATH. di Windows. Installer mencetak perbaikannya bersama catatan tersebut tetapi tidak mengubah PATH sendiri.

Pertama, periksa apakah program tersebut memang ada, lalu periksa apakah foldernya ada di PATH Anda. Perbaikan PATH bersifat permanen, jadi Anda cukup menerapkannya sekali. Pilih tab platform Anda dan jalankan perintahnya di sana: di terminal Anda di macOS dan Linux, atau di PowerShell atau Command Prompt di Windows.

ls -la ~/.local/bin/claude

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

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

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

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

claude --version

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

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

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

claude --version

dir "%USERPROFILE%\.local\bin\claude.exe"

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

claude --version

Periksa instalasi yang bertentangan

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

which -a claude

ls -la ~/.local/bin/claude

ls -la ~/.claude/local/

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

where.exe claude

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

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

Instalasi yang gagal karena izin akan menyebutkan path yang tidak dapat dibuat atau ditulisnya. Di Windows, instalasi menulis di bawah %USERPROFILE%, yang dapat ditulis oleh pengguna Anda secara default, jadi bagian ini jarang berlaku di sana.

Di macOS dan Linux, instalasi menulis ke lokasi-lokasi berikut:

• ~/.claude/downloads/: tempat perintah instalasi menyimpan binary yang diunduh
• ~/.local/bin/: launcher claude
• ~/.local/share/claude/: setiap versi yang diunduhnya
• ~/.local/state/claude/: file lock-nya
• ~/.cache/claude/: unduhan yang di-stage
• ~/.claude.json: file konfigurasi global Anda, tempat installer mencatat metode instalasi

Jika Anda mengatur XDG_DATA_HOME, XDG_STATE_HOME, atau XDG_CACHE_HOME, instalasi menggunakan lokasi tersebut sebagai pengganti ~/.local/share, ~/.local/state, dan ~/.cache. Jika Anda mengatur CLAUDE_CONFIG_DIR, file konfigurasi global berada di bawah direktori tersebut alih-alih di direktori home Anda.

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 Verifikasi PATH Anda terlebih dahulu; perintah di bawah mengasumsikan claude ada di PATH Anda.

Konfirmasi binary ada dan dapat dieksekusi:

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

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

Perintah install gagal dengan salah satu error berikut ketika yang diunduhnya bukan script instalasi.

Bash atau Zsh: error mengutip baris pertama dari halaman yang dikembalikan.

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

PowerShell, parse errors: error menunjuk ke halaman yang dikembalikan, dengan iex mencoba menjalankan HTML dan CSS sebagai PowerShell.

iex : At line:1 char:2310
+ ... igin="anonymous"/><script type="text/javascript">!function(o,c){var n ...
Missing argument in parameter list.
...

Kata-katanya bervariasi dengan versi PowerShell dan bahasa sistem: Anda mungkin melihat Missing expression after unary operator '--' atau ParserError dengan ParseException sebagai gantinya. Tag HTML atau CSS dalam teks yang dikutip mengidentifikasi kegagalan ini. Jika Anda mengunduh dengan -OutFile install.ps1 sebagai gantinya, file yang disimpan adalah halaman web yang sama, jadi itu tidak membantu juga.

PowerShell, System.Xml.XmlDocument: error menyebutkan tipe ini alih-alih mengutip halaman.

System.Xml.XmlDocument : The term 'System.Xml.XmlDocument' is not recognized as the name of a cmdlet, function, script
file, or operable program.

Ketika irm dapat mem-parse respons sebagai XML, ia mengembalikan objek XML alih-alih teks, lalu iex mencoba menjalankan nama tipe objek tersebut sebagai perintah. Script instalasi adalah kode PowerShell dan tidak dapat di-parse sebagai XML, jadi error ini juga berarti respons tersebut adalah sesuatu selain script. Kata-kata di sekitar nama tipe bervariasi dengan versi PowerShell dan bahasa sistem, tetapi System.Xml.XmlDocument itu sendiri tetap sama, jadi cocokkan berdasarkan nama tipe.

CMD: Anda melihat error ini, diikuti oleh HTML dari halaman yang dikembalikan.

< was unexpected at this time.

C:\Users\you><!DOCTYPE html>...

Baris pertama muncul dalam bahasa sistem Anda, jadi cari HTML yang mengikutinya.

403 tanpa halaman: tergantung pada bagaimana permintaan dirutekan, curl melaporkan status 403 tanpa body HTML.

curl: (22) The requested URL returned error: 403

Semuanya berarti URL instalasi mengembalikan halaman web, dokumen XML, atau status error alih-alih script instalasi. Jika output error mengutip "App unavailable in region," Claude Code tidak tersedia di negara Anda. Lihat supported countries.

403 tanpa body sering memiliki penyebab yang sama, tetapi juga dapat berasal dari proxy perusahaan atau firewall yang memblokir download. Jika Anda berada di negara yang didukung dan masih melihat 403, kerjakan Check network connectivity sebelum mencoba installer alternatif di bawah, karena installer tersebut menjangkau host yang sama.

Sebaliknya, ini dapat terjadi karena masalah jaringan, routing regional, atau gangguan layanan sementara.

Solusi:

1. Coba lagi setelah beberapa menit: masalahnya sering bersifat sementara. Tunggu dan coba perintah asli lagi.

2. Gunakan metode instalasi alternatif: tidak seperti instalasi native, instalasi Homebrew atau WinGet tidak memperbarui dirinya sendiri secara default.

   Di macOS, instal melalui Homebrew:

   brew install --cask claude-code
   

   Di Windows, instal melalui WinGet:

   winget install Anthropic.ClaudeCode
   

   Kemudian jalankan claude --version untuk mengonfirmasi: perintah mencetak nomor versi seperti 2.1.211 (Claude Code). Jika shell melaporkan claude tidak ditemukan, buka jendela terminal baru dan coba ulang: sesi tempat Anda menginstal menyimpan PATH lamanya.

`command not found: claude` after installation

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

Di Windows, jika error mulai muncul tepat setelah Claude Code diperbarui, lihat pulihkan claude.exe dari backup-nya.

Jika tidak, lihat Verify your PATH untuk perbaikan di setiap platform.

`permission denied` when adding to your PATH

Jika perintah echo yang menambahkan ~/.local/bin ke PATH Anda mencetak zsh: permission denied: /Users/you/.zshrc atau bash: /home/you/.bashrc: Permission denied, pengguna Anda tidak dapat menulis ke file tersebut dan tidak ada yang disimpan. Di terminal Anda, periksa siapa pemilik file tersebut, menggunakan nama file shell Anda sebagai pengganti ~/.zshrc:

ls -l ~/.zshrc

Kolom ketiga dari output adalah pemiliknya.

• Pemiliknya adalah pengguna lain, seperti root: ambil alih kepemilikan dengan sudo chown $(whoami) ~/.zshrc, yang memerlukan hak administrator.
• Pemiliknya adalah Anda: file tersebut read-only. Jadikan dapat ditulis dengan chmod u+w ~/.zshrc.

Kemudian jalankan lagi dua perintah PATH untuk shell Anda di Verify your PATH.

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

Perintah curl ... | bash mengunduh script dan menyalurkannya ke Bash untuk dieksekusi. Error ini, dan error terkait curl: (23) Failure writing output to destination, berarti Bash tidak menerima script lengkap. Exit code 56 menunjukkan download itu sendiri terputus, dan exit code 23 menunjukkan curl tidak dapat menulis apa yang diterima ke pipe, biasanya karena Bash keluar lebih awal.

Uji bahwa Anda dapat menjangkau downloads.claude.ai dengan pemeriksaan di Check network connectivity. Jika Anda menjangkau server, kegagalan asli mungkin bersifat intermiten; coba ulang perintah install. Anda juga dapat mencoba metode instalasi alternatif.

Homebrew cask unavailable or outdated

Homebrew melaporkan Error: Cask 'claude-code' is unavailable: No Cask with this name exists ketika salinan lokal indeks cask Homebrew Anda mendahului publikasi cask. Segarkan indeks dan coba ulang:

brew update
brew install --cask claude-code

Jika Homebrew menginstal versi Claude Code yang lebih lama dari yang Anda harapkan, indeks yang sudah usang biasanya menjadi penyebabnya. Cask claude-code melacak saluran stabil dan biasanya tertinggal sekitar satu minggu dari rilis terbaru; untuk versi terbaru jalankan brew install --cask claude-code@latest sebagai gantinya. Lihat Configure release channel untuk perbedaan antara dua cask.

`Cask 'claude-code@latest' is not installed`

Homebrew menawarkan dua cask, claude-code dan claude-code@latest. Menjalankan brew upgrade --cask claude-code@latest ketika cask tersebut bukan yang terinstal akan mencetak Error: Cask 'claude-code@latest' is not installed. Untuk melihat cask mana yang Anda miliki, jalankan ini di terminal Anda:

brew list --cask | grep claude-code

Upgrade cask yang dicetaknya. Jika tidak mencetak apa pun, tidak ada cask yang terinstal.

TLS or SSL connection errors

Error seperti ini berarti TLS handshake gagal:

• curl: (35) TLS connect error
• schannel: next InitializeSecurityContext failed
• PowerShell's Could not create SSL/TLS secure channel
• PowerShell's Could not establish trust relationship for the SSL/TLS secure channel

Untuk CRYPT_E_NO_REVOCATION_CHECK atau CRYPT_E_REVOCATION_OFFLINE, langsung ke langkah 4.

Solusi:

1. 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.

2. Di Windows PowerShell 5.1, aktifkan TLS 1.2:

   [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
   

   Kemudian jalankan installer di jendela yang sama:

   irm https://claude.ai/install.ps1 | iex
   

3. Periksa gangguan proxy atau firewall: proxy perusahaan 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 download install untuk mempercayai CA proxy perusahaan Anda:

   macOS/Linux Windows PowerShell

   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:

   macOS/Linux Windows PowerShell

   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 mengonfirmasi proxy adalah penyebabnya.

4. Di Windows, lewati pemeriksaan revokasi sertifikat yang diblokir. Error CRYPT_E_NO_REVOCATION_CHECK (0x80092012) dan CRYPT_E_REVOCATION_OFFLINE (0x80092013) berarti curl menjangkau server tetapi jaringan Anda memblokir pencarian revokasi sertifikat, yang umum di belakang firewall perusahaan. Jika perintah yang gagal adalah curl yang mengunduh install.cmd, jalankan ulang dari Command Prompt dengan --ssl-revoke-best-effort ditambahkan:

   curl --ssl-revoke-best-effort -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
   

   Ketika download script itu sendiri mengalami error yang sama, script mencoba ulang dengan pemeriksaan revokasi best-effort secara otomatis, jadi flag hanya diperlukan pada perintah yang Anda jalankan sendiri. Pemeriksaan best-effort mentoleransi server revokasi yang tidak dapat dijangkau tetapi masih menolak sertifikat yang diketahui telah dicabut, sesuai dengan cara browser menangani revokasi. Anda juga dapat menghindari pemeriksaan revokasi curl sepenuhnya dengan menjalankan PowerShell installer dari PowerShell, yang mengunduh melalui .NET dan tidak gagal ketika server revokasi tidak dapat dijangkau:

   irm https://claude.ai/install.ps1 | iex
   

   Anda juga dapat menginstal 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. Lihat Check network connectivity.

The connection dropped while downloading the update

Koneksi ke server download tertutup saat claude install atau claude update sedang mengambil binary Claude Code, dan retry tidak berhasil memulihkannya. Claude Code mencoba ulang download ketika koneksi terputus, transfer macet, atau file yang diunduh gagal dalam pemeriksaan checksum, hingga total tiga kali percobaan. Error HTTP yang sudah selesai, seperti 404, tidak dicoba ulang karena server sudah menjawab. Sebelum v2.1.202, satu koneksi yang terputus langsung menggagalkan download dengan error polos aborted alih-alih mencoba ulang.

The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.

Teks dalam tanda kurung menyebutkan percobaan mana yang gagal dan error jaringan yang mendasarinya. claude update mendahului pesan tersebut dengan Error: Failed to install native update di stderr.

Download yang tetap terhubung tetapi tidak selesai dalam 10 menit gagal dengan Download timed out: exceeded the total deadline sebagai gantinya. Claude Code tidak mencoba ulang download yang timeout, karena koneksi yang terlalu lambat untuk selesai dalam batas waktu juga tidak akan selesai pada retry langsung. Langkah-langkah di bawah berlaku untuk kedua pesan.

Proxy atau gateway dapat menutup transfer yang panjang sebelum selesai, dan binary Claude Code adalah download yang besar.

Yang harus dilakukan:

• Jalankan claude update lagi. Pada jaringan yang selain itu sehat, download biasanya berhasil pada percobaan berikutnya. Untuk pesan timeout, jalankan lagi dari jaringan yang lebih cepat atau kurang dibatasi.
• Jika jaringan Anda memerlukan proxy, atur HTTPS_PROXY sebelum menjalankan installer atau claude update. Lihat Check network connectivity.
• Jika proxy perusahaan terus menutup transfer, minta tim jaringan Anda untuk mengizinkan download penuh dari downloads.claude.ai. Lihat Network access requirements.
• Jalankan claude doctor dari shell Anda untuk diagnostik instalasi

Wrong install command on Windows

Jika Anda melihat 'irm' is not recognized, The token '&&' is not a valid statement separator, A parameter cannot be found that matches parameter name 'fsSL', atau 'bash' is not recognized as the name of a cmdlet, Anda menyalin perintah install untuk shell atau sistem operasi yang berbeda. Jika perintah mencetak teks script alih-alih menginstal apa pun, Anda menjalankan hanya sebagian darinya.

• 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 a valid statement separator: Anda berada di PowerShell tetapi menjalankan perintah CMD installer. Gunakan PowerShell installer:

  irm https://claude.ai/install.ps1 | iex
  

• A parameter cannot be found that matches parameter name 'fsSL': Anda menjalankan installer macOS/Linux curl -fsSL ... | bash di Windows PowerShell, di mana curl adalah alias untuk Invoke-WebRequest dan menolak flag -fsSL. Gunakan PowerShell installer sebagai gantinya:

  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
  

• Perintah mencetak teks script alih-alih menginstal: Anda menjalankan bagian download dari perintah tanpa bagian yang mengeksekusinya. irm https://claude.ai/install.ps1 sendirian mencetak script yang diunduh ke terminal. Salurkan ke iex untuk menjalankannya:

  irm https://claude.ai/install.ps1 | iex
  

  Di CMD, curl -fsSL https://claude.ai/install.cmd tanpa -o mencetak batch script alih-alih menyimpannya. Jalankan perintah lengkap:

  curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
  

Installer mana pun yang Anda gunakan, konfirmasi itu berfungsi: buka terminal baru dan jalankan claude --version, yang mencetak nomor versi seperti 2.1.211 (Claude Code).

`running scripts is disabled on this system`

Menginstal atau menjalankan Claude Code melalui npm di Windows dapat gagal dengan SecurityError:

npm : File C:\Program Files\nodejs\npm.ps1 cannot be loaded because running scripts is disabled on this system. For more information, see about_Execution_Policies at https:/go.microsoft.com/fwlink/?LinkID=135170.
...
    + CategoryInfo          : SecurityError: (:) [], PSSecurityException

Error yang sama menyebutkan claude.ps1 ketika Anda menjalankan claude setelah npm install. Kebijakan eksekusi PowerShell memblokir script launcher .ps1 yang npm buat untuk perintahnya. Kebijakan berlaku untuk file script, jadi tidak mempengaruhi PowerShell installer irm https://claude.ai/install.ps1 | iex, yang menjalankan teks yang diunduh secara langsung.

Solusi:

1. Izinkan script yang dibuat secara lokal untuk pengguna Anda, kemudian coba ulang:

   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
   

2. Panggil launcher .cmd sebagai gantinya: npm.cmd dan claude.cmd melakukan pekerjaan yang sama, dan kebijakan tidak mencakup mereka.
3. Gunakan PowerShell installer alih-alih npm. Ini menginstal binary alih-alih script .ps1.

`The process cannot access the file` during Windows install

Jika PowerShell installer gagal dengan Failed to download binary: The process cannot access the file ... because it is being used by another process, installer tidak dapat menulis ke %USERPROFILE%\.claude\downloads. Ini biasanya berarti upaya install sebelumnya masih berjalan, atau software antivirus memindai binary yang sebagian diunduh di folder itu.

Tutup jendela PowerShell lain yang menjalankan installer dan tunggu pemindaian antivirus melepaskan file. Kemudian hapus folder downloads dan jalankan installer lagi:

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"
irm https://claude.ai/install.ps1 | iex

`claude.exe` missing after an update on Windows

Jika terminal Anda melaporkan 'claude' is not recognized tepat setelah Claude Code diperbarui di Windows, periksa apakah %USERPROFILE%\.local\bin masih berisi claude.exe. Jika direktori itu tidak ada di PATH Anda sama sekali, lihat Verify your PATH sebagai gantinya. Untuk memperbarui di Windows, Claude Code mengganti nama claude.exe yang ada ke samping sebagai backup dan memindahkan versi baru ke tempatnya. Jika memindahkan versi baru ke tempat gagal dan Claude Code tidak dapat mengganti nama backup kembali juga, direktori menyimpan backup tetapi tidak memiliki claude.exe.

Backup adalah file di direktori yang sama yang namanya dimulai dengan claude.exe.old. diikuti oleh timestamp numerik. Jalankan yang berikut di PowerShell untuk mengganti nama backup terbaru kembali ke claude.exe:

Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe

Kemudian jalankan claude --version untuk mengonfirmasi perbaikan. claude.exe yang dipulihkan mencetak nomor versi.

Jika tidak ada file claude.exe.old.*, atau claude masih gagal setelah penggantian nama, instal ulang sebagai gantinya:

irm https://claude.ai/install.ps1 | iex

Sebelum v2.1.281, Claude Code dapat menghapus backup sementara claude.exe masih hilang.

Install killed on low-memory Linux servers

Pesan Killed selama install biasanya berarti Linux out-of-memory (OOM) killer menghentikan langkah claude install karena sistem kehabisan memori bebas. Ini umum di VPS dan cloud instance kecil. Script install melaporkan penyebabnya dan keluar dengan kode 137. Dalam contoh ini, nomor baris dan ID proses bervariasi menurut rilis dan eksekusi:

Setting up Claude Code...
bash: line 183: 34803 Killed    "$binary_path" install ${TARGET:+"$TARGET"}
Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.
Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.

Instalasi memerlukan kira-kira 512 MB memori bebas, dan menjalankan Claude Code memerlukan lebih banyak. Lihat system requirements.

Solusi:

1. 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
   

2. Tutup proses lain untuk membebaskan memori sebelum menginstal.

3. Gunakan instance yang lebih besar jika memungkinkan. Claude Code memerlukan setidaknya 4 GB RAM.

Installation was killed before it could finish

Script install melaporkan ketika langkah claude install dihentikan oleh sinyal. Di Linux, exit code 137 berarti proses menerima SIGKILL, dan pada host dengan memori rendah itu biasanya adalah kernel out-of-memory (OOM) killer. Script mencetak penjelasan ini dan keluar dengan kode 137:

Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.
Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.

Untuk sinyal fatal lainnya, dan untuk exit code 137 di macOS, script mencetak Installation was killed before it could finish (exit code <N>) dengan exit code yang sebenarnya dan menghilangkan penjelasan out-of-memory. Pesan ini berasal dari script install yang digunakan macOS dan Linux, yang juga mencakup instalasi di dalam WSL; script install Windows native tidak pernah mencetaknya. Sebelum v2.1.200, script keluar hanya dengan baris Killed polos dari shell.

Yang harus dilakukan:

• Hentikan proses lain untuk membebaskan memori, lalu jalankan ulang installer
• Tambahkan swap space atau pindah ke instance yang lebih besar. Lihat Install killed on low-memory Linux servers untuk perintah file swap.

Install hangs in Docker

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

Solusi:

1. Atur direktori kerja 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
   

2. Berikan Docker lebih banyak memori jika menggunakan Docker Desktop. Container build berbagi memori yang dialokasikan ke virtual machine Docker Desktop, jadi buka Settings > Resources di Docker Desktop, naikkan batas memori, dan jalankan ulang build.

`Raw mode is not supported` during install

Ketika server-managed settings organisasi Anda menyertakan perubahan yang memerlukan security approval, versi Claude Code sebelum 2.1.246 mencoba menampilkan dialog persetujuan selama claude install. Dialog memerlukan terminal di stdin. Ketika installer menjalankan claude install dari pipe, seperti yang dilakukan curl -fsSL https://claude.ai/install.sh | bash, stdin adalah pipe alih-alih terminal, jadi install gagal dengan error yang berisi Raw mode is not supported.

Claude Code v2.1.246 dan lebih baru tidak menampilkan dialog selama claude install atau claude update. Perintah berjalan dengan pengaturan yang terakhir Anda setujui, dan Claude Code menampilkan dialog di sesi interaktif Anda berikutnya. Jika konfigurasi startup organisasi Anda menunggu pengambilan pengaturan, seperti ketika mengatur forceRemoteSettingsRefresh, dialog masih muncul selama perintah ini, dan install yang dijalankan dari pipe masih gagal.

Di setiap konfigurasi lain, menjalankan ulang installer melewati error ini, karena script menjalankan perintah install rilis terbaru bahkan ketika Anda memintanya untuk menginstal versi yang lebih lama. Jalankan ulang perintah untuk platform Anda:

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

irm https://claude.ai/install.ps1 | iex

claude --version mencetak versi yang diinstal oleh eksekusi ulang tersebut.

`claude update` or `claude doctor` hangs

claude update dan claude doctor memindai file konfigurasi shell Anda untuk alias claude yang sudah usang: ~/.zshrc, ~/.bashrc, dan ~/.config/fish/config.fish, plus di macOS yang pertama dari ~/.bash_profile, ~/.bash_login, atau ~/.profile yang ada. Jika Anda mengatur ZDOTDIR, file Zsh adalah $ZDOTDIR/.zshrc sebagai gantinya. Ketika salah satu path tersebut adalah direktori, Claude Code melewatinya dan kedua perintah selesai secara normal. Sebelum v2.1.214, direktori di salah satu path tersebut membuat kedua perintah hang dan meninggalkan bagian System diagnostics dari /status kosong. claude doctor hang tanpa output; claude update hang tepat setelah mencetak Checking for updates.

Jika Anda mengalami hang pada versi sebelumnya, temukan direktorinya. Dalam output perintah ini, baris yang dimulai dengan d menandai path itu sebagai direktori. Baris No such file or directory berarti tidak ada apa pun di path itu dan bukan penyebabnya:

ls -ld ~/.zshrc ~/.bashrc ~/.bash_profile ~/.bash_login ~/.profile ~/.config/fish/config.fish

Pindahkan direktori ke samping, atau perbarui ke v2.1.214 atau lebih baru. Karena claude update hang pada versi yang terpengaruh, perbarui dengan menjalankan ulang install script sebagai gantinya.

Claude Desktop overrides the `claude` command on Windows

Jika Anda menginstal versi Claude Desktop yang lebih lama, aplikasi tersebut mungkin mendaftarkan Claude.exe di direktori WindowsApps yang mendapat 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 either Git for Windows (for bash) or PowerShell

Git for Windows bersifat opsional. Claude Code menggunakan PowerShell tool saat Git Bash tidak ada, jadi error ini berarti tidak ada shell yang ditemukan.

Jika PowerShell hilang dari PATH Anda, lokasi defaultnya adalah C:\Windows\System32\WindowsPowerShell\v1.0\. Tambahkan direktori itu ke PATH Anda, atau instal PowerShell 7, yang menyediakan pwsh.

Untuk menginstal Git for Windows sebagai gantinya, unduh dari git-scm.com/downloads/win. Selama setup, pilih "Add to PATH." Restart terminal Anda setelah menginstal. Menginstalnya mengaktifkan Bash tool, berguna saat bekerja dengan script dan tooling berbasis Bash.

Jika Git sudah terinstal tetapi Claude Code tidak dapat menemukannya, bandingkan lokasinya dengan tempat yang diperiksa Claude Code. Ketika CLAUDE_CODE_GIT_BASH_PATH tidak diatur, Claude Code mencari bash.exe dalam urutan ini:

1. Lokasi instalasi default C:\Program Files\Git dan C:\Program Files (x86)\Git.
2. git di PATH Anda, menggunakan bin\bash.exe dari instalasi Git itu.

Di langkah 2, Claude Code melewati git yang berada di folder tempat Anda meluncurkan Claude Code, atau di bawahnya di path yang berisi node_modules atau folder virtual-environment seperti .venv atau env, misalnya C:\dev\env\myproject\Git ketika Anda meluncurkan dari C:\dev\env\myproject. Ini mencegah Claude Code menjalankan executable yang ditempatkan proyek di sana. Jika Git Anda berada di lokasi seperti itu, arahkan CLAUDE_CODE_GIT_BASH_PATH ke sana.

Untuk mengarahkan Claude Code ke instalasi Git tertentu, temukan dengan menjalankan where.exe git di PowerShell, kemudian atur path bin\bash.exe dari instalasi itu sebagai CLAUDE_CODE_GIT_BASH_PATH di file settings.json Anda:

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

Jika CLAUDE_CODE_GIT_BASH_PATH diatur ke path yang benar dan file ada tetapi Claude Code masih tidak menggunakannya, periksa nama file terlebih dahulu. Claude Code hanya menerima file bernama bash.exe, sh.exe, bash, atau sh; dengan nama lain, seperti launcher git-bash.exe milik Git for Windows, Claude Code mengabaikan variabel dan mendeteksi Git Bash secara otomatis seolah-olah variabel tidak diatur, sambil mencatat warning yang terlihat dengan --debug. Path yang tidak ada mendapat fallback dan warning yang sama. Sebelum v2.1.219, Claude Code menggunakan file apa pun yang ada sebagai shell tanpa memeriksa namanya, dan keluar saat startup dengan Claude Code was unable to find CLAUDE_CODE_GIT_BASH_PATH path ketika path tidak ada.

Jika nama file benar, software endpoint security seperti AppLocker, Group Policy software restriction policies, atau EDR agent mungkin mengganggu. Minta tim IT Anda untuk memasukkan claude.exe dan proses yang dijalankannya, termasuk cmd.exe dan bash.exe, ke allowlist dalam kebijakan endpoint protection Anda.

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 varian binary 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:

1. 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.

2. 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. Buat GitHub issue dengan output ldd --version dan ls /lib/libc.musl*.

3. Jika Anda benar-benar di musl, seperti Alpine Linux, instal paket yang diperlukan:

   apk add libgcc libstdc++ ripgrep
   

   Di Alpine, ripgrep berada di community repository. Jika apk melaporkan bahwa paket hilang, lihat Alpine Linux setup.

`Illegal instruction`

Jika menjalankan claude atau installer mencetak Illegal instruction, binary native menggunakan instruksi CPU yang tidak didukung prosesor Anda. Ada dua penyebab yang berbeda.

Ketidakcocokan arsitektur. 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, buat GitHub issue dengan output tersebut.

Set instruksi AVX tidak ada. Jika arsitektur Anda benar tetapi Anda masih melihat Illegal instruction, CPU Anda mungkin tidak memiliki AVX atau instruksi lain yang diperlukan binary. Ini mempengaruhi kira-kira prosesor Intel dan AMD sebelum 2013, dan virtual machine di mana hypervisor tidak meneruskan AVX ke guest.

Di VPS atau VM, jalankan grep -m1 -ow avx /proc/cpuinfo; hasil kosong berarti AVX tidak tersedia untuk guest.

Tidak ada workaround untuk binary native; pantau issue #50384 untuk status, dan sertakan model CPU Anda dari grep -m1 "model name" /proc/cpuinfo 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 mana pun.

`dyld: cannot load` on macOS

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

Error Symbol not found yang mereferensikan libicucore berarti versi macOS Anda lebih lama dari yang didukung binary:

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

Loader dapat juga menolak load commands binary, yang juga berarti versi macOS Anda terlalu lama:

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

Solusi:

1. 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.

2. Perbarui macOS jika Anda berada di versi yang lebih lama. Binary menggunakan load commands dan system libraries yang tidak didukung versi macOS yang lebih lama. Metode instalasi alternatif seperti Homebrew mengunduh binary yang sama dan tidak akan menyelesaikan error ini.

`Bus error` while a session is running

Jika sesi yang sedang berjalan keluar dan shell Anda mencetak Bus error, salah satu penyebabnya adalah Claude Code tidak lagi dapat membaca file executable-nya sendiri dari disk. Misalnya, file tersebut terpotong, atau dihapus di network storage, saat sesi berjalan.

Sebelum pesan dari shell, runtime Claude Code dapat mencetak laporan crash yang menyertakan panic(main thread): Bus error at address dan oh no: Bun has crashed. This indicates a bug in Bun, not your code. Ketika executable menjadi tidak dapat dibaca, crash berasal dari file yang tidak dapat dibaca, bukan dari bug di Bun. Laporan tersebut juga bisa tidak muncul, jika runtime juga tidak dapat membaca kode yang mencetaknya.

Mulai sesi baru untuk melanjutkan. Jika Claude Code diinstal di network storage, ikuti Install on network storage agar upgrade tidak menghapus binary yang masih dibutuhkan oleh sesi yang sedang berjalan.

`Exec format error` on WSL1

Jika menjalankan claude di WSL mencetak cannot execute binary file: Exec format error, Anda berada di WSL1 dan mengalami regresi binary native yang sudah diketahui dan dilacak di issue #38788. Program headers binary berubah dengan cara yang tidak dapat ditangani oleh loader WSL1.

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.

Masalah deteksi OS atau platform. Jika npm melaporkan ketidakcocokan platform selama instalasi, WSL mungkin mengambil npm Windows. 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.

Konflik versi nvm. Jika Anda memiliki nvm terinstal di WSL dan Windows, beralih versi Node di WSL mungkin rusak karena WSL mengimpor PATH Windows secara default dan nvm Windows mendapat 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 mendapat prioritas, tambahkan path Node Linux Anda di depan secara eksplisit:

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

Permission errors during installation

Jika native installer gagal dengan error permission, direktori target mungkin tidak dapat ditulis. Lihat Check directory permissions.

Jika Anda sebelumnya menginstal dengan npm dan mengalami error permission khusus npm, 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 mengunduh binary native sebagai optional dependency per platform, seperti @anthropic-ai/claude-code-darwin-arm64. npm kemudian menjalankan postinstall script paket, yang menyalin binary itu ke tempatnya sebagai perintah claude; sampai script itu berjalan, claude adalah script placeholder. Jika download atau langkah postinstall dilewati, placeholder tetap ada, dan menjalankan claude di macOS dan Linux mencetak:

Error: claude native binary not installed.

Either postinstall did not run (--ignore-scripts, some pnpm configs)
or the platform-native optional dependency was not downloaded
(--omit=optional).

Run the postinstall manually (adjust path for local vs global install):
  node node_modules/@anthropic-ai/claude-code/install.cjs

Or reinstall without --ignore-scripts / --omit=optional.

Di Windows, bin/claude.exe adalah script placeholder yang sama alih-alih executable nyata, jadi PowerShell dan CMD melaporkan bahwa mereka tidak dapat menjalankan file alih-alih mencetak pesan ini.

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 fallback JavaScript jika dilewati, dan menjalankan install.cjs lagi tidak dapat menempatkan binary yang tidak pernah diunduh.
• Install scripts dinonaktifkan. --ignore-scripts dan beberapa konfigurasi pnpm melewati langkah postinstall tetapi masih mengunduh paket platform. Jalankan node node_modules/@anthropic-ai/claude-code/install.cjs seperti yang disarankan pesan, atau instal ulang tanpa flag. Jika postinstall tidak dapat berjalan di lingkungan Anda sama sekali, node node_modules/@anthropic-ai/claude-code/cli-wrapper.cjs menemukan paket yang diunduh dan meluncurkannya, dengan biaya proses Node tambahan di setiap start. Jika wrapper mencetak Could not find native binary package sebagai gantinya, paket platform tidak pernah diunduh, jadi perbaiki penyebab optional-dependencies di atas terlebih dahulu.
• 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 menyediakan binary untuk platform lain; lihat system requirements. Di FreeBSD, installer melaporkan platform sebagai tidak didukung. Sebelum v2.1.205, installer memperlakukan FreeBSD sebagai Linux dan mengunduh binary yang tidak dapat dijalankan.
• Mirror npm perusahaan tidak memiliki paket platform. Pastikan registry Anda mencerminkan kedelapan paket platform @anthropic-ai/claude-code-* selain paket meta.

npm `ENOTEMPTY` error during update or reinstall

Ketika Anda menjalankan npm install -g @anthropic-ai/claude-code di atas instalasi yang ada, npm dapat gagal saat memindahkan direktori paket lama ke samping:

npm error code ENOTEMPTY
npm error syscall rename
npm error path /home/you/.nvm/versions/node/v22.13.1/lib/node_modules/@anthropic-ai/claude-code
npm error dest /home/you/.nvm/versions/node/v22.13.1/lib/node_modules/@anthropic-ai/.claude-code-tVWAnUUt
npm error errno -39
npm error ENOTEMPTY: directory not empty, rename '...'

Baris npm error path menyebutkan direktori yang tidak dapat dipindahkan npm. Hapus direktori itu dan direktori .claude-code-* sisa apa pun di sebelahnya, yang dapat ditinggalkan oleh eksekusi sebelumnya yang terputus. Perintah di bawah menemukan direktori paket global Anda dengan npm root -g; jika direktori yang disebutkan baris npm error path tidak berada di bawah direktori yang dicetak npm root -g, misalnya karena Anda beralih versi Node dengan nvm, hapus direktori yang disebutkan error sebagai gantinya:

rm -rf "$(npm root -g)/@anthropic-ai/claude-code"

rm -rf "$(npm root -g)/@anthropic-ai/.claude-code-"*

Remove-Item -Recurse -Force "$(npm root -g)/@anthropic-ai/claude-code", "$(npm root -g)/@anthropic-ai/.claude-code-*"

Kemudian instal ulang:

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

Konfirmasi dengan claude --version, yang mencetak nomor versi seperti 2.1.211 (Claude Code).

Login and authentication

Bagian ini mengatasi kegagalan login, OAuth errors, dan masalah token.

Reset your login

Saat login gagal dan penyebabnya tidak jelas, autentikasi ulang yang bersih menyelesaikan sebagian besar kasus:

1. Jalankan /logout untuk sign out sepenuhnya
2. Tutup Claude Code
3. Restart dengan claude dan selesaikan proses autentikasi 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 mencoba 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.

403 Forbidden after login

Jika Anda melihat API Error: 403 Request not allowed setelah login:

• Pengguna Claude Pro/Max: verifikasi langganan Anda aktif di claude.ai/settings
• Pengguna Anthropic Console: konfirmasi akun Anda memiliki role "Claude Code" atau "Developer". Admin menetapkan ini di halaman Members pada Console di platform.claude.com/settings/members.
• Di belakang proxy: proxy perusahaan dapat mengganggu permintaan API. Lihat konfigurasi jaringan untuk setup proxy.

Claude Code access has not been granted for this account

Jika halaman sign-in menampilkan Authorization failed dengan pesan Claude Code access has not been granted for this account. Contact your administrator. setelah Anda login dari Claude Code, organisasi Claude Enterprise Anda telah menetapkan role Anda ke Custom dan tidak ada custom roles yang ditetapkan ke grup Anda yang memberikan Claude Code. Pada Custom role, Anda hanya mendapatkan akses dari custom roles tersebut, jadi tidak ada yang dapat Anda ubah di Claude Code yang menyelesaikan error ini.

Untuk mendapatkan akses:

1. Minta Owner organisasi Claude Anda untuk menetapkan custom role yang memberikan akses Claude Code ke salah satu grup Anda, atau untuk mengubah role Anda dari Custom ke standard role seperti User. Owner mengelola roles di pengaturan role organisasi.
2. Setelah Owner membuat perubahan, jalankan claude dan login lagi.

This organization has been disabled with an active subscription

Jika Anda melihat API Error: 400 ... "This organization has been disabled" meskipun memiliki langganan Claude aktif, environment variable ANTHROPIC_API_KEY menimpa langganan Anda. Ini biasanya terjadi saat kunci API lama dari employer atau project sebelumnya masih diatur di shell profile Anda.

Saat ANTHROPIC_API_KEY ada dan Anda telah menyetujuinya, Claude Code menggunakan kunci itu alih-alih kredensial OAuth langganan Anda. Dalam mode non-interaktif dengan flag -p, kunci selalu digunakan saat ada. Lihat prioritas autentikasi untuk urutan resolusi lengkap.

Untuk menggunakan langganan Anda sebagai gantinya, unset environment variable dan hapus dari shell profile Anda:

unset ANTHROPIC_API_KEY
claude

Remove-Item Env: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 autentikasi mana yang aktif.

OAuth login fails in WSL2, SSH, or containers

Saat Claude Code berjalan di WSL2, pada mesin remote melalui SSH, atau di dalam container, browser biasanya terbuka di host yang berbeda dan redirectnya tidak dapat menjangkau server callback lokal Claude Code. Setelah Anda sign in, browser menampilkan kode login alih-alih redirect kembali secara otomatis. Tempel kode itu ke terminal di prompt Paste code here if prompted untuk menyelesaikan login.

Jika browser tidak terbuka sama sekali dari WSL2, atur environment variable BROWSER ke path Windows browser Anda:

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

Atau, tekan c di interactive login prompt untuk menyalin OAuth URL, atau salin URL yang claude auth login cetak, dan buka di browser di mesin lokal Anda.

Jika menempel kode ke interactive prompt tidak melakukan apa pun, binding paste terminal Anda mungkin tidak menjangkau input field. Coba shortcut paste alternatif terminal Anda, sering kali right-click atau Shift+Insert di Windows Terminal, atau gunakan claude auth login sebagai gantinya, yang membaca kode yang ditempel dari standard input:

claude auth login

Fallback ini juga berlaku di Windows native atau terminal apa pun di mana menempel ke interactive prompt 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 autentikasi ulang. Jika ini terjadi sering, periksa bahwa jam sistem Anda akurat, karena validasi token bergantung pada timestamp yang benar.

Sesi paralel pada satu mesin berbagi login yang disimpan dan mengoordinasikan pembaruannya sehingga hanya satu proses yang menyegarkan token pada satu waktu. Untuk mengetahui apa yang dilakukan sesi lainnya setelah Anda login lagi di salah satunya, lihat Not logged in.

Sebelum v2.1.211, membangunkan mesin dari sleep dapat menyebabkan dua sesi memperbarui dengan token yang sama, yang mencabut login yang disimpan dan meminta setiap sesi terbuka untuk login lagi sekaligus.

Di macOS, Claude Code menyimpan kredensial ke login Keychain. Saat Keychain menolak write, seperti saat terkunci di sesi SSH atau passwordnya tidak sinkron dengan password akun Anda, Claude Code menyimpan login Anda ke file plaintext ~/.claude/.credentials.json sebagai gantinya. Login Console yang membuat kunci API gagal sampai Keychain dapat ditulis lagi.

Untuk membuat Keychain dapat ditulis lagi dan memindahkan login Anda kembali ke Keychain terenkripsi:

security unlock-keychain ~/Library/Keychains/login.keychain-db

Bedrock, Agent Platform, or Foundry credentials not loading

Jika Anda mengkonfigurasi Claude Code untuk menggunakan cloud provider dan melihat Could not load credentials from any providers di Amazon Bedrock, Could not load the default credentials di Google Cloud's Agent Platform, atau ChainedTokenCredential authentication failed di Microsoft Foundry, cloud provider CLI Anda mungkin tidak terautentikasi di shell saat ini.

Untuk Amazon Bedrock, konfirmasi kredensial AWS Anda valid:

aws sts get-caller-identity

Untuk Google Cloud's Agent Platform, 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 kredensial berfungsi di terminal Anda tetapi tidak di ekstensi VS Code atau JetBrains, proses IDE mungkin tidak mewarisi environment shell Anda. Atur environment variable provider di pengaturan IDE itu sendiri, atau luncurkan IDE dari terminal di mana mereka sudah diekspor.

Lihat Amazon Bedrock, Google Cloud's Agent Platform, atau Microsoft Foundry untuk setup provider lengkap.

Still stuck

Jika tidak ada di atas yang menyelesaikan masalah Anda:

1. Periksa GitHub repository untuk known issues, atau buka yang baru dengan sistem operasi Anda, perintah install yang Anda jalankan, dan output error lengkap
2. Jika claude --version berfungsi tetapi sesuatu yang lain salah, jalankan claude doctor untuk laporan diagnostik otomatis
3. Jika Anda dapat memulai sesi, gunakan /feedback di dalam Claude Code untuk melaporkan masalah
4. Jika masalahnya adalah dengan akun Anda daripada install, seperti loop login, langganan yang tidak dikenali, atau organisasi yang dinonaktifkan, hubungi dukungan Anthropic: masuk di claude.ai (Pengguna Console: platform.claude.com), klik inisial Anda di sudut kiri bawah, dan pilih Get help. Lihat How to get support untuk alur lengkapnya.