Ajan tabanlı yapay zekâ kod araçları

Yapay zekâ kodlama asistanları, basit otomatik tamamlamadan plan yapabilen, birden fazla dosyayı düzenleyebilen, testleri çalıştırabilen ve pull request oluşturabilen otonom ajanlara dönüştü. Bu eğitimde üç önemli aracı ele alacağız: Claude Code, Cursor ve GitHub Copilot.

1) Bir aracı "ajan tabanlı" yapan nedir?

Geleneksel yapay zekâ kod tamamlama araçları, sonraki birkaç satırı önerir. Ajan tabanlı araçlar ise daha ileri gider:

Yetenek	Otomatik tamamlama	Ajan tabanlı
Kapsam	Geçerli satır/fonksiyon	Tüm kod tabanı
Planlama	Yok	Çok adımlı akıl yürütme
Yürütme	Yalnızca öneriler	Dosyaları düzenleyebilir, komutları çalıştırabilir
Bağlam	Geçerli dosya	Deponun tamamını anlama
İş akışı	Tepkisel	Görevleri otonom olarak tamamlama

Ajan tabanlı araçlar projenizin tüm yapısını anlayabilir, birden fazla dosyaya yayılan değişiklikleri planlayabilir, bu değişiklikleri uygulayabilir, testleri çalıştırabilir ve görev tamamlanana kadar yineleme yapabilir.

2) Hızlı karşılaştırma: Claude Code, Cursor ve Copilot

Özellik	Claude Code	Cursor	GitHub Copilot
Arayüz	CLI, web, IDE eklentileri	Tam IDE (VS Code çatalı)	IDE uzantıları
Bağlam penceresi	Büyük (uzun bağlamlı Opus)	Tüm depo indeksleme	Daha küçük, gelişiyor
Çoklu dosya düzenleme	Güçlü	Mükemmel	Gelişiyor
Plan modu	Var	Var	Var (daha yeni)
Fiyatlandırma	Pro/Max katmanları	Krediler + abonelik	Abonelik
En uygun kullanım	Mimari, büyük yeniden düzenlemeler	Etkileşimli geliştirme	Satır içi kodlama

3) Claude Code'un temelleri

Claude Code, geniş bağlam pencerelerine sahip Opus 4.8 (güncel varsayılan modeli) üzerinde çalışır. Kurulum ve kimlik doğrulama:

# Claude Code'u yükleyin (yerel yükleyici, önerilen)
curl -fsSL https://claude.ai/install.sh | bash

# Ya da npm aracılığıyla (Node 18+ gerekir)
npm install -g @anthropic-ai/claude-code

# Kimlik doğrulama: claude'u çalıştırın ve tarayıcıdaki istemi izleyin
claude

# Projenizde başlatın
cd your-project
claude

Temel komutlar

# Kod tabanınız hakkında soru sorun
claude "Kimlik doğrulama burada nasıl uygulanmış?"

# Kod oluşturun
claude "Bir hız sınırlayıcı ara yazılımı ekle"

# Çoklu dosya yeniden düzenlemesi
claude "Kod tabanının tamamında UserService adını AuthService olarak değiştir"

# PR oluşturun
claude "Tüm API uç noktalarına girdi doğrulaması ekleyen bir PR oluştur"

Proje yapılandırması

Proje bağlamını deponuzun kökündeki bir CLAUDE.md dosyasına yerleştirin. Claude Code, her oturumun başında bu dosyayı otomatik olarak okur:

# Proje notları

- Dil: TypeScript, Prettier ile biçimlendirilir
- Testler: Vitest, tests/ içinde
- node_modules/ veya dist/ dizinlerine dokunma

Makine tarafından okunabilen ayarlar (araç izinleri, ortam değişkenleri, kancalar) .claude/settings.json dosyasına yazılır. Örneğin, yıkıcı araçlar çalıştırılmadan önce onay istemek için izinleri burada yapılandırın.

Bellek ve bağlam

Kalıcı proje bağlamı, Claude Code'un her oturumun başında yüklediği CLAUDE.md dosyalarında ve düzeltmeleriniz ile tercihlerinize göre Claude'un kendisinin güncellediği otomatik bellek deposunda tutulur. Kalıcı bağlam sağlamak için tek seferlik bir "Hatırla:" istemi vermek yerine CLAUDE.md dosyasını düzenleyin:

# CLAUDE.md
Bu bir monorepo'dur. Paylaşılan kod packages/ içinde bulunur.

Çalışma bağlamını sıfırlamak için oturum içinde /clear komutunu kullanın.

