Troubleshooting - Claude Code Docs

Troubleshoot installation issues

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

Temukan pesan kesalahan atau gejala yang Anda lihat:

Apa yang Anda lihat	Solusi
`command not found: claude` atau `'claude' is not recognized`	Perbaiki PATH Anda
`syntax error near unexpected token '<'`	Install script returns HTML
`curl: (56) Failure writing output to destination`	Download script first, then run it
`Killed` selama install di Linux	Add swap space for low-memory servers
`TLS connect error` atau `SSL/TLS secure channel`	Update CA certificates
`Failed to fetch version` atau tidak dapat menjangkau server download	Check network and proxy settings
`irm is not recognized` atau `&& is not valid`	Use the right command for your shell
`Claude Code on Windows requires git-bash`	Install or configure Git Bash
`Error loading shared library`	Wrong binary variant for your system
`Illegal instruction` di Linux	Architecture mismatch
`dyld: cannot load` atau `Abort trap` di macOS	Binary incompatibility
`Invoke-Expression: Missing argument in parameter list`	Install script returns HTML
`App unavailable in region`	Claude Code tidak tersedia di negara Anda. Lihat negara yang didukung.
`unable to get local issuer certificate`	Configure corporate CA certificates
`OAuth error` atau `403 Forbidden`	Fix authentication

Jika masalah Anda tidak terdaftar, kerjakan langkah-langkah diagnostik ini.

Debug installation problems

Check network connectivity

Installer mengunduh dari storage.googleapis.com. Verifikasi Anda dapat menjangkaunya:

curl -sI https://storage.googleapis.com

Jika ini gagal, jaringan Anda mungkin memblokir koneksi. Penyebab umum:

Firewall perusahaan atau proxy memblokir Google Cloud Storage
Pembatasan jaringan regional: coba VPN atau jaringan alternatif
Masalah TLS/SSL: perbarui sertifikat CA sistem Anda, atau periksa apakah HTTPS_PROXY dikonfigurasi

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

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

Verify your PATH

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

macOS/Linux
Windows PowerShell
Windows CMD

echo $PATH | tr ':' '\n' | grep local/bin

Jika tidak ada output, direktori hilang. Tambahkan ke konfigurasi shell Anda:

# Zsh (macOS default)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Bash (Linux default)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

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

claude --version

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

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

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

Mulai ulang terminal Anda agar perubahan berlaku.Verifikasi perbaikan berhasil:

claude --version

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

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

claude --version

Check for conflicting installations

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

macOS/Linux
Windows PowerShell

Buat daftar semua binary claude yang ditemukan di PATH Anda:

which -a claude

Periksa apakah installer native dan versi npm ada:

ls -la ~/.local/bin/claude

ls -la ~/.claude/local/

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

where.exe claude
Test-Path "$env:LOCALAPPDATA\Claude Code\claude.exe"

Jika Anda menemukan beberapa instalasi, pertahankan hanya satu. Instalasi native di ~/.local/bin/claude direkomendasikan. Hapus instalasi tambahan apa pun: Uninstall instalasi npm global:

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

Hapus instalasi Homebrew di macOS:

brew uninstall --cask claude-code

Check directory permissions

Installer memerlukan akses tulis ke ~/.local/bin/ dan ~/.claude/. Jika instalasi gagal dengan kesalahan izin, periksa apakah direktori ini dapat ditulis:

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

Jika salah satu direktori tidak dapat ditulis, buat direktori instalasi dan atur pengguna Anda sebagai pemilik:

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

Verify the binary works

Jika claude diinstal tetapi crash atau hang saat startup, jalankan pemeriksaan ini untuk mempersempit penyebabnya. Konfirmasi binary ada dan dapat dieksekusi:

ls -la $(which claude)

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

ldd $(which claude) | grep "not found"

Jalankan pemeriksaan kewarasan cepat bahwa binary dapat dieksekusi:

claude --version

Common installation issues

Ini adalah masalah instalasi yang paling sering dihadapi dan solusinya.

Install script returns HTML instead of a shell script

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

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

Di PowerShell, masalah yang sama muncul sebagai:

Invoke-Expression: Missing argument in parameter list.

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

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

`command not found: claude` after installation

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

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

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

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

Perintah curl ... | bash mengunduh skrip dan meneruskannya langsung ke Bash untuk dieksekusi menggunakan pipe (|). Kesalahan ini berarti koneksi putus sebelum skrip selesai diunduh. Penyebab umum termasuk gangguan jaringan, unduhan diblokir di tengah aliran, atau batas sumber daya sistem. Solusi:

