Cursor AI Editor Rehberi

Cursor AI Editor Kapsamlı Kullanım Rehberi

Bu rehber, AI-first kod editörü Cursor un tüm özelliklerini, kurulum ve yapılandırma adımlarını, verimli kullanım tekniklerini ve ileri düzey stratejileri kapsamlı olarak ele almaktadır. VS Code altyapısı üzerine kurulu Cursor, yapay zeka destekli kod yazımını yeni bir seviyeye taşımaktadır.

🚀 Önemli Not: Cursor sürekli güncellenmektedir. Bu rehber 2024-2025 dönemi için hazırlanmıştır. Yeni özellikler ve değişiklikler olabilir. En güncel bilgi için cursor.com adresini takip edin.

Cursor Nedir ve Neden Kullanmalı?

Cursor Genel Bakış

Cursor hakkında temel bilgiler.

CURSOR NEDİR?



GENEL BİLGİLER:

Tür: AI-first kod editörü

Altyapı: VS Code fork

Şirket: Anysphere Inc.

Çıkış: 2023

Yatırım: $60M+ (Andreessen Horowitz)

Kullanıcı: 100,000+ geliştirici



TEMEL KONSEPT:

VS Code un tüm özelliklerini içerir

AI yetenekleri native olarak entegre

Multi-file editing ve codebase anlama

Copilot alternatifi değil, farklı yaklaşım



VS CODE İLE İLİŞKİ:

VS Code fork u (ayrı uygulama)

VS Code eklentileri çoğunlukla çalışır

Ayarlar ve temalar import edilebilir

Aynı kısayollar ve arayüz

Ek AI özellikleri native



NEDEN CURSOR?



1. AI-First Tasarım:

   AI sonradan eklenmedi, temelinde var

   Tüm özellikler AI etrafında tasarlandı

   Daha derin entegrasyon



2. Multi-File Editing:

   Composer ile proje genelinde düzenleme

   Tek komutla çoklu dosya değişikliği

   Büyük refactoring kolaylığı



3. Codebase Understanding:

   Tüm projeyi indexler

   Semantic arama

   Context-aware öneriler



4. Model Esnekliği:

   GPT-4, Claude, özel modeller

   Model seçimi kullanıcıda

   Farklı görevler için farklı modeller



5. Privacy Mode:

   Kod sunucuya gönderilmez seçeneği

   Enterprise için önemli

   SOC 2 uyumlu

Fiyatlandırma ve Planlar

Cursor fiyatlandırma detayları.

CURSOR FİYATLANDIRMA



PLANLAR:



1. HOBBY (Ücretsiz):

   Fiyat: $0

   

   İçerik:

   - 2000 completion/ay

   - 50 slow premium request/ay

   - 200 cursor-small request/ay

   - Temel özellikler

   

   Sınırlamalar:

   - Premium modeller sınırlı

   - Slow request (beklemeli)

   - Composer sınırlı



2. PRO:

   Fiyat: $20/ay

   

   İçerik:

   - Sınırsız completion

   - 500 fast premium request/ay

   - Sınırsız slow premium request

   - Sınırsız cursor-small

   - Tüm özellikler

   - Claude ve GPT-4 erişimi

   - Privacy mode

   

   Özellikler:

   - Composer tam erişim

   - Codebase indexing

   - Öncelikli destek



3. BUSINESS:

   Fiyat: $40/kullanıcı/ay

   

   İçerik:

   - Pro nun tüm özellikleri

   - Merkezi yönetim

   - SSO/SAML

   - Kullanım analytics

   - Admin dashboard

   - Öncelikli destek

   - SLA garantisi



REQUEST TÜRLERİ:



Fast Request:

- Anında yanıt

- Premium modeller (GPT-4, Claude)

- Pro da 500/ay



Slow Request:

- Kuyrukta bekler (genelde kısa)

- Premium modeller

- Pro da sınırsız



Cursor-small:

- Hızlı, hafif model

- Basit tamamlamalar için

- Çok hızlı yanıt



MODEL KULLANIMI:



GPT-4 / GPT-4 Turbo:

- En güçlü genel model

- Karmaşık görevler için



Claude 3.5 Sonnet:

- Hızlı ve kaliteli

- Kod için optimize



Claude 3 Opus:

- En güçlü Claude

- Karmaşık reasoning



cursor-small:

- Hızlı completion

- Basit öneriler

Kurulum ve Yapılandırma

Kurulum Adımları

Cursor kurulumu ve ilk yapılandırma.

CURSOR KURULUM



ADIM 1: İNDİRME



cursor.com adresine git

İşletim sistemini seç:

- macOS (Intel / Apple Silicon)

- Windows

- Linux (AppImage / deb)



Download butonuna tıkla

Dosyayı indir



ADIM 2: YÜKLEME



macOS:

