Rehber Claude Code command not found hatası: Kurulumdan sonra komut neden bulunamaz?

Claude Code kurulduktan sonra “claude: command not found” ya da Windows'ta “claude tanınmıyor” hatası alıyorsanız, önce yeni bir terminal açın. Kurulum sırasında yapılan PATH değişikliği eski terminal oturumuna yansımamış olabilir. Aynı komutu tekrar tekrar kurmak, farklı kurulumların üst üste binmesine yol açabilir.

En kısa kontrol sırası​

1. Kurulumun gerçekten başarıyla tamamlandığını son mesajdan doğrulayın; indirme ekranının kapanması tek başına yeterli değildir.
2. PowerShell, Terminal veya kullandığınız kabuğu kapatıp yeniden açın. Editörün iç terminalini kullanıyorsanız editörü yeniden başlatmak gerekebilir.
3. Yeni terminalde “claude --version” çalıştırın.
4. Komut hâlâ yoksa hangi ortamda olduğunuzu ayırın: Windows PowerShell, WSL veya macOS/Linux terminali aynı kurulum yolunu kullanmak zorunda değildir.

Komutun hangi yoldan geldiğini bulun​

Windows PowerShell'de:
macOS veya Linux'ta:
Komut bir yol döndürüyorsa sorun “hiç kurulu olmaması” olmayabilir. Dönen dosyanın hangi kurulum yöntemiyle oluştuğunu ve terminalin onu gerçekten çalıştırıp çalıştıramadığını inceleyin. Birden fazla sonuç varsa eski kurulumla yeni kurulumun karışmış olabileceğini not edin; ne olduğunu bilmediğiniz klasörleri topluca silmeyin.

WSL kullanıyorsanız Windows'ta kurulmuş bir programın Linux tarafında aynı şekilde çalışacağını varsaymayın. Hata çıktısını paylaşırken WSL dağıtımını ve komutu hangi terminalde çalıştırdığınızı belirtin. Windows PATH'inin Linux içindeki araçlarla karışması, kurulum ve çalışma ortamını ayırmanızı gerektirir.

Kurulum yöntemiyle ilgili karar​

Kurulumu yenilemek gerekiyorsa yalnız resmi kurulum sayfasındaki, işletim sisteminize uygun güncel yöntemi kullanın. npm ile kurulmuş bir sürümde Node kaynaklı hata görüyorsanız Node sürümünü ayrıca kontrol edin; native kurulum ile npm kurulumunun bağımlılıkları aynı değildir. İzin hatasını çözmek için yönetici yetkisini veya sudo'yu rastgele eklemek yerine, resmi sorun giderme adımını uygulayın.

Komut açılıyor ama giriş yapılamıyorsa​

Sürüm bilgisi yazdırılıyorsa komut bulma sorunu çözülmüştür. Bundan sonra hesap oturumu, kuruluş erişimi veya API yapılandırmasını ayrı değerlendirin. “Komut bulunamadı” ile “yetkilendirme başarısız” aynı arıza değildir; birini düzeltmek için diğerinin ayarlarını sıfırlamayın.

Destek isteği için şu kısa şablon yeterlidir:
Bu kayıtta parola, API anahtarı veya oturum belirteci bulunmamalı. Başarı ölçütü, yeni bir terminal oturumunda komutun sürüm göstermesi ve seçtiğiniz erişim yöntemiyle çalışmayı başlatabilmesidir.

Kaynaklar​

Claude: Kurulum ve kimlik doğrulama sorunları