Periksa stabilitas jaringan: Binary Claude Code dihosting di Google Cloud Storage. Uji bahwa Anda dapat menjangkaunya:
```
curl -fsSL https://storage.googleapis.com -o /dev/null
```
Jika perintah selesai diam-diam, koneksi Anda baik-baik saja dan masalahnya mungkin intermiten. Coba ulang perintah install. Jika Anda melihat kesalahan, jaringan Anda mungkin memblokir unduhan.

Coba metode instalasi alternatif: Di macOS atau Linux:

brew install --cask claude-code

Di Windows:

winget install Anthropic.ClaudeCode

TLS or SSL connection errors

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

Perbarui sertifikat CA sistem Anda: Di Ubuntu/Debian:

sudo apt-get update && sudo apt-get install ca-certificates

Di macOS melalui Homebrew:

brew install ca-certificates

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

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

Periksa gangguan proxy atau firewall: proxy perusahaan yang melakukan inspeksi TLS dapat menyebabkan kesalahan ini, termasuk unable to get local issuer certificate. Atur NODE_EXTRA_CA_CERTS ke bundel sertifikat CA perusahaan Anda:
```
export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca.pem
```
Tanyakan kepada tim IT Anda untuk file sertifikat jika Anda tidak memilikinya. Anda juga dapat mencoba pada koneksi langsung untuk mengkonfirmasi proxy adalah penyebabnya.

`Failed to fetch version from storage.googleapis.com`

Installer tidak dapat menjangkau server download. Ini biasanya berarti storage.googleapis.com diblokir di jaringan Anda. Solusi:

Uji konektivitas secara langsung:

curl -sI https://storage.googleapis.com

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

Windows: `irm` or `&&` not recognized

Jika Anda melihat 'irm' is not recognized atau The token '&&' is not valid, Anda menjalankan perintah yang salah untuk shell Anda.

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

Install killed on low-memory Linux servers

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

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

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

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

Install hangs in Docker

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

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

Windows: Claude Desktop overrides `claude` CLI command

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

Windows: “Claude Code on Windows requires git-bash”

Claude Code di Windows native memerlukan Git for Windows, yang mencakup Git Bash. Jika Git tidak diinstal, unduh dan instal dari git-scm.com/downloads/win. Selama setup, pilih “Add to PATH.” Mulai ulang terminal Anda setelah menginstal. Jika Git sudah diinstal tetapi Claude Code masih tidak dapat menemukannya, atur jalur di file settings.json Anda:

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

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

Linux: wrong binary variant installed (musl/glibc mismatch)

Jika Anda melihat kesalahan tentang perpustakaan bersama yang hilang seperti libstdc++.so.6 atau libgcc_s.so.1 setelah instalasi, installer mungkin telah mengunduh varian binary yang salah untuk sistem Anda.

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

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

Periksa libc mana yang digunakan sistem Anda:
```
ldd /bin/ls | head -1
```
Jika menunjukkan linux-vdso.so atau referensi ke /lib/x86_64-linux-gnu/, Anda berada di glibc. Jika menunjukkan musl, Anda berada di musl.
Jika Anda berada di glibc tetapi mendapat binary musl, hapus instalasi dan instal ulang. Anda juga dapat mengunduh binary yang benar secara manual dari bucket GCS di https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases/{VERSION}/manifest.json. Ajukan GitHub issue dengan output dari ldd /bin/ls dan ls /lib/libc.musl*.
Jika Anda benar-benar di musl (Alpine Linux), instal paket yang diperlukan:
```
apk add libgcc libstdc++ ripgrep
```

`Illegal instruction` on Linux

Jika installer mencetak Illegal instruction alih-alih pesan OOM Killed, binary yang diunduh tidak cocok dengan arsitektur CPU Anda. Ini biasanya terjadi pada server ARM yang menerima binary x86, atau pada CPU lama yang kekurangan set instruksi yang diperlukan.

bash: line 142: 2238232 Illegal instruction    "$binary_path" install ${TARGET:+"$TARGET"}

Solusi:

Verifikasi arsitektur Anda:
```
uname -m
```
x86_64 berarti 64-bit Intel/AMD, aarch64 berarti ARM64. Jika binary tidak cocok, ajukan GitHub issue dengan output.
Coba metode instalasi alternatif sementara masalah arsitektur diselesaikan:
```
brew install --cask claude-code
```

`dyld: cannot load` on macOS

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

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