4) Cursor IDE'nin ajan tabanlı özellikleri

Cursor, ajan tabanlı iş akışları etrafında oluşturulmuştur. Temel özellikler:

Ajan modu

Composer'ı Ajan modunda açmak için Cmd+Shift+I (Mac) veya Ctrl+Shift+I (Windows/Linux) tuşlarına basın:

Ajan modu iş akışı:
1. Görevinizi açıklayın
2. Ajan bir plan oluşturur
3. Onaylar veya değiştirirsiniz
4. Ajan değişiklikleri uygular
5. İnceleyip yineleme yaparsınız

Plan modu

Karmaşık görevlerde Plan modunu açıkça kullanın:

@plan Şunlarla kullanıcı kimlik doğrulaması ekle:
- JWT belirteçleri
- Yenileme belirteci rotasyonu
- bcrypt ile parola karma işlemi
- Oturum açma denemelerinde hız sınırlama

Ajan şunları yapar:

1. Mevcut kodunuzu inceler
2. Ayrıntılı bir uygulama planı oluşturur
3. Onayınızı bekler
4. Planı adım adım uygular

Bağlam ekleme

Belirli bir bağlam eklemek için @ kullanın:

@file src/api/auth.ts
@folder src/middleware
@docs https://jwt.io/introduction

Bu kalıpları izleyen JWT doğrulama ara yazılımını uygula

Paralel ajanlar

Farklı dallarda birden fazla ajanı eşzamanlı olarak çalıştırın:

# Cursor'da:
1. Komut Paleti'ni açın
2. "Cursor: New Agent in Worktree"
3. Her ajan yalıtılmış olarak çalışır
4. Sonuçları yan yana karşılaştırın

Cursor 3, yerel çalışma kopyaları, git worktree'leri ve bulut ortamlarında birden fazla ajanı paralel olarak çalıştıran bir Agents Window ekledi (açmak için Cmd+Shift+P tuşlarına basıp "Agents Window" yazın). /worktree komutu her ajanı kendine ait yalıtılmış bir git worktree'sinde başlatır; /best-of-n ise aynı görevi birkaç modelde çalıştırarak çıktıları yan yana karşılaştırmanızı sağlar.

Tutarlılık kuralları

.cursor/rules/project.mdc dosyasını oluşturun:

# Proje Kuralları

## Kod Stili
- TypeScript katı modunu kullan
- Fonksiyonel bileşenleri tercih et
- Varsayılan dışa aktarımlar yerine adlandırılmış dışa aktarımları kullan

## Test
- Her özellik için test gerekir
- describe/it bloklarını kullan
- Harici servisleri taklit et

## Güvenlik
- Gizli bilgileri asla commit etme
- Tüm kullanıcı girdilerini doğrula
- Parametreli sorgular kullan

5) GitHub Copilot'ın ajan tabanlı özellikleri

Copilot, otomatik tamamlamanın ötesine geçti:

Copilot Chat

Sohbet panelini açın ve eğik çizgi komutlarını kullanın:

/explain - Seçili kodu açıkla
/fix - Seçimdeki sorunları düzelt
/tests - Testler oluştur
/doc - Dokümantasyon ekle

Kodlama ajanı (issue'dan pull request'e)

# GitHub'da:
1. Bir GitHub issue'su açın
2. Atanan kişi olarak "Copilot"ı seçin
3. Kodlama ajanı arka planda çalışır:
   issue'yu analiz eder, dosyaları düzenler, testleri çalıştırır
4. İncelemeniz için bir pull request açar

Bu özellik, VS Code veya JetBrains içinde sizinle eşzamanlı çalışan Copilot'ın IDE içi ajan modundan farklıdır.

Copilot artık otonom çalışmasını ikiye ayırıyor: ajan modu IDE'nizin (VS Code ve JetBrains) içinde eşzamanlı çalışarak hangi dosyaların düzenleneceğine karar verir, terminal komutlarını çalıştırır ve hatalar üzerinde yineleme yapar; kodlama ajanı ise bulutta eşzamansız çalışarak kendisine atanan bir issue'yu ele alır ve siz başka bir şey üzerinde çalışırken bir pull request teslim eder.

Bağlama dayalı satır içi öneriler

Copilot kod tabanınızı okur. Yorumlarla ona yardımcı olun:

// Şunları yapan kimlik doğrulama ara yazılımı:
// - Authorization başlığından JWT'yi çıkarır
// - Belirteç imzasını doğrular
// - Kullanıcıyı isteğe ekler
// - Geçersizse 401 döndürür
export function authMiddleware(req, res, next) {
  // Copilot uygulamayı oluşturur
}

