Cursor AI Kullanımı Rehberi: Yapay Zeka ile Kod Nasıl Yazılır?

Cursor AI kullanımı, yazılım geliştirme süreçlerini yapay zeka entegrasyonuyla 10 kat hızlandıran, Visual Studio Code tabanlı yeni nesil bir akıllı kod editörüdür. Cursor AI; kod tabanınızı (codebase) tamamen analiz ederek Claude 3.5 Sonnet ve GPT-4o gibi gelişmiş yapay zeka modellerini doğrudan geliştirme ortamınıza entegre eder. Bu rehberde, sıfırdan proje oluşturmaktan var olan karmaşık kod bloklarını otomatize etmeye, hataları anında çözmekten .cursorrules dosyası ile özel yapay zeka talimatları oluşturmaya kadar tüm adımları detaylarıyla bulacaksınız.

Cursor AI Kullanımı İçin Temel Gereksinimler

Yapay zeka destekli kodlama dünyasına adım atmadan önce geliştirme ortamınızı doğru yapılandırmanız gerekir. Cursor AI, klasik kod tamamlama eklentilerinden (GitHub Copilot gibi) farklı olarak bağımsız bir IDE (Bütünleşik Geliştirme Ortamı) olarak çalışır.

• Cursor AI Editörü: Resmi web sitesinden Windows, macOS veya Linux işletim sisteminize uygun sürümün indirilmesi.
• Etkin Bir Hesap ve Model Erişimi: Proje karmaşıklığına göre Cursor Pro aboneliği veya kendi OpenAI/Anthropic API anahtarınız (API Key).
• VS Code Eklenti ve Ayar Geçmişi: Var olan VS Code konfigürasyonlarınızı tek tıkla aktarabilmek için mevcutta kullanılan eklenti listesi.
• Git Reposu Entegrasyonu: Kod değişikliklerini versiyon kontrol sistemiyle izlemek için temel Git yapılandırması.

Adım Adım Cursor AI Kullanım Rehberi

Cursor AI ortamını maksimum verimle kullanmak ve yapay zekayı bir kıdemli yazılımcı (Senior Developer) gibi çalıştırmak için aşağıdaki adımları sırasıyla uygulayın.

1. Kurulum ve VS Code Ortamının Aktarılması

Cursor AI uygulamasını indirip kurduktan sonra karşınıza çıkan ilk kurulum ekranında “Import Settings from VS Code” seçeneğini işaretleyin. Bu işlem, mevcut tüm temanızı, kısayollarınızı ve yüklediğiniz eklentileri (Extensions) saniyeler içinde Cursor’a taşır. Böylece alışık olduğunuz çalışma düzeni bozulmaz.

2. Doğru Yapay Zeka Modelinin Seçilmesi

Cursor AI ayarlar menüsünden (Ctrl + , veya Cmd + ,) Models sekmesine gidin. Yazılım geliştirme ve mantıksal kod yazımı konusunda günümüzün en başarılı modeli olan Claude 3.5 Sonnet seçeneğini varsayılan olarak belirleyin. Karmaşık algoritma çözümlerinde ve tam proje üretiminde bu model, geleneksel modellerden çok daha yüksek bir başarı oranına sahiptir.

3. Satır İçi Kod Üretimi ve Düzenleme (Cmd+K / Ctrl+K)

Kod editöründe herhangi bir dosyadayken satır içinde kod yazdırmak veya var olan bir kodu değiştirmek için kısayolları kullanın:

1. Kod editöründe değiştirmek istediğiniz alanı seçin veya boş bir satıra gelin.
2. Windows’ta Ctrl + K, macOS’ta Cmd + K tuş kombinasyonuna basın.
3. Açılan istem kutusuna ne yapmak istediğinizi doğal dilde yazın (Örn: “Bu fonksiyona try-catch bloğu ekle ve oluşan hataları konsola detaylıca yazdır”).
4. Yapay zekanın ürettiği kod farkını (Diff view) inceleyin. Yeşil renkli eklemeleri ve kırmızı renkli silinenleri onaylamak için Accept butonuna tıklayın.

4. Tüm Proje Mimarisi Oluşturma: Composer Özelliği (Cmd+I / Ctrl+I)

Cursor AI’ın en güçlü özelliklerinden biri olan Composer, tek bir prompt ile birden fazla dosya oluşturabilir ve projenin mimarisini baştan sona kurgulayabilir. Cmd + I veya Ctrl + I tuşlarına basarak Composer penceresini açın. Örneğin; “Next.js ve Tailwind CSS kullanarak modern bir iletişim formu bileşeni oluştur, backend API rotasını yaz ve doğrulama (validation) işlemlerini Zod ile yap” şeklinde kapsamlı bir talimat verdiğinizde, yapay zeka gerekli tüm dosyaları otomatik olarak projenize ekler.

