✅ Sistem Gereksinimleri

Sistem Güncelleme Komutları

# Paket listesini güncelle
sudo apt update

# Mevcut paketleri güncelle
sudo apt upgrade -y

# Gerekli araçları kur
sudo apt install -y curl wget git

Node.js Kontrol

# Node.js kurulu mu kontrol et
node --version

Eğer "command not found" hatası alıyorsanız veya versiyon 18'den düşükse, aşağıdaki adımlarla kurun:

Yöntem 1: NodeSource ile Kurulum (Önerilen)

# NodeSource deposunu ekle (Node.js 22 LTS)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# Node.js'i kur
sudo apt install -y nodejs

# Kurulumu doğrula
node --version
npm --version

Yöntem 2: NVM ile Kurulum (Alternatif)

# NVM'i indir ve kur
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

# Terminal'i yeniden başlat veya:
source ~/.bashrc

# Node.js LTS versiyonunu kur
nvm install --lts

# Kurulumu doğrula
node --version
npm --version

npm Global Dizin Ayarı

# Global paketler için dizin oluştur
mkdir -p ~/.npm-global

# npm'e bu dizini kullanmasını söyle
npm config set prefix '~/.npm-global'

# PATH'e ekle
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc

# Değişiklikleri uygula
source ~/.bashrc

Claude CLI Kurulum Komutu

# Claude CLI'yi kur (sudo KULLANMA!)
npm install -g @anthropic-ai/claude-code

# Kurulumu doğrula
claude --version

Claude'u Başlat

# Herhangi bir dizinde çalıştır
claude

Giriş Adımları

1. Terminal stil seçimi yapın (önerilen: modern)
2. Enter tuşuna basarak giriş işlemini başlatın
3. Tarayıcı otomatik açılacak
4. Anthropic hesabınızla giriş yapın
5. Authorize butonuna tıklayın
6. Terminal'e dönün - otomatik olarak bağlanacak

Temel Kullanım

# Bir proje klasörüne git
cd ~/projelerim/benim-projem

# Claude'u başlat
claude

# Örnek komutlar:
> Bu proje ne yapıyor?
> Bir Python FastAPI server oluştur
> Bu koddaki hataları bul

# Çıkmak için
/exit

❌ "npm: command not found"

# Node.js düzgün kurulmamış, yeniden kur:
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
source ~/.bashrc

❌ "EACCES: permission denied"

# npm yapılandırmasını tekrar yap:
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# Sonra tekrar kur (sudo OLMADAN):
npm install -g @anthropic-ai/claude-code

❌ "claude: command not found"

# PATH'i kontrol et:
echo $PATH

# ~/.npm-global/bin görünmüyorsa:
source ~/.bashrc

# Hala olmuyorsa terminali kapat aç

❌ "Authentication failed"

# Yeniden giriş yap:
claude
/logout
/login

# Hesabında kredi/abonelik olduğundan emin ol:
# https://console.anthropic.com adresini kontrol et