6) Tüm araçlar için en iyi uygulamalar

Açık istemler yazın

❌ Kötü: "Hatayı düzelt"

✅ İyi: "Kullanıcı mevcut olmadığında UserService.getById içindeki 
null işaretçi istisnasını düzelt. İstisna fırlatmak yerine null döndür."

❌ Kötü: "Test ekle"

✅ İyi: "CartService için şu durumları kapsayan birim testleri ekle:
- Boş sepete ürün ekleme
- Ürünleri kaldırma
- İndirimlerle toplamları hesaplama
- Uç durum: negatif miktarlar"

Karmaşık görevlerde plan modunu kullanın

3 veya daha fazla dosyaya dokunan her görevde daima:

1. Önce bir plan isteyin
2. Planı inceleyin
3. Onaylayın veya değiştirin
4. Ajanın uygulamasına izin verin
5. Commit etmeden önce değişiklikleri inceleyin

Mimari bağlam sağlayın

Büyük bir çalışmadan önce ajanı bilgilendirin:

"Bu bir mikroservis mimarisidir:
- api-gateway: İstekleri yönlendirir
- auth-service: JWT, oturumlar
- user-service: Kullanıcı CRUD işlemleri
- notification-service: E-posta, anlık bildirim

Servisler Redis pub/sub aracılığıyla iletişim kurar.
Veritabanı, Prisma ORM kullanan PostgreSQL'dir."

Ajanlarla test güdümlü geliştirme

1. Önce başarısız olacak testi yazın:
   "E-posta doğrulaması bekleyen bir kullanıcı kaydı testi yaz"

2. Ajanın başarısız testi görmesini sağlayın:
   "Bu testi geçecek şekilde kayıt işlemini uygula"

3. Tüm testler geçene kadar yineleyin:
   "Kalan test hatalarını düzelt"

7) Güvenlik değerlendirmeleri

Ajan tabanlı araçların gerçek yetkileri vardır. Sınırlar belirleyin:

Onay geçitleri

// .claude/config.json
{
  "safety": {
    "requireApproval": [
      "rm",
      "git push",
      "npm publish",
      "database migrations",
      "env file changes"
    ]
  }
}

Korumalı alan kullanımı

# Ajanları yalıtılmış ortamlarda çalıştırın
docker run -v $(pwd):/workspace -it claude-sandbox

# Ya da yalıtım için git worktree'lerini kullanın
git worktree add ../feature-branch feature-branch

Hassas dosyalar

# .cursorignore / .claudeignore
.env
.env.*
secrets/
credentials/
*.pem
*.key

Tüm değişiklikleri inceleyin

# Ajan değişikliklerini kabul etmeden önce:
git diff --stat
git diff

# Etkileşimli hazırlama kullanın
git add -p

# İnceleme olmadan asla otomatik birleştirme yapmayın

8) İşe yarayan iş akışı kalıpları

Kalıp 1: Keşfet, Planla, Uygula

Oturum 1: "Ödeme sistemi nasıl çalışıyor?"
          → Ajan araştırır, siz öğrenirsiniz

Oturum 2: "Stripe eklemek için neler gerekir?"
          → Ajan plan oluşturur

Oturum 3: "Stripe entegrasyonunu uygula"
          → Ajan planı uygular

Kalıp 2: Paralel keşif

# Paralel ajanlarla Cursor'da:

Ajan 1: "Redis ile önbelleğe alma uygula"
Ajan 2: "Memcached ile önbelleğe alma uygula"
Ajan 3: "Bellek içi LRU ile önbelleğe alma uygula"

→ Uygulamaları karşılaştırın, en iyi yaklaşımı seçin

Kalıp 3: Aşamalı geçiş

Adım 1: "Kullanımdan kaldırılmış API'nin tüm kullanımlarını belirle"
Adım 2: "Yeni API için bağdaştırıcı oluştur"
Adım 3: "A modülünü bağdaştırıcıyı kullanacak şekilde taşı"
Adım 4: "B modülünü taşı..."
...
Adım N: "Bağdaştırıcıyı kaldır, yeni API'yi doğrudan kullan"

Kalıp 4: Önce test yaklaşımıyla özellik geliştirme

1. "Kullanıcı profili düzenleme için kabul testleri yaz"
2. "Profil doğrulaması için birim testleri yaz"
3. "Testleri geçecek şekilde uygula"
4. "Entegrasyon testleri ekle"
5. "Anlaşılırlık için yeniden düzenle"

9) Hangi araç ne zaman kullanılmalı?