- DMG dosyasını aç

- Cursor u Applications a sürükle

- İlk açılışta Gatekeeper onayı ver



Windows:

- EXE installer ı çalıştır

- Kurulum sihirbazını takip et

- Başlat menüsüne ekle



Linux:

- AppImage: chmod +x ve çalıştır

- deb: sudo dpkg -i cursor.deb



ADIM 3: HESAP OLUŞTURMA



Cursor ı aç

"Sign Up" seç

GitHub veya email ile kayıt ol

Email doğrulama yap

Plan seç (Hobby ücretsiz)



ADIM 4: VS CODE AYARLARINI İMPORT



İlk açılışta import seçeneği çıkar

"Import from VS Code" seç

İmport edilenler:

- Temalar

- Ayarlar

- Kısayollar

- Bazı eklentiler



Manuel import için:

Cmd+Shift+P (Mac) / Ctrl+Shift+P (Win)

"Import VS Code Settings"



ADIM 5: EKLENTİ KONTROLÜ



VS Code eklentilerini kontrol et

Çoğu otomatik çalışır

Sorunlu olanları yeniden kur

Cursor-specific eklentilere gerek yok



ADIM 6: TEMEL AYARLAR



Settings > Cursor Settings

- AI model seçimi

- Privacy ayarları

- Keyboard shortcuts

- Feature toggles

Önemli Ayarlar

Cursor yapılandırma ve optimizasyon.

CURSOR AYARLARI



CURSOR SETTINGS MENÜSÜ:



Erişim:

Cmd+, (Mac) / Ctrl+, (Win)

Veya: Cursor > Settings > Cursor Settings



1. MODELS:



Default Model:

- Chat için varsayılan model

- Öneri: Claude 3.5 Sonnet (hız/kalite dengesi)



Long Context Model:

- Büyük dosyalar için

- Öneri: GPT-4 Turbo veya Claude



Autocomplete Model:

- Tab completion için

- cursor-small varsayılan (hızlı)



2. FEATURES:



Copilot++:

- Tab completion özelliği

- Açık tutun



Cursor Tab:

- Gelişmiş tab önerileri

- Multi-line prediction

- Açık tutun



Cmd K:

- Inline editing

- Açık tutun



Chat:

- Sidebar chat

- Açık tutun



Composer:

- Multi-file editing

- Pro için açık



3. PRIVACY:



Privacy Mode:

- Kod sunucuya gönderilmez

- Local processing

- Pro özelliği



Codebase Indexing:

- Projeyi indexler

- Privacy mode ile uyumlu

- Önerilir



Telemetry:

- Kullanım verisi

- İsteğe bağlı kapatılabilir



4. BETA FEATURES:



Yeni özellikler için:

- Agent mode

- Yeni modeller

- Experimental features

Risk alabiliyorsanız açın



KEYBOARD SHORTCUTS:



Cursor Özel Kısayollar:

Cmd+K: Inline edit

Cmd+L: Chat aç

Cmd+I: Composer

Cmd+Shift+I: Composer (yeni)

Cmd+Enter: Chat ta gönder



Özelleştirme:

Keyboard Shortcuts menüsünden

cursor. ile başlayanlar

İstediğiniz gibi değiştirin



WORKSPACE AYARLARI:



.cursor klasörü:

Proje özel ayarlar

rules dosyası

Codebase talimatları



.cursorignore:

Indexing den hariç tutulacaklar

node_modules benzeri

Hassas dosyalar

Temel AI Özellikleri

Tab Completion (Cursor Tab)

Akıllı kod tamamlama özelliği.

TAB COMPLETION



NASIL ÇALIŞIR:



Yazarken otomatik öneri

Gri metin olarak görünür

Tab ile kabul et

Esc ile reddet

Yazarak geç



TEK SATIRLIK COMPLETION:



Örnek:

