Claude Code için resmi dokümanın önerdiği yol native kurulum, bunun için terminale tek bir satır yapıştırman yetiyor. Node.js sistem gereksinimleri arasında yok, yalnız npm ile kurarsan gerekiyor. Windows'ta komut PowerShell ya da CMD'de çalışıyor.

Başlamadan önce

Ücretli bir Claude planı (Pro, Max, Team ya da Enterprise) ya da önceden kredi yüklediğin bir Claude Console hesabı gerekiyor. Ücretsiz claude.ai planında Claude Code erişimi yok. Planlar ve fiyatlar claude.com/pricing sayfasında.

Bilgisayarında en az 4 GB RAM ve internet bağlantısı olmalı. Claude Code yalnız Anthropic'in desteklediği ülkelerde kullanılabiliyor.

Kurulum komutu

macOS 13.0 ya da üstü gerekiyor. Terminal'i açmak için Cmd + Space ile Spotlight'ı aç, Terminal yazıp Enter'a bas.

Açılan pencereye şu satırı Cmd + V ile yapıştır ve Enter'a bas:

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

Komut indirme sırasında ilerleme göstermiyor, pencereyi açık bırak. Kurulum bitince ekranda Claude Code successfully installed! yazıyor.

Kurulumu doğrula

Kurulum bitince yeni bir terminal penceresi aç. Kurulumu yaptığın pencere eski PATH ayarıyla açık kalıyor ve claude'u bulamayabilir.

Yeni pencerede şunu yaz:

claude --version

2.1.211 (Claude Code) gibi bir sürüm numarası görüyorsan kurulum tamam. Terminal claude'u bulamıyorsa Sık görülen hatalar bölümüne geç.

Daha ayrıntılı bir kontrol için şunu çalıştır:

claude doctor

Bu komut Claude Code'u açmadan kurulumun ve ayar dosyalarının durumunu yazıyor. Bir uyarı çıkarsa yanında önerilen düzeltme de oluyor.

İlk açılış ve giriş

Bir projede çalışacaksan önce o projenin klasörüne geç, /path/to/your/project yerine kendi klasörünün yolunu yaz. Sonra terminale claude yazıp Enter'a bas:

cd /path/to/your/project
claude

İlk açılışta Claude Code giriş yapmanı istiyor ve tarayıcıda bir pencere açılıyor. Claude hesabınla giriş yap, bilgilerin saklanıyor ve bir daha sormuyor.

Tarayıcı kendiliğinden açılmazsa terminalde c tuşuna bas. Giriş adresi panoya kopyalanıyor, onu tarayıcına yapıştır.

Terminalde fareyle tıklayamıyorsun, ok tuşlarıyla hareket ediyorsun. Claude çalışırken araya girmek istersen Esc'ye bas. Çıkmak için exit yaz, kullanabileceğin komutları da /help gösteriyor.

Sık görülen hatalar

Terminal command not found: claude ya da 'claude' is not recognized diyorsa kurulum klasörü PATH'te yok. PATH, terminalin programları aradığı klasörlerin listesi.

Önce yeni bir pencere aç. Düzelmezse kurulumun sonunda Setup notes altında yazan komutu çalıştır ya da aşağıdan kendi sistemine uyanı al. Bu düzeltmeyi bir kez yapman yetiyor.

Mac'te varsayılan shell olan Zsh için:

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

Linux'ta Bash için:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Windows'ta Setup notes'taki komutu çalıştır ya da sistem ayarlarında Environment Variables'ı açıp %USERPROFILE%\.local\bin klasörünü kullanıcı PATH'ine ekle. Sonra terminali kapatıp yeniden aç.

Windows'ta 'irm' is not recognized çıkıyorsa CMD'desin, PowerShell'i aç ya da CMD komutunu kullan. The token '&&' is not a valid statement separator hatası ise CMD komutunu PowerShell'e yapıştırdığını gösteriyor, PowerShell komutuna geç.

'bash' is not recognized ya da A parameter cannot be found that matches parameter name 'fsSL' hatası Mac ve Linux komutunu Windows'ta çalıştırınca çıkıyor. PowerShell komutunu kullan.

Kurulum syntax error near unexpected token '<' hatasıyla ya da ekrana <!DOCTYPE html> gibi HTML basarak duruyorsa adres kurulum script'i yerine bir web sayfası döndürmüş. Çıktıda App unavailable in region geçiyorsa Claude Code bulunduğun ülkede kullanılamıyor.

Ekrandaki tek hata curl: (22) The requested URL returned error: 403 ise sebep ülke kısıtı ya da şirket ağındaki bir proxy olabilir.

Şirket ağındaysan indirmeyi bir güvenlik duvarı da engelliyor olabilir. Proxy ayarı ve ağ kontrolü resmi sorun giderme sayfasında.

İki hatada da ülke kısıtı ya da ağ engeli yoksa birkaç dakika bekleyip komutu tekrar çalıştır. Hata sürerse Mac'te Homebrew ile kur:

brew install --cask claude-code

Windows'ta WinGet ile:

winget install Anthropic.ClaudeCode

Mac'te dyld: cannot load ya da built for Mac OS X 13.0 hatası büyük ihtimalle macOS sürümünün eski olduğunu gösteriyor. Apple menüsünden About This Mac'e bak, 13.0'dan eskiyse Software Update ile güncelle.

Girişten sonra API Error: 403 Request not allowed görüyorsan aboneliğinin aktif olduğunu claude.ai/settings sayfasında kontrol et. Console kullanıyorsan hesabında Claude Code ya da Developer rolü olmalı, bu rolü Console yöneticisi veriyor.

npm ile kurmak isteyenler için

Claude Code'un npm paketi de aynı native programı kuruyor. Bu yol için Node.js 22 ya da üstü gerekiyor.

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

Komutun başına sudo ekleme, izin sorunlarına ve güvenlik risklerine yol açabiliyor. Daha önce npm ile kurduysan ve izin hatası alıyorsan native kurulum komutuna geç.

Güncellemek için şu komutu kullan:

npm install -g @anthropic-ai/claude-code@latest

npm update -g seni en yeni sürüme taşımayabilir. Native ve npm kurulumunu aynı anda da tutma, sürümler karışabiliyor.

Güncelleme

Native kurulum kendini arka planda güncelliyor. Claude Code açılırken ve çalışırken yeni sürüme bakıyor, indirdiği sürüm bir sonraki açılışta devreye giriyor.

Beklemeden güncellemek istersen şunu çalıştır:

claude update

Son güncelleme denemesinin sonucunu claude doctor gösteriyor. Homebrew, WinGet ya da Linux paket yöneticisiyle kurduysan güncelleme varsayılan olarak kendiliğinden gelmiyor. Homebrew ve WinGet'te şu komutları arada bir çalıştır:

brew upgrade claude-code

winget upgrade Anthropic.ClaudeCode

Son kontrol ve kaynaklar

Son kontrol: 13 Ekim 2026. Komutlar ve hata metinleri şu resmi sayfalardan alındı:

claude --version bir sürüm numarası yazıyorsa Claude Code hazır. 2 saatte canlı uygulama programında Claude Code'a küçük bir web uygulaması yazdırıp internete çıkarıyorsun ve programın hazır başlangıç kodu herkese açılınca ilk uygulamanı orada yapabilirsin.