Solusi:

Periksa versi macOS Anda: Claude Code memerlukan macOS 13.0 atau lebih baru. Buka menu Apple dan pilih About This Mac untuk memeriksa versi Anda.
Perbarui macOS jika Anda berada di versi lama. Binary menggunakan perintah load yang versi macOS lama tidak mendukung.
Coba Homebrew sebagai metode instalasi alternatif:
```
brew install --cask claude-code
```

Windows installation issues: errors in WSL

Anda mungkin mengalami masalah berikut di WSL: OS/platform detection issues: jika Anda menerima kesalahan selama instalasi, WSL mungkin menggunakan Windows npm. Coba:

Jalankan npm config set os linux sebelum instalasi
Instal dengan npm install -g @anthropic-ai/claude-code --force --no-os-check. Jangan gunakan sudo.

Node not found errors: jika Anda melihat exec: node: not found saat menjalankan claude, lingkungan WSL Anda mungkin menggunakan instalasi Windows Node.js. Anda dapat mengkonfirmasi ini dengan which npm dan which node, yang harus menunjuk ke jalur Linux yang dimulai dengan /usr/ daripada /mnt/c/. Untuk memperbaiki ini, coba menginstal Node melalui package manager distribusi Linux Anda atau melalui nvm. nvm version conflicts: jika Anda memiliki nvm terinstal di WSL dan Windows, Anda mungkin mengalami konflik versi saat beralih versi Node di WSL. Ini terjadi karena WSL mengimpor Windows PATH secara default, menyebabkan Windows nvm/npm mengambil prioritas atas instalasi WSL. Anda dapat mengidentifikasi masalah ini dengan:

Menjalankan which npm dan which node - jika mereka menunjuk ke jalur Windows (dimulai dengan /mnt/c/), versi Windows sedang digunakan
Mengalami fungsionalitas yang rusak setelah beralih versi Node dengan nvm di WSL

Untuk mengatasi masalah ini, perbaiki Linux PATH Anda untuk memastikan versi Linux node/npm mengambil prioritas: Solusi utama: Pastikan nvm dimuat dengan benar di shell Anda Penyebab paling umum adalah nvm tidak dimuat di shell non-interaktif. Tambahkan berikut ini ke file konfigurasi shell Anda (~/.bashrc, ~/.zshrc, dll.):

# Load nvm if it exists
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

Atau jalankan langsung di sesi saat ini:

source ~/.nvm/nvm.sh

Alternatif: Sesuaikan urutan PATH Jika nvm dimuat dengan benar tetapi jalur Windows masih mengambil prioritas, Anda dapat secara eksplisit menambahkan jalur Linux Anda ke PATH di konfigurasi shell Anda:

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

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

WSL2 sandbox setup

Sandboxing didukung di WSL2 tetapi memerlukan penginstalan paket tambahan. Jika Anda melihat kesalahan seperti “Sandbox requires socat and bubblewrap” saat menjalankan /sandbox, instal dependensi:

Ubuntu/Debian
Fedora

sudo apt-get install bubblewrap socat

sudo dnf install bubblewrap socat

WSL1 tidak mendukung sandboxing. Jika Anda melihat “Sandboxing requires WSL2”, Anda perlu upgrade ke WSL2 atau menjalankan Claude Code tanpa sandboxing.

Permission errors during installation

Jika installer native gagal dengan kesalahan izin, direktori target mungkin tidak dapat ditulis. Lihat Check directory permissions. Jika Anda sebelumnya menginstal dengan npm dan mengalami kesalahan spesifik npm, beralih ke installer native:

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

Permissions and authentication

Bagian-bagian ini mengatasi kegagalan login, masalah token, dan perilaku prompt izin.

Repeated permission prompts

Jika Anda menemukan diri Anda berulang kali menyetujui perintah yang sama, Anda dapat mengizinkan alat tertentu berjalan tanpa persetujuan menggunakan perintah /permissions. Lihat Permissions docs.

Authentication issues

Jika Anda mengalami masalah autentikasi:

Jalankan /logout untuk keluar sepenuhnya
Tutup Claude Code
Mulai ulang dengan claude dan selesaikan proses autentikasi lagi

Jika browser tidak terbuka secara otomatis selama login, tekan c untuk menyalin URL OAuth ke clipboard Anda, kemudian tempel ke browser Anda secara manual.

OAuth error: Invalid code

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

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

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

