Cursor AI Tam Rehberi: Composer, Cmd+K, Codebase Indexing, .cursorrules ve Tüm Özellikler

by

Cursor AI, VS Code’un fork’u olan AI-native bir IDE. Tüm arayüz AI etrafında tasarlanmış. SitePoint’in Mart 2026 karşılaştırmasına göre 2026’nın en iyi AI IDE’si seçildi. Bu makalede yalnızca Cursor AI’nın tüm özelliklerini, kullanım adımlarını ve profesyonel ipuçlarını detaylıca anlatıyoruz.

Cursor Nedir? Diğer IDE’lerden Farkı Ne?

Cursor, VS Code tabanlıdır — tüm VS Code eklentileri, temalar ve kısayollar çalışır. Ama Cursor’ı farklı kılan: AI’nin IDE’nin merkezine yerleştirilmiş olması. VS Code + Copilot eklentisi yaklaşımında AI eklenti olarak eklenir; Cursor’da AI native’dir — her özellik AI ile entegre çalışır.

1. Cmd+K: Satır İçi AI Düzenleme

Cursor’ın en temel özelliği. Kodun içine bir prompt yazarsınız, Cursor o prompta göre kodu değiştirir:

  • Kod seçin ve Cmd+K (Mac) / Ctrl+K (Windows) basın.
  • Prompt yazın: “Bu fonksiyonu async yap”, “Buraya error handling ekle”, “Bu kodu TypeScript’e çevir”.
  • Cursor kodu analiz eder, değişikliği uygular ve diff gösterir.
  • Kabul edin (Accept) veya reddedin (Reject).
  • İsterseniz prompt’u değiştirip tekrar deneyin.

2. Composer: Çoklu Dosya AI Yazma

Composer, birden fazla dosyada aynı anda AI ile kod yazma. Bir feature’ı doğal dilde tanımlarsınız, Cursor tüm dosyaları oluşturur veya günceller:

  1. Cmd+I (Mac) / Ctrl+I (Windows) ile Composer’ı açın.
  2. Feature tanımı yazın: “Kullanıcı giriş sayfası yap, email ve şifre ile, validation dahil, loading state ve error toast’ı ile”.
  3. Cursor hangi dosyaların oluşturulacağını/güncelleneceğini listeler.
  4. Onaylayın. Cursor her dosyayı ayrı ayrı yazıp diff gösterir.
  5. Her dosyayı ayrı kabul/reject edebilirsiniz.

Composer, bir feature’ı sıfırdan oluştururken component, style, test, route — hepsini tek seferde üretir. Saatlerce sürecek bir işi dakikalara indirir.

3. Tab Tamamlama

Cursor’un tab tamamlaması, Copilot’tan farklı olarak tek satır değil, birden çok satırı tamamlar:

  • Tab’a basınca 10-20 satır yazabilir.
  • Bağlamı analiz ederek sizin ne yazmak istediğinizi tahmin eder.
  • Sadece sonraki kelimeyi değil, tüm bloğu önerir.
  • Cursor’ın tab tamamlaması Copilot’tan daha agresif — bazen tüm fonksiyonu önerir.

4. Codebase Indexing

Cursor, tüm projenizi indexler. Bu, AI’nin yalnızca açık dosyayı değil, tüm projeyi bilmesi anlamına gelir:

  • “Bu projede auth nerede yapılıyor?” — Cursor tüm dosyaları tarar, ilgili dosyaları listeler.
  • @file ile belirli dosyaları referans gösterün: @components/Button.tsx — Cursor o dosyayı referans alır.
  • @folder ile bir klasörün tamamını referans gösterin: @src/utils
  • @codebase ile tüm projeyi referans gösterin — Cursor tüm dosyaların özetini kullanır.

5. Model Seçimi

Cursor’da AI modeli seçebilirsiniz. Her görev için en uygun modeli kullanın:

  • Claude 4 Sonnet: Kod yazmada en güçlü. Cursor’un önerdiği varsayılan model. Composer ve Cmd+K için ideal.
  • GPT-4o: Genel kullanım. Hızlı, çok modlu, dengeli.
  • o3-mini: Mantık ve matematik gerektiren görevler. Algoritma tasarımı, optimizasyon.
  • Cursor Custom (cursor-small): Cursor’un kendi modeli. Hızlı tamamlama, düşük maliyet.
  • Auto: Cursor görevin karmaşıklığına göre otomatik model seçer.