function calculateTotal(items

// Tab a bas

function calculateTotal(items: CartItem[]): number {



Tetikleme:

- Fonksiyon imzaları

- Değişken atamaları

- Import statements

- Yaygın patterns



ÇOKLU SATIRLIK COMPLETION:



Cursor Tab özelliği

Birden fazla satır önerir

Bağlama göre tahmin



Örnek:

// Calculate the average of numbers

function calculateAverage(

// Tab a bas, tüm fonksiyon gelir

function calculateAverage(numbers: number[]): number {

    if (numbers.length === 0) return 0;

    const sum = numbers.reduce((a, b) => a + b, 0);

    return sum / numbers.length;

}



CONTEXT AWARENESS:



Cursor şunları anlar:

- Açık dosyalar

- Import edilen modüller

- Proje yapısı

- Kod stili

- Değişken isimleri

- Tip tanımları



Örnek:

// User interface tanımlı başka dosyada

const user: User = {

// Tab ile User alanları önerilir

    id: 1,

    name: "",

    email: "",

    createdAt: new Date()

}



VERİMLİ KULLANIM:



1. Yorum ile yönlendirme:

   // Validate email format using regex

   function validateEmail(

   // Daha doğru öneri gelir



2. Tip tanımları kullanın:

   function process(data: InputData): OutputData

   // Tipler context sağlar



3. İyi isimlendirme:

   function fetchUserById(userId: string)

   // İsim ne yapacağını anlatır



4. Örnek veri ile başlayın:

   const sampleUser = { id: 1, name: "John" }

   // Bu yapıya göre önerir



AYARLAR:



Cursor Settings > Features:

- Cursor Tab: On/Off

- Autocomplete delay

- Max suggestions



Sorun varsa:

- Disable et, restart et, enable et

- Model değiştir

- Cache temizle

Cmd+K (Inline Editing)

Satır içi AI düzenleme özelliği.

CMD+K (INLINE EDITING)



TEMEL KULLANIM:



Adım 1: Kod seç (veya cursor u konumlandır)

Adım 2: Cmd+K (Mac) / Ctrl+K (Win)

Adım 3: Ne istediğini yaz

Adım 4: Enter ile çalıştır

Adım 5: Değişikliği incele

Adım 6: Accept veya Reject



SENARYO 1: KOD ÜRETME



Cursor u boş satıra koy

Cmd+K

"Create a function that validates email addresses"

Enter



Sonuç:

function validateEmail(email: string): boolean {

    const emailRegex = /^[^s@]+@[^s@]+.[^s@]+$/;

    return emailRegex.test(email);

}



SENARYO 2: MEVCUT KODU DÜZENLEME



Kodu seç

Cmd+K

"Add error handling"

Enter



Önce:

function fetchData(url) {

    const response = await fetch(url);

    return response.json();

}



Sonra:

async function fetchData(url: string) {

    try {

        const response = await fetch(url);

        if (!response.ok) {

            throw new Error(`HTTP error! status: ${response.status}`);

        }

        return await response.json();

    } catch (error) {

        console.error('Fetch error:', error);

        throw error;

    }

}



SENARYO 3: DÖNÜŞTÜRME



Kodu seç

Cmd+K

"Convert to TypeScript with proper types"



Önce:

function processUser(user) {

    return {

        fullName: user.firstName + " " + user.lastName,

        age: user.age

    };

}



Sonra:

interface User {

    firstName: string;

    lastName: string;

    age: number;

}



interface ProcessedUser {

    fullName: string;

    age: number;

}



function processUser(user: User): ProcessedUser {

    return {

        fullName: `${user.firstName} ${user.lastName}`,

        age: user.age

    };

}



SENARYO 4: AÇIKLAMA VE YORUM



Kodu seç

Cmd+K

"Add JSDoc comments"



Sonuç:

/**

 * Validates an email address format

 * @param email - The email address to validate

 * @returns True if the email format is valid, false otherwise

 * @example

 * validateEmail("test@example.com") // returns true

 * validateEmail("invalid-email") // returns false

 */

function validateEmail(email: string): boolean {



ETKİLİ PROMPTLAR:



Genel:

"Add error handling"

"Add input validation"

"Make this async"

"Add TypeScript types"

"Optimize this code"

"Add logging"

"Add comments"



Spesifik:

"Handle the case when array is empty"

"Add rate limiting with 100 requests per minute"

"Convert callbacks to async/await"

"Split into smaller functions"

"Add retry logic with exponential backoff"



DIFF GÖRÜNÜMÜ:



Değişiklik sonrası:

- Yeşil: Eklenen satırlar

- Kırmızı: Silinen satırlar

- Accept: Değişikliği uygula

- Reject: İptal et

- Edit: Prompt u düzenle

Cmd+L (Chat)

AI sohbet paneli kullanımı.

CMD+L (CHAT)



TEMEL KULLANIM:



Cmd+L ile chat panelini aç

Soru sor veya görev ver

Enter ile gönder

Yanıtı incele

Kodu Apply ile uygula



CHAT ARAYÜZÜ:



Sol panel: Chat geçmişi

Ana alan: Mesajlaşma

Üst: Model seçimi

Alt: Input alanı



CONTEXT EKLEME:



@file ile dosya ekle:

"@src/utils/helpers.ts bu dosyadaki hataları bul"



@folder ile klasör:

"@components klasöründeki tüm bileşenleri listele"



@codebase ile tüm proje:

"@codebase authentication nasıl çalışıyor?"



@docs ile dokümantasyon:

"@docs React useEffect nasıl kullanılır?"



@web ile web arama:

"@web en son Next.js sürümü ne?"



@git ile git geçmişi:

"@git son commit te ne değişti?"



CHAT KOMUTLARI:



/edit - Kod düzenleme modu

/explain - Kod açıklama

/test - Test üretme

/fix - Hata düzeltme

/docs - Dokümantasyon



ÖRNEK KONUŞMALAR:



Kod Açıklama:

"Bu fonksiyon ne yapıyor?"

[Kod seçili veya @file ile]



Hata Ayıklama:

"Bu hata neden oluşuyor?

Error: Cannot read property 'map' of undefined"



Refactoring:

"Bu kodu daha okunabilir hale getir

@src/components/UserList.tsx"



Öğrenme:

"React useCallback ve useMemo arasındaki fark ne?

Ne zaman hangisini kullanmalıyım?"



Mimari:

"@codebase Bu projede state management nasıl yapılmış?

İyileştirme önerilerin neler?"



APPLY BUTONU:



Chat ta kod bloğu üretildiğinde

"Apply" butonu görünür

Tıkla ve hedef dosyayı seç

Diff görünümü ile incele

Accept veya Reject



CHAT GEÇMİŞİ:



Sol panelde geçmiş sohbetler

Tıklayarak geri dön

Silmek için sağ tık

Yeni chat için + butonu



MODEL SEÇİMİ:



Chat üstünde model dropdown

Görev türüne göre seç:

- Hızlı sorular: cursor-small

- Genel: Claude 3.5 Sonnet

- Karmaşık: GPT-4 veya Claude Opus

Composer

Çoklu dosya düzenleme özelliği.

COMPOSER



NEDİR:



Multi-file editing aracı

Proje genelinde değişiklik

Agentic coding

Pro özelliği



AÇMA:



Cmd+I (Mac) / Ctrl+I (Win)

Veya: Cmd+Shift+I (yeni pencere)



ARAYÜZ:



Üst: Prompt input

Orta: Dosya listesi ve değişiklikler

Alt: Accept/Reject butonları



TEMEL KULLANIM:



Adım 1: Composer ı aç (Cmd+I)

Adım 2: Ne istediğini detaylı yaz

Adım 3: Enter ile çalıştır

Adım 4: Değişiklikleri incele

Adım 5: Accept All veya dosya dosya kabul



SENARYO 1: YENİ FEATURE



Prompt:

"Create a user authentication system with:

- Login page component

- Register page component

- Auth context for state

- Protected route wrapper

- API functions for auth endpoints

Use TypeScript and follow existing code patterns."



Sonuç:

- src/pages/Login.tsx (yeni)

- src/pages/Register.tsx (yeni)

- src/context/AuthContext.tsx (yeni)

- src/components/ProtectedRoute.tsx (yeni)

- src/api/auth.ts (yeni)

- src/App.tsx (güncelleme - route ekleme)



SENARYO 2: REFACTORING



Prompt:

"Refactor all API calls in the project to use a centralized 

API client with:

- Base URL configuration

- Error handling

- Request/response interceptors

- TypeScript types

Update all existing API calls to use the new client."



Sonuç:

- src/api/client.ts (yeni)

- src/api/types.ts (yeni)

- src/services/userService.ts (güncelleme)

- src/services/productService.ts (güncelleme)

- [Diğer dosyalar güncellenir]



SENARYO 3: TEST EKLEME



Prompt:

"Add comprehensive unit tests for all functions in 

@src/utils folder using Jest. Include:

- Happy path tests

- Edge cases

- Error cases

Follow AAA pattern (Arrange-Act-Assert)"



Sonuç:

- src/utils/__tests__/helpers.test.ts

- src/utils/__tests__/validators.test.ts

- src/utils/__tests__/formatters.test.ts



SENARYO 4: MİGRASYON



Prompt:

"Migrate all class components to functional components 

with hooks. Maintain the same functionality.

@src/components"



SENARYO 5: DOKÜMANTASYON



Prompt:

"Add JSDoc comments to all exported functions 

in the project. Include:

- Description

- @param tags

- @returns tag

- @example where helpful"



ETKİLİ COMPOSER PROMPTLARI:



Detaylı Olun:

Kötü: "Add tests"

İyi: "Add Jest unit tests for UserService class covering 

     all public methods, including error cases and edge cases.

     Use mock for database calls. Follow AAA pattern."



Context Verin:

"Following the existing patterns in @src/api,

create a new endpoint handler for..."



Kısıtları Belirtin:

"Do not modify any existing tests.

Only add new test files.

Use the existing test utilities in @src/test-utils."



Adımları Listeleyin:

"1. Create the interface

2. Implement the service

3. Add the API route

4. Update the frontend to use it

5. Add basic tests"



DEĞİŞİKLİK YÖNETİMİ:



Her dosya için:

- Diff görünümü

- Accept/Reject ayrı ayrı

- Edit ile manuel düzenleme



Toplu işlem:

- Accept All: Tümünü kabul

- Reject All: Tümünü iptal



Geri alma:

- Undo ile geri al

- Git ile versiyonlama önemli

İleri Düzey Özellikler

Codebase Indexing

Proje indexleme ve semantic arama.

CODEBASE INDEXING



NEDİR:



Tüm projeyi vektör olarak indexler

Semantic anlam çıkarır

Hızlı ve akıllı arama

Context-aware yanıtlar



NASIL ÇALIŞIR:



1. Proje açıldığında indexleme başlar

2. Dosyalar parse edilir

3. Embedding ler oluşturulur

4. Local veya cloud da saklanır

5. Sorgularda kullanılır



AKTİFLEŞTİRME:



Cursor Settings > Features > Codebase Indexing

Enable et

İlk indexleme biraz zaman alır

Status bar da progress görünür



KULLANIM:



Chat ta @codebase ile:

"@codebase kullanıcı authentication nasıl çalışıyor?"

"@codebase database bağlantısı nerede yapılıyor?"

"@codebase API error handling pattern ı ne?"



Composer da otomatik:

Composer zaten codebase ı anlar

Explicit @codebase gerekmez



Cmd+K da:

Açık dosya + yakın dosyalar

Otomatik context



FAYDALAR:



1. Akıllı Yanıtlar:

   Proje özelinde cevaplar

   Var olan pattern ları kullanır

   Tutarlı kod üretir



2. Cross-File Understanding:

   İlişkili dosyaları bulur

   Import/export takibi

   Dependency anlama



3. Semantic Search:

   "auth ile ilgili dosyalar"

   "database query leri nerede"

   Tam metin değil, anlam araması



.CURSORIGNORE:



Indexing den hariç tutmak için:

Proje root una .cursorignore ekle



Örnek:

node_modules/

dist/

build/

.git/

*.log

*.min.js

coverage/

.env*

secrets/



PERFORMANS:



Büyük projeler için:

- İlk indexleme 5-15 dakika

- Sonraki güncellemeler hızlı

- RAM kullanımı artabilir

- SSD önerilir



Sorun varsa:

- Reindex: Cmd+Shift+P > Reindex

- Cache temizle

- Gereksiz dosyaları ignore et

Cursor Rules

Proje özel AI kuralları.

CURSOR RULES



NEDİR:



Proje özel AI talimatları

Her sorguda otomatik eklenir

Kod stili ve pattern tanımlama

Team standardizasyonu



DOSYA OLUŞTURMA:



Proje root una .cursorrules dosyası ekle

Veya: .cursor/rules dosyası



ÖRNEK RULES DOSYASI:



# Project Rules for Cursor AI



## Code Style

- Use TypeScript for all new files

- Use functional components with hooks for React

- Use named exports instead of default exports

- Maximum line length: 100 characters

- Use 2 spaces for indentation



## Naming Conventions

- Components: PascalCase (UserProfile.tsx)

- Hooks: camelCase with use prefix (useAuth.ts)

- Utils: camelCase (formatDate.ts)

- Constants: UPPER_SNAKE_CASE

- Interfaces: PascalCase with I prefix (IUser)



## Architecture Patterns

- Use repository pattern for data access

- Use service layer for business logic

- Keep components presentational when possible

- Use custom hooks for reusable logic



## Error Handling

- Always use try-catch for async operations

- Log errors with context information

- Return meaningful error messages

- Use custom error classes



## Testing

- Write tests for all new functions

- Use Jest and React Testing Library

- Follow AAA pattern

- Minimum 80% coverage for new code



## Documentation

- Add JSDoc to all exported functions

- Include @param and @returns

- Add @example for complex functions



## Forbidden

- No any type without explicit comment

- No console.log in production code

- No hardcoded credentials

- No direct DOM manipulation in React



## Preferred Libraries

- Date handling: date-fns

- HTTP client: axios

- State management: Zustand

- Form handling: React Hook Form

- Validation: Zod



## File Structure

src/

  components/    # React components

  hooks/         # Custom hooks

  services/      # Business logic

  api/           # API calls

  utils/         # Helper functions

  types/         # TypeScript types

  constants/     # Constants



KULLANIM ETKİSİ:



Rules tanımlandığında:

- Tab completion rules a uyar

- Cmd+K çıktısı rules a uyar

- Chat önerileri tutarlı olur

- Composer proje standardına uyar



TEAM PAYLAŞIMI:



.cursorrules dosyasını git e ekle

Tüm ekip aynı kuralları kullanır

Tutarlı AI çıktıları

Code review kolaylaşır



İPUÇLARI:



Spesifik olun:

Kötü: "Write good code"

İyi: "Use TypeScript strict mode, handle all errors"



Örnek verin:

"For API calls, follow this pattern:

const response = await apiClient.get('/users');

if (!response.ok) throw new ApiError(response);

return response.data;"



Öncelik belirtin:

"Most important: Type safety

Second: Error handling

Third: Performance"

Model Seçimi ve Stratejileri

Farklı görevler için model seçimi.

MODEL SEÇİMİ



MEVCUT MODELLER:



1. GPT-4 / GPT-4 Turbo:

   Güç: En yüksek reasoning

   Hız: Orta-yavaş

   Context: 128K token

   Kullanım: Karmaşık problemler



2. GPT-4o:

   Güç: GPT-4 seviyesi

   Hız: Daha hızlı

   Context: 128K token

   Kullanım: Genel amaçlı



3. Claude 3.5 Sonnet:

   Güç: Çok iyi

   Hız: Hızlı

   Context: 200K token

   Kullanım: Kod için optimal



4. Claude 3 Opus:

   Güç: En yüksek Claude

   Hız: Yavaş

   Context: 200K token

   Kullanım: Çok karmaşık görevler



5. cursor-small:

   Güç: Temel

   Hız: Çok hızlı

   Context: Sınırlı

   Kullanım: Basit completion



GÖREV BAZLI ÖNERİLER:



Tab Completion:

1. cursor-small (varsayılan, hızlı)

2. Claude 3.5 Sonnet (daha akıllı)



Cmd+K (Inline Edit):

1. Claude 3.5 Sonnet (hız+kalite)

2. GPT-4o (alternatif)



Chat (Soru-Cevap):

1. Claude 3.5 Sonnet (genel)

2. GPT-4 (karmaşık konular)



Chat (Kod Açıklama):

1. Claude 3.5 Sonnet

2. GPT-4



Composer (Multi-file):

1. Claude 3.5 Sonnet (hızlı iterasyon)

2. Claude 3 Opus (büyük değişiklikler)

3. GPT-4 (karmaşık mimari)



Debug:

1. GPT-4 (deep reasoning)

2. Claude 3.5 Sonnet



Test Yazma:

1. Claude 3.5 Sonnet

2. GPT-4



Dokümantasyon:

1. Claude 3.5 Sonnet

2. GPT-4o



MODEL DEĞİŞTİRME:



Chat ta: Üst dropdown dan seç

Cmd+K da: Prompt öncesi dropdown

Settings ta: Varsayılan ayarla



STRATEJİ:



Günlük Kullanım:

- Tab: cursor-small

- Cmd+K: Claude 3.5 Sonnet

- Chat: Claude 3.5 Sonnet



Zor Problemler:

- GPT-4 e geç

- Veya Claude 3 Opus



Request Yönetimi:

- Fast request ları akıllı kullan

- Basit işler için cursor-small

- Slow request sınırsız (Pro)

Verimli Workflow lar

Günlük Geliştirme Workflow u

Cursor ile günlük kodlama rutini.

GÜNLÜK GELİŞTİRME WORKFLOW



SABAH BAŞLANGIÇ:



1. Projeyi Aç:

   Cursor ı başlat

   Son projeyi aç

   Indexing tamamlanmasını bekle



2. Günün Planı (Chat):

   "@codebase Dün nerede kalmıştım?

   TODO ve FIXME leri listele"

   

3. Git Durumu:

   "@git Son commit ten bu yana değişiklikler ne?"



FEATURE GELİŞTİRME:



1. Tasarım (Chat):

   "[Feature] için mimari öner.

   Mevcut yapıya uyumlu olsun.

   @codebase"



2. Boilerplate (Composer):

   "Create boilerplate for [feature]:

   - Component file

   - Service file

   - Types file

   - Test file

   Following existing patterns."



3. Implementation (Cmd+K + Tab):

   Dosyaları aç

   Kod yaz, Tab ile tamamla

   Cmd+K ile düzenle



4. Test (Composer):

   "Add tests for the new [feature]

   @src/features/newFeature"



5. Review (Chat):

   "Review my implementation:

   @src/features/newFeature

   Check for bugs, improvements"



BUG FIXING:



1. Hatayı Anla (Chat):

   "Bu hata ne anlama geliyor?

   [Hata mesajı]

   @codebase"



2. Lokasyonu Bul:

   "@codebase Bu hata nereden kaynaklanıyor olabilir?"



3. Fix (Cmd+K):

   Problemi kodda bul

   Cmd+K ile fix iste



4. Test:

   Değişikliği test et

   Regression olmadığından emin ol



REFACTORING:



1. Analiz (Chat):

   "@codebase Technical debt nerede?

   Refactoring önerileri?"



2. Plan:

   "Bu refactoring i adım adım planla:

   [Refactoring tanımı]"



3. Uygula (Composer):

   "Refactor [konu] following this plan:

   [Plan]

   Make sure all tests pass."



4. Verify:

   Testleri çalıştır

   Manuel test

   Code review



GÜNÜ KAPATMA:



1. Commit Mesajı (Chat):

   "Bu değişiklikler için commit mesajı yaz:

   @git diff"



2. TODO Güncelle:

   "Yarın yapılacakları listele

   @codebase"



3. Dokümantasyon:

   Gerekli notları ekle

   README güncelle

Hızlı Klavye Kısayolları

Verimlilik için kısayol referansı.

KLAVYE KISAYOLLARI REHBERİ



CURSOR ÖZEL KISAYOLLAR:



AI Özellikleri:

Cmd+K          Inline edit

Cmd+L          Chat aç/gizle

Cmd+I          Composer

Cmd+Shift+I    Composer (yeni pencere)

Cmd+Enter      Chat ta gönder

Cmd+Shift+L    Chat a seçimi ekle

Cmd+.          Quick fix (AI destekli)



Tab Completion:

Tab            Öneriyi kabul et

Esc            Öneriyi reddet

Alt+]          Sonraki öneri

Alt+[          Önceki öneri

Cmd+→          Kelime kelime kabul



Chat İçinde:

Cmd+Enter      Mesaj gönder

Cmd+Shift+V    Kod bloğu yapıştır

Up Arrow       Önceki mesajı düzenle



VS CODE TEMEL (Cursor da Çalışır):



Genel:

Cmd+Shift+P    Command Palette

Cmd+P          Quick Open (dosya)

Cmd+,          Settings

Cmd+B          Sidebar toggle

Cmd+J          Terminal toggle



Düzenleme:

Cmd+D          Sonraki eşleşmeyi seç

Cmd+Shift+K    Satır sil

Alt+Up/Down    Satır taşı

Cmd+Shift+F    Projede ara

Cmd+H          Find and Replace



Navigasyon:

Cmd+G          Satıra git

Cmd+Shift+O    Sembole git

F12            Definition a git

Cmd+Click      Definition a git

Alt+←/→        Geri/ileri git



Multi-Cursor:

Cmd+Alt+Up     Üste cursor ekle

Cmd+Alt+Down   Alta cursor ekle

Cmd+D          Sonraki eşleşmeyi seç

Cmd+Shift+L    Tüm eşleşmeleri seç



Terminal:

Cmd+`          Terminal aç/kapat

Cmd+Shift+`    Yeni terminal



ÖZEL KOMBİNASYONLAR:



Hızlı Fix:

1. Hatalı kodda dur

2. Cmd+. (quick fix)

3. AI suggestion seç



Kod Açıklama:

1. Kodu seç

2. Cmd+L (chat aç)

3. "Explain this" yaz



Hızlı Test:

1. Fonksiyonu seç

2. Cmd+L

3. "Write tests" yaz

4. Apply ile ekle



Refactor:

1. Kodu seç

2. Cmd+K

3. "Refactor to..." yaz



ÖZELLEŞTİRME:



Kısayol değiştirme:

Cmd+K Cmd+S    Keyboard Shortcuts aç

cursor. ile    Cursor komutlarını filtrele

İstediğini     Değiştir

Sorun Giderme ve İpuçları

Yaygın Sorunlar ve Çözümler

Sık karşılaşılan problemler.

SORUN GİDERME



SORUN: AI Yanıt Vermiyor



Çözümler:

1. İnternet bağlantısını kontrol et

2. Cursor ı restart et

3. Hesap durumunu kontrol et (limit?)

4. Model değiştir

5. Cache temizle: Cmd+Shift+P > Clear Cache



SORUN: Tab Completion Çalışmıyor



Çözümler:

1. Settings > Cursor Tab > Enable

2. Dosya türü destekleniyor mu?

3. Cursor restart

4. Eklenti çakışması kontrol

5. .cursorignore da mı dosya?



SORUN: Yavaş Performans



Çözümler:

1. Büyük dosyaları .cursorignore a ekle

2. Gereksiz eklentileri kapat

3. Codebase reindex

4. Cursor restart

5. RAM kullanımını kontrol et



SORUN: Yanlış/Alakasız Öneriler



Çözümler:

1. Daha fazla context ver

2. Yorum ile yönlendir

3. Model değiştir (GPT-4 dene)

4. .cursorrules ekle

5. Codebase reindex



SORUN: Composer Çok Fazla Değişiklik



Çözümler:

1. Prompt u daralt

2. "Only modify X file" ekle

3. "Do not change Y" ekle

4. Adım adım iste



SORUN: VS Code Eklentisi Çalışmıyor



Çözümler:

1. Eklentiyi yeniden kur

2. Uyumluluk kontrol (bazıları uyumsuz)

3. Cursor güncellemesi kontrol

4. Alternatif eklenti ara



SORUN: Hesap/Billing Sorunu



Çözümler:

1. cursor.com/settings kontrol

2. Billing bilgilerini güncelle

3. support@cursor.com ile iletişim



LOG GÖRÜNTÜLEME:



Help > Toggle Developer Tools

Console tab ında hataları gör

Network tab ında API sorunlarını gör



RESET:



Tam sıfırlama:

1. Cursor ı kapat

2. ~/.cursor klasörünü sil (ayarlar gider)

3. Cursor ı tekrar başlat

4. Hesaba tekrar gir

En İyi Uygulamalar

Cursor dan maksimum verim alma.

EN İYİ UYGULAMALAR



PROMPT YAZMA:



1. Spesifik Olun:

   Kötü: "Fix this"

   İyi: "Fix the null pointer exception on line 15 

        by adding a null check before accessing user.name"



2. Context Verin:

   Kötü: "Add validation"

   İyi: "Add email validation using regex, return boolean,

        handle edge cases like empty string and null"



3. Format Belirtin:

   "Return TypeScript code with proper types"

   "Add JSDoc comments"

   "Follow existing code style"



4. Kısıtları Belirtin:

   "Do not modify other functions"

   "Keep backward compatibility"

   "Maximum 50 lines"



PROJE ORGANİZASYONU:



1. .cursorrules Kullanın:

   Proje standartlarını tanımlayın

   Team genelinde tutarlılık



2. .cursorignore Kullanın:

   Gereksiz dosyaları hariç tutun

   Performans ve güvenlik



3. İyi Dosya Yapısı:

   Mantıklı klasör organizasyonu

   AI nin anlamasını kolaylaştırır



4. Tip Tanımları:

   TypeScript kullanın

   Interface ve type tanımlayın

   AI daha iyi anlar



VERİMLİLİK:



1. Doğru Aracı Seçin:

   Tab: Kısa tamamlama

   Cmd+K: Tek dosya düzenleme

   Chat: Soru-cevap, açıklama

   Composer: Çoklu dosya



2. Model Stratejisi:

   Basit: cursor-small

   Normal: Claude 3.5 Sonnet

   Karmaşık: GPT-4



3. Iteratif Yaklaşım:

   Küçük adımlarla ilerleyin

   Her adımı doğrulayın

   Geri almak kolay olsun



4. Git Kullanın:

   Sık commit yapın

   AI değişikliklerinden önce commit

   Geri alma kolaylığı



GÜVENLİK:



1. Hassas Bilgiler:

   API key leri paylaşmayın

   .env dosyalarını ignore edin

   Credentials dikkat



2. Privacy Mode:

   Gerekiyorsa etkinleştirin

   Kurumsal gereksinimleri kontrol



3. Kod Review:

   AI çıktısını inceleyin

   Güvenlik açıklarını kontrol

   Test edin



ÖĞRENME:



1. AI Çıktısını Anlayın:

   Körü körüne kabul etmeyin

   Neden böyle yazdığını anlayın



2. Yeni Özellikler:

   Changelog takip edin

   Yeni özellikleri deneyin

   Community yi takip edin



3. Feedback:

   Sorunları bildirin

   Feature request yapın

   Community ye katılın

Sıkça Sorulan Sorular

S: Cursor VS Code dan farklı mı?

C: Cursor, VS Code un fork udur (kopyası). Aynı arayüz ve özelliklere sahiptir, üzerine AI yetenekleri eklenmiştir. VS Code eklentilerinin çoğu çalışır.

S: Copilot varken neden Cursor?

C: Cursor multi-file editing (Composer), codebase indexing ve AI-first tasarımı ile farklılaşır. Copilot tek dosya odaklıyken, Cursor proje genelinde çalışabilir.

S: Ücretsiz versiyon yeterli mi?

C: Hobi projeleri ve öğrenme için yeterlidir. Profesyonel kullanımda Pro planı önerilir (daha fazla request, Composer, privacy mode).

S: Kodum sunucuya gönderiliyor mu?

C: Varsayılan olarak evet, AI işlemesi için. Privacy Mode açıkken kod sunucuya gönderilmez (Pro özelliği). Kurumsal gereksinimlerinize göre ayarlayın.

S: Hangi diller destekleniyor?

C: Tüm popüler diller desteklenir: Python, JavaScript, TypeScript, Java, C#, Go, Rust, Ruby, PHP, Swift, Kotlin ve daha fazlası.

S: VS Code ayarlarım aktarılır mı?

C: Evet, ilk kurulumda import seçeneği var. Temalar, ayarlar, kısayollar ve çoğu eklenti aktarılır.

S: Offline çalışır mı?

C: AI özellikleri için internet gerekli. Temel editör özellikleri (VS Code) offline çalışır.

S: Team için uygun mu?

C: Evet, Business planı team yönetimi, SSO ve analytics sunar. .cursorrules ile team standardizasyonu sağlanabilir.