Claude Code Serisi Eğitimi 5: Claude Code Nasıl Kurulur?

Claude Code Nasıl Kurulur

Claude Code kurulumunun grafik arayüzünde 'İleri' düğmesi yoktur; tamamen komut satırında yapılır. Eğer npm kullanıyorsanız, tüm süreç iki dakikadan fazla sürmez.

Ön Koşullar

Başlamadan önce, aşağıdakilere sahip olduğunuzdan emin olun:

Node.js 18 veya üstü
Kontrol etmek için terminalde node -v çalıştırın. Sürüm 18'den düşükse, nvm, fnm kullanarak veya doğrudan nodejs.org adresinden yükseltin.
Bir Anthropic hesabı
Kayıt adresi: https://console.anthropic.com. Hesap bir API Anahtarı sağlayacak, kurulumdan sonra gerekli olacak. Kayıt ücretsizdir, gerçek maliyet kullanıma göre hesaplanır.
Ağ, Anthropic API uç noktasına erişebilmelidir
Varsayılan alan adı api.anthropic.com. Ortam bir proxy yapılandırması gerektiriyorsa, terminalde HTTP_PROXY veya HTTPS_PROXY ayarlamayı unutmayın.

Kurulum Yöntemi 1: npm ile Global Kurulum

Bu en yaygın yöntemdir; bir kez kurduktan sonra her yerde kullanılabilir.

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

Tamamlandığında, claude --version çalıştırın; bir sürüm numarası çıktısı alırsanız, kurulum başarılıdır. Global kurulumdan sonra, claude komutu herhangi bir dizinde doğrudan çağrılabilir.

Bir izin hatasıyla karşılaşırsanız (macOS'ta /usr/local/lib dizininde yaygındır), iki çözüm yolu vardır:

sudo ile kurulum yapmak (kolay ama güvenlik tartışmalı).
npm'i kullanıcı dizinini kullanacak şekilde yapılandırarak sudo'dan kaçının:
bash mkdir -p ~/.npm-global npm config set prefix '~/.npm-global'
Ardından ~/.npm-global/bin öğesini PATH değişkenine ekleyin ve terminali yeniden başlatın.

Kurulum Yöntemi 2: npx ile Anında Kullanım

Herhangi bir şeyi global olarak kurmak istemiyorsanız veya sadece geçici olarak denemek istiyorsanız, npx kullanmak daha doğrudandır.

npx @anthropic-ai/claude-code

npx, en son paketi geçici olarak indirir, çalıştırdıktan sonra global bir komut bırakmaz. Her kullanımda güncellemeleri kontrol eder, bu nedenle doğal olarak en son sürümde kalır. Dezavantajı, biraz daha yavaş olması (her seferinde indirme yapar) ve otomatik betiklerde sık sık çağırmak için uygun olmamasıdır.

Uygun senaryolar: İlk kez deneyimleme, başka birinin makinesinde geçici kullanım veya ara sıra kullanım.

Normal Şekilde Başlatılabildiğini Doğrulama

Kurulumdan sonra hemen kimlik doğrulamaya geçmeyin. Basit bir komut çalıştırarak aracın başlatılıp başlatılamadığını kontrol edin:

claude --help

Yardım bilgisi çıktısı alınırsa, ikili dosyada sorun yok demektir. Bir sonraki adım hesabınızı bağlamaktır, bu daha sonra anlatılacak.

İki yöntemle kurulan uygulama aynıdır; sonraki kimlik doğrulama ve kullanım şekilleri tamamen aynıdır. Size hangisi daha uygunsa onu seçin.

Sık Sorulan Sorular

Node sürümü çok düşük
Sürüm 18'in altındaysa doğrudan hata verir, uyarı değil. Node'u yükseltmek en doğrudan çözümdür.
Ağ zaman aşımı
İster npm paket çekme ister sonraki API bağlantısı olsun, proxy veya güvenlik duvarı nedeniyle takılabilir. Önce curl https://api.anthropic.com komutunun çalıştığını doğrulayın, ardından sonraki işlemlere geçin.
Windows'ta doğrudan yerel cmd kullanımı
Teorik olarak mümkün olsa da, garip yol kaçış sorunlarından kaçınmak için Git Bash, WSL2 veya Windows Terminal kullanılması önerilir.