315 {315 {
316 "matcher": "Edit|Write",316 "matcher": "Edit|Write",
317 "hooks": [317 "hooks": [
318318 { "type": "command", "command": "npx prettier --write --ignore-unknown \"$(jq -r '.tool_input.file_path')\"" } { "type": "command", "command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\"" }
319 ]319 ]
320 }320 }
321 ]321 ]
92 92
93Selain binary, image memerlukan:93Selain binary, image memerlukan:
94 94
9595* **Image berbasis glibc**: satu-satunya dependensi dinamis dari build glibc adalah library glibc. Image berbasis musl memerlukan build `linux-x64-musl` atau `linux-arm64-musl` ditambah paket tambahan; lihat [Penyiapan Alpine Linux](https://code.claude.com/docs/id/setup.md#alpine-linux-and-musl-based-distributions).* **Image berbasis glibc**: satu-satunya dependensi dinamis dari build glibc adalah library glibc. Image berbasis musl memerlukan build `linux-x64-musl` atau `linux-arm64-musl`, yang satu-satunya dependensi dinamisnya adalah musl.
96* **Direktori state yang dapat ditulis**: gateway berjalan sebagai pengguna apa pun, tetapi image minimal tidak memiliki direktori home yang dapat ditulis. Atur `CLAUDE_CONFIG_DIR` ke path yang dapat ditulis seperti `/tmp/.claude`.96* **Direktori state yang dapat ditulis**: gateway berjalan sebagai pengguna apa pun, tetapi image minimal tidak memiliki direktori home yang dapat ditulis. Atur `CLAUDE_CONFIG_DIR` ke path yang dapat ditulis seperti `/tmp/.claude`.
97* **Perintah container**: `claude gateway --config /etc/claude/gateway.yaml`, dengan file konfigurasi di-mount secara read-only dan secret disediakan sebagai environment variable; gateway mendengarkan pada `listen.port`, default `8080`.97* **Perintah container**: `claude gateway --config /etc/claude/gateway.yaml`, dengan file konfigurasi di-mount secara read-only dan secret disediakan sebagai environment variable; gateway mendengarkan pada `listen.port`, default `8080`.
98 98
3335 "hooks": [3335 "hooks": [
3336 {3336 {
3337 "type": "command",3337 "type": "command",
33383338 "command": "bash -c 'jq -r .worktree_path | xargs rm -rf'" "command": "bash -c 'p=$(jq -er .worktree_path) && rm -rf -- \"$p\"'"
3339 }3339 }
3340 ]3340 ]
3341 }3341 }
50 "PostToolUse": [50 "PostToolUse": [
51 {51 {
52 "matcher": "Edit|Write",52 "matcher": "Edit|Write",
5353 "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write" }] "hooks": [{ "type": "command", "command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\"" }]
54 }54 }
55 ],55 ],
56 "Notification": [56 "Notification": [
221 "hooks": [221 "hooks": [
222 {222 {
223 "type": "command",223 "type": "command",
224224 "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write" "command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\""
225 }225 }
226 ]226 ]
227 }227 }
32| `Ctrl+Z` | Jeda Claude Code | Unix saja. Menangguhkan proses ke shell Anda; jalankan `fg` untuk melanjutkan |32| `Ctrl+Z` | Jeda Claude Code | Unix saja. Menangguhkan proses ke shell Anda; jalankan `fg` untuk melanjutkan |
33| `Panah Kiri/Kanan` | Siklus melalui tab dialog | Navigasi antar tab dalam dialog izin dan menu. Dalam dialog bertab, kunci beralih tab sementara baris tab memiliki fokus. Lihat [Tindakan tab](https://code.claude.com/docs/id/keybindings.md#tabs-actions) untuk cara fokus bergerak |33| `Panah Kiri/Kanan` | Siklus melalui tab dialog | Navigasi antar tab dalam dialog izin dan menu. Dalam dialog bertab, kunci beralih tab sementara baris tab memiliki fokus. Lihat [Tindakan tab](https://code.claude.com/docs/id/keybindings.md#tabs-actions) untuk cara fokus bergerak |
34| `Tab` | Terima saran pelengkapan otomatis, atau tambahkan komentar ke jawaban izin | Saat saran pelengkapan otomatis ditampilkan dalam input prompt, menerima saran yang dipilih. Pada sebagian besar prompt izin, dengan **Ya** atau **Tidak** fokus, membuka bidang komentar pada opsi itu, dan menekannya lagi menutup bidang. Lihat [tambahkan komentar saat Anda menjawab prompt izin](https://code.claude.com/docs/id/permissions.md#add-a-comment-when-you-answer-a-permission-prompt) |34| `Tab` | Terima saran pelengkapan otomatis, atau tambahkan komentar ke jawaban izin | Saat saran pelengkapan otomatis ditampilkan dalam input prompt, menerima saran yang dipilih. Pada sebagian besar prompt izin, dengan **Ya** atau **Tidak** fokus, membuka bidang komentar pada opsi itu, dan menekannya lagi menutup bidang. Lihat [tambahkan komentar saat Anda menjawab prompt izin](https://code.claude.com/docs/id/permissions.md#add-a-comment-when-you-answer-a-permission-prompt) |
3535| `Panah Atas/Bawah` atau `Ctrl+P`/`Ctrl+N` | Pindahkan kursor atau navigasi riwayat perintah | Ketika input mencakup lebih dari satu baris visual, baik dibungkus atau multiline, pertama kali memindahkan kursor dalam prompt. Setelah kursor berada di baris visual pertama atau terakhir, menekan lagi menavigasi riwayat perintah. Sementara Anda memiliki pesan antrian, `Atas` dari baris pertama malah [membawanya kembali](#take-back-what-you-queued) || `Panah Atas/Bawah` atau `Ctrl+P`/`Ctrl+N` | Pindahkan kursor atau navigasi riwayat perintah | Ketika input mencakup lebih dari satu baris visual, baik dibungkus atau multiline, pertama kali memindahkan kursor dalam prompt. Setelah kursor berada di baris visual pertama atau terakhir, menekan lagi menavigasi riwayat perintah. Sementara Anda memiliki pesan antrian, `Up` dari baris pertama malah [membawanya kembali](#take-back-what-you-queued) |
36| `Esc` | Interupsi Claude, atau tutup dialog | Hentikan respons atau panggilan alat saat ini di tengah giliran sehingga Anda dapat mengalihkan. Claude menyimpan pekerjaan yang dilakukan sejauh ini. Jika Anda memiliki [pesan antrian](#queue-messages-while-claude-works), Claude Code mengirimnya selanjutnya. Ketika dialog terbuka, `Esc` menutup dialog. Saat item footer dipilih, seperti baris di [panel subagen](https://code.claude.com/docs/id/sub-agents.md#run-subagents-in-foreground-or-background) di bawah prompt, `Esc` [membatalkan pilihannya](https://code.claude.com/docs/id/keybindings.md#footer-actions) alih-alih mengganggu. Pada prompt izin, `Esc` menolak tindakan, sama seperti [**Tidak** tanpa komentar](https://code.claude.com/docs/id/permissions.md#add-a-comment-when-you-answer-a-permission-prompt) |36| `Esc` | Interupsi Claude, atau tutup dialog | Hentikan respons atau panggilan alat saat ini di tengah giliran sehingga Anda dapat mengalihkan. Claude menyimpan pekerjaan yang dilakukan sejauh ini. Jika Anda memiliki [pesan antrian](#queue-messages-while-claude-works), Claude Code mengirimnya selanjutnya. Ketika dialog terbuka, `Esc` menutup dialog. Saat item footer dipilih, seperti baris di [panel subagen](https://code.claude.com/docs/id/sub-agents.md#run-subagents-in-foreground-or-background) di bawah prompt, `Esc` [membatalkan pilihannya](https://code.claude.com/docs/id/keybindings.md#footer-actions) alih-alih mengganggu. Pada prompt izin, `Esc` menolak tindakan, sama seperti [**Tidak** tanpa komentar](https://code.claude.com/docs/id/permissions.md#add-a-comment-when-you-answer-a-permission-prompt) |
3737| `Esc` + `Esc` | Hapus draf input, atau putar ulang | Ketika input prompt berisi teks, `Esc` ganda menghapusnya dan menyimpan draf ke riwayat sehingga `Atas` mengingatnya. Ketika input kosong, `Esc` ganda membuka [menu putar ulang](https://code.claude.com/docs/id/checkpointing.md) untuk memulihkan atau merangkum kode dan percakapan dari titik sebelumnya || `Esc` + `Esc` | Hapus draf input, atau putar ulang | Ketika input prompt berisi teks, `Esc` ganda menghapusnya dan menyimpan draf ke riwayat sehingga `Up` mengingatnya. Ketika input kosong, `Esc` ganda membuka [menu putar ulang](https://code.claude.com/docs/id/checkpointing.md) untuk memulihkan atau merangkum kode dan percakapan dari titik sebelumnya |
38| `Ctrl+Enter` atau `Ctrl+X Ctrl+S` | Kirim pesan antrian sekarang | Mengirim [pesan antrian](#queue-messages-while-claude-works) Anda, dan draf Anda bersama mereka, keluar segera. [Ketika Claude Code mengirim apa yang Anda antrekan](#when-claude-code-sends-what-you-queued) mencakup apa yang terjadi pada giliran yang sedang dikerjakan Claude. Dalam [mode shell](#shell-mode-with-prefix), kunci hanya mengantrekan perintah Anda. Di terminal yang tidak melaporkan kunci diperluas, `Ctrl+Enter` tiba sebagai `Enter` biasa; `Ctrl+X Ctrl+S` bekerja di terminal apa pun. Memerlukan Claude Code v2.1.275 atau yang lebih baru |38| `Ctrl+Enter` atau `Ctrl+X Ctrl+S` | Kirim pesan antrian sekarang | Mengirim [pesan antrian](#queue-messages-while-claude-works) Anda, dan draf Anda bersama mereka, keluar segera. [Ketika Claude Code mengirim apa yang Anda antrekan](#when-claude-code-sends-what-you-queued) mencakup apa yang terjadi pada giliran yang sedang dikerjakan Claude. Dalam [mode shell](#shell-mode-with-prefix), kunci hanya mengantrekan perintah Anda. Di terminal yang tidak melaporkan kunci diperluas, `Ctrl+Enter` tiba sebagai `Enter` biasa; `Ctrl+X Ctrl+S` bekerja di terminal apa pun. Memerlukan Claude Code v2.1.275 atau yang lebih baru |
3939| `Shift+Tab`, atau `Alt+M` di Windows ketika runtime Node atau Bun tidak mengaktifkan mode input VT | Mode izin siklus | Siklus melalui `default` (berlabel Manual dalam indikator mode), `acceptEdits`, `plan`, dan, ketika tersedia, `bypassPermissions` dan kemudian `auto`. Dari `auto`, tekan pertama beralih ke `default`. Lihat [mode izin](https://code.claude.com/docs/id/permission-modes.md). Pada prompt izin file, kunci yang sama menutup [bidang komentar](https://code.claude.com/docs/id/permissions.md#add-a-comment-when-you-answer-a-permission-prompt) yang terbuka. Tanpa bidang terbuka, ini memilih opsi yang memungkinkan tindakan untuk sisa sesi, ketika prompt menawarkan opsi itu || `Shift+Tab`, atau `Alt+M` di Windows ketika runtime Node atau Bun tidak mengaktifkan mode input VT | Siklus mode izin | Siklus melalui `default` (berlabel Manual dalam indikator mode), `acceptEdits`, dan `plan`, lalu `bypassPermissions` dan `auto` jika tersedia. Lihat [mode izin](https://code.claude.com/docs/id/permission-modes.md). Pada permintaan izin file, tombol yang sama menutup [bidang komentar](https://code.claude.com/docs/id/permissions.md#add-a-comment-when-you-answer-a-permission-prompt) yang terbuka. Tanpa bidang terbuka, ini memilih opsi yang mengizinkan tindakan untuk sisa sesi, ketika permintaan tersebut menawarkan opsi itu. Pada permintaan persetujuan rencana, ini menyetujui rencana |
40| `Option+P` (macOS) atau `Alt+P` (Windows/Linux) | Model switch | Alihkan model tanpa menghapus prompt Anda |40| `Option+P` (macOS) atau `Alt+P` (Windows/Linux) | Model switch | Alihkan model tanpa menghapus prompt Anda |
41| `Option+T` (macOS) atau `Alt+T` (Windows/Linux) | Alihkan extended thinking | Aktifkan atau nonaktifkan mode extended thinking. Tidak berpengaruh pada Opus 5.5, Sonnet 5.5, Haiku 5.5, atau model Fable, yang selalu menggunakan extended thinking. Bekerja di macOS tanpa mengonfigurasi Option sebagai Meta |41| `Option+T` (macOS) atau `Alt+T` (Windows/Linux) | Alihkan extended thinking | Aktifkan atau nonaktifkan mode extended thinking. Tidak berpengaruh pada Opus 5.5, Sonnet 5.5, Haiku 5.5, atau model Fable, yang selalu menggunakan extended thinking. Bekerja di macOS tanpa mengonfigurasi Option sebagai Meta |
42| `Option+O` (macOS) atau `Alt+O` (Windows/Linux) | Alihkan mode cepat | Aktifkan atau nonaktifkan [mode cepat](https://code.claude.com/docs/id/fast-mode.md) |42| `Option+O` (macOS) atau `Alt+O` (Windows/Linux) | Alihkan mode cepat | Aktifkan atau nonaktifkan [mode cepat](https://code.claude.com/docs/id/fast-mode.md) |
304claude --permission-mode plan304claude --permission-mode plan
305```305```
306 306
307307Tekan `Shift+Tab` lagi untuk keluar dari plan mode tanpa menyetujui rencana.Saat tidak ada permintaan persetujuan yang terbuka, tekan `Shift+Tab` lagi untuk keluar dari plan mode. Pada permintaan persetujuan, tekan `Esc` terlebih dahulu, karena menekan `Shift+Tab` di sana akan menyetujui rencana.
308 308
309### Meninjau dan menyetujui rencana309### Meninjau dan menyetujui rencana
310 310
344 "PostToolUse": [344 "PostToolUse": [
345 {345 {
346 "matcher": "Write|Edit",346 "matcher": "Write|Edit",
347347 "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npm run lint:fix" }] "hooks": [{ "type": "command", "command": "f=$(jq -r '.tool_input.file_path') && npm run lint:fix -- \"$f\"" }]
348 }348 }
349 ]349 ]
350 }350 }
40>40>
41> **macOS, Linux, WSL:**41> **macOS, Linux, WSL:**
42>42>
4343> ```bash theme={null}> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
44> curl -fsSL https://claude.ai/install.sh | bash44> curl -fsSL https://claude.ai/install.sh | bash
45> ```45> ```
46>46>
48>48>
49> **Windows PowerShell:**49> **Windows PowerShell:**
50>50>
5151> ```powershell theme={null}> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
52> irm https://claude.ai/install.ps1 | iex52> irm https://claude.ai/install.ps1 | iex
53> ```53> ```
54>54>
55> **Windows CMD:**55> **Windows CMD:**
56>56>
5757> ```batch theme={null}> ```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
58> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd58> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
59> ```59> ```
60>60>
72 72
73> [tab] Homebrew73> [tab] Homebrew
74>74>
7575> ```bash theme={null}> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
76> brew install --cask claude-code76> brew install --cask claude-code
77> ```77> ```
78>78>
84 84
85> [tab] WinGet85> [tab] WinGet
86>86>
8787> ```powershell theme={null}> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
88> winget install Anthropic.ClaudeCode88> winget install Anthropic.ClaudeCode
89> ```89> ```
90>90>
141 141
142### Alpine Linux dan distribusi berbasis musl142### Alpine Linux dan distribusi berbasis musl
143 143
144144Menginstal Claude Code di Alpine dan distribusi berbasis musl/uClibc lainnya memerlukan `bash` dan `curl` untuk perintah instalasi, serta `libgcc`, `libstdc++`, dan `ripgrep` saat runtime. Alpine tidak menyertakan `bash` atau `curl` secara default, jadi perintah instalasi yang didokumentasikan gagal dengan kesalahan `not found` sampai Anda menginstalnya. Instal paket-paket ini menggunakan manajer paket distribusi Anda, kemudian atur `USE_BUILTIN_RIPGREP=0`.Di Alpine dan distribusi berbasis musl lainnya, [perintah instalasi](#install-claude-code) memerlukan `bash` dan `curl`, dan Claude Code sendiri memerlukan `bash` atau `zsh`. Alpine tidak menyertakan `bash` atau `curl` secara default, jadi perintah instalasi yang didokumentasikan gagal dengan kesalahan `not found` sampai Anda menginstalnya.
145 145
146Contoh ini menginstal paket yang diperlukan di Alpine:146Contoh ini menginstal paket yang diperlukan di Alpine:
147 147
148```bash theme={null}148```bash theme={null}
149149apk add bash curl libgcc libstdc++ ripgrepapk add bash curl
150```
151
152Di Alpine, `ripgrep` berada di repositori komunitas. Jika `apk` melaporkan bahwa paket hilang, tambahkan repositori komunitas ke `/etc/apk/repositories`, menggunakan versi Alpine Anda:
153
154```bash theme={null}
155echo "https://dl-cdn.alpinelinux.org/alpine/v3.22/community" >> /etc/apk/repositories
156```
157
158Jalankan `apk update` untuk menyegarkan indeks paket, dan coba lagi perintah `apk add`.
159
160Kemudian atur `USE_BUILTIN_RIPGREP` ke `0` di file [`settings.json`](https://code.claude.com/docs/id/settings-reference#all-settings) Anda:
161
162```json theme={null}
163{
164 "env": {
165 "USE_BUILTIN_RIPGREP": "0"
166 }
167}
168```150```
169 151
170## Verifikasi instalasi Anda152## Verifikasi instalasi Anda
443> wget -O /etc/apk/keys/claude-code.rsa.pub \425> wget -O /etc/apk/keys/claude-code.rsa.pub \
444> https://downloads.claude.ai/keys/claude-code.rsa.pub426> https://downloads.claude.ai/keys/claude-code.rsa.pub
445> echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories427> echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories
446428> apk add claude-code> apk add bash claude-code
447> ```429> ```
448>430>
449> Untuk beralih ke saluran `latest`, hapus baris repositori `stable` dan tambahkan repositori `latest`:431> Untuk beralih ke saluran `latest`, hapus baris repositori `stable` dan tambahkan repositori `latest`:
388> Get-Command claude | Select-Object Source388> Get-Command claude | Select-Object Source
389> ```389> ```
390 390
391391Di 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](https://code.claude.com/docs/id/setup.md#alpine-linux-and-musl-based-distributions).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 [Ketidakcocokan binary musl atau glibc di Linux](#linux-musl-or-glibc-binary-mismatch).
392 392
393```bash theme={null}393```bash theme={null}
394ldd "$(command -v claude)" | grep "not found"394ldd "$(command -v claude)" | grep "not found"
402 402
403## Masalah instalasi umum403## Masalah instalasi umum
404 404
405405Ini adalah masalah instalasi yang paling sering dihadapi dan solusinya.Berikut adalah masalah instalasi yang paling sering ditemui beserta solusinya.
406 406
407407### Install script returns HTML instead of a shell script### Skrip instalasi mengembalikan HTML, bukan skrip shell
408 408
409409Perintah install gagal dengan salah satu error berikut ketika yang diunduhnya bukan script instalasi.Perintah instalasi gagal dengan salah satu error berikut ketika yang diunduhnya bukan skrip instalasi.
410 410
411411**Bash atau Zsh**: error mengutip baris pertama dari halaman yang dikembalikan.**Bash atau Zsh**: error tersebut mengutip baris pertama dari halaman yang dikembalikan.
412 412
413```text theme={null}413```text theme={null}
414bash: line 1: syntax error near unexpected token `<'414bash: line 1: syntax error near unexpected token `<'
415bash: line 1: `<!DOCTYPE html>'415bash: line 1: `<!DOCTYPE html>'
416```416```
417 417
418418**PowerShell, parse errors**: error menunjuk ke halaman yang dikembalikan, dengan `iex` mencoba menjalankan HTML dan CSS sebagai PowerShell.**PowerShell, error parse**: error tersebut menunjuk ke dalam halaman yang dikembalikan, dengan `iex` mencoba menjalankan HTML dan CSS sebagai PowerShell.
419 419
420```text theme={null}420```text theme={null}
421iex : At line:1 char:2310421iex : At line:1 char:2310
424...424...
425```425```
426 426
427427Kata-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.Kata-katanya bervariasi tergantung 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 menandakan kegagalan ini. Jika Anda mengunduh dengan `-OutFile install.ps1` sebagai gantinya, file yang disimpan adalah halaman web yang sama, sehingga cara itu juga tidak membantu.
428 428
429429**PowerShell, `System.Xml.XmlDocument`**: error menyebutkan tipe ini alih-alih mengutip halaman.**PowerShell, `System.Xml.XmlDocument`**: error tersebut menyebutkan tipe ini alih-alih mengutip halaman.
430 430
431```text theme={null}431```text theme={null}
432System.Xml.XmlDocument : The term 'System.Xml.XmlDocument' is not recognized as the name of a cmdlet, function, script432System.Xml.XmlDocument : The term 'System.Xml.XmlDocument' is not recognized as the name of a cmdlet, function, script
433file, or operable program.433file, or operable program.
434```434```
435 435
436436Ketika `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.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. Skrip instalasi adalah kode PowerShell dan tidak dapat di-parse sebagai XML, sehingga error ini juga berarti respons tersebut adalah sesuatu selain skrip. Kata-kata di sekitar nama tipe bervariasi tergantung versi PowerShell dan bahasa sistem, tetapi `System.Xml.XmlDocument` itu sendiri tetap sama, jadi cocokkan berdasarkan nama tipe tersebut.
437 437
438**CMD**: Anda melihat error ini, diikuti oleh HTML dari halaman yang dikembalikan.438**CMD**: Anda melihat error ini, diikuti oleh HTML dari halaman yang dikembalikan.
439 439
443C:\Users\you><!DOCTYPE html>...443C:\Users\you><!DOCTYPE html>...
444```444```
445 445
446446Baris pertama muncul dalam bahasa sistem Anda, jadi cari HTML yang mengikutinya.Baris pertama muncul dalam bahasa sistem Anda, jadi carilah HTML yang mengikutinya.
447 447
448448**403 tanpa halaman**: tergantung pada bagaimana permintaan dirutekan, curl melaporkan status 403 tanpa body HTML.**403 tanpa halaman**: tergantung bagaimana permintaan dirutekan, curl melaporkan status 403 tanpa body HTML.
449 449
450```text theme={null}450```text theme={null}
451curl: (22) The requested URL returned error: 403451curl: (22) The requested URL returned error: 403
452```452```
453 453
454454Semuanya 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](https://www.anthropic.com/supported-countries).Semua ini berarti URL instalasi mengembalikan halaman web, dokumen XML, atau status error alih-alih skrip instalasi. Jika output error mengutip "App unavailable in region," Claude Code tidak tersedia di negara Anda. Lihat [negara yang didukung](https://www.anthropic.com/supported-countries).
455 455
456456403 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](#check-network-connectivity) sebelum mencoba installer alternatif di bawah, karena installer tersebut menjangkau host yang sama.403 polos tanpa body sering kali memiliki penyebab yang sama, tetapi juga dapat berasal dari proxy atau firewall perusahaan yang memblokir unduhan. Jika Anda berada di negara yang didukung dan masih melihat 403, ikuti langkah-langkah di [Periksa konektivitas jaringan](#check-network-connectivity) sebelum mencoba penginstal alternatif di bawah, karena penginstal tersebut menjangkau host yang sama.
457 457
458458Sebaliknya, ini dapat terjadi karena masalah jaringan, routing regional, atau gangguan layanan sementara.Selain itu, hal ini dapat terjadi karena masalah jaringan, perutean regional, atau gangguan layanan sementara.
459 459
460**Solusi:**460**Solusi:**
461 461
4624621. **Coba lagi setelah beberapa menit**: masalahnya sering bersifat sementara. Tunggu dan coba perintah asli lagi.1. **Coba lagi setelah beberapa menit**: masalah ini sering kali bersifat sementara. Tunggu dan coba lagi perintah aslinya.
463 463
4642. **Gunakan metode instalasi alternatif**: tidak seperti instalasi native, instalasi Homebrew atau WinGet [tidak memperbarui dirinya sendiri secara default](https://code.claude.com/docs/id/setup.md#auto-updates).4642. **Gunakan metode instalasi alternatif**: tidak seperti instalasi native, instalasi Homebrew atau WinGet [tidak memperbarui dirinya sendiri secara default](https://code.claude.com/docs/id/setup.md#auto-updates).
465 465
475 winget install Anthropic.ClaudeCode475 winget install Anthropic.ClaudeCode
476 ```476 ```
477 477
478478 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. Kemudian jalankan `claude --version` untuk memastikan: perintah tersebut mencetak nomor versi seperti `2.1.211 (Claude Code)`. Jika shell melaporkan bahwa `claude` tidak ditemukan, buka jendela terminal baru dan coba lagi: sesi tempat Anda menginstal tetap menggunakan `PATH` lamanya.
479 479
480480### `command not found: claude` after installation### `command not found: claude` setelah instalasi
481 481
482482Instalasi selesai tetapi `claude` tidak berfungsi. Error yang tepat bervariasi menurut platform:Instalasi selesai tetapi `claude` tidak berfungsi. Error persisnya bervariasi menurut platform:
483 483
484| Platform | Pesan error |484| Platform | Pesan error |
485| :- | :- |485| :- | :- |
488| Windows CMD | `'claude' is not recognized as an internal or external command` |488| Windows CMD | `'claude' is not recognized as an internal or external command` |
489| PowerShell | `claude : The term 'claude' is not recognized as the name of a cmdlet` |489| PowerShell | `claude : The term 'claude' is not recognized as the name of a cmdlet` |
490 490
491491Di Windows, jika error mulai muncul tepat setelah Claude Code diperbarui, lihat [pulihkan `claude.exe` dari backup-nya](#claude-exe-missing-after-an-update-on-windows).Di Windows, jika error mulai muncul tepat setelah Claude Code diperbarui, lihat [pulihkan `claude.exe` dari cadangannya](#claude-exe-missing-after-an-update-on-windows).
492 492
493Jika tidak, lihat [Verifikasi PATH Anda](#verify-your-path) untuk perbaikan di setiap platform.493Jika tidak, lihat [Verifikasi PATH Anda](#verify-your-path) untuk perbaikan di setiap platform.
494 494
495495### `permission denied` when adding to your PATH### `permission denied` saat menambahkan ke PATH Anda
496 496
497497Jika 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`: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 tersimpan. Di terminal Anda, periksa siapa pemilik file tersebut, dengan menggunakan nama file shell Anda sebagai pengganti `~/.zshrc`:
498 498
499```bash theme={null}499```bash theme={null}
500ls -l ~/.zshrc500ls -l ~/.zshrc
503Kolom ketiga dari output adalah pemiliknya.503Kolom ketiga dari output adalah pemiliknya.
504 504
505* **Pemiliknya adalah pengguna lain, seperti `root`**: ambil alih kepemilikan dengan `sudo chown $(whoami) ~/.zshrc`, yang memerlukan hak administrator.505* **Pemiliknya adalah pengguna lain, seperti `root`**: ambil alih kepemilikan dengan `sudo chown $(whoami) ~/.zshrc`, yang memerlukan hak administrator.
506506* **Pemiliknya adalah Anda**: file tersebut read-only. Jadikan dapat ditulis dengan `chmod u+w ~/.zshrc`.* **Pemiliknya adalah Anda**: file tersebut bersifat read-only. Jadikan dapat ditulis dengan `chmod u+w ~/.zshrc`.
507 507
508Kemudian jalankan lagi dua perintah PATH untuk shell Anda di [Verifikasi PATH Anda](#verify-your-path).508Kemudian jalankan lagi dua perintah PATH untuk shell Anda di [Verifikasi PATH Anda](#verify-your-path).
509 509
510### `curl: (56) Failure writing output to destination`510### `curl: (56) Failure writing output to destination`
511 511
512512Perintah `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.Perintah `curl ... | bash` mengunduh skrip dan menyalurkannya (pipe) ke Bash untuk dieksekusi. Error ini, dan error terkait `curl: (23) Failure writing output to destination`, berarti Bash tidak menerima skrip secara lengkap. Exit code 56 menunjukkan bahwa unduhan itu sendiri terputus, dan exit code 23 menunjukkan bahwa curl tidak dapat menulis apa yang diterimanya ke pipe, biasanya karena Bash keluar lebih awal.
513 513
514514Uji bahwa Anda dapat menjangkau `downloads.claude.ai` dengan pemeriksaan di [Check network connectivity](#check-network-connectivity). Jika Anda menjangkau server, kegagalan asli mungkin bersifat intermiten; coba ulang perintah install. Anda juga dapat [mencoba metode instalasi alternatif](https://code.claude.com/docs/id/setup.md#install-claude-code).Uji apakah Anda dapat menjangkau `downloads.claude.ai` dengan pemeriksaan di [Periksa konektivitas jaringan](#check-network-connectivity). Jika Anda berhasil menjangkau server, kegagalan awal kemungkinan bersifat intermiten; coba lagi perintah instalasi. Anda juga dapat [mencoba metode instalasi alternatif](https://code.claude.com/docs/id/setup.md#install-claude-code).
515 515
516516### Homebrew cask unavailable or outdated### Cask Homebrew tidak tersedia atau usang
517 517
518518Homebrew 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:Homebrew melaporkan `Error: Cask 'claude-code' is unavailable: No Cask with this name exists` ketika salinan lokal indeks cask Homebrew Anda lebih lama daripada publikasi cask tersebut. Perbarui indeks dan coba lagi:
519 519
520```bash theme={null}520```bash theme={null}
521brew update521brew update
522brew install --cask claude-code522brew install --cask claude-code
523```523```
524 524
525525Jika 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](https://code.claude.com/docs/id/setup.md#configure-release-channel) untuk perbedaan antara dua cask.Jika Homebrew menginstal versi Claude Code yang lebih lama dari yang Anda harapkan, indeks usang yang sama biasanya menjadi penyebabnya. Cask `claude-code` mengikuti saluran stabil dan biasanya tertinggal sekitar satu minggu dari rilis terbaru; untuk versi terbaru, jalankan `brew install --cask claude-code@latest` sebagai gantinya. Lihat [Konfigurasi saluran rilis](https://code.claude.com/docs/id/setup.md#configure-release-channel) untuk perbedaan antara kedua cask tersebut.
526 526
527### `Cask 'claude-code@latest' is not installed`527### `Cask 'claude-code@latest' is not installed`
528 528
532brew list --cask | grep claude-code532brew list --cask | grep claude-code
533```533```
534 534
535535Upgrade cask yang dicetaknya. Jika tidak mencetak apa pun, tidak ada cask yang terinstal.Tingkatkan cask yang dicetaknya. Jika tidak mencetak apa pun, tidak ada cask yang terinstal.
536 536
537537### TLS or SSL connection errors### Error koneksi TLS atau SSL
538 538
539539Error seperti ini berarti TLS handshake gagal:Error seperti berikut berarti handshake TLS gagal:
540 540
541* `curl: (35) TLS connect error`541* `curl: (35) TLS connect error`
542* `schannel: next InitializeSecurityContext failed`542* `schannel: next InitializeSecurityContext failed`
543543* PowerShell's `Could not create SSL/TLS secure channel`* `Could not create SSL/TLS secure channel` dari PowerShell
544544* PowerShell's `Could not establish trust relationship for the SSL/TLS secure channel`* `Could not establish trust relationship for the SSL/TLS secure channel` dari PowerShell
545 545
546546Untuk `CRYPT_E_NO_REVOCATION_CHECK` atau `CRYPT_E_REVOCATION_OFFLINE`, langsung ke langkah 4.Untuk `CRYPT_E_NO_REVOCATION_CHECK` atau `CRYPT_E_REVOCATION_OFFLINE`, lanjutkan ke langkah 4.
547 547
548**Solusi:**548**Solusi:**
549 549
555 sudo apt-get update && sudo apt-get install ca-certificates555 sudo apt-get update && sudo apt-get install ca-certificates
556 ```556 ```
557 557
558558 Di macOS, curl sistem menggunakan Keychain trust store; memperbarui macOS itu sendiri memperbarui root certificates. Di macOS, curl sistem menggunakan trust store Keychain; memperbarui macOS itu sendiri akan memperbarui sertifikat root.
559 559
5602. **Di Windows PowerShell 5.1, aktifkan TLS 1.2**:5602. **Di Windows PowerShell 5.1, aktifkan TLS 1.2**:
561 ```powershell theme={null}561 ```powershell theme={null}
562 [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12562 [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
563 ```563 ```
564564 Kemudian jalankan installer di jendela yang sama: Kemudian jalankan penginstal di jendela yang sama:
565 ```powershell theme={null}565 ```powershell theme={null}
566 irm https://claude.ai/install.ps1 | iex566 irm https://claude.ai/install.ps1 | iex
567 ```567 ```
568 568
5695693. **Periksa gangguan proxy atau firewall**: proxy perusahaan yang melakukan TLS inspection dapat menyebabkan error ini, termasuk `unable to get local issuer certificate`, `unable to verify the first certificate`, dan `SELF_SIGNED_CERT_IN_CHAIN`. Buat download install mempercayai CA proxy perusahaan Anda:3. **Periksa gangguan proxy atau firewall**: proxy perusahaan yang melakukan inspeksi TLS dapat menyebabkan error ini, termasuk `unable to get local issuer certificate`, `unable to verify the first certificate`, dan `SELF_SIGNED_CERT_IN_CHAIN`. Buat unduhan instalasi memercayai CA proxy perusahaan Anda:
570 570
571 > [tab] macOS/Linux571 > [tab] macOS/Linux
572 >572 >
573573 > Atur `CURL_CA_BUNDLE` untuk download `curl` milik script install, dan [`NODE_EXTRA_CA_CERTS`](https://code.claude.com/docs/id/network-config#custom-ca-certificates) untuk perintah `claude install` yang kemudian dijalankan oleh script. Minta file PEM berisi sertifikat root CA proxy Anda kepada tim IT jika Anda belum memilikinya. Contoh ini mengatur keduanya ke file CA proxy Anda dan menjalankan script di terminal yang sama: > Atur `CURL_CA_BUNDLE` untuk unduhan `curl` skrip instalasi, dan [`NODE_EXTRA_CA_CERTS`](https://code.claude.com/docs/id/network-config#custom-ca-certificates) untuk perintah `claude install` yang kemudian dijalankan oleh skrip. Mintalah file PEM berisi sertifikat CA root proxy Anda kepada tim IT jika Anda belum memilikinya. Contoh ini mengatur keduanya ke file CA proxy Anda dan menjalankan skrip di terminal yang sama:
574 >574 >
575 > ```bash theme={null}575 > ```bash theme={null}
576 > export CURL_CA_BUNDLE=/path/to/corporate-ca.pem576 > export CURL_CA_BUNDLE=/path/to/corporate-ca.pem
578 > curl -fsSL https://claude.ai/install.sh | bash578 > curl -fsSL https://claude.ai/install.sh | bash
579 > ```579 > ```
580 >580 >
581581 > Jika instalasi masih gagal dengan salah satu error sertifikat tersebut, minta tim IT Anda untuk file yang berisi root certificate publik sekaligus rantai CA lengkap proxy Anda. Kemudian atur kedua variabel ke file tersebut. > Jika instalasi masih gagal dengan salah satu error sertifikat tersebut, mintalah kepada tim IT Anda file yang berisi sertifikat root publik sekaligus rantai CA lengkap proxy Anda. Kemudian atur kedua variabel ke file tersebut.
582 582
583 > [tab] Windows PowerShell583 > [tab] Windows PowerShell
584 >584 >
585585 > PowerShell installer mengunduh melalui .NET, yang memvalidasi TLS terhadap Windows certificate store. Minta tim IT Anda untuk menambahkan sertifikat CA proxy ke Windows store jika belum ada, kemudian jalankan installer: > Penginstal PowerShell mengunduh melalui .NET, yang memvalidasi TLS terhadap penyimpanan sertifikat Windows. Mintalah tim IT Anda untuk menambahkan sertifikat CA proxy ke penyimpanan Windows jika belum ada, lalu jalankan penginstal:
586 >586 >
587 > ```powershell theme={null}587 > ```powershell theme={null}
588 > irm https://claude.ai/install.ps1 | iex588 > irm https://claude.ai/install.ps1 | iex
589 > ```589 > ```
590 590
591591 Untuk Claude Code itu sendiri setelah diinstal, atur `NODE_EXTRA_CA_CERTS` sehingga permintaan API mempercayai bundle yang sama: Untuk Claude Code itu sendiri setelah terinstal, atur `NODE_EXTRA_CA_CERTS` agar permintaan API memercayai bundle yang sama:
592 592
593 > [tab] macOS/Linux593 > [tab] macOS/Linux
594 >594 >
602 > $env:NODE_EXTRA_CA_CERTS = 'C:\path\to\corporate-ca.pem'602 > $env:NODE_EXTRA_CA_CERTS = 'C:\path\to\corporate-ca.pem'
603 > ```603 > ```
604 604
6056054. **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:4. **Di Windows, gunakan solusi alternatif untuk mengatasi pemeriksaan revokasi yang diblokir**. Error `CRYPT_E_NO_REVOCATION_CHECK (0x80092012)` dan `CRYPT_E_REVOCATION_OFFLINE (0x80092013)` berarti curl berhasil menjangkau server tetapi jaringan Anda memblokir pencarian revokasi sertifikat, yang umum terjadi di balik firewall perusahaan. Jika perintah yang gagal adalah `curl` yang mengunduh `install.cmd`, jalankan ulang dari Command Prompt dengan menambahkan `--ssl-revoke-best-effort`:
606 ```batch theme={null}606 ```batch theme={null}
607 curl --ssl-revoke-best-effort -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd607 curl --ssl-revoke-best-effort -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
608 ```608 ```
609609 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: Ketika unduhan milik skrip itu sendiri mengalami error yang sama, skrip secara otomatis mencobanya ulang dengan pemeriksaan revokasi best-effort, sehingga flag tersebut hanya diperlukan pada perintah yang Anda jalankan sendiri. Pemeriksaan best-effort menoleransi server revokasi yang tidak dapat dijangkau tetapi tetap menolak sertifikat yang diketahui telah dicabut, sesuai dengan cara browser menangani revokasi. Anda juga dapat sepenuhnya menghindari pemeriksaan revokasi curl dengan menjalankan penginstal PowerShell dari PowerShell, yang mengunduh melalui .NET dan tidak gagal ketika server revokasi tidak dapat dijangkau:
610 ```powershell theme={null}610 ```powershell theme={null}
611 irm https://claude.ai/install.ps1 | iex611 irm https://claude.ai/install.ps1 | iex
612 ```612 ```
613613 Anda juga dapat menginstal dengan `winget install Anthropic.ClaudeCode`, yang menghindari curl sepenuhnya. Anda juga dapat menginstal dengan `winget install Anthropic.ClaudeCode`, yang sepenuhnya menghindari curl.
614 614
615### `Failed to fetch version from downloads.claude.ai`615### `Failed to fetch version from downloads.claude.ai`
616 616
617617Bagian akhir pesan menyebutkan alasannya. Jika alasannya adalah error sertifikat seperti `unable to verify the first certificate`, lihat [TLS or SSL connection errors](#tls-or-ssl-connection-errors). Untuk alasan lainnya, lihat [Check network connectivity](#check-network-connectivity).Bagian akhir pesan memberikan alasannya. Jika berupa error sertifikat seperti `unable to verify the first certificate`, lihat [Error koneksi TLS atau SSL](#tls-or-ssl-connection-errors). Untuk alasan lainnya, lihat [Periksa konektivitas jaringan](#check-network-connectivity).
618 618
619### The connection dropped while downloading the update619### The connection dropped while downloading the update
620 620
621621Koneksi 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.Koneksi ke server unduhan tertutup saat `claude install` atau `claude update` sedang mengambil binary Claude Code, dan retry tidak berhasil memulihkannya. Claude Code mencoba ulang unduhan 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 unduhan dengan error polos `aborted` alih-alih mencoba ulang.
622 622
623```text theme={null}623```text theme={null}
624The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.624The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.
626 626
627Teks 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.627Teks 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.
628 628
629629Download 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.Unduhan yang tetap terhubung tetapi tidak selesai dalam 10 menit akan gagal dengan `Download timed out: exceeded the total deadline` sebagai gantinya. Claude Code tidak mencoba ulang unduhan yang kehabisan waktu, 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 tersebut.
630 630
631631Proxy atau gateway dapat menutup transfer yang panjang sebelum selesai, dan binary Claude Code adalah download yang besar.Proxy atau gateway dapat menutup transfer yang panjang sebelum selesai, dan binary Claude Code merupakan unduhan yang besar.
632 632
633**Yang harus dilakukan:**633**Yang harus dilakukan:**
634 634
635635* 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.* Jalankan `claude update` lagi. Pada jaringan yang selain itu sehat, unduhan biasanya berhasil pada percobaan berikutnya. Untuk pesan kehabisan waktu, jalankan lagi dari jaringan yang lebih cepat atau yang tidak terlalu dibatasi.
636636* Jika jaringan Anda memerlukan proxy, atur `HTTPS_PROXY` sebelum menjalankan installer atau `claude update`. Lihat [Check network connectivity](#check-network-connectivity).* Jika jaringan Anda memerlukan proxy, atur `HTTPS_PROXY` sebelum menjalankan penginstal atau `claude update`. Lihat [Periksa konektivitas jaringan](#check-network-connectivity).
637637* Jika proxy perusahaan terus menutup transfer, minta tim jaringan Anda untuk mengizinkan download penuh dari `downloads.claude.ai`. Lihat [Network access requirements](https://code.claude.com/docs/id/network-config.md#network-access-requirements).* Jika proxy perusahaan terus menutup transfer, mintalah tim jaringan Anda untuk mengizinkan unduhan penuh dari `downloads.claude.ai`. Lihat [Persyaratan akses jaringan](https://code.claude.com/docs/id/network-config.md#network-access-requirements).
638* Jalankan `claude doctor` dari shell Anda untuk diagnostik instalasi638* Jalankan `claude doctor` dari shell Anda untuk diagnostik instalasi
639 639
640### Release verification failed for Claude Code640### Release verification failed for Claude Code
641 641
642642Pesan 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.Pesan dari `claude update` atau `claude install` ini berarti Claude Code tidak dapat memastikan bahwa rilis yang akan diinstalnya asli, sehingga tidak menginstal apa pun. Versi apa pun yang sudah Anda miliki tetap berfungsi.
643 643
644```text theme={null}644```text theme={null}
645Release verification failed for Claude Code <version> (<reason>). The update was not installed.645Release verification failed for Claude Code <version> (<reason>). The update was not installed.
646```646```
647 647
648648Ambil langkah yang sesuai dengan nilai dalam tanda kurung di pesan Anda:Lakukan langkah yang sesuai dengan nilai dalam tanda kurung pada pesan Anda:
649 649
650650* **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 yang diawali dengan `sidecar_fetch_`**: jalankan lagi perintah yang sama dari shell Anda. `claude update` berhasil jika mencetak baris yang diawali dengan `Successfully updated from`, dan `claude install` berhasil jika mencetak `Claude Code successfully installed!`.
651651* **Nilai lainnya**: coba perintah yang sama lagi nanti* **Nilai lainnya**: coba lagi perintah yang sama nanti
652 652
653653Untuk nilai apa pun, jika pesan tersebut muncul lagi, [laporkan masalahnya](#still-stuck) dan sertakan pesan lengkapnya.Dengan nilai apa pun, jika pesan tersebut terus muncul, [laporkan masalahnya](#still-stuck) dan sertakan pesan lengkapnya.
654 654
655655### `Auto-update failed · Run claude doctor` in the session footer### `Auto-update failed · Run claude doctor` di footer sesi
656 656
657Baris 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.657Baris 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.
658 658
659659Baris 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](#find-your-error).Baris tersebut mengarahkan Anda ke `claude doctor`, yang baris `Last update attempt: failed (install_failed)`-nya memberikan tanggal tetapi tidak menyebutkan penyebabnya. Untuk menyelesaikan pembaruan atau melihat mengapa pembaruan gagal, jalankan `claude update` di shell Anda sebagai gantinya. Jika instalasi tersebut juga gagal, cari error yang dicetak oleh `claude update` di bawah [Temukan error Anda](#find-your-error).
660 660
661661### Wrong install command on Windows### Perintah instalasi yang salah di Windows
662 662
663663Jika 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.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 instalasi untuk shell atau sistem operasi yang berbeda. Jika perintah mencetak teks skrip alih-alih menginstal apa pun, Anda hanya menjalankan sebagian darinya.
664 664
665665* **`irm` not recognized**: Anda berada di CMD, bukan PowerShell. Anda memiliki dua opsi:* **`irm` tidak dikenali**: Anda berada di CMD, bukan PowerShell. Anda memiliki dua opsi:
666 666
667667 Buka PowerShell dengan mencari "PowerShell" di Start menu, kemudian jalankan perintah install asli: Buka PowerShell dengan mencari "PowerShell" di menu Start, lalu jalankan perintah instalasi aslinya:
668 668
669 ```powershell theme={null}669 ```powershell theme={null}
670 irm https://claude.ai/install.ps1 | iex670 irm https://claude.ai/install.ps1 | iex
671 ```671 ```
672 672
673673 Atau tetap di CMD dan gunakan CMD installer sebagai gantinya: Atau tetap di CMD dan gunakan penginstal CMD sebagai gantinya:
674 674
675 ```batch theme={null}675 ```batch theme={null}
676 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd676 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
677 ```677 ```
678 678
679679* **`&&` not a valid statement separator**: Anda berada di PowerShell tetapi menjalankan perintah CMD installer. Gunakan PowerShell installer:* **`&&` bukan pemisah pernyataan yang valid**: Anda berada di PowerShell tetapi menjalankan perintah penginstal CMD. Gunakan penginstal PowerShell:
680 ```powershell theme={null}680 ```powershell theme={null}
681 irm https://claude.ai/install.ps1 | iex681 irm https://claude.ai/install.ps1 | iex
682 ```682 ```
683 683
684684* **`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:* **`A parameter cannot be found that matches parameter name 'fsSL'`**: Anda menjalankan penginstal macOS/Linux `curl -fsSL ... | bash` di Windows PowerShell, tempat `curl` merupakan alias untuk `Invoke-WebRequest` dan menolak flag `-fsSL`. Gunakan penginstal PowerShell sebagai gantinya:
685 ```powershell theme={null}685 ```powershell theme={null}
686 irm https://claude.ai/install.ps1 | iex686 irm https://claude.ai/install.ps1 | iex
687 ```687 ```
688 688
689689* **`bash` not recognized**: Anda menjalankan installer macOS/Linux di Windows. Gunakan PowerShell installer sebagai gantinya:* **`bash` tidak dikenali**: Anda menjalankan penginstal macOS/Linux di Windows. Gunakan penginstal PowerShell sebagai gantinya:
690 ```powershell theme={null}690 ```powershell theme={null}
691 irm https://claude.ai/install.ps1 | iex691 irm https://claude.ai/install.ps1 | iex
692 ```692 ```
693 693
694694* **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:* **Perintah mencetak teks skrip alih-alih menginstal**: Anda menjalankan separuh perintah yang mengunduh tanpa bagian yang mengeksekusinya. `irm https://claude.ai/install.ps1` saja akan mencetak skrip yang diunduh ke terminal. Salurkan (pipe) ke `iex` untuk menjalankannya:
695 695
696 ```powershell theme={null}696 ```powershell theme={null}
697 irm https://claude.ai/install.ps1 | iex697 irm https://claude.ai/install.ps1 | iex
698 ```698 ```
699 699
700700 Di CMD, `curl -fsSL https://claude.ai/install.cmd` tanpa `-o` mencetak batch script alih-alih menyimpannya. Jalankan perintah lengkap: Di CMD, `curl -fsSL https://claude.ai/install.cmd` tanpa `-o` mencetak skrip batch alih-alih menyimpannya. Jalankan perintah lengkapnya:
701 701
702 ```batch theme={null}702 ```batch theme={null}
703 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd703 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
704 ```704 ```
705 705
706706Installer 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)`.Penginstal mana pun yang Anda gunakan, pastikan penginstal tersebut berhasil: buka terminal baru dan jalankan `claude --version`, yang mencetak nomor versi seperti `2.1.211 (Claude Code)`.
707 707
708### `running scripts is disabled on this system`708### `running scripts is disabled on this system`
709 709
715 + CategoryInfo : SecurityError: (:) [], PSSecurityException715 + CategoryInfo : SecurityError: (:) [], PSSecurityException
716```716```
717 717
718718Error 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.Error yang sama menyebutkan `claude.ps1` ketika Anda menjalankan `claude` setelah instalasi npm. Kebijakan eksekusi PowerShell memblokir skrip peluncur `.ps1` yang dibuat npm untuk perintah-perintahnya. Kebijakan tersebut berlaku untuk file skrip, sehingga tidak memengaruhi penginstal PowerShell `irm https://claude.ai/install.ps1 | iex`, yang menjalankan teks yang diunduh secara langsung.
719 719
720**Solusi:**720**Solusi:**
721 721
7227221. **Izinkan script yang dibuat secara lokal untuk pengguna Anda**, kemudian coba ulang:1. **Izinkan skrip yang dibuat secara lokal untuk pengguna Anda**, lalu coba lagi:
723 ```powershell theme={null}723 ```powershell theme={null}
724 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser724 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
725 ```725 ```
7267262. **Panggil launcher `.cmd` sebagai gantinya**: `npm.cmd` dan `claude.cmd` melakukan pekerjaan yang sama, dan kebijakan tidak mencakup mereka.2. **Panggil peluncur `.cmd` sebagai gantinya**: `npm.cmd` dan `claude.cmd` melakukan pekerjaan yang sama, dan kebijakan tersebut tidak mencakup keduanya.
7277273. **Gunakan [PowerShell installer](https://code.claude.com/docs/id/setup.md#install-claude-code)** alih-alih npm. Ini menginstal binary alih-alih script `.ps1`.3. **Gunakan [penginstal PowerShell](https://code.claude.com/docs/id/setup.md#install-claude-code)** alih-alih npm. Penginstal ini menginstal binary, bukan skrip `.ps1`.
728 728
729729### `The process cannot access the file` during Windows install### `The process cannot access the file` saat instalasi Windows
730 730
731731Jika 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.Jika penginstal PowerShell gagal dengan `Failed to download binary: The process cannot access the file ... because it is being used by another process`, penginstal tidak dapat menulis ke `%USERPROFILE%\.claude\downloads`. Hal ini biasanya berarti upaya instalasi sebelumnya masih berjalan, atau perangkat lunak antivirus sedang memindai binary yang terunduh sebagian di folder tersebut.
732 732
733733Tutup jendela PowerShell lain yang menjalankan installer dan tunggu pemindaian antivirus melepaskan file. Kemudian hapus folder downloads dan jalankan installer lagi:Tutup jendela PowerShell lain yang menjalankan penginstal dan tunggu hingga pemindaian antivirus melepaskan file tersebut. Kemudian hapus folder downloads dan jalankan penginstal lagi:
734 734
735```powershell theme={null}735```powershell theme={null}
736Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"736Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"
737irm https://claude.ai/install.ps1 | iex737irm https://claude.ai/install.ps1 | iex
738```738```
739 739
740740### `claude.exe` missing after an update on Windows### `claude.exe` hilang setelah pembaruan di Windows
741 741
742742Jika 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](#verify-your-path) sebagai gantinya. Untuk memperbarui di Windows, Claude Code mengganti nama `claude.exe` yang ada ke samping sebagai backup dan memindahkan versi baru ke tempatnya. Jika memindahkan versi baru ke tempat gagal dan Claude Code tidak dapat mengganti nama backup kembali juga, direktori menyimpan backup tetapi tidak memiliki `claude.exe`.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 tersebut sama sekali tidak ada di PATH Anda, lihat [Verifikasi PATH Anda](#verify-your-path) sebagai gantinya. Untuk memperbarui di Windows, Claude Code mengganti nama `claude.exe` yang ada menjadi cadangan dan memindahkan versi baru ke tempatnya. Jika pemindahan versi baru ke tempatnya gagal dan Claude Code juga tidak dapat mengembalikan nama cadangan tersebut, direktori tersebut tetap menyimpan cadangan tetapi tidak memiliki `claude.exe`.
743 743
744744Backup 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`:Cadangan tersebut adalah file di direktori yang sama yang namanya diawali dengan `claude.exe.old.` diikuti timestamp numerik. Jalankan perintah berikut di PowerShell untuk mengganti nama cadangan terbaru kembali menjadi `claude.exe`:
745 745
746```powershell theme={null}746```powershell theme={null}
747Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe747Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe
748```748```
749 749
750750Kemudian jalankan `claude --version` untuk mengonfirmasi perbaikan. `claude.exe` yang dipulihkan mencetak nomor versi.Kemudian jalankan `claude --version` untuk memastikan perbaikan berhasil. `claude.exe` yang dipulihkan akan mencetak nomor versi.
751 751
752Jika tidak ada file `claude.exe.old.*`, atau `claude` masih gagal setelah penggantian nama, instal ulang sebagai gantinya:752Jika tidak ada file `claude.exe.old.*`, atau `claude` masih gagal setelah penggantian nama, instal ulang sebagai gantinya:
753 753
755irm https://claude.ai/install.ps1 | iex755irm https://claude.ai/install.ps1 | iex
756```756```
757 757
758758Sebelum v2.1.281, Claude Code dapat menghapus backup sementara `claude.exe` masih hilang.Sebelum v2.1.281, Claude Code dapat menghapus cadangan saat `claude.exe` masih hilang.
759 759
760760### Install killed on low-memory Linux servers### Instalasi dihentikan di server Linux dengan memori rendah
761 761
762762Pesan `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:Pesan `Killed` saat instalasi biasanya berarti OOM (out-of-memory) killer Linux menghentikan langkah `claude install` karena sistem kehabisan memori bebas. Hal ini umum terjadi pada VPS kecil dan instans cloud. Skrip instalasi melaporkan penyebabnya dan keluar dengan kode 137. Dalam contoh ini, nomor baris dan ID proses bervariasi menurut rilis dan eksekusi:
763 763
764```text theme={null}764```text theme={null}
765Setting up Claude Code...765Setting up Claude Code...
768Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.768Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.
769```769```
770 770
771771Instalasi memerlukan kira-kira 512 MB memori bebas, dan menjalankan Claude Code memerlukan lebih banyak. Lihat [system requirements](https://code.claude.com/docs/id/setup.md#system-requirements).Instalasi memerlukan sekitar 512 MB memori bebas, dan menjalankan Claude Code memerlukan lebih banyak lagi. Lihat [persyaratan sistem](https://code.claude.com/docs/id/setup.md#system-requirements).
772 772
773**Solusi:**773**Solusi:**
774 774
7757751. **Tambahkan swap space** jika server Anda memiliki RAM terbatas. Swap menggunakan ruang disk sebagai memori overflow, memungkinkan instalasi selesai bahkan dengan RAM fisik rendah.1. **Tambahkan ruang swap** jika server Anda memiliki RAM terbatas. Swap menggunakan ruang disk sebagai memori luapan, sehingga instalasi dapat selesai meskipun RAM fisik rendah.
776 776
777 Buat file swap 2 GB dan aktifkan:777 Buat file swap 2 GB dan aktifkan:
778 778
783 sudo swapon /swapfile783 sudo swapon /swapfile
784 ```784 ```
785 785
786786 Kemudian coba ulang instalasi: Kemudian coba lagi instalasi:
787 787
788 ```bash theme={null}788 ```bash theme={null}
789 curl -fsSL https://claude.ai/install.sh | bash789 curl -fsSL https://claude.ai/install.sh | bash
790 ```790 ```
791 791
7927922. **Tutup proses lain** untuk membebaskan memori sebelum menginstal.2. **Tutup proses lain** untuk mengosongkan memori sebelum menginstal.
793 793
7947943. **Gunakan instance yang lebih besar** jika memungkinkan. Claude Code memerlukan setidaknya 4 GB RAM.3. **Gunakan instans yang lebih besar** jika memungkinkan. Claude Code memerlukan RAM minimal 4 GB.
795 795
796### Installation was killed before it could finish796### Installation was killed before it could finish
797 797
798798Script 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:Skrip instalasi 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 berasal dari OOM (out-of-memory) killer kernel. Skrip mencetak penjelasan ini dan keluar dengan kode 137:
799 799
800```text theme={null}800```text theme={null}
801Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.801Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.
802Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.802Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.
803```803```
804 804
805805Untuk 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.Untuk sinyal fatal lainnya, dan untuk exit code 137 di macOS, skrip mencetak `Installation was killed before it could finish (exit code <N>)` dengan exit code yang sebenarnya dan menghilangkan penjelasan tentang kehabisan memori. Pesan ini berasal dari skrip instalasi yang digunakan macOS dan Linux, yang juga mencakup instalasi di dalam WSL; skrip instalasi Windows native tidak pernah mencetaknya. Sebelum v2.1.200, skrip keluar hanya dengan baris `Killed` polos dari shell.
806 806
807**Yang harus dilakukan:**807**Yang harus dilakukan:**
808 808
809809* Hentikan proses lain untuk membebaskan memori, lalu jalankan ulang installer* Hentikan proses lain untuk mengosongkan memori, lalu jalankan ulang penginstal
810810* Tambahkan swap space atau pindah ke instance yang lebih besar. Lihat [Install killed on low-memory Linux servers](#install-killed-on-low-memory-linux-servers) untuk perintah file swap.* Tambahkan ruang swap atau pindah ke instans yang lebih besar. Lihat [Instalasi dihentikan di server Linux dengan memori rendah](#install-killed-on-low-memory-linux-servers) untuk perintah file swap.
811 811
812812### Install hangs in Docker### Instalasi macet di Docker
813 813
814814Saat menginstal Claude Code di Docker container, menginstal sebagai root ke `/` dapat menyebabkan hang.Saat menginstal Claude Code di container Docker, menginstal sebagai root ke `/` dapat menyebabkan instalasi macet.
815 815
816**Solusi:**816**Solusi:**
817 817
8188181. **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:1. **Atur direktori kerja** sebelum menjalankan penginstal. Ketika dijalankan dari `/`, penginstal memindai seluruh filesystem, yang menyebabkan penggunaan memori berlebihan. Mengatur `WORKDIR` membatasi pemindaian ke direktori kecil:
819 ```dockerfile theme={null}819 ```dockerfile theme={null}
820 WORKDIR /tmp820 WORKDIR /tmp
821 RUN curl -fsSL https://claude.ai/install.sh | bash821 RUN curl -fsSL https://claude.ai/install.sh | bash
822 ```822 ```
823 823
8248242. **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.2. **Berikan lebih banyak memori ke Docker** jika menggunakan Docker Desktop. Container build berbagi memori yang dialokasikan ke mesin virtual Docker Desktop, jadi buka **Settings > Resources** di Docker Desktop, naikkan batas memori, dan jalankan ulang build.
825 825
826826### `Raw mode is not supported` during install### `Raw mode is not supported` saat instalasi
827 827
828828Ketika [server-managed settings](https://code.claude.com/docs/id/server-managed-settings.md) organisasi Anda menyertakan perubahan yang memerlukan [security approval](https://code.claude.com/docs/id/server-managed-settings.md#security-approval-dialogs), 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`.Ketika [pengaturan yang dikelola server](https://code.claude.com/docs/id/server-managed-settings.md) organisasi Anda menyertakan perubahan yang memerlukan [persetujuan keamanan](https://code.claude.com/docs/id/server-managed-settings.md#security-approval-dialogs), versi Claude Code sebelum 2.1.246 mencoba menampilkan dialog persetujuan selama `claude install`. Dialog tersebut memerlukan terminal pada stdin. Ketika penginstal menjalankan `claude install` dari pipe, seperti yang dilakukan `curl -fsSL https://claude.ai/install.sh | bash`, stdin adalah pipe dan bukan terminal, sehingga instalasi gagal dengan error yang berisi `Raw mode is not supported`.
829 829
830830Claude 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](https://code.claude.com/docs/id/server-managed-settings.md#enforce-fail-closed-startup), seperti ketika mengatur `forceRemoteSettingsRefresh`, dialog masih muncul selama perintah ini, dan install yang dijalankan dari pipe masih gagal.Claude Code v2.1.246 dan yang lebih baru tidak menampilkan dialog tersebut selama `claude install` atau `claude update`. Perintah berjalan dengan pengaturan yang terakhir Anda setujui, dan Claude Code menampilkan dialog tersebut di sesi interaktif Anda berikutnya. Jika konfigurasi startup organisasi Anda [menunggu pengambilan pengaturan](https://code.claude.com/docs/id/server-managed-settings.md#enforce-fail-closed-startup), seperti ketika konfigurasi tersebut mengatur `forceRemoteSettingsRefresh`, dialog tersebut tetap muncul selama perintah-perintah ini, dan instalasi yang dijalankan dari pipe tetap gagal.
831 831
832832Di 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:Dalam setiap konfigurasi lainnya, menjalankan ulang penginstal akan melewati error ini, karena skrip menjalankan perintah `install` dari rilis terbaru bahkan ketika Anda memintanya untuk menginstal versi yang lebih lama. Jalankan ulang perintah untuk platform Anda:
833 833
834> [tab] macOS/Linux834> [tab] macOS/Linux
835>835>
845 845
846`claude --version` mencetak versi yang diinstal oleh eksekusi ulang tersebut.846`claude --version` mencetak versi yang diinstal oleh eksekusi ulang tersebut.
847 847
848848### `claude update` or `claude doctor` hangs### `claude update` atau `claude doctor` macet
849 849
850850`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`.`claude update` dan `claude doctor` memindai file konfigurasi shell Anda untuk mencari alias `claude` yang usang: `~/.zshrc`, `~/.bashrc`, dan `~/.config/fish/config.fish`, ditambah di macOS file pertama yang ada di antara `~/.bash_profile`, `~/.bash_login`, atau `~/.profile`. Jika Anda mengatur `ZDOTDIR`, file Zsh-nya 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 macet dan membiarkan bagian System diagnostics dari `/status` kosong. `claude doctor` macet tanpa output; `claude update` macet tepat setelah mencetak `Checking for updates`.
851 851
852852Jika 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:Jika Anda mengalami macet ini pada versi yang lebih lama, temukan direktori tersebut. Dalam output perintah ini, baris yang diawali dengan `d` menandai path tersebut sebagai direktori. Baris `No such file or directory` berarti tidak ada apa pun di path tersebut dan bukan penyebabnya:
853 853
854```bash theme={null}854```bash theme={null}
855ls -ld ~/.zshrc ~/.bashrc ~/.bash_profile ~/.bash_login ~/.profile ~/.config/fish/config.fish855ls -ld ~/.zshrc ~/.bashrc ~/.bash_profile ~/.bash_login ~/.profile ~/.config/fish/config.fish
856```856```
857 857
858858Pindahkan 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](https://code.claude.com/docs/id/setup.md#install-claude-code) sebagai gantinya.Pindahkan direktori tersebut ke tempat lain, atau perbarui ke v2.1.214 atau yang lebih baru. Karena `claude update` macet pada versi yang terdampak, perbarui dengan menjalankan ulang [skrip instalasi](https://code.claude.com/docs/id/setup.md#install-claude-code) sebagai gantinya.
859 859
860860### Claude Desktop overrides the `claude` command on Windows### Claude Desktop menimpa perintah `claude` di Windows
861 861
862862Jika 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.Jika Anda menginstal versi lama Claude Desktop, aplikasi tersebut mungkin mendaftarkan `Claude.exe` di direktori `WindowsApps` yang mendapat prioritas PATH di atas Claude Code CLI. Menjalankan `claude` akan membuka aplikasi Desktop alih-alih CLI.
863 863
864Perbarui Claude Desktop ke versi terbaru untuk memperbaiki masalah ini.864Perbarui Claude Desktop ke versi terbaru untuk memperbaiki masalah ini.
865 865
866### Claude Code on Windows requires either Git for Windows (for bash) or PowerShell866### Claude Code on Windows requires either Git for Windows (for bash) or PowerShell
867 867
868868Git for Windows bersifat opsional. Claude Code menggunakan [PowerShell tool](https://code.claude.com/docs/id/tools-reference.md#powershell-tool) saat Git Bash tidak ada, jadi error ini berarti tidak ada shell yang ditemukan.Git for Windows bersifat opsional. Claude Code menggunakan [tool PowerShell](https://code.claude.com/docs/id/tools-reference.md#powershell-tool) ketika Git Bash tidak ada, sehingga error ini berarti tidak ada shell yang ditemukan.
869 869
870870**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](https://aka.ms/powershell), yang menyediakan `pwsh`.**Jika PowerShell tidak ada di PATH Anda**, lokasi default-nya adalah `C:\Windows\System32\WindowsPowerShell\v1.0\`. Tambahkan direktori tersebut ke `PATH` Anda, atau instal [PowerShell 7](https://aka.ms/powershell), yang menyediakan `pwsh`.
871 871
872872**Untuk menginstal Git for Windows sebagai gantinya**, unduh dari [git-scm.com/downloads/win](https://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.**Untuk menginstal Git for Windows sebagai gantinya**, unduh dari [git-scm.com/downloads/win](https://git-scm.com/downloads/win). Selama penyiapan, pilih "Add to PATH." Mulai ulang terminal Anda setelah menginstal. Menginstalnya akan mengaktifkan tool Bash, yang berguna saat bekerja dengan skrip dan alat berbasis Bash.
873 873
874874**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:**Jika Git sudah terinstal** tetapi Claude Code tidak dapat menemukannya, bandingkan lokasinya dengan tempat-tempat yang diperiksa Claude Code. Ketika `CLAUDE_CODE_GIT_BASH_PATH` tidak diatur, Claude Code mencari `bash.exe` dengan urutan berikut:
875 875
8761. Lokasi instalasi default `C:\Program Files\Git` dan `C:\Program Files (x86)\Git`.8761. Lokasi instalasi default `C:\Program Files\Git` dan `C:\Program Files (x86)\Git`.
8778772. `git` di `PATH` Anda, menggunakan `bin\bash.exe` dari instalasi Git itu.2. `git` di `PATH` Anda, menggunakan `bin\bash.exe` dari instalasi Git tersebut.
878 878
879879Di 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.Pada langkah 2, Claude Code melewati `git` yang berada di folder tempat Anda meluncurkan Claude Code, atau di bawahnya dalam 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`. Hal ini mencegah Claude Code menjalankan executable yang ditempatkan di sana oleh sebuah proyek. Jika Git Anda berada di lokasi seperti itu, arahkan `CLAUDE_CODE_GIT_BASH_PATH` ke lokasi tersebut.
880 880
881881**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](https://code.claude.com/docs/id/settings.md) Anda:**Untuk mengarahkan Claude Code ke instalasi Git tertentu**, temukan dengan menjalankan `where.exe git` di PowerShell, lalu atur path `bin\bash.exe` dari instalasi tersebut sebagai `CLAUDE_CODE_GIT_BASH_PATH` di [file settings.json](https://code.claude.com/docs/id/settings.md) Anda:
882 882
883```json theme={null}883```json theme={null}
884{884{
888}888}
889```889```
890 890
891891**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 `CLAUDE_CODE_GIT_BASH_PATH` diatur ke path yang benar dan file tersebut ada** tetapi Claude Code tetap tidak menggunakannya, periksa nama file tersebut terlebih dahulu. Claude Code hanya menerima file bernama `bash.exe`, `sh.exe`, `bash`, atau `sh`; dengan nama lain, seperti peluncur `git-bash.exe` milik Git for Windows, Claude Code mengabaikan variabel tersebut dan mendeteksi Git Bash secara otomatis seolah-olah variabel itu tidak diatur, sambil mencatat peringatan yang terlihat dengan `--debug`. Path yang tidak ada mendapatkan fallback dan peringatan 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 tersebut tidak ada.
892 892
893893Jika 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.Jika nama file sudah benar, perangkat lunak keamanan endpoint seperti AppLocker, kebijakan pembatasan perangkat lunak Group Policy, atau agent EDR mungkin mengganggu. Mintalah tim IT Anda untuk menambahkan `claude.exe` dan proses yang dijalankannya, termasuk `cmd.exe` dan `bash.exe`, ke allowlist dalam kebijakan perlindungan endpoint Anda.
894 894
895### Claude Code does not support 32-bit Windows895### Claude Code does not support 32-bit Windows
896 896
897897Windows 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:Windows menyertakan dua entri PowerShell di menu Start: `Windows PowerShell` dan `Windows PowerShell (x86)`. Entri x86 berjalan sebagai proses 32-bit dan memicu error ini bahkan pada mesin 64-bit. Untuk memeriksa kasus mana yang Anda alami, jalankan ini di jendela yang sama yang menghasilkan error:
898 898
899```powershell theme={null}899```powershell theme={null}
900[Environment]::Is64BitOperatingSystem900[Environment]::Is64BitOperatingSystem
901```901```
902 902
903903Jika 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 `True`, sistem operasi Anda tidak bermasalah. Tutup jendela tersebut, buka `Windows PowerShell` tanpa akhiran x86, dan jalankan lagi perintah instalasi.
904 904
905905Jika ini mencetak `False`, Anda berada di edisi Windows 32-bit. Claude Code memerlukan sistem operasi 64-bit. Lihat [system requirements](https://code.claude.com/docs/id/setup.md#system-requirements).Jika ini mencetak `False`, Anda menggunakan edisi Windows 32-bit. Claude Code memerlukan sistem operasi 64-bit. Lihat [persyaratan sistem](https://code.claude.com/docs/id/setup.md#system-requirements).
906 906
907907### Linux musl or glibc binary mismatch### Ketidakcocokan binary musl atau glibc di Linux
908 908
909909Jika 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.Jika Anda melihat error tentang shared library yang hilang seperti `ld-linux-x86-64.so.2` atau `ld-linux-aarch64.so.1` setelah instalasi, penginstal mungkin telah mengunduh varian binary yang salah untuk sistem Anda.
910 910
911```text theme={null}911```text theme={null}
912912Error loading shared library libstdc++.so.6: No such file or directoryError loading shared library ld-linux-x86-64.so.2: No such file or directory
913```913```
914 914
915Ini dapat terjadi pada sistem berbasis glibc yang memiliki paket cross-compilation musl terinstal, menyebabkan installer salah mendeteksi sistem sebagai musl.
916
917**Solusi:**915**Solusi:**
918 916
9191. **Periksa libc mana yang digunakan sistem Anda**:9171. **Periksa libc mana yang digunakan sistem Anda**:
922 ```920 ```
923 Output yang menyebutkan `GNU libc` atau `GLIBC` berarti glibc. Output yang menyebutkan `musl` berarti musl.921 Output yang menyebutkan `GNU libc` atau `GLIBC` berarti glibc. Output yang menyebutkan `musl` berarti musl.
924 922
9259232. **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](https://github.com/anthropics/claude-code/issues) dengan output `ldd --version` dan `ls /lib/libc.musl*`.2. **Jika Anda menggunakan glibc tetapi mendapatkan binary musl**, hapus instalasi dan instal ulang. Anda juga dapat mengunduh binary yang benar secara manual menggunakan manifest di `https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json`. Ajukan [issue GitHub](https://github.com/anthropics/claude-code/issues) dengan output dari `ldd --version` dan `ls /lib/libc.musl*`.
926 924
9279253. **Jika Anda benar-benar di musl**, seperti Alpine Linux, instal paket yang diperlukan:3. **Jika Anda menggunakan musl tetapi mendapatkan binary glibc**, [hapus instalasi](https://code.claude.com/docs/id/setup.md#uninstall-claude-code). Di Alpine Linux, instal terlebih dahulu paket-paket yang disebutkan dalam [penyiapan Alpine Linux](https://code.claude.com/docs/id/setup.md#alpine-linux-and-musl-based-distributions). Kemudian jalankan [perintah instalasi](https://code.claude.com/docs/id/setup.md#install-claude-code), yang menginstal binary musl.
928 ```bash theme={null}
929 apk add libgcc libstdc++ ripgrep
930 ```
931 Di Alpine, `ripgrep` berada di community repository. Jika `apk` melaporkan bahwa paket hilang, lihat [Alpine Linux setup](https://code.claude.com/docs/id/setup.md#alpine-linux-and-musl-based-distributions).
932 926
933### `Illegal instruction`927### `Illegal instruction`
934 928
935929Jika menjalankan `claude` atau installer mencetak `Illegal instruction`, binary native menggunakan instruksi CPU yang tidak didukung prosesor Anda. Ada dua penyebab yang berbeda.Jika menjalankan `claude` atau penginstal mencetak `Illegal instruction`, binary native menggunakan instruksi CPU yang tidak didukung prosesor Anda. Ada dua penyebab berbeda.
936 930
937931**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](https://github.com/anthropics/claude-code/issues) dengan output tersebut.**Ketidakcocokan arsitektur.** Penginstal mengunduh binary yang salah, misalnya x86 pada 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, [ajukan issue GitHub](https://github.com/anthropics/claude-code/issues) dengan output tersebut.
938 932
939933**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.**Set instruksi AVX tidak ada.** Jika arsitektur Anda benar tetapi Anda masih melihat `Illegal instruction`, CPU Anda kemungkinan tidak memiliki AVX atau instruksi lain yang diperlukan binary. Hal ini memengaruhi prosesor Intel dan AMD dari sekitar sebelum tahun 2013, serta mesin virtual yang hypervisor-nya tidak meneruskan AVX ke guest.
940 934
941935Di VPS atau VM, jalankan `grep -m1 -ow avx /proc/cpuinfo`; hasil kosong berarti AVX tidak tersedia untuk guest.Pada VPS atau VM, jalankan `grep -m1 -ow avx /proc/cpuinfo`; hasil kosong berarti AVX tidak tersedia untuk guest.
942 936
943937Tidak ada workaround untuk binary native; pantau [issue #50384](https://github.com/anthropics/claude-code/issues/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.Tidak ada solusi alternatif untuk binary native; pantau [issue #50384](https://github.com/anthropics/claude-code/issues/50384) untuk statusnya, dan sertakan model CPU Anda dari `grep -m1 "model name" /proc/cpuinfo` di Linux atau `sysctl -n machdep.cpu.brand_string` di macOS saat melapor.
944 938
945939Metode instalasi alternatif mengunduh binary native yang sama dan tidak akan menyelesaikan penyebab mana pun.Metode instalasi alternatif mengunduh binary native yang sama dan tidak akan mengatasi kedua penyebab tersebut.
946 940
947941### `dyld: cannot load` on macOS### `dyld: cannot load` di macOS
948 942
949943Jika Anda melihat `dyld: Symbol not found`, `dyld: cannot load`, atau `Abort trap: 6` selama instalasi, binary tidak kompatibel dengan versi macOS atau hardware Anda.Jika Anda melihat `dyld: Symbol not found`, `dyld: cannot load`, atau `Abort trap: 6` saat instalasi, binary tersebut tidak kompatibel dengan versi macOS atau perangkat keras Anda.
950 944
951945Error `Symbol not found` yang mereferensikan `libicucore` berarti versi macOS Anda lebih lama dari yang didukung binary:Error `Symbol not found` yang merujuk ke `libicucore` berarti versi macOS Anda lebih lama daripada yang didukung binary:
952 946
953```text theme={null}947```text theme={null}
954dyld: Symbol not found: _ubrk_clone948dyld: Symbol not found: _ubrk_clone
956 Expected in: /usr/lib/libicucore.A.dylib950 Expected in: /usr/lib/libicucore.A.dylib
957```951```
958 952
959953Loader dapat juga menolak load commands binary, yang juga berarti versi macOS Anda terlalu lama:Loader juga dapat menolak load command binary, yang juga berarti versi macOS Anda terlalu lama:
960 954
961```text theme={null}955```text theme={null}
962dyld: cannot load 'claude-2.1.42-darwin-x64' (load command 0x80000034 is unknown)956dyld: cannot load 'claude-2.1.42-darwin-x64' (load command 0x80000034 is unknown)
965 959
966**Solusi:**960**Solusi:**
967 961
9689621. **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.1. **Periksa versi macOS Anda**: Claude Code memerlukan macOS 13.0 atau yang lebih baru. Buka menu Apple dan pilih About This Mac untuk memeriksa versi Anda.
969 963
9709642. **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.2. **Perbarui macOS** jika Anda menggunakan versi yang lebih lama. Binary menggunakan load command dan library sistem yang tidak didukung oleh versi macOS yang lebih lama. Metode instalasi alternatif seperti Homebrew mengunduh binary yang sama dan tidak akan mengatasi error ini.
971 965
972966### `Bus error` while a session is running### `Bus error` saat sesi sedang berjalan
973 967
974968Jika 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.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 penyimpanan jaringan, saat sesi berjalan.
975 969
976970Sebelum 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.Sebelum pesan shell, runtime Claude Code dapat mencetak laporan crash yang mencakup `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 tersebut 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.
977 971
978972Mulai sesi baru untuk melanjutkan. Jika Claude Code diinstal di network storage, ikuti [Install on network storage](https://code.claude.com/docs/id/setup.md#install-on-network-storage) agar upgrade tidak menghapus binary yang masih dibutuhkan oleh sesi yang sedang berjalan.Mulai sesi baru untuk melanjutkan. Jika Claude Code diinstal di penyimpanan jaringan, ikuti [Instal di penyimpanan jaringan](https://code.claude.com/docs/id/setup.md#install-on-network-storage) agar peningkatan versi tidak menghapus binary yang masih dibutuhkan oleh sesi yang sedang berjalan.
979 973
980974### `Exec format error` on WSL1### `Exec format error` di WSL1
981 975
982976Jika 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](https://github.com/anthropics/claude-code/issues/38788). Program headers binary berubah dengan cara yang tidak dapat ditangani oleh loader WSL1.Jika menjalankan `claude` di WSL mencetak `cannot execute binary file: Exec format error`, Anda menggunakan WSL1 dan mengalami regresi binary native yang diketahui dan dilacak di [issue #38788](https://github.com/anthropics/claude-code/issues/38788). Program header binary berubah dengan cara yang tidak dapat ditangani oleh loader WSL1.
983 977
984Perbaikan paling bersih adalah mengonversi distribusi Anda ke WSL2 dari PowerShell:978Perbaikan paling bersih adalah mengonversi distribusi Anda ke WSL2 dari PowerShell:
985 979
987wsl --set-version <DistroName> 2981wsl --set-version <DistroName> 2
988```982```
989 983
990984Jika 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:Jika Anda perlu tetap menggunakan WSL1, panggil binary melalui dynamic linker. Tambahkan fungsi ini ke `~/.bashrc` di dalam WSL, ganti path-nya jika direktori home Anda berbeda:
991 985
992```bash theme={null}986```bash theme={null}
993claude() {987claude() {
995}989}
996```990```
997 991
998992Kemudian jalankan `source ~/.bashrc` dan coba ulang `claude`.Kemudian jalankan `source ~/.bashrc` dan coba lagi `claude`.
999 993
1000994### npm install errors in WSL### Error instalasi npm di WSL
1001 995
1002996Masalah ini berlaku jika Anda menginstal Claude Code dengan `npm install -g` di dalam WSL. Jika Anda menggunakan [native installer](https://code.claude.com/docs/id/setup.md), lewati bagian ini. Di npm 12, instal seperti yang dijelaskan dalam [Memperbaiki instalasi npm 12](#fix-an-npm-12-install).Masalah-masalah ini berlaku jika Anda menginstal Claude Code dengan `npm install -g` di dalam WSL. Jika Anda menggunakan [penginstal native](https://code.claude.com/docs/id/setup.md), lewati bagian ini. Di npm 12, instal sebagaimana dijelaskan di [Perbaiki instalasi npm 12](#fix-an-npm-12-install).
1003 997
1004998**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`.**Masalah deteksi OS atau platform.** Jika npm melaporkan ketidakcocokan platform saat instalasi, WSL kemungkinan menggunakan `npm` Windows. Jalankan `npm config set os linux` terlebih dahulu, lalu instal dengan `npm install -g @anthropic-ai/claude-code --force`. Jangan gunakan `sudo`.
1005 999
10061000**`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`](https://github.com/nvm-sh/nvm).**`exec: node: not found` saat menjalankan `claude`.** Lingkungan WSL Anda kemungkinan menggunakan instalasi Node.js Windows. Konfirmasikan dengan `which npm` dan `which node`: path yang diawali dengan `/mnt/c/` adalah binary Windows, sedangkan path Linux diawali dengan `/usr/`. Untuk memperbaikinya, instal Node melalui package manager distribusi Linux Anda atau melalui [`nvm`](https://github.com/nvm-sh/nvm).
1007 1001
10081002**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`:**Konflik versi nvm.** Jika Anda memiliki nvm yang terinstal di WSL dan Windows, berpindah versi Node di WSL mungkin gagal karena WSL mengimpor PATH Windows secara default dan nvm Windows mendapat prioritas. Penyebab paling umum adalah nvm tidak dimuat di shell Anda. Tambahkan loader nvm ke `~/.bashrc` atau `~/.zshrc`:
1009 1003
1010```bash theme={null}1004```bash theme={null}
1011export NVM_DIR="$HOME/.nvm"1005export NVM_DIR="$HOME/.nvm"
1013[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"1007[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
1014```1008```
1015 1009
10161010Atau muat di sesi saat ini:Atau muat di sesi Anda saat ini:
1017 1011
1018```bash theme={null}1012```bash theme={null}
1019source ~/.nvm/nvm.sh1013source ~/.nvm/nvm.sh
1020```1014```
1021 1015
10221016Jika nvm dimuat tetapi path Windows masih mendapat prioritas, tambahkan path Node Linux Anda di depan secara eksplisit:Jika nvm sudah dimuat tetapi path Windows masih mendapat prioritas, tambahkan path Node Linux Anda di awal secara eksplisit:
1023 1017
1024```bash theme={null}1018```bash theme={null}
1025export PATH="$HOME/.nvm/versions/node/$(node -v)/bin:$PATH"1019export PATH="$HOME/.nvm/versions/node/$(node -v)/bin:$PATH"
1027 1021
1028> [!WARNING]1022> [!WARNING]
1029>1023>
10301024> 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.> Hindari menonaktifkan impor PATH Windows melalui `appendWindowsPath = false` karena hal ini merusak kemampuan untuk memanggil executable Windows dari WSL. Demikian pula, hindari menghapus instalasi Node.js dari Windows jika Anda menggunakannya untuk pengembangan Windows.
1031 1025
10321026### Permission errors during installation### Error permission saat instalasi
1033 1027
10341028Jika native installer gagal dengan error permission, direktori target mungkin tidak dapat ditulis. Lihat [Check directory permissions](#check-directory-permissions).Jika penginstal native gagal dengan error permission, direktori target mungkin tidak dapat ditulis. Lihat [Periksa hak akses direktori](#check-directory-permissions).
1035 1029
10361030Jika Anda sebelumnya menginstal dengan npm dan mengalami error permission khusus npm, beralih ke native installer:Jika sebelumnya Anda menginstal dengan npm dan mengalami error permission khusus npm, beralihlah ke penginstal native:
1037 1031
1038```bash theme={null}1032```bash theme={null}
1039curl -fsSL https://claude.ai/install.sh | bash1033curl -fsSL https://claude.ai/install.sh | bash
1040```1034```
1041 1035
10421036### Native binary not found after npm install### Binary native tidak ditemukan setelah instalasi npm
1043 1037
10441038Paket npm `@anthropic-ai/claude-code` mengunduh binary native sebagai optional dependency per platform, seperti `@anthropic-ai/claude-code-darwin-arm64`. `claude` adalah script placeholder sampai langkah postinstall paket `@anthropic-ai/claude-code` berjalan dan mengganti placeholder tersebut dengan binary itu. Jika download atau langkah postinstall dilewati, placeholder tetap ada, dan menjalankan `claude` di macOS dan Linux mencetak:Paket npm `@anthropic-ai/claude-code` mengunduh binary native sebagai dependensi opsional per platform, seperti `@anthropic-ai/claude-code-darwin-arm64`. `claude` merupakan skrip placeholder hingga langkah postinstall paket `@anthropic-ai/claude-code` berjalan dan mengganti placeholder tersebut dengan binary itu. Jika unduhan atau langkah postinstall dilewati, placeholder tetap berada di tempatnya, dan menjalankan `claude` di macOS dan Linux akan mencetak:
1045 1039
1046```text theme={null}1040```text theme={null}
1047Error: claude native binary not installed.1041Error: claude native binary not installed.
1056Or reinstall without --ignore-scripts / --omit=optional.1050Or reinstall without --ignore-scripts / --omit=optional.
1057```1051```
1058 1052
10591053Di 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.Di Windows, `bin/claude.exe` adalah placeholder skrip shell yang sama, bukan executable sungguhan, sehingga PowerShell dan CMD melaporkan bahwa mereka tidak dapat menjalankan file tersebut alih-alih mencetak pesan ini.
1060 1054
10611055Periksa penyebab berikut:Periksa penyebab-penyebab berikut:
1062 1056
10631057* **npm 12 melewati langkah postinstall secara default.** Ketika Anda menginstal atau memperbarui Claude Code dengan npm 12, npm tetap menyelesaikan instalasi tanpa menjalankan langkah tersebut. Lihat [Memperbaiki instalasi npm 12](#fix-an-npm-12-install).* **npm 12 melewati langkah postinstall secara default.** Ketika Anda menginstal atau memperbarui Claude Code dengan npm 12, npm tetap menyelesaikan instalasi tanpa menjalankan langkah tersebut. Lihat [Perbaiki instalasi npm 12](#fix-an-npm-12-install).
10641058* **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.* **Dependensi opsional dinonaktifkan.** Hapus `--omit=optional` dari perintah instalasi npm Anda, `--no-optional` dari pnpm, atau `--ignore-optional` dari yarn, dan periksa bahwa `.npmrc` tidak mengatur `optional=false`. Kemudian instal ulang. Binary native hanya dikirimkan sebagai dependensi opsional, sehingga tidak ada fallback JavaScript jika dilewati, dan menjalankan `install.cjs` lagi tidak dapat menempatkan binary yang tidak pernah diunduh.
10651059* **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.* **Skrip instalasi dinonaktifkan.** `--ignore-scripts` dan beberapa konfigurasi pnpm melewati langkah postinstall tetapi tetap mengunduh paket platform. Jalankan `node node_modules/@anthropic-ai/claude-code/install.cjs` seperti yang disarankan pesan tersebut, atau instal ulang tanpa flag tersebut. Jika postinstall sama sekali tidak dapat berjalan di lingkungan Anda, `node node_modules/@anthropic-ai/claude-code/cli-wrapper.cjs` menemukan paket yang diunduh dan meluncurkannya, dengan konsekuensi adanya proses Node tambahan pada setiap startup. Jika wrapper mencetak `Could not find native binary package` sebagai gantinya, paket platform tidak pernah diunduh, jadi perbaiki terlebih dahulu penyebab dependensi opsional di atas.
10661060* **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](https://code.claude.com/docs/id/setup.md#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.* **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 [persyaratan sistem](https://code.claude.com/docs/id/setup.md#system-requirements). Di FreeBSD, penginstal melaporkan platform tersebut sebagai tidak didukung. Sebelum v2.1.205, penginstal memperlakukan FreeBSD sebagai Linux dan mengunduh binary yang tidak dapat berjalan.
1067* **Mirror npm perusahaan tidak memiliki paket platform.** Pastikan registry Anda mencerminkan kedelapan paket platform `@anthropic-ai/claude-code-*` selain paket meta.1061* **Mirror npm perusahaan tidak memiliki paket platform.** Pastikan registry Anda mencerminkan kedelapan paket platform `@anthropic-ai/claude-code-*` selain paket meta.
1068 1062
10691063#### Memperbaiki instalasi npm 12#### Perbaiki instalasi npm 12
1070 1064
10711065Jika `claude` mencetak `Error: claude native binary not installed.` setelah instalasi atau pembaruan npm, atau di Windows shell tidak dapat menjalankannya, jalankan `npm --version`. Versi yang dimulai dengan `12` berarti bahwa, kecuali konfigurasi npm Anda mengizinkannya, npm melewati langkah postinstall Claude Code, yang menempatkan binary. Untuk versi lainnya, periksa [penyebab lain](#native-binary-not-found-after-npm-install).Jika `claude` mencetak `Error: claude native binary not installed.` setelah instalasi atau pembaruan npm, atau di Windows shell tidak dapat menjalankannya, jalankan `npm --version`. Versi yang diawali dengan `12` berarti bahwa, kecuali konfigurasi npm Anda mengizinkannya, npm melewati langkah postinstall Claude Code, yang bertugas menempatkan binary. Untuk versi lainnya, periksa [penyebab lain](#native-binary-not-found-after-npm-install).
1072 1066
10731067Untuk memperbaiki instalasi npm 12, beralih ke native installer atau izinkan langkah tersebut:Untuk memperbaiki instalasi npm 12, beralihlah ke penginstal native atau izinkan langkah tersebut:
1074 1068
10751069* **Beralih ke native installer**: [instal dengan native installer](https://code.claude.com/docs/id/setup.md#install-claude-code), lalu [hapus instalasi paket npm](https://code.claude.com/docs/id/setup.md#uninstall-with-npm). Pembaruan selanjutnya tidak menggunakan npm, sehingga error tidak muncul kembali.* **Beralih ke penginstal native**: [instal dengan penginstal native](https://code.claude.com/docs/id/setup.md#install-claude-code), lalu [hapus instalasi paket npm](https://code.claude.com/docs/id/setup.md#uninstall-with-npm). Pembaruan selanjutnya tidak menggunakan npm, sehingga error tersebut tidak akan muncul kembali.
10761070* **Tetap menggunakan npm**: untuk instalasi npm global, tambahkan Claude Code ke `allow-scripts` di konfigurasi npm pengguna Anda. npm kemudian menjalankan install scripts Claude Code pada setiap instalasi dan pembaruan berikutnya, serta dalam instalasi proyek yang `package.json`-nya tidak mengatur `allowScripts`.* **Tetap menggunakan npm**: untuk instalasi npm global, tambahkan Claude Code ke `allow-scripts` dalam konfigurasi npm pengguna Anda. npm kemudian menjalankan skrip instalasi Claude Code pada setiap instalasi dan pembaruan berikutnya, serta pada instalasi proyek yang `package.json`-nya tidak mengatur `allowScripts`.
1077 1071
10781072 Gunakan native installer untuk instalasi lokal di `~/.claude/local`. Gunakan juga jika script `package.json` Anda memanggil `npm install` dan Anda menjalankannya dengan pnpm 9, pnpm 10, Yarn 1, atau alat lain yang meneruskan pengaturan ini kepadanya. Di npm 12.1 dan lebih baru, instalasi tersebut dapat gagal dengan `EALLOWSCRIPTS` setelah pengaturan disimpan. Gunakan penginstal native untuk instalasi lokal di `~/.claude/local`. Gunakan juga penginstal native jika skrip `package.json` Anda memanggil `npm install` dan Anda menjalankannya dengan pnpm 9, pnpm 10, Yarn 1, atau alat lain yang meneruskan pengaturan ini kepada skrip tersebut. Di npm 12.1 dan yang lebih baru, instalasi tersebut dapat gagal dengan `EALLOWSCRIPTS` setelah pengaturan disimpan.
1079 1073
10801074 1. Jika `npm --version` mencetak 12.0.x, perbarui npm ke 12.1 atau lebih baru, misalnya dengan `npm install -g npm@latest`. Di 12.0.x, instalasi proyek yang dimulai oleh alat `npx` atau script `npm run` dapat gagal dengan `EALLOWSCRIPTS` setelah pengaturan disimpan. 1. Jika `npm --version` mencetak 12.0.x, perbarui npm ke 12.1 atau yang lebih baru, misalnya dengan `npm install -g npm@latest`. Di 12.0.x, instalasi proyek yang dimulai oleh tool `npx` atau skrip `npm run` dapat gagal dengan `EALLOWSCRIPTS` setelah pengaturan disimpan.
1081 1075
10821076 2. Jalankan `npm config get allow-scripts` dan catat paket apa pun yang dicantumkannya, karena perintah berikutnya menggantikan seluruh nilai. Simpan pengaturan dengan paket-paket tersebut di dalam tanda kutip, seperti dalam `"allow-scripts=@anthropic-ai/claude-code,<package>"`: 2. Jalankan `npm config get allow-scripts` dan catat paket apa pun yang dicantumkannya, karena perintah berikutnya menggantikan seluruh nilainya. Simpan pengaturan dengan paket-paket tersebut di dalam tanda kutip, seperti pada `"allow-scripts=@anthropic-ai/claude-code,<package>"`:
1083 1077
1084 ```bash theme={null}1078 ```bash theme={null}
1085 npm config set "allow-scripts=@anthropic-ai/claude-code" --location=user1079 npm config set "allow-scripts=@anthropic-ai/claude-code" --location=user
1091 npm install -g @anthropic-ai/claude-code1085 npm install -g @anthropic-ai/claude-code
1092 ```1086 ```
1093 1087
10941088 Jika perintah ini atau langkah 1 gagal dengan `EACCES`, beralih ke native installer alih-alih menjalankannya ulang dengan `sudo`. Claude Code menjalankan npm tanpa `sudo` saat memperbarui dirinya sendiri, sehingga pembaruan otomatis akan gagal dengan cara yang sama. Jika langkah ini atau langkah 1 gagal dengan `EACCES`, beralihlah ke penginstal native alih-alih menjalankannya ulang dengan `sudo`. Claude Code menjalankan npm tanpa `sudo` saat memperbarui dirinya sendiri, sehingga pembaruan otomatis akan gagal dengan cara yang sama.
1095 1089
1096 4. Jika `claude --version` tidak mencetak nomor versi, periksa [penyebab lain](#native-binary-not-found-after-npm-install).1090 4. Jika `claude --version` tidak mencetak nomor versi, periksa [penyebab lain](#native-binary-not-found-after-npm-install).
1097 1091
10981092 Untuk membatalkan, atur daftar lagi tanpa `@anthropic-ai/claude-code`, atau hapus seluruh daftar dengan `npm config delete allow-scripts --location=user`. Di npm 12, error tersebut akan muncul kembali setelah pembaruan Anda berikutnya. Untuk membatalkan, atur daftar tersebut lagi tanpa `@anthropic-ai/claude-code`, atau hapus seluruh daftar dengan `npm config delete allow-scripts --location=user`. Di npm 12, error tersebut kemudian akan muncul kembali setelah pembaruan Anda berikutnya.
1099 1093
11001094### npm `ENOTEMPTY` error during update or reinstall### Error npm `ENOTEMPTY` saat pembaruan atau instalasi ulang
1101 1095
11021096Ketika Anda menjalankan `npm install -g @anthropic-ai/claude-code` di atas instalasi yang ada, npm dapat gagal saat memindahkan direktori paket lama ke samping:Ketika Anda menjalankan `npm install -g @anthropic-ai/claude-code` di atas instalasi yang sudah ada, npm dapat gagal saat memindahkan direktori paket lama ke tempat lain:
1103 1097
1104```text theme={null}1098```text theme={null}
1105npm error code ENOTEMPTY1099npm error code ENOTEMPTY
1110npm error ENOTEMPTY: directory not empty, rename '...'1104npm error ENOTEMPTY: directory not empty, rename '...'
1111```1105```
1112 1106
11131107Baris `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:Baris `npm error path` menyebutkan direktori yang tidak dapat dipindahkan npm. Hapus direktori tersebut beserta direktori `.claude-code-*` sisa 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 berpindah versi Node dengan nvm, hapus direktori yang disebutkan oleh error tersebut sebagai gantinya:
1114 1108
1115> [tab] macOS/Linux1109> [tab] macOS/Linux
1116>1110>
1118> rm -rf "$(npm root -g)/@anthropic-ai/claude-code"1112> rm -rf "$(npm root -g)/@anthropic-ai/claude-code"
1119> ```1113> ```
1120>1114>
11211115> Kemudian hapus direktori temp sisa apa pun. Jika Zsh mencetak `no matches found`, tidak ada yang perlu dihapus:> Kemudian hapus direktori sementara sisa. Jika Zsh mencetak `no matches found`, tidak ada yang perlu dihapus:
1122>1116>
1123> ```bash theme={null}1117> ```bash theme={null}
1124> rm -rf "$(npm root -g)/@anthropic-ai/.claude-code-"*1118> rm -rf "$(npm root -g)/@anthropic-ai/.claude-code-"*
1130> Remove-Item -Recurse -Force "$(npm root -g)/@anthropic-ai/claude-code", "$(npm root -g)/@anthropic-ai/.claude-code-*"1124> Remove-Item -Recurse -Force "$(npm root -g)/@anthropic-ai/claude-code", "$(npm root -g)/@anthropic-ai/.claude-code-*"
1131> ```1125> ```
1132 1126
11331127Kemudian instal ulang. Di npm 12, ikuti [Memperbaiki instalasi npm 12](#fix-an-npm-12-install). Jika tidak, jalankan:Kemudian instal ulang. Di npm 12, ikuti [Perbaiki instalasi npm 12](#fix-an-npm-12-install). Jika tidak, jalankan:
1134 1128
1135```bash theme={null}1129```bash theme={null}
1136npm install -g @anthropic-ai/claude-code1130npm install -g @anthropic-ai/claude-code
1137```1131```
1138 1132
11391133Konfirmasi dengan `claude --version`, yang mencetak nomor versi seperti `2.1.211 (Claude Code)`.Konfirmasikan dengan `claude --version`, yang mencetak nomor versi seperti `2.1.211 (Claude Code)`.
1140 1134
1141## Login and authentication1135## Login and authentication
1142 1136
152> apk add ripgrep152> apk add ripgrep
153> ```153> ```
154>154>
155155> `ripgrep` berada di repositori komunitas Alpine. Jika `apk` melaporkan bahwa paket hilang, lihat [Alpine Linux setup](https://code.claude.com/docs/id/setup.md#alpine-linux-and-musl-based-distributions).> `ripgrep` berada di repositori komunitas Alpine.
156 156
157> [tab] Arch157> [tab] Arch
158>158>