Pengguna Claude Pro/Max: verifikasi langganan Anda aktif di claude.ai/settings
Pengguna Console: konfirmasi akun Anda memiliki peran “Claude Code” atau “Developer” yang ditetapkan oleh admin Anda
Di belakang proxy: proxy perusahaan dapat mengganggu permintaan API. Lihat network configuration untuk setup proxy.

Login berbasis browser di WSL2 mungkin gagal jika WSL tidak dapat membuka browser Windows Anda. Atur variabel lingkungan BROWSER:

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

Atau salin URL secara manual: saat prompt login muncul, tekan c untuk menyalin URL OAuth, kemudian tempel ke browser Windows Anda.

”Not logged in” or token expired

Jika Claude Code meminta Anda untuk login lagi setelah sesi, token OAuth Anda mungkin telah kedaluwarsa. Jalankan /login untuk re-authenticate. Jika ini terjadi sering, periksa bahwa jam sistem Anda akurat, karena validasi token bergantung pada timestamp yang benar.

Configuration file locations

Claude Code menyimpan konfigurasi di beberapa lokasi:

File	Tujuan
`~/.claude/settings.json`	Pengaturan pengguna (izin, hooks, override model)
`.claude/settings.json`	Pengaturan proyek (diperiksa ke kontrol sumber)
`.claude/settings.local.json`	Pengaturan proyek lokal (tidak dikomit)
`~/.claude.json`	Status global (tema, OAuth, MCP servers)
`.mcp.json`	MCP servers proyek (diperiksa ke kontrol sumber)
`managed-mcp.json`	Managed MCP servers
Managed settings	Managed settings (server-managed, MDM/OS-level policies, atau file-based)

Di Windows, ~ mengacu pada direktori home pengguna Anda, seperti C:\Users\YourName. Untuk detail tentang mengonfigurasi file ini, lihat Settings dan MCP.

Resetting configuration

Untuk mengatur ulang Claude Code ke pengaturan default, Anda dapat menghapus file konfigurasi:

# Reset all user settings and state
rm ~/.claude.json
rm -rf ~/.claude/

# Reset project-specific settings
rm -rf .claude/
rm .mcp.json

Ini akan menghapus semua pengaturan, konfigurasi MCP server, dan riwayat sesi Anda.

Performance and stability

Bagian-bagian ini mencakup masalah yang terkait dengan penggunaan sumber daya, responsivitas, dan perilaku pencarian.

High CPU or memory usage

Claude Code dirancang untuk bekerja dengan sebagian besar lingkungan pengembangan, tetapi dapat mengonsumsi sumber daya signifikan saat memproses codebase besar. Jika Anda mengalami masalah kinerja:

Gunakan /compact secara teratur untuk mengurangi ukuran konteks
Tutup dan mulai ulang Claude Code di antara tugas-tugas besar
Pertimbangkan menambahkan direktori build besar ke file .gitignore Anda

Command hangs or freezes

Jika Claude Code tampak tidak responsif:

Tekan Ctrl+C untuk mencoba membatalkan operasi saat ini
Jika tidak responsif, Anda mungkin perlu menutup terminal dan memulai ulang

Search and discovery issues

Jika Search tool, @file mentions, custom agents, dan custom skills tidak berfungsi, instal sistem ripgrep:

# macOS (Homebrew)  
brew install ripgrep

# Windows (winget)
winget install BurntSushi.ripgrep.MSVC

# Ubuntu/Debian
sudo apt install ripgrep

# Alpine Linux
apk add ripgrep

# Arch Linux
pacman -S ripgrep

Kemudian atur USE_BUILTIN_RIPGREP=0 di environment Anda.

Slow or incomplete search results on WSL

Penalti kinerja pembacaan disk saat bekerja lintas filesystem di WSL dapat menghasilkan kecocokan yang lebih sedikit dari yang diharapkan saat menggunakan Claude Code di WSL. Pencarian masih berfungsi, tetapi mengembalikan hasil lebih sedikit daripada di filesystem native.

/doctor akan menunjukkan Search sebagai OK dalam kasus ini.

Solusi:

Kirimkan pencarian yang lebih spesifik: kurangi jumlah file yang dicari dengan menentukan direktori atau jenis file: “Search for JWT validation logic in the auth-service package” atau “Find use of md5 hash in JS files”.
Pindahkan proyek ke filesystem Linux: jika memungkinkan, pastikan proyek Anda berada di filesystem Linux (/home/) daripada filesystem Windows (/mnt/c/).
Gunakan Windows native sebagai gantinya: pertimbangkan menjalankan Claude Code secara native di Windows alih-alih melalui WSL, untuk kinerja filesystem yang lebih baik.