6. .cursorrules: Proje Kuralları

Proje kök dizinine .cursorrules dosyası koyun. Cursor’a proje kurallarını öğretir:

Örnek .cursorrules: “TypeScript kullan, fonksiyon isimleri camelCase, React functional components (class değil), testler jest ile, CSS modules yerine Tailwind kullan, her fonksiyona JSDoc ekle, error handling try-catch ile.”

Cursor, her yeni kod üretiminde bu kuralları uygular. Proje tutarlılığını otomatik sağlar.

7. @web: İnternet Arama

Sohbette @web yazın, Cursor internette arama yapar:

  • @web React 19 yeni özellikleri — Cursor internetten en güncel dokümantasyonu okur.
  • @web Next.js 15 app router migration guide — Migration rehberini okur, kodu günceller.
  • @web Python 3.13 yeni modüller — Yeni modülleri öğrenir, kullanır.

8. Cursor Chat

Cursor’ın sohbet penceresi, VS Code’dakinden farklı olarak tüm projeyi referans alabilir:

  • @file, @folder, @codebase ile referanslar.
  • @web ile internet arama.
  • @docs ile kütüphane dokümantasyonu referansı: @docs React hooks
  • @git ile git geçmişi: “Son commit’te ne değişti?”
  • Normal sohbet: “Bu projede en iyi nasıl test yazarım?”

9. Code Review

Cursor, kodunuzu otomatik review eder. Bir dosyayı kaydettiğinizde veya PR açmadan önce Cursor potansiyel sorunları listeler: güvenlik açıkları, performans sorunları, best practice ihlalleri, erişilebilirlik eksiklikleri.

10. Git Entegrasyonu

  • Diff review: “Bu branch’de ne değişti?” — Cursor tüm diff’i özetler.
  • Commit message: Cursor staging area’daki değişikliklere göre commit message önerir.
  • PR açıklama: Bir branch’in tüm değişikliklerini PR açıklamasına çevirir.
  • Merge conflict: “Bu conflict’ı çöz” — Cursor her conflict için öneri sunar.

Profesyonel İpuçları

İpucu 1: Composer’ı Büyük Değişiklikler İçin Kullanın

Küçük değişiklikler için Cmd+K, büyük değişiklikler için Composer. Bir feature eklerken Composer kullanın — birden fazla dosyayı tek seferde yönetir.

İpucu 2: .cursorrules’u Proje Başında Kurun

Proje başında .cursorrules dosyasını oluşturun. Kod stili, framework, test aracı, hata yönetimi — hepsini tanımlayın. Cursor bundan sonra her kod üretiminde bu kuralları izler.

İpucu 3: @docs ile Kütüphane Dokümantasyonu

Yeni bir kütüphane kullanırken @docs ile referans verin. Cursor kütüphanenin en güncel API’sini öğrenir, deprecated metodları kullanmaz.

İpucu 4: Model’i Göreve Göre Seçin

Kod yazma: Claude 4 Sonnet. Hızlı tamamlama: Cursor Custom. Mantık: o3-mini. Auto modu çoğu durumda iyi ama kritik görevlerde manuel seçim daha iyi sonuç verir.

İpucu 5: Tab ile Akıcı Yazım

Tab tamamlamasını pasif kullanmayın. Her yazdığınızda Tab önerisini kontrol edin. Cursor genelde ne yazmak istediğinizi bilir. Tab + hızlı yazım = 2-3x hız.

Fiyatlandırma

  • Free: Sınırlı tamamlama (2000 tamamlama/ay), temel özellikler.
  • Pro (20 USD/ay): Sınırsız tamamlama, premium modeller (Claude, GPT-4o), Composer, codebase indexing.
  • Business (40 USD/ay/kullanıcı): Team yönetimi, güvenlik kontrolleri, admin dashboard.
  • Enterprise: Özel fiyatlandırma, SSO, audit log, custom models.

Kaynaklar

Bir yanıt yazın

E-posta adresiniz yayınlanmayacak. Gerekli alanlar * ile işaretlenmişlerdir