TPToolpazar

Yazılım Geliştirici

Claude Code CLI Rehberi

Anthropic Claude Code komut satırı aracı için Türkçe kurulum, slash komutları, MCP sunucuları ve verimli kullanım rehberi.

Claude Code, Anthropic’in resmi komut satırı aracıdır: terminalinizden doğrudan Claude modelleriyle çalışır, dosyaları okuyup düzenler, kod yazar, testleri çalıştırır, git commit’leri oluşturur. Cursor veya Aider gibi alternatiflerden farkı, Anthropic’in “agentic kodlama” deneyimi için en sıkı sıkıya tasarladığı arayüz olmasıdır. Bu rehber Claude Code’u Türkiye’de kurmak, ayarlamak ve verimli kullanmak için adım adım yönergeleri içerir.

Kurulum (macOS, Windows, Linux)

Claude Code Node.js 18+ gerektirir. macOS ve Linux’tanpm install -g @anthropic-ai/claude-code ile kurulur; Windows için PowerShell üzerinde aynı komut çalışır. Anthropic ayrıca tek-tıklayışlı yükleyici (installer) sunar — claude.com adresinden indirilir.

Kurulumdan sonra claude komutu ile bir API anahtarı girilir veya Claude.ai hesabı ile OAuth bağlantısı yapılır. OAuth tercih edilir çünkü Pro/Max abonelikten kullanım kotası kaynaklanır; ayrı API faturası gelmez.

Temel İş Akışı

Bir proje klasörüne gidin ve claude komutunu çalıştırın. Açılan terminal arayüzünde sade Türkçe (veya İngilizce) ile ne istediğinizi yazarsınız:

  • “src/utils/format.ts dosyasını oku ve numaraları binlik ayraçla biçimlendiren bir fonksiyon ekle.”
  • “Tüm test dosyalarını çalıştır, başarısız olanları listele.”
  • “Bu commit’in mesajını gözden geçir ve düzelt.”

Claude, dosyaları okumak, düzenlemek, terminal komutu çalıştırmak, tarayıcıda link açmak gibi araçları kendisi seçer. Her hassas eylemden önce sizden onay ister (varsayılan); bu davranışı ayarlardan değiştirebilirsiniz.

Slash Komutları ve Skills

Claude Code, slash komutları ile sık görevleri tek satırda yapar:

  • /help — yardım menüsü
  • /init — projeye CLAUDE.md dosyası ekler (Claude’un proje hafızası)
  • /cost — şimdiye kadar harcanan token / dolar
  • /clear — sohbeti sıfırla
  • /compact — bağlamı sıkıştır (uzun seansta)
  • /login — hesap değişimi
  • /agents — özel alt-agent’ları yönet

Skills sistemi, proje veya kişisel düzeyde yeniden kullanılabilir prompt+kod paketleri tanımlar. Örneğin bir “PR oluştur” skill’i, branş yaratıp commit’leyip GitHub PR açana kadar aynı sırayı tekrar eder.

MCP (Model Context Protocol) ile Genişletme

Claude Code, MCP sunucularını destekler — bu sayede Slack, GitHub, Linear, PostgreSQL, Stripe gibi sistemlerle Claude doğrudan konuşur. claude mcp add komutuyla bir sunucu kayıt edilir; ardından konuşmalarınızda ilgili kaynağa erişim açılır. MCP rehberimiz konuyu derinlemesine ele alır.

CLAUDE.md Dosyası: Proje Hafızası

Projenin kök dizinine CLAUDE.md ekleyin: Claude bu dosyayı her seansın başında otomatik yükler. Bu, tekrarlayan talimatları her sefer yeniden yazma yükünü kaldırır. Tipik içerik:

  • Stack açıklaması (Next.js 14, Postgres, vb.)
  • Komutlar (test, build, dev)
  • Stil tercihleri (“async/await kullan, then() değil”)
  • Mimari kurallar (“DB çağrılarını lib/db içinden yap”)

Birden fazla CLAUDE.md kabul edilir: home dizinindeki kişisel kurallar, proje kökünde takım kuralları, alt klasörlerde alana özel kurallar. Hepsi birleştirilir.

Verimli Kullanım İpuçları

  • Plan modu: Karmaşık bir değişiklik için “önce plan yap” deyin; Claude tüm dosyaları okuyup yazılı plan üretir, sizden onay aldıktan sonra uygular.
  • Küçük commit, sık doğrulama: Her büyük değişiklikten sonra npm test çalıştırın; bir şey kırıldıysa Claude aynı seansta düzeltir.
  • Geri alma kolaylığı: Çalıştırmadan önce git commit yapın. Beğenmediğiniz değişiklikte git restoreile geri dönün.
  • Token tasarrufu: /clear ile yeni göreve sıfırdan başlayın; eski sohbet bağlamını taşıma yapmaz.

Sık Sorulan Sorular

Claude Code ücretsiz mi?
Yazılım ücretsiz, ancak modelin kendisi ücretli. Claude Pro/Max aboneliği veya API kredisi gerekir. Pro 20 USD/ay ile günlük çoğu geliştirici görevine yeter.
Cursor'a göre farkı nedir?
Cursor bir IDE (VS Code çatallaması). Claude Code bir CLI — VS Code, Vim, JetBrains gibi mevcut editörünüzü değiştirmez. Editör yan yana açık, Claude terminalde çalışır. Çoklu agent ve uzun-süreli arka plan görevlerinde Claude Code daha esnek.
Türkçe komut verebilir miyim?
Evet, Claude Code prompt’ları herhangi bir dilde alır. Türkçe verdiğinizde yanıtları da Türkçe gelir. Kod, değişken adı, yorum gibi alanlarda dil seçimi sizin tercihiniz.
Yapacağı her şeyi onaylamam gerekiyor mu?
Varsayılan’da hassas eylemler (dosya yazımı, terminal komutu) onay ister. Settings’den “permission mode’u açıp kuralları kişiselleştirebilirsiniz: belirli komutları otomatik kabul, geri kalanı onay vs.
Hooks nedir?
Claude Code yaşam döngüsünde tetiklenen kabuk komutları. Örneğin “dosya yazımından önce prettier çalıştır” veya “test başarısızsa beni Slack’te uyar.” settings.json içinde tanımlanır.
Çoklu projeye nasıl bakar?
Her terminal sekmesi ayrı bir Claude seansı. Aynı anda iki klasörde iki Claude çalıştırabilir, hatta git worktree ile aynı repoda farklı branş için iki sohbet açabilirsiniz. Skill sistemi paralel iş akışlarını koordine etmek için pratik.

İlgili rehberler