IDE integration issues

Jika Claude Code tidak terhubung ke IDE Anda atau berperilaku tidak terduga dalam terminal IDE, coba solusi di bawah ini.

JetBrains IDE not detected on WSL2

Jika Anda menggunakan Claude Code di WSL2 dengan IDE JetBrains dan mendapatkan kesalahan “No available IDEs detected”, ini mungkin karena konfigurasi jaringan WSL2 atau Windows Firewall memblokir koneksi.

WSL2 networking modes

WSL2 menggunakan jaringan NAT secara default, yang dapat mencegah deteksi IDE. Anda memiliki dua opsi: Opsi 1: Konfigurasi Windows Firewall (direkomendasikan)

Temukan alamat IP WSL2 Anda:

wsl hostname -I
# Example output: 172.21.123.45

Buka PowerShell sebagai Administrator dan buat aturan firewall:

New-NetFirewallRule -DisplayName "Allow WSL2 Internal Traffic" -Direction Inbound -Protocol TCP -Action Allow -RemoteAddress 172.21.0.0/16 -LocalAddress 172.21.0.0/16

Sesuaikan rentang IP berdasarkan subnet WSL2 Anda dari langkah 1.

Mulai ulang IDE dan Claude Code Anda

Opsi 2: Beralih ke mirrored networking Tambahkan ke .wslconfig di direktori pengguna Windows Anda:

[wsl2]
networkingMode=mirrored

Kemudian mulai ulang WSL dengan wsl --shutdown dari PowerShell.

Masalah jaringan ini hanya mempengaruhi WSL2. WSL1 menggunakan jaringan host secara langsung dan tidak memerlukan konfigurasi ini.

Untuk tips konfigurasi JetBrains tambahan, lihat JetBrains IDE guide.

Report Windows IDE integration issues

Jika Anda mengalami masalah integrasi IDE di Windows, buat issue dengan informasi berikut:

Tipe lingkungan: Windows native (Git Bash) atau WSL1/WSL2
Mode jaringan WSL, jika berlaku: NAT atau mirrored
Nama dan versi IDE
Versi ekstensi/plugin Claude Code
Tipe shell: Bash, Zsh, PowerShell, dll.

Escape key not working in JetBrains IDE terminals

Jika Anda menggunakan Claude Code di terminal JetBrains dan tombol Esc tidak mengganggu agen seperti yang diharapkan, ini mungkin karena benturan pintasan keyboard dengan pintasan default JetBrains. Untuk memperbaiki masalah ini:

Buka Settings → Tools → Terminal
Baik:
- Hapus centang “Move focus to the editor with Escape”, atau
- Klik “Configure terminal keybindings” dan hapus pintasan “Switch focus to Editor”
Terapkan perubahan

Ini memungkinkan tombol Esc untuk benar-benar mengganggu operasi Claude Code.

Markdown formatting issues

Claude Code kadang-kadang menghasilkan file markdown dengan tag bahasa yang hilang pada fence kode, yang dapat mempengaruhi syntax highlighting dan readability di GitHub, editor, dan alat dokumentasi.

Missing language tags in code blocks

Jika Anda memperhatikan blok kode seperti ini dalam markdown yang dihasilkan:

```
function example() {
  return "hello";
}
```text

Alih-alih blok yang diberi tag dengan benar seperti:

```javascript
function example() {
  return "hello";
}
```text

Solusi:

Minta Claude untuk menambahkan tag bahasa: minta “Add appropriate language tags to all code blocks in this markdown file.”
Gunakan post-processing hooks: atur hooks pemformatan otomatis untuk mendeteksi dan menambahkan tag bahasa yang hilang. Lihat Auto-format code after edits untuk contoh hook PostToolUse pemformatan.
Verifikasi manual: setelah menghasilkan file markdown, tinjau untuk pemformatan blok kode yang tepat dan minta koreksi jika diperlukan.

Inconsistent spacing and formatting

Jika markdown yang dihasilkan memiliki baris kosong berlebihan atau spasi yang tidak konsisten: Solusi:

Minta koreksi pemformatan: minta Claude untuk “Fix spacing and formatting issues in this markdown file.”
Gunakan alat pemformatan: atur hooks untuk menjalankan formatter markdown seperti prettier atau skrip pemformatan kustom pada file markdown yang dihasilkan.
Tentukan preferensi pemformatan: sertakan persyaratan pemformatan dalam prompt Anda atau file memory proyek.

