Hangi Agent IDE ile Kod Yazmalı? Cursor, Codex, Claude Code, Copilot ve Antigravity

Daha önce LangGraph ve n8n ile geçirdik. Bir tarafta karar mantığını yöneten graf tabanlı framework, diğer tarafta operasyonel iş akışlarını görünür hale getiren otomasyon aracı. Şimdi AI Stack Rehberi serisinin üçüncü katmanına geçiyoruz: ajan editörleri.

Bu yazıda beş farklı Agent IDE'yi inceliyoruz: Cursor, OpenAI Codex, Claude Code, GitHub Copilot ve Antigravity. Ancak sadece araç karşılaştırması yapmıyoruz. Bu araçları gerçekten verimli kullanan ekiplerin ortak bir pratiği var: workspace yapılandırması. Rules, skills ve workflows dosyalarını proje başında tanımlamak, sonraki yüzlerce interaksiyonun kalitesini belirliyor.

Ajan IDE Nedir, Neden Farklı?

Bir geliştirici olarak şu soruyu sorabiliriz: bu araçlar gerçekten ajan mı, yoksa sadece daha akıllı birer otomatik tamamlama mı?

Geleneksel AI asistanlar, VS Code'daki eklentiler ve ChatGPT tabanlı editör uzantıları tek dosya düzeyinde çalışır. Bir fonksiyonu açıklarsınız, kod üretir, yapıştırırsınız. Dosyalar arası bağlantıyı, mimari değişikliği veya planlı değişiklik setini yönetemezler.

Ajan IDE'ler ise duruma göre birden fazla dosyayı değiştirebilir, görev listesini planlayabilir ve değişiklikleri tutarlı bir şekilde uygulayabilir. Bu fark, küçük bir refactor görevi için fark etmez. Ancak bir özellik ekleme veya mimari yeniden yapılandırma söz konusu olduğunda büyük bir ayrım yaratır.

Bu beş aracın hepsi bu kapasiteye sahip, ama farklı yollarla ve farklı iş akışlarıyla. Hepsinin ortak noktası ise şu: ajan ne kadar iyi tanıyorsa projenizi, o kadar doğru üretiyor. Bu tanıma işlemi de instructions dosyaları ile başlıyor.

Beş Agent IDE, Beş Farklı Yaklaşım

Her aracın güçlü yanı farklı bir karar anına denk düşüyor. Kısa bir bakış:

Cursor — VS Code tabanlı, tanıdık arayüz, hızlı kurulum. Chat, Compose ve Agent modlarıyla çalışır. .cursor/rules/ dizini altında .mdc dosyaları ile proje kurallarını tanımlarsınız. Dosya pattern'ine göre otomatik aktive olan, ajan tarafından ihtiyaca göre seçilen veya her zaman yüklenen kurallar oluşturabilirsiniz. Modüler yapısıyla farklı dosya gruplarına farklı kurallar atayabilirsiniz.

OpenAI Codex — Terminal tabanlı ajan. AGENTS.md dosyasıyla çalışır. Issue-to-PR akışı kurabilir: GitHub Issue açarsınız, ajan plan yapar, birden fazla dosyayı değiştirir ve pull request oluşturur. Global tercihler (~/.codex/AGENTS.md), proje kuralları (AGENTS.md) ve alt dizin override'ları (AGENTS.override.md) ile hiyerarşik yapılandırma sunar. /init komutuyla başlangıç dosyası oluşturabilirsiniz.

Claude Code — Anthropic'in terminal tabanlı ajan IDE'si. CLAUDE.md dosyasıyla çalışır. Diğerlerinden farklı bir özelliği var: Auto Memory. Claude, çalışma sırasında düzeltmelerinizden ve proje pattern'lerinizden otomatik olarak öğrenir ve bunları ~/.claude/projects/ altına kaydeder. /init komutuyla proje analizi yapıp CLAUDE.md üretebilir, /memory ile hafızayı yönetebilirsiniz. Ayrıca .claude/skills/ altında SKILL.md dosyaları ile tekrarlanabilir iş akışları tanımlayabilirsiniz. Claude Desktop üzerinden Cowork sekmesiyle masaüstü arayüzünden de kullanılabilir.

