Claude Code hata kodları ve sorun giderme

Yaygın neden: Kurulum dizini PATH'te değil veya mevcut kabuk (shell) yapılandırmasını yeniden yüklemedi.

Çözüm: Yeni bir terminal açın ya da Claude Code kurulum dizinini PATH'e ekleyip kabuk yapılandırmanızı yeniden yükleyin.

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

Yaygın neden: Node sürümü resmî gereksinimin altında veya WSL, Windows tarafındaki Node'u çağırıyor.

Çözüm: Node'u yükseltin ya da resmî yerel yükleyiciyi kullanın. WSL'de which node / which npm ile yolun Linux ortamından geldiğini doğrulayın.

node -v
which node
which npm

Yaygın neden: Global npm dizininin sahibi root veya daha önce sudo ile yapılan bir kurulum izinleri bozmuş.

Çözüm: Claude Code'u sudo ile kurmayın. npm önekini (prefix) bir kullanıcı dizinine değiştirin veya yerel yükleyiciyi kullanın.

npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"

Yaygın neden: Tarayıcıdaki OAuth geri çağrısı yerel CLI aracına ulaşmıyor — uzak SSH, devcontainer, sıkı güvenlik duvarları veya engellenen localhost geri çağrılarında yaygındır.

Çözüm: Tarayıcının ve CLI aracının aynı makinede birbirine erişebildiğini doğrulayın. Gerekirse çıkış yapın, Claude Code'u yeniden başlatın ve kimlik doğrulamayı yeniden tamamlayın.

/logout
# 关闭 Claude Code 后重新运行
claude

Yaygın neden: Kurumsal bir proxy veya güvenlik ağ geçidi, Node'un varsayılan olarak güvenmediği kendinden imzalı bir CA ekliyor.

Çözüm: BT ekibinizden kurumsal CA paketini isteyin ve NODE_EXTRA_CA_CERTS ile belirtin.

export NODE_EXTRA_CA_CERTS=/path/to/company-ca.pem

Yaygın neden: Proxy değişkenleri yanlış ayarlanmış, proxy protokolü desteklenmiyor, NO_PROXY hedef alan adını proxy dışında bırakıyor ya da kurumsal güvenlik duvarı erişimi engelliyor.

Çözüm: Claude Code standart HTTP/HTTPS proxy ortam değişkenlerini kullanır; belgelere göre SOCKS proxy'leri desteklenmez. Önce HTTPS_PROXY ile yeniden test edin.

export HTTPS_PROXY=http://proxy.example.com:8080
echo $HTTPS_PROXY
echo $NO_PROXY

Yaygın neden: Kuruluş Claude Code'u etkinleştirmemiş, kurumsal izin listesi mevcut çıkışı içermiyor, hesap / bölge / politika kısıtlamaları geçerli ya da proxy reddediliyor.

Çözüm: Kişisel hesaplarda önce desteklenen bölgeleri ve hesap durumunu doğrulayın; kurumsal hesaplarda bir yöneticinin Claude Code izinlerini, SSO'yu, IP izin listesini ve güvenlik duvarı kurallarını kontrol etmesini sağlayın.

Yaygın neden: İstekler çok sık, eşzamanlılık çok yüksek ya da hesap planı veya kuruluş hız sınırına ulaştı.

Çözüm: Dış katmandaki eşzamanlılığı azaltın, yeniden deneme döngülerini durdurun ve sınırın sıfırlanmasını bekleyin. Hızı zorlamak için Claude Code'u birden çok worker ile sarmalamayın.

Yaygın neden: API anahtarı başka bir kabuktan geliyor, bir Console anahtarı OAuth oturumuyla çakışıyor ya da kuruluş SSO ile giriş yapılmasını zorunlu tutuyor.

Çözüm: ANTHROPIC_API_KEY değişkeninin mevcut kabukta ayarlı olup olmadığını kontrol edin. Kurumsal hesaplar, yöneticinin belirlediği Console/SSO giriş akışını izlemelidir.

echo $ANTHROPIC_API_KEY