Reduce markdown formatting issues

Untuk meminimalkan masalah pemformatan:

Jadilah eksplisit dalam permintaan: minta “properly formatted markdown with language-tagged code blocks”
Gunakan konvensi proyek: dokumentasikan gaya markdown pilihan Anda di CLAUDE.md
Atur validation hooks: gunakan post-processing hooks untuk secara otomatis memverifikasi dan memperbaiki masalah pemformatan umum

Get more help

Jika Anda mengalami masalah yang tidak tercakup di sini:

Gunakan perintah /bug dalam Claude Code untuk melaporkan masalah langsung ke Anthropic
Periksa GitHub repository untuk masalah yang diketahui
Jalankan /doctor untuk mendiagnosis masalah. Ini memeriksa:
- Tipe instalasi, versi, dan fungsionalitas pencarian
- Status auto-update dan versi yang tersedia
- File pengaturan yang tidak valid (JSON yang salah bentuk, tipe yang tidak benar)
- Kesalahan konfigurasi MCP server
- Masalah konfigurasi pintasan keyboard
- Peringatan penggunaan konteks (file CLAUDE.md besar, penggunaan token MCP tinggi, aturan izin yang tidak dapat dijangkau)
- Plugin dan kesalahan pemuatan agen
Tanyakan Claude secara langsung tentang kemampuan dan fiturnya - Claude memiliki akses bawaan ke dokumentasinya

Agen

Alat dan plugin

Otomasi

Pemecahan Masalah

​Troubleshoot installation issues

​Debug installation problems

​Check network connectivity

​Verify your PATH

​Check for conflicting installations

​Check directory permissions

​Verify the binary works

​Common installation issues

​Install script returns HTML instead of a shell script

​command not found: claude after installation

​curl: (56) Failure writing output to destination

​TLS or SSL connection errors

​Failed to fetch version from storage.googleapis.com

​Windows: irm or && not recognized

​Install killed on low-memory Linux servers

​Install hangs in Docker

​Windows: Claude Desktop overrides claude CLI command

​Windows: “Claude Code on Windows requires git-bash”

​Linux: wrong binary variant installed (musl/glibc mismatch)

​Illegal instruction on Linux

​dyld: cannot load on macOS

​Windows installation issues: errors in WSL

​WSL2 sandbox setup

​Permission errors during installation

​Permissions and authentication

​Repeated permission prompts

​Authentication issues

​OAuth error: Invalid code

​403 Forbidden after login

​OAuth login fails in WSL2

​”Not logged in” or token expired

​Configuration file locations

​Resetting configuration

​Performance and stability

​High CPU or memory usage

​Command hangs or freezes

​Search and discovery issues

​Slow or incomplete search results on WSL

​IDE integration issues

​JetBrains IDE not detected on WSL2

​WSL2 networking modes

​Report Windows IDE integration issues

​Escape key not working in JetBrains IDE terminals

​Markdown formatting issues

​Missing language tags in code blocks

​Inconsistent spacing and formatting

​Reduce markdown formatting issues

​Get more help

Troubleshoot installation issues

Debug installation problems

Check network connectivity

Verify your PATH

Check for conflicting installations

Check directory permissions

Verify the binary works

Common installation issues

Install script returns HTML instead of a shell script

`command not found: claude` after installation

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

TLS or SSL connection errors

`Failed to fetch version from storage.googleapis.com`

Windows: `irm` or `&&` not recognized

Install killed on low-memory Linux servers

Install hangs in Docker

Windows: Claude Desktop overrides `claude` CLI command

Windows: “Claude Code on Windows requires git-bash”

Linux: wrong binary variant installed (musl/glibc mismatch)

`Illegal instruction` on Linux

`dyld: cannot load` on macOS

Windows installation issues: errors in WSL

WSL2 sandbox setup

Permission errors during installation

Permissions and authentication

Repeated permission prompts

Authentication issues

OAuth error: Invalid code

403 Forbidden after login

OAuth login fails in WSL2

”Not logged in” or token expired

Configuration file locations

Resetting configuration

Performance and stability

High CPU or memory usage

Command hangs or freezes

Search and discovery issues

Slow or incomplete search results on WSL

IDE integration issues

JetBrains IDE not detected on WSL2

WSL2 networking modes

Report Windows IDE integration issues

Escape key not working in JetBrains IDE terminals

Markdown formatting issues

Missing language tags in code blocks

Inconsistent spacing and formatting

Reduce markdown formatting issues

Get more help