Skip to main content
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: 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. Di Linux, instal aplikasi dengan apt dengan mengikuti instruksi instalasi Linux.

​
Jalankan pemeriksaan diagnostik

​
Periksa konektivitas jaringan

Installer mengunduh dari downloads.claude.ai. Verifikasi Anda dapat menjangkaunya:
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:

​
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.
Ekstensi VS Code tidak menempatkan claude di lokasi ini. Ini menggabungkan salinan pribadi CLI di dalam direktori ekstensi untuk panel chat-nya sendiri dan tidak menambahkannya ke PATH. Jika Anda hanya telah menginstal ekstensi, ~/.local/bin/claude tidak akan ada. Jalankan instalasi standalone untuk menggunakan claude dari terminal, kemudian lanjutkan di bawah.
Periksa apakah direktori instalasi ada di PATH Anda dengan membuat daftar entri PATH dan memfilter untuk local/bin:
Jika ini mencetak /Users/you/.local/bin atau /home/you/.local/bin, direktori ada di PATH Anda dan Anda dapat melompat ke Periksa instalasi yang bertentangan. Jika tidak ada output, tambahkan ke konfigurasi shell Anda.Untuk Zsh, default di macOS:
Untuk Bash, default di sebagian besar distribusi Linux:
Atau, tutup dan buka kembali terminal Anda.Untuk shell lain seperti fish atau Nushell, tambahkan ~/.local/bin ke PATH Anda menggunakan sintaks konfigurasi shell Anda sendiri, kemudian restart terminal Anda.Verifikasi perbaikan berhasil:

​
Periksa instalasi yang bertentangan

Beberapa instalasi Claude Code dapat menyebabkan ketidakcocokan versi atau perilaku yang tidak terduga. Periksa apa yang terinstal:
Buat daftar semua binary claude yang ditemukan di PATH Anda:
Jika ini tidak mencetak apa pun, tidak ada claude di PATH Anda. Kembali ke Verifikasi PATH Anda.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:
Native install menunjukkan symlink ke ~/.local/share/claude/versions/. Script atau symlink yang Anda buat sendiri di path ini adalah custom launcher, yang auto-update meninggalkan di tempat.Jika salah satu perintah ls mencetak No such file or directory, itu bukan error. Ini berarti tidak ada yang terinstal di lokasi itu, jadi lanjutkan ke pemeriksaan berikutnya.
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:
Hapus legacy local npm install:
Hapus instalasi Homebrew di macOS. Jika Anda menginstal cask claude-code@latest, ganti nama itu:
Hapus instalasi WinGet di Windows:

​
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:
Jika direktori mana pun tidak dapat ditulis, buat direktori instalasi dan atur pengguna Anda sebagai pemilik:

​
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:
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.
Konfirmasi binary dapat dieksekusi:

​
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:
Di PowerShell, masalah yang sama muncul sebagai parse errors yang menunjuk ke halaman yang dikembalikan, dengan iex mencoba menjalankan HTML dan CSS sebagai PowerShell:
Wording 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. Tergantung pada bagaimana permintaan dirutekan, Anda mungkin malah melihat 403 tanpa body HTML:
Semuanya berarti URL instalasi mengembalikan halaman HTML atau status error alih-alih script instalasi. Jika halaman HTML mengatakan “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. Gunakan metode instalasi alternatif: Di macOS, instal melalui Homebrew:
    Di Windows, instal melalui WinGet:
    Kemudian jalankan claude --version untuk mengkonfirmasi: 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.
  2. 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: 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, 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. Solusi:
  1. Periksa stabilitas jaringan: Binary Claude Code dihosting di downloads.claude.ai. Uji bahwa Anda dapat menjangkaunya:
    Baris HTTP/2 200 berarti Anda menjangkau server dan kegagalan asli mungkin bersifat intermiten; coba ulang perintah install. Hasil lain menunjukkan penyebabnya:
    • 403: biasanya proxy atau network filter yang memblokir host, atau Claude Code tidak tersedia di region Anda
    • 5xx: biasanya masalah layanan sementara; tunggu beberapa menit dan coba ulang
    • Could not resolve host atau connection timeout: jaringan Anda memblokir download
  2. Coba metode instalasi alternatif: Di macOS:
    Di Windows:
    Kemudian jalankan claude --version untuk mengkonfirmasi: 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.