5. Bağlam (Context) Yönetimi ve @ Sembolü Kullanımı

Yapay zekaya doğru cevabı verdirmek, ona sunduğunuz bağlamın (context) kalitesine bağlıdır. Cursor AI sohbet panelinde (Cmd + L / Ctrl + L) özel yönlendirme sembolleri bulunur:

• @Files: Sadece belirlediğiniz spesifik bir dosyayı yapay zekaya okutur.
• @Folder: Tüm bir klasör içeriğini bağlam olarak sunar.
• @Docs: Popüler kütüphanelerin veya eklediğiniz özel dokümantasyonların resmi belgelerini referans gösterir.
• @Codebase: Tüm projenizi tarayarak yapay zekanın tüm mimariyi anlamasını sağlar.
• @Web: Güncel internet araması yaparak en yeni kütüphane güncellemelerini çekmesini sağlar.

6. Otomatik Hata Ayıklama (Debugging) ve Terminal Entegrasyonu

Projenizi çalıştırırken terminalde bir hata aldığınızda, hatayı kopyalayıp tarayıcıda aratmanıza gerek yoktur. Terminal penceresinde beliren “Fix with AI” butonuna tıkladığınızda Cursor AI hatanın kök nedenini tespit eder, ilgili dosyayı bulur ve düzeltme önerisini anında ekranınıza getirir.

Püf Noktaları ve En Çok Yapılan Hatalar

Cursor AI kullanırken maksimum verim almak ve projelerinizi bozmamak için dikkat etmeniz gereken kritik ipuçları şunlardır:

Altın Kural: Yapay zekanın ürettiği her kodu körü körüne onaylamayın (Accept yapmayın). Kod farkı (Diff) ekranını mutlaka inceleyin ve yazılım mimarinize uygunluğunu denetleyin.

• .cursorrules Dosyası Kullanın: Projenizin kök dizinine .cursorrules isimli bir dosya ekleyin. Bu dosyaya “Her zaman TypeScript kullan”, “Yorum satırlarını Türkçe yaz”, “Tailwind class’larını grupla” gibi kurallar yazarak yapay zekanın projenize özel standartlara uymasını sağlayın.
• Aşırı Bağlam Yüklemesinden Kaçının: Bütün projeyi (@Codebase) her sorguda çağırmak yapay zekanın odak noktasını dağıtabilir. Sadece ilgili dosyaları (@Files) çağırmak daha doğru ve hızlı sonuçlar verir.
• Hassas Veri Güvenliği: API anahtarlarınızı veya gizli verilerinizi asla kod dosyalarının içine yalın halde yazmayın. .env dosyalarınızı .cursorignore listesine ekleyerek yapay zeka sunucularına gönderilmesini engelleyin.

Sıkça Sorulan Sorular (FAQ)

Cursor AI kullanımı tamamen ücretsiz mi?

Cursor AI, aylık belirli sayıda hızlı kullanım ve sınırsız yavaş kullanım sunan ücretsiz bir plana (Hobby Plan) sahiptir. Ancak Claude 3.5 Sonnet ve GPT-4o gibi gelişmiş modellere kesintisiz, yüksek hızlı erişim ve geniş bağlam penceresi için Pro abonelik almanız veya kendi API anahtarınızı kullanmanız önerilir.

Cursor AI kullanmak için kodlama bilmek şart mı?

Temel seviyede yazılım mantığı bilmek avantaj sağlar; ancak hiç kodlama bilmeyen kişiler de fikirlerini doğal dille açıklayarak Cursor AI sayesinde eksiksiz web siteleri, otomasyon betikleri ve uygulamalar geliştirebilirler.

Cursor AI ile VS Code arasındaki temel fark nedir?

VS Code standart bir kod editörüdür ve yapay zeka özellikleri sonradan eklentilerle dâhil edilir. Cursor AI ise doğrudan VS Code altyapısı üzerine inşa edilmiş, yapay zekayı çekirdeğine entegre etmiş bir araçtır. Kod tabanını indeksleme, dosya oluşturma ve terminal hatalarını çözme yetenekleri standart eklentilere kıyasla çok daha derindir.

Hangi AI modeli Cursor AI içerisinde en iyi sonucu verir?

Güncel testlerde ve yazılımcı geri bildirimlerinde, karmaşık kod mantığı kurma, refactoring (kod iyileştirme) ve hatasız syntax üretimi konusunda Claude 3.5 Sonnet açık ara en başarılı modeldir.