🔧 Sistem Bakımı 5 Ocak 2026

Claude Code - Tamamen Kaldırma ve Sıfırdan Yükleme

Claude CLI'sını sistemden tamamen temizleyip sıfırdan yükleme rehberi

📝 Basit Anlatım (Herkes İçin)

Claude Code nedir?
Claude Code, Anthropic'in resmi CLI (komut satırı) aracıdır. Terminal üzerinden Claude AI ile kod yazmanızı, dosya düzenlemenizi ve proje yönetmenizi sağlar.

Neden tamamen kaldırıp yeniden yükleyeceğiz?
Bazen Claude Code'da sorunlar oluşabilir: eski cache dosyaları, bozuk konfigürasyon, güncel olmayan sürümler. En temiz çözüm, her şeyi sıfırdan başlatmaktır - sanki hiç yüklenmemiş gibi!

Ne yapacağız?
3 aşamalı bir süreç: 1) Tamamen kaldırma, 2) Cache/config temizliği, 3) Sıfırdan yükleme

⚠️ DİKKAT: Bu işlem sırasında tüm Claude Code ayarları, oturum bilgileri ve cache silinecektir. İşlem sonrası yeniden giriş yapmanız gerekecek.

🔧 Teknik Detaylar (Geliştiriciler İçin)

📂 Silinecek Dosya/Klasörler

  • • ~/.claude/ - Tüm Claude Code config ve cache dosyaları
  • • ~/.npm/_cacache/ - NPM cache (Claude Code paketleri)
  • • /usr/local/bin/claude - Global binary (symlink)
  • • node_modules/@anthropic-ai/claude-code - NPM paketi

⚙️ Kullanılan Araçlar

  • npm - Paket yöneticisi (kaldırma/yükleme)
  • rm -rf - Dosya/klasör silme (dikkatli kullan!)
  • which - Binary konum bulma
  • ls -la - Dosya listeleme (doğrulama için)

🔍 Sistem Gereksinimleri

  • ✅ Node.js 18+ (kontrol: node -v)
  • ✅ npm 9+ (kontrol: npm -v)
  • ✅ Internet bağlantısı (paket indirmek için)
  • ✅ Sudo yetkisi (global yükleme için)
1

AŞAMA 1: Claude Code'u Tamamen Kaldırma

Adım 1.1

Global Claude Code Paketini Kaldır

NPM ile global olarak yüklenmiş Claude Code paketini sistemden kaldırıyoruz.

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

Beklenen Çıktı: removed 1 package in 2s

Adım 1.2

Claude Config Klasörünü Sil

Kullanıcı ayarları, oturum bilgileri ve cache'lerin bulunduğu klasörü tamamen siliyoruz.

rm -rf ~/.claude

⚠️ DİKKAT: Bu komut tüm Claude ayarlarını siler. API anahtarları, oturum bilgileri kaybolacaktır.

Doğrulama: ls -la ~/.claude → "No such file or directory" görmeli

Adım 1.3

Global Binary'yi Kaldır (Varsa)

Sistem PATH'inde olan claude komutunu bulup kaldırıyoruz.

# Önce konumu kontrol et

which claude

# Eğer konum görüyorsan (örn: /usr/local/bin/claude), sil:

sudo rm -f /usr/local/bin/claude

Doğrulama: which claude → Hiçbir çıktı vermemeli (komut bulunamadı)

Adım 1.4

NPM Cache Temizliği

Claude Code ile ilgili tüm NPM cache dosyalarını temizliyoruz.

# Cache'i tamamen temizle

npm cache clean --force

# Cache klasörünü doğrudan sil (daha agresif)

rm -rf ~/.npm/_cacache

✅ Sonuç: NPM cache temizlendi, yeni yüklemede güncel paket indirilecek.

2

AŞAMA 2: Kaldırma İşlemini Doğrula

Kontrol

Tüm Kontrolleri Çalıştır

Her komutu çalıştır ve beklenen sonuçları gör.

# 1. Claude komutu kaldırılmış mı?

which claude

Beklenen: (çıktı yok - komut bulunamadı)

# 2. Claude klasörü silinmiş mi?

ls -la ~/.claude

Beklenen: ls: cannot access '~/.claude': No such file or directory

# 3. NPM global paketlerde Claude yok mu?

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

Beklenen: (empty)

# 4. Claude komutunu çalıştırmayı dene

claude --version

Beklenen: command not found: claude

✅ Tüm kontroller başarılı ise: Sistem tamamen temiz, sıfırdan yüklemeye hazır!

❌ Eğer hala kalıntı varsa: İlgili adımları tekrar çalıştır. Gerekirse sudo kullan.

3

AŞAMA 3: Claude Code'u Sıfırdan Yükle

Adım 3.1

NPM ile Global Yükleme

