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 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.
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. 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.
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.
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.
Periksa apakah installer telah menempatkan program:
  • No such file or directory: tidak ada native install. Jika Anda belum menginstal Claude Code dengan cara lain, seperti dengan npm, Homebrew, atau package manager Linux, instal Claude Code. Jika Anda menginstalnya dengan cara lain, lihat Periksa instalasi yang bertentangan.
  • Daftar untuk file tersebut: program ada. Periksa PATH Anda selanjutnya.
Buat daftar entri PATH Anda dan filter untuk folder instalasi:
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 dengan dua perintah untuk shell Anda. Perintah echo menyimpan pengaturan untuk setiap terminal baru, dan source menerapkannya ke jendela yang sedang Anda gunakan. Perintah echo tidak mencetak apa pun jika berhasil.Untuk Zsh, default di macOS:
Untuk Bash di Linux, di mana ini adalah default di sebagian besar distribusi:
Untuk Bash di macOS, tambahkan baris ke ~/.bash_profile sebagai gantinya. Terminal di macOS memulai Bash sebagai login shell, yang mengabaikan ~/.bashrc dan hanya membaca yang pertama dari ~/.bash_profile, ~/.bash_login, atau ~/.profile yang ada. Jika Anda sudah memiliki ~/.bash_login atau ~/.profile dan tidak ada ~/.bash_profile, letakkan baris di file itu daripada membuat ~/.bash_profile:
Atau, tutup dan buka kembali terminal Anda.Jika perintah echo mencetak permission denied, lihat permission denied saat menambahkan ke PATH 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:
Jika claude masih tidak ditemukan, periksa penyebab berikut:
  • Terminal dibuka sebelum perubahan: jendela yang sudah terbuka tetap menggunakan PATH lamanya, dan terminal di dalam editor mengambil PATH-nya dari editor. Buka jendela baru, atau keluar dan buka kembali editor.
  • Baris tidak tersimpan: jalankan grep -n '.local/bin' ~/.zshrc, menggunakan nama file shell Anda. Perintah ini mencetak baris beserta nomor barisnya jika baris tersebut ada. Jika tidak mencetak apa pun, jalankan kembali dua perintah PATH.
  • Baris masuk ke file shell lain: jalankan echo $0 untuk melihat shell Anda, lalu jalankan dua perintah PATH untuk shell tersebut.

​
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 mencetak claude not found, baris no claude in, atau tidak mencetak apa pun, tidak ada claude di PATH Anda. Pemeriksaan berikutnya menunjukkan apakah claude terinstal sama sekali.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 ls -la ~/.local/bin/claude mencetak No such file or directory, tidak ada native install. Jika Anda belum menginstal Claude Code dengan cara lain, seperti dengan npm, Homebrew, atau package manager Linux, instal Claude Code. Jika ~/.local/bin/claude ada tetapi which -a claude tidak mencantumkannya, folder tersebut tidak ada di PATH Anda: lihat Verifikasi PATH Anda.
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

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

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.
PowerShell, parse errors: error menunjuk ke halaman yang dikembalikan, dengan iex mencoba menjalankan HTML dan CSS sebagai PowerShell.
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.
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.
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.
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:
    Di Windows, instal melalui WinGet:
    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 Verifikasi PATH Anda 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:
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 Verifikasi PATH Anda.

​
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:
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:
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:
    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:
    Kemudian jalankan installer di jendela yang sama:
  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:
    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 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:
    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:
    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.
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

​
Release verification failed for Claude Code

Pesan dari claude update atau claude install ini berarti Claude Code tidak dapat mengonfirmasi bahwa rilis yang akan diinstalnya asli, sehingga tidak ada yang diinstal. Versi apa pun yang sudah Anda miliki tetap berfungsi.
Ambil langkah yang sesuai dengan nilai dalam tanda kurung di pesan Anda:
  • Nilai yang dimulai dengan sidecar_fetch_: jalankan perintah yang sama lagi dari shell Anda. claude update berhasil jika mencetak baris yang dimulai dengan Successfully updated from, dan claude install berhasil jika mencetak Claude Code successfully installed!.
  • Nilai lainnya: coba perintah yang sama lagi nanti
Untuk nilai apa pun, jika pesan tersebut muncul lagi, laporkan masalahnya dan sertakan pesan lengkapnya.

​
Auto-update failed · Run claude doctor in the session footer

Baris merah ini berarti Claude Code mencoba memperbarui dirinya sendiri di latar belakang dan pembaruan tersebut tidak terinstal. Anda dapat terus bekerja tanpa melakukan apa pun. Baris tersebut mengarahkan Anda ke claude doctor, yang baris Last update attempt: failed (install_failed)-nya memberikan tanggal tetapi tidak menyebutkan penyebab. Untuk menyelesaikan pembaruan atau melihat mengapa gagal, jalankan claude update di shell Anda sebagai gantinya. Jika instalasi itu juga gagal, cari error yang dicetak claude update di bawah Find your error.

​
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:
    Atau tetap di CMD dan gunakan CMD installer sebagai gantinya:
  • && not a valid statement separator: 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. Salurkan 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 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:
  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:

​
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 Verifikasi PATH Anda 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:
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:
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:
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:
    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.

​
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:
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:
  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:
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:
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:
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:
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.
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. 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:
    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:
Loader dapat juga 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 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:
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. 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:
Atau muat di sesi saat ini:
Jika nvm dimuat tetapi path Windows masih mendapat prioritas, tambahkan path Node Linux Anda di depan secara eksplisit:
Hindari menonaktifkan impor PATH Windows melalui appendWindowsPath = false karena ini merusak kemampuan untuk memanggil executable Windows dari WSL. Demikian pula, hindari menghapus instalasi Node.js dari Windows jika Anda menggunakannya untuk pengembangan Windows.

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

​
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:
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:
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:
Kemudian hapus direktori temp sisa apa pun. Jika Zsh mencetak no matches found, tidak ada yang perlu 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, 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:
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:
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 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:
1

Periksa akses Keychain

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

Buka kunci Keychain

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

Sinkronkan ulang password Keychain jika membuka kunci tidak membantu

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

Logout dan login kembali

Setelah Keychain dapat ditulis lagi, Claude Code memindahkan kredensial kembali saat berikutnya menulis kredensial. Untuk memaksanya sekarang, jalankan /logout dan kemudian /login. Logout menghapus semua kredensial yang disimpan, termasuk isi file plaintext, login server MCP yang disimpan, dan nilai sensitif plugin, jadi bersiaplah untuk mengotorisasi ulang server MCP dan memasukkan ulang 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 terautentikasi di shell saat ini. Untuk Amazon Bedrock, konfirmasi kredensial AWS 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 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.