Ubuntu Üzerine Claude Code Kurulumu: Terminalde Yapay Zeka Dönemi!

Anthropic tarafından geliştirilen Claude Code, terminalinizde yaşayan, kod tabanınızı anlayan ve doğal dildeki komutlarla daha hızlı kod yazmanıza yardımcı olan “etmen (agentic)” bir kodlama aracıdır. Klasik web tabanlı asistanların aksine, projenizin dosyalarına, bağımlılıklarına ve git geçmişine doğrudan erişerek tam bağlamda çalışır.

Bu rehberde; Ubuntu (26.04, 24.04, 22.04) sistemlerde Claude Code kurulumu, kimlik doğrulama ve temel kullanım adımlarını inceleyeceğiz.

Sistem Gereksinimleri

Claude Code’u kurmadan önce, sisteminizin aşağıdaki gereksinimleri karşıladığından emin olun:

• İşletim Sistemi: Ubuntu 20.04 veya daha yeni bir sürüm (Önerilen: 26.04, 24.04, 22.04 LTS).
• RAM: Minimum 4 GB.
• İnternet: Kimlik doğrulama ve yapay zeka etkileşimleri için aktif bir internet bağlantısı gereklidir.
• Kabuk (Shell): Bash veya Zsh.
• Abonelik: Claude Pro (20$/ay), Max (100-200$/ay), Teams paketlerinden biri veya Anthropic Console üzerinde aktif bir ödeme yöntemi tanımlanmış hesap.

Önemli Not: Yerel yükleyici, kod arama işlemleri için ripgrep aracını içerir. Kurulumdan sonra arama özellikleri düzgün çalışmazsa, ripgrep’i şu komutla manuel olarak kurabilirsiniz:

sudo apt install ripgrep

Kurulum Yöntemi Seçimi

Ubuntu’da Claude Code kurmak için üç ana yol mevcuttur. Anthropic, en stabil deneyim ve otomatik güncellemeler için Yerel Yükleyiciyi (Native Installer) önermektedir.

1. Yöntem: Native Installer ile Kurulum (Önerilen)

Bu yöntem, Anthropic’ten önceden derlenmiş bir ikili dosya indirir ve bağımsız çalışır.

Bağımlılıkları Kurun

sudo apt update && sudo apt install curl -y

Kurulum Betiğini Çalıştırın

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

Bu betik, Claude Code’u ~/.local/bin/claude konumuna kuracaktır. Eğer “komut bulunamadı” hatası alırsanız, source ~/.bashrc komutuyla kabuğunuzu yenileyin.

Kurulumu Doğrulayın

claude --version
claude doctor

claude doctor komutu, kurulumunuzun ve sistem yapılandırmanızın sağlıklı olduğunu denetler.

2. Yöntem: Homebrew ile Kurulum

Geliştirme araçlarınızı zaten Homebrew (Linuxbrew) ile yönetiyorsanız bu yolu izleyebilirsiniz:

brew install --cask claude-code

Not: Homebrew kurulumları otomatik güncellenmez. Periyodik olarak brew upgrade claude-code çalıştırmalısınız.

3. Yöntem: npm ile Kurulum (Kullanım Dışı)

Bu yöntem artık önerilmemektedir ancak Node.js 18+ yüklü sistemlerde hala çalışmaktadır:

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

Kimlik Doğrulama ve İlk Başlatma

Claude Code’u kullanabilmek için bir Claude Pro, Max, Team aboneliği veya kredisi olan bir Anthropic Console hesabı gereklidir.

1. Proje dizininize gidin: cd ~/projeniz
2. Aracı başlatın: claude
3. Tarayıcıda açılan pencereden Anthropic hesabınızla giriş yapın.
4. Yetki verdikten sonra terminale dönün; bağlantı otomatik olarak kurulacaktır.

Temel Kullanım: Slash (/) Komutları

Claude Code interaktif bir oturum sunar. Oturum içindeyken şu kısayolları kullanabilirsiniz:

• /help: Tüm komutları gösterir.
• /init: Projeye CLAUDE.md rehber dosyası ekleyerek Claude’un projeyi tanımasını sağlar.
• /compact: Bağlamı daraltarak maliyeti ve token kullanımını düşürür.
• /cost: Mevcut oturumun maliyetini gösterir.
• /exit: Oturumdan çıkar.

Kullanım Örnekleri

• claude> Bu projedeki kimlik doğrulama yapısını açıkla.
• claude> src/utils.ts dosyasına e-posta doğrulama fonksiyonu ekle.
• claude> Dünkü değişiklikleri özetle ve anlamlı bir commit mesajı yaz.

Sorun Giderme (Troubleshooting)

• Komut Bulunamadı: Eğer claude yazınca hata alıyorsanız, PATH ayarınızı kontrol edin:echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
• Arama Özellikleri Hatalı: Claude, arama için ripgrep kullanır. Eksikse kurun:sudo apt install ripgrep
• Bellek Sorunları: Çok büyük projelerde /compact komutunu sık kullanın ve node_modules gibi dizinlerin .gitignore içinde olduğundan emin olun.

Sonuç

Claude Code artık Ubuntu sisteminize kuruldu ve yapılandırıldı; böylece doğrudan terminalinizden yapay zeka destekli yazılım geliştirme sürecini başlatabilirsiniz. Yerel yükleyici (native installer), otomatik güncellemelerle en akıcı deneyimi sunarken; npm ve Homebrew seçenekleri, özel iş akışı ihtiyaçları olan kullanıcılar için alternatifler sağlar.

İlk Adımlar ve İpuçları

• Projeyi Başlatma: İlk projenize başlamak için kod dizininize gidin ve terminale claude komutunu yazın.
• Proje Bağlamı: Claude Code’a proje yapınız ve kodlama standartlarınız hakkında bağlam sağlamak için /init komutunu kullanarak bir CLAUDE.md dosyası oluşturun.
• Bakım ve Optimizasyon: * Kurulumun sağlık durumunu kontrol etmek için /doctor komutunu kullanın.
  • Uzun çalışma oturumlarında bağlam boyutunu (context size) yönetmek için /compact komutundan faydalanın.