​
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:
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.

​
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:
  1. Perbarui sertifikat CA sistem Anda: Di Ubuntu/Debian:
    Di macOS, curl sistem menggunakan Keychain trust store; memperbarui macOS itu sendiri memperbarui root certificates.
  2. Di Windows, aktifkan TLS 1.2 di PowerShell sebelum menjalankan installer:
  3. 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 download install untuk mempercayai CA proxy perusahaan Anda:
    Untuk Claude Code itu sendiri setelah diinstal, atur NODE_EXTRA_CA_CERTS sehingga permintaan API mempercayai bundle yang sama:
    Tanyakan tim IT Anda untuk file sertifikat jika Anda tidak memilikinya. Anda juga dapat mencoba koneksi langsung untuk mengkonfirmasi 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:
    Ketika download script itu sendiri mengalami error yang sama, script menjalankan 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:
    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.

​
Wrong install command on Windows

Jika Anda melihat 'irm' is not recognized, The token '&&' is not valid, 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:
    Atau tetap di CMD dan gunakan CMD installer sebagai gantinya:
  • && not valid: Anda berada di PowerShell tetapi menjalankan perintah CMD installer. Gunakan PowerShell installer:
  • 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:
  • bash not recognized: Anda menjalankan installer macOS/Linux di Windows. Gunakan PowerShell installer sebagai gantinya:
  • 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. Pipa ke iex untuk menjalankannya:
    Di CMD, curl -fsSL https://claude.ai/install.cmd tanpa -o mencetak batch script alih-alih menyimpannya. Jalankan perintah lengkap:
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:
Error yang sama menamai 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:
  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:

​
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 gratis. Ini umum di VPS dan cloud instances kecil. Script install melaporkan penyebabnya dan keluar dengan kode 137. Dalam contoh ini, nomor baris dan ID proses bervariasi menurut rilis dan jalankan:
Instalasi memerlukan kira-kira 512 MB memori gratis, 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:
    Kemudian coba ulang instalasi:
  2. Tutup proses lain untuk membebaskan memori sebelum menginstal.
  3. 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:
  1. 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:
  2. Berikan Docker lebih banyak memori jika menggunakan Docker Desktop. Buat container berbagi memori yang dialokasikan ke Docker Desktop virtual machine, 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 Anda terakhir 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 jalankan install 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:
claude --version mencetak versi yang dijalankan ulang diinstal.

​
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 yang ada di path itu dan bukan penyebabnya:
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, 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 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 Claude Code memeriksa. 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 menjaga Claude Code dari menjalankan executable yang ditempatkan proyek di sana. Jika Git Anda berada di lokasi seperti itu, arahkan CLAUDE_CODE_GIT_BASH_PATH ke sana. Untuk menunjukkan Claude Code ke instalasi Git tertentu, temukannya dengan menjalankan where.exe git di PowerShell, kemudian atur path bin\bash.exe dari instalasi itu sebagai CLAUDE_CODE_GIT_BASH_PATH di settings.json file Anda:
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 Git for Windows, itu mengabaikan variabel dan auto-detects Git Bash seolah-olah tidak diatur, mencatat warning yang terlihat dengan --debug. Path yang tidak ada mendapat fallback dan warning yang sama. Sebelum v2.1.219, Claude Code menggunakan file 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 agents mungkin mengganggu. Minta tim IT Anda untuk allowlist claude.exe dan proses yang dijalankannya, termasuk cmd.exe dan bash.exe, 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:
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.
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:
    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. File 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:
    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 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 AVX instruction set. 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, dan virtual machines di mana hypervisor tidak melewatkan AVX ke guest. Di VPS atau VM, jalankan grep -m1 -ow avx /proc/cpuinfo; hasil kosong berarti AVX tidak tersedia untuk guest. Tidak ada native-binary workaround; track 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 apa 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 binary dukung:
Loader dapat sebagai gantinya menolak load commands binary, yang juga berarti versi macOS Anda terlalu lama:
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 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:
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:
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:
Atau muat di sesi saat ini:
Jika nvm dimuat tetapi path Windows masih mengambil prioritas, tambahkan path Node Linux Anda secara eksplisit:
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:

​
Native binary not found after npm install

Paket npm @anthropic-ai/claude-code mengunduh binary native sebagai per-platform optional dependency, seperti @anthropic-ai/claude-code-darwin-arm64. npm kemudian menjalankan postinstall script paket, yang menyalin binary itu ke tempat sebagai perintah claude; sampai itu berjalan, claude adalah script placeholder. Jika baik download atau langkah postinstall dilewati, placeholder tetap ada, dan menjalankan claude di macOS dan Linux mencetak:
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 JavaScript fallback 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 mengirimkan 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.
  • Corporate npm mirror kehilangan paket platform. Pastikan registry Anda mencerminkan semua delapan paket @anthropic-ai/claude-code-* platform 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:
Baris npm error path menamai direktori yang npm tidak dapat pindahkan. Hapus direktori itu dan direktori .claude-code-* leftover apa pun di sebelahnya, yang jalankan terputus sebelumnya dapat tinggalkan. Perintah di bawah menemukan direktori paket global Anda dengan npm root -g; jika direktori yang baris npm error path namai tidak berada di bawah direktori yang npm root -g cetak, misalnya karena Anda beralih versi Node dengan nvm, hapus direktori yang error namai sebagai gantinya:
Kemudian hapus direktori temp leftover apa pun. Jika zsh mencetak no matches found, tidak ada yang dihapus:
Kemudian instal ulang:
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, re-authentication yang bersih menyelesaikan sebagian besar kasus:
  1. Jalankan /logout untuk sign out sepenuhnya
  2. Tutup Claude Code
  3. 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.

​
403 Forbidden after login

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

​
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 variabel environment BROWSER ke path Windows browser Anda:
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:
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 re-authenticate. 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 pembaruan tokennya sehingga hanya satu proses yang menyegarkan token pada satu waktu. 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 credentials 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 API key gagal sampai Keychain dapat ditulis lagi. Untuk membuat Keychain dapat ditulis lagi dan memindahkan login Anda kembali ke Keychain terenkripsi:
1

Check Keychain access

Jalankan claude doctor untuk memeriksa akses Keychain. Saat Keychain menolak writes, laporan mencantumkan peringatan yang dimulai dengan macOS Keychain is not writable, diikuti oleh perbaikan yang disarankan. Saat laporan tidak mencantumkan peringatan Keychain, Keychain dapat ditulis dan Anda dapat melompat ke langkah terakhir.
2

Unlock the Keychain

Masukkan password Keychain Anda saat perintah memintanya, kemudian jalankan claude doctor lagi. Saat unlock berhasil, laporan tidak lagi mencantumkan peringatan Keychain.
3

Resync the Keychain password if unlocking doesn't help

Buka Keychain Access, pilih keychain login, dan pilih Edit > Change Password for Keychain “login” untuk menyinkronkannya kembali dengan password akun Anda. Kemudian jalankan claude doctor lagi. Lanjutkan ke langkah berikutnya setelah laporan tidak lagi mencantumkan peringatan Keychain.
4

Log out and back in

Setelah Keychain dapat ditulis lagi, Claude Code memindahkan credentials kembali saat berikutnya menulis credential. Untuk memaksanya sekarang, jalankan /logout dan kemudian /login. Logout menghapus semua credentials yang disimpan, termasuk isi file plaintext, login server MCP yang disimpan, dan nilai sensitif plugin, jadi bersiaplah untuk re-authorize server MCP dan re-enter plugin secrets sesudahnya. Login lagi menyimpan login Anda di Keychain.

​
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 authenticated di shell saat ini. Untuk Amazon Bedrock, konfirmasi AWS credentials Anda valid:
Untuk Google Cloud’s Agent Platform, konfirmasi ANTHROPIC_VERTEX_PROJECT_ID dan CLOUD_ML_REGION diatur di shell Anda, kemudian atur application default credentials:
Untuk Microsoft Foundry, konfirmasi ANTHROPIC_FOUNDRY_API_KEY diatur, atau sign in dengan Azure CLI sehingga default credential chain dapat menemukan akun Anda:
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 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.