Giriş: Xcode'da Yeni Bir Çağ Başlıyor
Apple, Şubat 2026'da Xcode 26.3'ü yayınladığında iOS geliştirme dünyası sessizce ama derinden değişti. Ajan tabanlı kodlama (agentic coding) dedikleri bu özellik, Xcode'u alışık olduğumuz kod editöründen bambaşka bir şeye dönüştürüyor — yapay zeka destekli bir iş birliği platformuna. Anthropic'in Claude Agent'ı ve OpenAI'nin Codex'i artık doğrudan Xcode içinden kullanılabiliyor.
Peki bu gerçekte ne anlama geliyor?
Önceki Xcode sürümlerinde AI desteği, kod yazarken gelen otomatik tamamlama önerilerinden ibaretti. Fena değildi ama devrimsel de sayılmazdı. Xcode 26.3 ile işler tamamen değişti: ajanlar artık bağımsız olarak çalışabiliyor. Projenizi derleyebilir, testlerinizi çalıştırabilir, SwiftUI önizlemelerini görsel olarak kontrol edebilir ve hata bulduğunda kendisi düzeltebilir. Evet, doğru okudunuz.
Bu rehberde, Xcode 26.3'teki ajan tabanlı kodlamayı sıfırdan nasıl kuracağınızı, hangi ajanları kullanabileceğinizi ve günlük iş akışınıza nasıl entegre edeceğinizi adım adım göstereceğim.
Ajan Tabanlı Kodlama Nedir?
Geleneksel AI kodlama asistanlarını bilirsiniz — siz yazarken küçük kod parçacıkları önerir, bazen isabetli olur bazen de tam tutturamaz. Ajan tabanlı kodlama ise tamamen farklı bir paradigma.
Siz hedefinizi doğal dil ile tanımlıyorsunuz, ajan ise bu hedefi gerçekleştirmek için planlama yapıyor, kod yazıyor, derliyor, test ediyor ve hataları düzeltiyor. Tüm bunları otonom olarak. Açıkçası ilk denediğimde biraz tedirgin oldum ama sonuçlar gerçekten etkileyici.
Xcode 26.3'teki ajan tabanlı kodlamanın temel farkları şunlar:
- Otonom çalışma: Ajan, görevi küçük adımlara böler ve her adımı bağımsız olarak tamamlar
- Proje farkındalığı: Projenizin dosya yapısını ve mimarisini anlayarak bağlama uygun kod üretir
- Derleme ve test: Yazdığı kodu Xcode üzerinden derler, testleri çalıştırır ve doğrular
- Görsel doğrulama: SwiftUI önizlemelerinin ekran görüntülerini alarak UI'ın beklentilere uygun olup olmadığını kontrol eder
- Dokümantasyon erişimi: Apple'ın tüm geliştirici dokümantasyonuna ve WWDC video transkriptlerine erişebilir
Desteklenen Yapay Zeka Ajanları
Xcode 26.3, üç farklı şekilde yapay zeka ajanlarıyla çalışmanıza olanak tanıyor. Hadi her birine bakalım.
1. Yerleşik Ajanlar: Claude Agent ve Codex
Apple, Anthropic ve OpenAI ile doğrudan iş birliği yaparak Claude Agent ve Codex'i Xcode'a entegre etmiş. Bu ajanları tek tıkla indirip hemen kullanmaya başlayabilirsiniz — otomatik olarak da güncelleniyor.
- Claude Agent (Anthropic): Karmaşık talimatları anlama, uzun bağlamda tutarlılık ve kod hakkında akıl yürütme konusunda oldukça güçlü
- Codex (OpenAI): Programlama dillerini yorumlama ve hızlı kod üretimi konusunda uzmanlaşmış
2. MCP ile Üçüncü Taraf Ajanlar
Apple'ın burada yaptığı hamle çok akıllıca: Model Context Protocol (MCP) adlı açık standardı destekleyerek herhangi bir uyumlu aracın Xcode ile entegre olmasını sağlıyor. Gemini CLI, Cursor, GitHub Copilot ve MCP destekleyen diğer tüm ajanlar Xcode'a bağlanabiliyor. Kısacası tek bir AI'a mahkum değilsiniz.
3. Ajanlar Arası Geçiş
Aynı projede farklı ajanlar arasında kolayca geçiş yapabilirsiniz. Belirli bir görev için Claude daha uygunsa onu seçip, başka bir görev için Codex'e geçebilirsiniz. Bu esneklik gerçekten kullanışlı.
Adım Adım Kurulum Rehberi
Ön Gereksinimler
Başlamadan önce elinizde şunlar olmalı:
- macOS'un en güncel sürümü
- Xcode 26.3 (App Store veya Apple Developer sitesinden indirilebilir)
- Anthropic veya OpenAI hesabı (API anahtarı için)
- Apple Developer Program üyeliği
Adım 1: Xcode 26.3'ü Yükleyin
Mac App Store'dan veya Apple Developer sitesinden Xcode 26.3'ü indirip yükleyin. İlk açılışta ajan tabanlı kodlama hakkında bir bilgilendirme ekranı göreceksiniz — burayı hızlıca okuyup geçebilirsiniz ama göz atmanızı tavsiye ederim.
Adım 2: Kodlama Zekası Ayarlarını Yapılandırın
Xcode'u açtıktan sonra şu adımları izleyin:
- Xcode → Settings (veya
⌘ + ,) menüsünü açın - Intelligence sekmesine gidin
- Coding Intelligence bölümünde aşağıdaki seçenekleri yapılandırın:
- Internet erişimi: Ajanların internet araçlarını kullanmasına izin verir
- Bash erişimi: Ajanların terminal komutlarını çalıştırmasına izin verir (bu konuda biraz dikkatli olun)
Güvenlik Uyarısı: Bash erişimini yalnızca ne yaptığınızı biliyorsanız etkinleştirin. Bu özellik ajanın sisteminizde komut çalıştırmasına izin verir. Eğer henüz bu konuda deneyiminiz yoksa, bu seçeneği kapalı tutmanız en iyisi.
Adım 3: Ajanı İndirin ve Bağlayın
Intelligence ayarlarında, kullanmak istediğiniz ajanı (Claude Agent veya Codex) tek tıkla indirebilirsiniz. İndirdikten sonra Anthropic veya OpenAI hesabınızla giriş yapın ya da API anahtarınızı girin. Süreç oldukça basit.
Adım 4: Ajan Panelini Açın
Projenizi açtıktan sonra Xcode'un sol üst köşesindeki yıldız simgesine tıklayarak ajan panelini açın. Bu panel üzerinden ajana doğal dil ile komutlar verebilirsiniz. İlk komutunuzu yazmak heyecan verici — itiraf edeyim.
Yerleşik Ajanları Güncelleme
Xcode 26.3, Claude Code ve Codex'in paketlenmiş sürümleriyle geliyor. Ancak bu sürümler her zaman en güncel olmayabiliyor. En son sürümleri kullanmak istiyorsanız sembolik bağlantılar oluşturabilirsiniz:
# Codex'i Homebrew ile yüklediyseniz:
ln -sf $(which codex) ~/Library/Developer/Xcode/CodingAssistant/Agents/Versions/26.3/codex
# Claude Code'u yüklediyseniz:
ln -sf $(which claude) ~/Library/Developer/Xcode/CodingAssistant/Agents/Versions/26.3/claudeBu sayede Xcode her zaman sisteminize kurulu olan en güncel ajan sürümünü kullanır. Küçük bir adım ama farkı hissedeceksiniz.
MCP ile Üçüncü Taraf Ajan Bağlama
Xcode 26.3'ün bence en güçlü yanlarından biri Model Context Protocol (MCP) desteği. Bu açık standart sayesinde Xcode'un 20 yerleşik aracını herhangi bir uyumlu ajana açabilirsiniz.
MCP'yi Etkinleştirme
- Xcode 26.3'ü açın
- Settings → Intelligence bölümüne gidin
- Model Context Protocol altında Xcode Tools seçeneğini On konumuna getirin
Xcode artık gelen MCP bağlantılarını kabul edecek ve harici bir ajan bağlandığında görsel bir gösterge sunacak.
MCP Köprüsünün Mimarisi
Sistemin çalışma prensibini anlamak için şu akışa bakabilirsiniz:
Harici Ajan ↔ MCP Protokolü ↔ mcpbridge ↔ XPC ↔ Xcodemcpbridge, Xcode komut satırı araçlarıyla birlikte gelen bir ikili dosya. MCP protokolü ile Xcode'un dahili XPC iletişim katmanı arasında çevirmen görevi görüyor. Xcode'un bir proje açık durumda çalışıyor olması yeterli — mcpbridge Xcode'u otomatik olarak algılıyor.
Claude Code'u MCP ile Bağlama
claude mcp add --transport stdio xcode -- xcrun mcpbridgeTek satır. Bu kadar basit.
Codex'i MCP ile Bağlama
codex mcp add xcode -- xcrun mcpbridgeGemini CLI'ı MCP ile Bağlama
Google'ın Gemini CLI'ını da MCP üzerinden bağlayabilirsiniz. Bunun için Gemini CLI v0.27.0 veya üstü gerekiyor (bu sürüm Xcode'un MCP yanıt formatını doğru yorumluyor).
Proje kök dizininize giderek yapılandırmayı oluşturun. Bu işlem projenizde bir .gemini/settings.json dosyası oluşturur. Bağlantı kurulduğunda Xcode bir izin diyalogu gösterecek — Allow'a tıklayın ve devam edin.
İpucu: MCP yapılandırmasını global yerine proje bazlı yapmanızı öneririm. Bu sayede Xcode her projede gereksiz izin isteği göndermez ve işler daha düzenli ilerler.
Xcode MCP Araçları: Ajanlar Neler Yapabilir?
Xcode 26.3, MCP üzerinden 20 yerleşik araç sunuyor. Hepsini tek tek anlatmak yerine, en önemli olanlarına odaklanalım.
Dokümantasyon Araması
Bu sıradan bir API araması değil. Apple'ın Squirrel MLX adını verdiği, Apple Silicon için optimize edilmiş MLX tabanlı gömme (embedding) sistemiyle çalışan semantik bir arama motoru. Tüm Apple geliştirici dokümantasyonunu ve iOS 15'ten iOS 26'ya kadar olan WWDC video transkriptlerini tarıyor. Cidden etkileyici bir kapsam.
Proje Yapısı İnceleme
Ajan, projenizin dosya yapısını keşfedebilir, ilgili dosyaları açabilir ve proje ayarlarını inceleyebilir. Bu sayede bağlama uygun, tutarlı kod üretiyor — rastgele kod yapıştırmak yerine projenizin stiline uyum sağlıyor.
Derleme ve Hata Düzeltme
Ajan projeyi doğrudan Xcode üzerinden derleyebiliyor. Derleme hatası oluştuğunda hata günlüklerini okur, hataları düzeltir ve tekrar derler. Bu döngü tüm hatalar giderilene kadar otomatik olarak devam ediyor. İlk seferde çalışmasını izlemek biraz büyüleyici, söylemeliyim.
SwiftUI Önizleme Yakalama
Bence en etkileyici özellik bu: ajan, SwiftUI önizlemelerinizin gerçek ekran görüntülerini alabiliyor. Yani UI'ınızın nasıl göründüğünü görerek tasarım beklentilerinizle karşılaştırıyor ve gerektiğinde düzeltmeler yapıyor. Şu anda başka hiçbir IDE harici ajanlara bu yeteneği sunmuyor.
Test Çalıştırma
Ajan birim testlerinizi çalıştırabilir, sonuçları değerlendirir ve başarısız olan testleri düzeltebilir. Böylece "derledim ama test yazmadım" dönemine elveda diyebilirsiniz (en azından kısmen).
Swift REPL Ortamı
Tam bir derleme döngüsüne girmeden, mantığı doğrulama, API davranışlarını test etme veya hızlı prototipleme için kullanılabilir. Küçük denemeleri hızlıca yapmak için ideal.
Pratik Kullanım: Örnek Bir İş Akışı
Teoriden pratiğe geçelim. Ajan tabanlı kodlamanın gerçek bir senaryoda nasıl çalıştığını göstermek istiyorum. Diyelim ki mevcut bir SwiftUI uygulamasına yeni bir özellik eklemek istiyorsunuz.
1. Hedefinizi Tanımlayın
Ajan panelini açın ve doğal dil ile isteğinizi yazın:
"Bu uygulamaya bir kullanıcı profil sayfası ekle. Sayfada
kullanıcının adı, e-posta adresi ve profil fotoğrafı gösterilsin.
Profil fotoğrafı için AsyncImage kullan ve bir düzenleme butonu ekle."2. Ajan Planını İnceleyin
Ajan isteğinizi küçük adımlara böler ve çalışmaya başlamadan önce planını sunar. Bu aşamada planı onaylayabilir veya değişiklik isteyebilirsiniz. Hemen "onayla" demek yerine planı gözden geçirmenizi tavsiye ederim — bazen gereksiz adımlar ekliyor olabiliyor.
3. Otonom Geliştirme Süreci
Onayınızdan sonra ajan şu adımları otomatik olarak gerçekleştiriyor:
- Mevcut proje yapısını inceler
- İlgili Apple dokümantasyonuna bakar
- Gerekli dosyaları oluşturur ve kodu yazar
- Projeyi derler
- SwiftUI önizlemelerini yakalayarak görsel doğrulama yapar
- Hata varsa düzeltir ve tekrar derler
- Tüm değişikliklerin özetini sunar
Bu süreci ilk izlediğinizde "bunu gerçekten kendi başına mı yapıyor?" diye düşünmeniz normal.
4. Kilometre Taşları ile Güvenlik
Xcode, ajanın yaptığı her değişiklikte otomatik olarak kilometre taşları oluşturuyor. Sonuçtan memnun değilseniz herhangi bir noktaya geri dönebilirsiniz — git işlemlerine bile gerek kalmadan. Bu özellik özellikle deneme aşamasında büyük bir rahatlık sağlıyor.
Skills (Beceriler): Yeniden Kullanılabilir Bilgi
Skills, ajanınızla paylaşabileceğiniz yeniden kullanılabilir bilgi belgeleri. Örneğin projenizde veri akışının nasıl yönetildiğini veya animasyon oluşturma konusundaki best practice'lerinizi bir skill belgesi olarak tanımlayabilirsiniz.
Skills Klasörleri
# Codex skills klasörü
~/Library/Developer/Xcode/CodingAssistant/codex/skills
# Claude Agent skills klasörü
~/Library/Developer/Xcode/CodingAssistant/ClaudeAgentConfig/skillsMevcut skill belgelerinizi bu klasörlere kopyalayabilir veya sembolik bağlantılarla paylaşabilirsiniz:
# Mevcut Codex skilllerini Xcode'un skills klasörüne bağlama
ln -sf ~/.codex/skills/* ~/Library/Developer/Xcode/CodingAssistant/codex/skills/Yapılandırma Dosyaları
Her ajanın kendi yapılandırma dosyası var:
- Codex:
~/Library/Developer/Xcode/CodingAssistant/codex/config.toml - Claude:
~/Library/Developer/Xcode/CodingAssistant/ClaudeAgentConfig/.claude
Bu dosyalar üzerinden özel MCP'ler ekleyebilir veya varsayılan modeli değiştirebilirsiniz.
Maliyet ve Fiyatlandırma
Şeffaf olalım, bu konu önemli:
- Xcode 26.3: Ücretsiz (App Store veya Apple Developer sitesinden indirilebilir)
- Claude Agent kullanımı: Anthropic API ücretine tabi — token kullanımına göre ücretlendiriliyorsunuz
- Codex kullanımı: OpenAI API ücretine tabi — yine token bazlı
- MCP uyumlu diğer araçlar: Her aracın kendi fiyatlandırma modeli var
Apple, her iki şirketle iş birliği yaparak token kullanımını optimize ettiğini ve maliyetleri düşük tutmaya çalıştığını söylüyor. Yine de yoğun kullanımda faturaların artabileceğini göz önünde bulundurun. İlk birkaç hafta kullanımınızı yakından takip etmenizi öneririm.
En İyi Uygulamalar ve İpuçları
1. Prompt'larınızı Odaklı Tutun
Ajana verdiğiniz talimatlar ne kadar net ve odaklı olursa sonuçlar o kadar iyi oluyor. "Uygulamayı iyileştir" gibi geniş kapsamlı istekler yerine, "Profil sayfasındaki AsyncImage yükleme süresini optimize et" gibi spesifik talimatlar verin. Fark gerçekten gece gündüz.
2. Ajanın Önce Plan Yapmasını İsteyin
Apple'ın da önerdiği bir yaklaşım: ajandan kod yazmadan önce planını açıklamasını isteyin. Bu, ajanın daha düşünceli ve tutarlı sonuçlar üretmesini sağlıyor. Kendi deneyimimden söyleyebilirim, bu adımı atlamak genellikle daha fazla düzeltme gerektiriyor.
3. Bash Erişimini Dikkatli Kullanın
Bash erişimi güçlü bir özellik ama güvenlik riskleri de taşıyor. Deneyim kazanana kadar bu seçeneği kapalı tutmanızı veya her komut için onay isteme modunda bırakmanızı öneririm. Temkinli olmakta fayda var.
4. Ajanlar Arasında Geçiş Yapın
Her ajanın güçlü yanları farklı. Claude Agent karmaşık mimari kararlarında daha başarılıyken, Codex hızlı kod üretiminde öne çıkabiliyor. Görevinize göre en uygun ajanı seçmekten çekinmeyin — ikisini de denemek en iyisi.
5. Skills Belgelerini Etkin Kullanın
Projenize özel kodlama standartlarınızı, mimari kararlarınızı ve best practice'lerinizi skill belgeleri olarak tanımlayın. Bu sayede ajan projenizin kurallarına uygun kod üretecektir. Biraz ön hazırlık gerektiriyor ama uzun vadede büyük zaman kazandırıyor.
6. Kilometre Taşlarını Değerlendirin
Ajanın yaptığı her değişikliği hemen kabul etmeyin. Kilometre taşlarını inceleyerek değişikliklerin beklentilerinize uygun olduğunu doğrulayın. Sonuçta ajan güçlü bir araç ama son karar her zaman sizin.
Bilinen Sınırlamalar
Xcode 26.3'teki ajan tabanlı kodlama güçlü bir özellik olsa da henüz mükemmel değil. İşte bilmeniz gereken bazı sınırlamalar:
- Üçüncü taraf MCP uyumluluğu: Bazı MCP istemcileri (örneğin Cursor) Xcode'un yanıt formatıyla tam uyumlu olmayabiliyor. Apple'ın
mcpbridge'i yanıtlarıcontentalanında döndürürken, MCP spesifikasyonustructuredContentalanını da gerektirebiliyor - Kimlik doğrulama akışları: Supabase gibi kimlik doğrulama gerektiren MCP'lerin Xcode'un korumalı ortamında nasıl çalışacağı henüz tam netleşmemiş durumda
- Çoklu kurulum yönetimi: Claude Code, bağımsız Codex ve Xcode Codex olmak üzere üç ayrı kurulumu yönetmek biraz karmaşık olabiliyor
- API maliyetleri: Yoğun kullanım senaryolarında yapay zeka API maliyetleri ciddi tutarlara ulaşabiliyor — bütçenizi göz önünde bulundurun
Sıkça Sorulan Sorular
Xcode 26.3'teki ajan tabanlı kodlama ücretsiz mi?
Xcode 26.3'ün kendisi ücretsiz. Ancak Claude Agent ve Codex gibi yapay zeka ajanlarının kullanımı, ilgili API sağlayıcılarının (Anthropic veya OpenAI) ücretlendirme politikalarına tabi. Token kullanımına göre ücret ödüyorsunuz.
Ajan tabanlı kodlama ile geleneksel AI kod tamamlama arasındaki fark nedir?
Geleneksel AI kod tamamlama, siz yazarken satır satır öneri sunar. Ajan tabanlı kodlama ise çok daha kapsamlı: siz bir hedef belirlersiniz, ajan planlama yapar, kod yazar, derler, test eder ve hataları düzeltir. Aradaki fark, GPS'in yol tarifi vermesi ile şoförün sizi doğrudan götürmesi gibi düşünülebilir.
Hangi yapay zeka ajanını seçmeliyim: Claude mu, Codex mi?
Her iki ajan da güçlü. Claude Agent karmaşık talimatları anlama ve uzun bağlamda tutarlılık konusunda öne çıkarken, Codex hızlı kod üretimi konusunda başarılı. Dürüst olmak gerekirse, ikisini de deneyip projenize en uygun olanı seçmeniz en sağlıklı yaklaşım. Ajanlar arasında geçiş yapmak zaten çok kolay.
MCP nedir ve neden önemlidir?
Model Context Protocol (MCP), yapay zeka ajanlarının IDE araçlarıyla iletişim kurmasını sağlayan açık bir standart. MCP sayesinde yalnızca Claude ve Codex değil, Gemini CLI, Cursor, GitHub Copilot gibi MCP destekleyen herhangi bir araç Xcode'un 20 yerleşik aracına erişebiliyor. Bu da size tercih ettiğiniz ajanı kullanma özgürlüğü veriyor.
Ajan tabanlı kodlama güvenli mi? Kodum üçüncü taraflarla paylaşılır mı?
Ajanlar kullanıldığında kodunuz ilgili yapay zeka sağlayıcısına (Anthropic veya OpenAI) gönderiliyor ve bu sağlayıcıların veri gizliliği politikaları geçerli oluyor. Apple, Xcode'da otomatik kilometre taşları oluşturarak istenmeyen değişiklikleri kolayca geri almanızı sağlıyor. Bash erişimi gibi hassas izinleri dikkatli yönetmeniz önemli — bu konuda fazla vurgu yapıyorum ama gerçekten kritik bir nokta.