Claude Code'u global olarak yükle (tüm projelerden erişilebilir).

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

Beklenen Çıktı: Paket indiriliyor, bağımlılıklar yükleniyor, symlink oluşturuluyor...

⏱️ Süre: İnternet hızınıza göre 30 saniye - 2 dakika arası

Adım 3.2

Yüklemeyi Doğrula

Claude Code'un başarıyla yüklendiğini kontrol et.

# Versiyon kontrol et

claude --version

# Komut konumunu kontrol et

which claude

✅ Başarılı: Versiyon numarası görüyorsun (örn: 0.7.0) → Yükleme tamamlandı!

Adım 3.3

Claude Code'u Başlat ve Giriş Yap

İlk kez çalıştır ve Anthropic hesabınla giriş yap.

# Claude'u başlat

claude

İlk Başlatma Süreci:

  1. Claude açılacak ve giriş yapmanızı isteyecek
  2. Tarayıcıda Anthropic login sayfası açılacak
  3. Hesabınızla giriş yapın
  4. Authorization kodunu terminalden onaylayın
  5. Claude kullanıma hazır!

⚠️ Önemli: API Key veya Claude hesabı gereksinimleri değişmiş olabilir. Resmi dökümana bakın: claude.com/claude-code

Adım 3.4

İlk Testi Yap

Claude'un düzgün çalıştığını test etmek için basit bir komut dene.

# Basit bir test mesajı gönder

claude "Merhaba, çalışıyor musun?"

# Veya interaktif modda test et

claude
> Basit bir hesaplama yap: 125 * 8

✅ Başarılı: Claude yanıt veriyorsa → Her şey düzgün çalışıyor!

🔧 Sorun Giderme (Troubleshooting)

❌ Sorun: "command not found: claude"

Yükleme sonrası claude komutu tanınmıyor.

Çözümler:

  1. PATH kontrolü: echo $PATH
    → /usr/local/bin veya ~/.npm-global/bin listede var mı?
  2. Shell'i yeniden başlat: exec $SHELL
    → PATH değişikliklerini yükler
  3. NPM prefix kontrolü: npm config get prefix
    → Global paketlerin nereye yüklendiğini gösterir
  4. Manuel PATH ekleme: export PATH="$PATH:$(npm config get prefix)/bin"
    → ~/.bashrc veya ~/.zshrc'ye ekle (kalıcı olması için)

❌ Sorun: "Permission denied" hatası

Yükleme veya çalıştırma sırasında yetki hatası alınıyor.

Çözümler:

  1. Sudo ile yükle: sudo npm install -g @anthropic-ai/claude-code
  2. NPM permissions düzelt:
    sudo chown -R $(whoami) ~/.npm ~/.npm-global
  3. Binary permission: sudo chmod +x /usr/local/bin/claude

❌ Sorun: Login/Authentication başarısız

Giriş yapamıyorum veya auth hatası alıyorum.

Çözümler:

  1. Config sıfırla: rm -rf ~/.claude && claude
  2. API Key doğrudan kullan:
    export ANTHROPIC_API_KEY="your-api-key-here"
  3. Tarayıcı cache temizle: Login sayfası açılmıyorsa tarayıcı cache/cookie'lerini temizle
  4. Resmi döküman: docs.anthropic.com/claude-code/authentication

❌ Sorun: Eski versiyon yüklenmiş

Güncel versiyon değil, eski bir sürüm yüklendi.

Çözümler:

  1. Latest tag ile yükle:
    npm install -g @anthropic-ai/claude-code@latest
  2. NPM cache temizle ve tekrar yükle:
    npm cache clean --force && npm install -g @anthropic-ai/claude-code
  3. Yüklü versiyonu kontrol et: npm list -g @anthropic-ai/claude-code

📊 Özet: Tüm Komutlar Tek Seferde

# 🔴 AŞAMA 1: KALDIRMA

npm uninstall -g @anthropic-ai/claude-code
rm -rf ~/.claude
sudo rm -f /usr/local/bin/claude
npm cache clean --force
rm -rf ~/.npm/_cacache

# 🟡 AŞAMA 2: DOĞRULAMA

which claude                                    # → (çıktı yok)
ls -la ~/.claude                                # → No such file
npm list -g @anthropic-ai/claude-code          # → (empty)
claude --version                                # → command not found

# 🟢 AŞAMA 3: SIFIRDAN YÜKLEME

npm install -g @anthropic-ai/claude-code
claude --version                                # → Versiyon görmeli
which claude                                    # → Konum görmeli
claude                                          # → İlk kez başlat, giriş yap
claude "Merhaba, çalışıyor musun?"             # → Test et

✅ İşlem Tamamlandı! Claude Code tamamen temiz bir şekilde yüklendi ve kullanıma hazır.