GitHub Copilot — VS Code, JetBrains ve GitHub web arayüzüne entegre. .github/copilot-instructions.md dosyasıyla repo genelinde kurallar tanımlarsınız. Daha granüler kontrol için .github/instructions/*.instructions.md dosyaları oluşturabilir, YAML frontmatter ile applyTo glob pattern'leri belirtebilirsiniz. Agent Mode ile planlı çalışma, Cloud Agent ile doğrudan GitHub'dan ajan çalıştırma ve Copilot CLI ile terminal tabanlı ajan deneyimi sunar. Ayrıca AGENTS.md, CLAUDE.md, GEMINI.md gibi diğer araçların dosyalarıyla da uyumludur.

Antigravity — Google'ın geliştirdiği ajan IDE. GEMINI.md dosyasıyla çalışır. Manager ve Editor olmak üzere iki panel üzerinden işler. Manager panelinde yüksek seviye görev tanımlarsınız, ajan plan oluşturur ve Editor panelinde adım adım kod üretimini gösterir. Global (~/.gemini/GEMINI.md), proje ve JIT (alt dizin taraması) olmak üzere üç katmanlı hiyerarşi sunar. /init ile scaffold oluşturabilir, SKILL.md ile tekrarlanabilir iş akışları tanımlayabilirsiniz.

Instructions Mekanizması: Her IDE'nin Kurallar Dosyası

Bu araçların hepsinde ortak bir konsept var: projenize özel kuralları bir dosyaya yazıyorsunuz ve ajan her oturumda bu kuralları okuyor. Bu dosyanın adı, formatı ve davranışı araçtan araca değişiyor. İşte karşılaştırma:

Cursor burada farklılaşıyor: .mdc dosyaları YAML frontmatter ile aktivasyon modları tanımlayabiliyor. Bir kural her zaman aktif olabilir, belirli dosya pattern'lerine göre otomatik yüklenebilir veya ajanın kendi kararıyla çağrılabilir. Bu modüler yapı, büyük projelerde gereksiz kural yükünü azaltıyor.

Claude Code ise Auto Memory özelliğiyle öne çıkıyor. Manuel olarak CLAUDE.md yazmak yerine, Claude çalışma sırasında projenizdeki pattern'leri keşfedip kendi hafızasına kaydedebiliyor. Bu, "sıfırdan kural yazmak" ile "ajana öğretmek" arasındaki farkı ortaya koyuyor.

GitHub Copilot ekosistem avantajını kullanıyor: aynı repo'daki copilot-instructions.md dosyası tüm ekip üyelerinin IDE'lerinde otomatik yükleniyor. Ayrıca diğer araçların dosyalarıyla da uyumlu çalışabilmesi cross-tool geçişleri kolaylaştırıyor.

Workspace Yapılandırmasının Önemi

Bu noktada bir gerçeği kabul etmeliyiz: ajan IDE'nin gerçek gücü aracın kendisinde değil, ona verdiğiniz bağlamda yatıyor.

Projenizin teknoloji yığınını, mimari kararlarını, test komutlarını ve kodlama standartlarını bilmeyen bir ajan, ne kadar güçlü olursa olsun, genel çıktı üretir. Bu çıktı düzenleme maliyeti, bazen sıfırdan yazma maliyetini aşıyor.

Bir proje başında yapılan 15 dakikalık yapılandırma, sonraki aylardaki her interaksiyonun kalitesini doğrudan etkiler.

Etkili bir instructions dosyası şunları içerir:

• Proje rolü — Ajanın projedeki pozisyonu
• Teknoloji yığını — Framework, dil, paket yöneticisi tercihleri
• Build ve test komutları — npm run lint, pnpm test gibi
• Dokunulmaması gereken alanlar — vendor/, scripts/provision.sh gibi
• Kodlama standartları — İsimlendirme, dosya yapısı, pattern tercihleri
• Mimari kısıtlamalar — "Bu projede REST kullanıyoruz, GraphQL yok" gibi

Bunu bir benzetmeyle açıklayalım: instructions dosyası, bir ekibe yeni katılan geliştiriciye verdiğiniz onboarding belgesidir. Ne kadar iyi hazırlanırsa, geliştirici o kadar hızlı üretken olur.

GitHub'dan Gerçek Örnekler

Bu alanda açık kaynak topluluk çok aktif. İşte kullanabileceğiniz bazı kaynaklar:

Cursor kuralları için: PatrickJS/awesome-cursorrules — Framework (Next.js, React, Angular), dil ve mimari endişeye göre kategorize edilmiş .mdc kural koleksiyonu. Kendi projenize uyarlamak için iyi bir başlangıç noktası.

AGENTS.md şablonları için: tairov/awesome-agents.md — Gerçek projelerde kullanılan AGENTS.md dosyaları, şablonlar ve araçlar. Codex ve diğer AGENTS.md destekleyen araçlar için referans.

Claude Code skills için: alirezarezvani/claude-skills — 500'den fazla skill içeren, platform bağımsız (Claude Code, Codex, Gemini CLI, Cursor) bir skill kütüphanesi. i18n yönetiminden frontend tasarım kurallarına kadar hazır skill dosyaları.

Bu repo'ları doğrudan kopyalamak yerine, kendi projenize uyarlayarak kullanmanızı öneriyoruz. Her proje kendine özgü kısıtlamalar taşır; genel kurallar iyi bir başlangıçtır ama proje bağlamını siz eklemelisiniz.

Sürekli Güncellenen Araçlar

Bu araçların tümü aktif geliştirme altında ve hızla evriliyorlar. Bu, bir aracı "değerlendirip rafa kaldırmak" yerine düzenli olarak takip etmek gerektiği anlamına geliyor:

• Cursor artık sadece chat ve inline edit değil: Agent modu, Background Agents, Cloud Agent, MCP sunucu desteği, Skills ve CLI aracı eklendi. Rules sistemi .cursorrules dosyasından modüler .mdc formatına evrildi.
• Codex başlangıçta sadece bir API'ydi. Şimdi masaüstü platformda çalışan, Issue-to-PR akışı kurabilen tam bir ajan. AGENTS.md standardı cross-tool uyumluluk kazandı.
• Claude Code Auto Memory, SKILL.md sistemi, /init ve /memory komutlarıyla diğerlerinden farklı bir yol izliyor. Claude Desktop'taki Cowork sekmesi ile masaüstü arayüze de taşındı.
• GitHub Copilot agent mode, cloud agent, Copilot CLI, MCP entegrasyonu, hooks, custom agents ve Copilot Memory gibi özelliklerle sürekli genişliyor. OpenAI Codex ve Anthropic Claude'u third-party agent olarak entegre etti.
• Antigravity Manager-Editor ayrımıyla mimari görünürlük sağlıyor. GEMINI.md ve SKILL.md sistemi ile workspace yapılandırması destekliyor.

Bu araçların güncel özelliklerini kendi resmi dokümantasyonlarından takip etmenizi öneriyoruz. Bu yazıdaki bilgiler yayın tarihindeki durumu yansıtıyor.

Karar Çerçevesi: Hangi IDE Benim İçin?

Bu beş aracı bir karşılaştırma tablosunda konumlandırmak mümkün:

Tablodan önce hangi soruyu sorduğumuzu netleştirmeliyiz. "Hangisi en iyi?" diye sorarsak cevap yok; her araç farklı bir karar anına ait. "Benim durumumda hangisi çalışır?" diye sorarsak iş değişir.

• Günlük geliştirme hızı için, küçük ve orta ölçekli ekipler için Cursor uygun bir başlangıç noktası. Öğrenme eğrisi düşük, topluluk desteği yüksek.
• Kod üretimini CI/CD döngüsüne bağlamak, Issue-to-PR akışı kurmak istiyorsanız Codex veya Copilot Cloud Agent güçlü adaylar.
• Ajanın projeden öğrenmesini, skills ve tekrarlanabilir iş akışları oluşturmasını istiyorsanız Claude Code farklı bir deneyim sunuyor.
• Mevcut VS Code veya JetBrains ortamından çıkmak istemiyorsanız ve ekosistem genişliği öncelikliyse Copilot altyapı gerektirmeyen bir seçenek.
• Mimari yeniden yapılandırma, çok dosyalı değişiklik setleri ve plan görünürlüğü öncelikliyse Antigravity Manager-Editor modeli avantajlı.

Şunu da belirtmeliyiz: ajan IDE, ekibinizin teknik kapasitesine bağlı. Ekip kod yazmıyorsa veya CI/CD döngüsü yoksa, ajan IDE'nin üretkenlik kazanımı sınırlı kalır. Araç, ekip zaten teknik olarak yüksek performans gösteriyorsa hız artırır; teknik borç birikiyorsa sadece daha hızlı hata üretir.

W20 ve W21 ile Nasıl Bağlanıyor?

Bu seriyi takip edenler için bağlantı açık: LangGraph karar mantığını yönetir, n8n iş akışlarını otomasyonla kurar, ajan IDE ise kodu üretir. Bunlar farklı karar anları; birbirinin yerine değil, birbirinin üzerine eklenen katmanlar.

Bir ekip n8n ile operasyonel akış kurup LangGraph ile ajan karar mantığını yönetiyorsa, ajan IDE ile kod üretim hızını artırabilir. Üç katman birlikte çalıştığında, bir yazılım ekibinin AI araç ekosistemindeki konumu netleşir.

Yön

Ajan IDE kategorisini derinleştirmek isteyenler için her aracın resmi dokümantasyonu iyi bir başlangıç noktası: Cursor Docs, Claude Code Docs, GitHub Copilot Docs, OpenAI Codex. Hepsi aktif geliştirmede; takip etmeye değer.

SSS

AI Stack Rehberi serisinin bu bölümü. Önceki yazılar: LangGraph, n8n.