TPToolpazar

Yazılım Geliştirici

Cursor IDE Rehberi

Cursor kurulum, model seçimi, .cursorrules ile takım davranışı, Composer ile çoklu-dosya agent — Türkçe kapsamlı rehber.

Cursor, VS Code çatallaması olarak doğmuş ve bugün dünyanın en yaygın agentic kodlama editörü hâline gelmiş bir IDE’dir. Tab tamamlama, çoklu-dosya değişiklik agent’ı (Composer) ve istediğiniz LLM’e bağlanma esnekliğiyle Türkiye’deki yazılım ekiplerinin çoğunda bir noktada denenmiş bir araç. Bu rehber Cursor’ı kurmayı, ayarlamayı, model seçmeyi, .cursorrules dosyası ile takım davranışı belirlemeyi ve günlük iş akışında verim sağlamayı anlatır.

Cursor Nedir, VS Code'dan Farkı?

Cursor, VS Code’un açık kaynak çatallaması (MIT lisansı taşıyan kod tabanı). Tüm VS Code eklentileri, ayarları, kısayolları çalışır. Üzerine yapay zeka odaklı dört özellik eklenir:

  • Cursor Tab: İmlecinizin etrafındaki bağlamı kullanarak çoklu-satır, çoklu-yer kod tamamlama. GitHub Copilot’un birkaç adım önündedir.
  • Inline chat (Cmd+K): Seçili kodu sohbette değiştir, açıkla, refactor et.
  • Chat panel (Cmd+L): Sohbet penceresi, tüm proje bağlamını okuyup soru cevaplayabilir.
  • Composer (Cmd+Shift+I): Çoklu-dosya agent. Hedef tanımla; Cursor planı çıkarır, dosyaları okur+düzenler, değişikleri inceleme için sunar.

Kurulum

cursor.com adresinden Mac/Windows/Linux için installer indirin. Mevcut VS Code ayarlarınızı (eklentiler, anahtar bağları, tema) ilk açılışta otomatik olarak içe aktarır. Ücretsiz seviye günlük sınırlı tamamlama; Pro abonelik 20 USD/ay aktif kullanım için. Türkiye’den kart kabul edilir, iptali kolaydır.

Model Seçimi

Settings → Models bölümünde mevcut seçenekler:

  • cursor-fast: Düşük gecikmeli, ücretsiz seviyede de mevcut, basit tamamlama için.
  • claude-sonnet-4.x / claude-opus-4.x: Önerilen, karmaşık görevler için.
  • gpt-5 / gpt-5-mini: OpenAI alternatifi.
  • gemini-2.5-pro: Çok-modal ve uzun bağlam için.
  • o3 / o4-mini: Karmaşık akıl yürütme için.

Pro abonelik kapsamında premium model kullanımı “hızlı istek” kotasına bağlı (aylık 500 hızlı istek). Aşıldıktan sonra “yavaş istek” veya “Max” ek ücretlendirme ile devam eder. Kendi API anahtarınızı bağlayabilirsiniz (BYOK)— bu durumda Cursor aboneliği sadece UI ücreti olarak kalır.

.cursorrules ile Takım Davranışı

Projenin kök dizinine .cursorrules dosyası ekleyin. Cursor bu dosyayı her sohbet/composer seansında bağlama otomatik ekler — tekrarlayan talimatları yeniden yazma yükünü kaldırır. Tipik içerik:

# Stack
- Next.js 14, App Router, TypeScript strict
- Tailwind 3.4, brand renkleri DC2626 (kırmızı), F59E0B (amber)
- Turkish UI, slug'lar Türkçe ("/araclar/kdv-hesaplayici" gibi)

# Stil
- async/await kullan, .then() yapma
- Bileşen ismi PascalCase, hook ismi camelCase
- Yorumları sadece "neden" için yaz, "ne" için değil

# Mimari
- DB sorgularını lib/db içine yaz, app/ veya components/ içinden çağırma
- API route'larını app/api/ altında, dosya başına bir endpoint

Takımca bu dosyayı git’e koyun; Cursor kullansın kullanmasın insan geliştiriciler de fayda sağlar.

Composer ile Çoklu-Dosya Görevler

Cmd+Shift+I (Mac) veya Ctrl+Shift+I (Win) ile Composer açılır. “Bu repoda bir takvim bileşeni ekle, Pazartesi başlasın Türkçe gün adlarıyla” gibi bir hedef yazın. Cursor:

  1. İlgili dosyaları okur (mevcut bileşenler, theme tokens)
  2. Plan üretir — hangi dosya yaratılacak, hangileri düzenlenecek
  3. Önizleme sunar; siz kabul/reddedip her dosyayı tek tek inceleyin
  4. Kabul edilenleri uygular

Pratik tavsiye: önce dar bir görev tanımlayın, sonuçları doğrulayın, sonra genişletin. “Tüm projeyi yeniden yaz” gibi geniş istekler bağlam-aşımı ve plan kaymasına yol açar.

Cursor vs Claude Code vs Codex

Üçü farklı arayüz felsefeleri: Cursor IDE, Claude Code ve Codex CLI. Cursor görsel iş akışı sevenler için (kod yan yana, chat bitişik). Claude Code/Codex CLI minimalist terminal-tabanlı ekipler için. Birçok geliştirici ikisini paralel kullanır: günlük iteratif değişiklikler Cursor’da, büyük yapısal refactor Claude Code’da.

Detaylı kıyaslama için Kod yazan AI araçları rehberi.

Sık Sorulan Sorular

Cursor ücretsiz kullanılabilir mi?
Evet, ücretsiz seviye günde sınırlı tamamlama ve sohbet sunar. Yoğun kullanım için Pro 20 USD/ay önerilir. Free tier'da Cursor Tab özelliği daha yavaş model kullanır.
VS Code'umdaki ayarlar Cursor'a aktarılır mı?
Evet, ilk açılışta tüm eklentiler, tema, anahtar bağları, kullanıcı ayarları otomatik içe aktarılır. Ayrıca Cursor güncellemeleri VS Code güncellemelerinden bağımsızdır.
Hangi modeli seçmeliyim?
Çoğu görev için Claude Sonnet (denge); karmaşık refactor için Claude Opus; hızlı küçük tamamlama için cursor-fast; karmaşık akıl yürütme için o3/o4-mini. Composer'da kalite önemliyse Opus tercih edin.
Kendi API anahtarımı kullanabilir miyim?
Evet. Settings → Models → 'Use your own API key' ile Anthropic, OpenAI, Google anahtarınızı bağlayın. Bu durumda Cursor aboneliği gerekmez (sadece teknik özellikler için).
Cursor verilerimi saklıyor mu?
Privacy mode kapalıyken kod parçaları telemetri için Cursor sunucularına gidebilir. Privacy mode açıkken kod sadece anlık model çağrısı için iletilir. Hassas projelerde Privacy mode'u açın (Settings → Privacy).
Türkçe komut destekleniyor mu?
Tamamen. Composer ve sohbete Türkçe yazabilirsiniz; arkadaki model (Claude, GPT, Gemini) ne ise onun Türkçe yetkinliği geçerli.
.cursorrules ne zaman okunur?
Her yeni sohbet/Composer seansının başında, repo kökünden okunup model bağlamına eklenir. Dosyayı değiştirdikten sonra yeni seans açın.

İlgili rehberler