Durum	Önerilen Araç
Gerçek zamanlı kodlama, satır içi yardım	GitHub Copilot
Büyük yeniden düzenlemeler, mimari	Claude Code
Tam geliştirme oturumu	Cursor
Kod hakkında hızlı sorular	Herhangi bir sohbet arayüzü
Issue'lardan PR oluşturma	Copilot Workspace
Karmaşık çoklu dosya değişiklikleri	Cursor Agent
API tasarımı, dokümantasyon	Claude Code
Yeni bir kod tabanını öğrenme	Cursor veya Claude Code

10) Etkinliği ölçme

Ajan tabanlı araçları değerlendirmek için şu metrikleri izleyin:

const metrics = {
  // Verimlilik
  suggestionsAccepted: 'sakladığınız önerilerin yüzdesi',
  timeToFeature: 'başlangıçtan birleştirilmiş PR aşamasına kadar geçen saat',
  linesPerHour: 'kod üretim hızı (dikkatli kullanın)',
  
  // Kalite
  bugsIntroduced: 'yapay zekâ tarafından oluşturulan koda kadar izlenen kusurlar',
  testCoverage: 'yapay zekâ tarafından oluşturulan kodun kapsamı',
  reviewChanges: 'yapay zekâ önerilerini ne ölçüde değiştirdiğiniz',
  
  // Maliyet
  apiCosts: 'yapay zekâ araçlarına yapılan aylık harcama',
  creditsUsed: 'tüketilen Cursor kredileri',
  
  // Öğrenme
  newPatternsLearned: 'yapay zekâdan öğrendiğiniz teknikler',
  codebaseUnderstanding: 'yapay zekânın öğrenmenize ne kadar yardımcı olduğu',
}

11) Yaygın hatalar

Ajana aşırı güvenmek

❌ Büyük değişiklikleri incelemeden kabul etmek
❌ Ajanların yıkıcı komutlar çalıştırmasına izin vermek
❌ Yayınlamadan önce kodu anlamamak

✅ Her değişikliği inceleyin
✅ Yayınladığınız şeyi anlayın
✅ Ajanları yerinize geçen araçlar değil, iş arkadaşları olarak kullanın

Bağlam kirliliği

❌ Alakasız bağlam içeren devasa istemler
❌ Birbiriyle ilgisiz görevler arasında bağlamı temizlememek
❌ Oluşturulan dosyaları bağlama dahil etmek

✅ İstemleri odaklı tutun
✅ Belirli @file referansları kullanın
✅ Derleme çıktılarını hariç tutun

İstem belirsizliği

❌ "Daha iyi yap"
❌ "Sorunları düzelt"
❌ "Birkaç test ekle"

✅ "Zaman karmaşıklığını O(n²)'den O(n log n)'ye düşür"
✅ "45. satırdaki null durumunu erken dönüş yaparak ele al"
✅ "Uç durumlar için testler ekle: boş girdi, maksimum uzunluk, unicode"

12) Başlangıç kontrol listesi

## Kurulum Kontrol Listesi

### Claude Code
- [ ] CLI'yi yükleyin: `npm install -g @anthropic/claude-code`
- [ ] Kimlik doğrulaması yapın: `claude login`
- [ ] `.claude/config.json` oluşturun
- [ ] Hassas dosyalar için `.claudeignore` ekleyin

### Cursor
- [ ] cursor.com adresinden indirin
- [ ] VS Code ayarlarını içe aktarın
- [ ] `.cursor/rules/` dizinini yapılandırın
- [ ] Ajan modu için `Cmd+Shift+I` kısayolunu öğrenin

### GitHub Copilot
- [ ] Uzantıyı IDE'nize yükleyin
- [ ] Copilot Chat'i etkinleştirin
- [ ] Issue'lar için Copilot Workspace'i deneyin
- [ ] `.github/copilot-instructions.md` dosyasını yapılandırın

### Tüm Araçlar
- [ ] Yıkıcı işlemler için onay geçitleri ayarlayın
- [ ] Gizli bilgiler için yok sayma dosyaları oluşturun
- [ ] İnceleme iş akışı oluşturun
- [ ] İlk günden itibaren metrikleri izleyin

İlgili içerikler

• Hızlı yüklenen bir web oyunu yayınlayın
• Oyun mantığı için Web Worker'lar
• Game Jam'ler ve Hackathon'lar — Yapay zekâ kod araçları, 48 saatlik bir jam'de yapılabilecekleri değiştiriyor
• Web Oyunu Motorları Karşılaştırması — yapay zekâ destekli iş akışlarıyla iyi çalışan bir motor seçme