Tam Laravel + Claude Kod Ekosistemi: Gerçekten İhtiyacınız Olan Her Araç, Eklenti ve Konfigürasyon

Orijinal makale hafiz.dev adresinde yayınlanmıştır.

Artık 9,000’den fazla Claude Code eklentisi bulunuyor. Laravel’in resmi belgelerinde tamamen “AI” bölümü var. Taylor Otwell, resmi bir Claude Code eklenti marketplace’i yayınladı. Ve muhtemelen hala, üç ay önce Reddit’ten kopyaladığınız yarım yazılmış bir CLAUDE.md dosyasıyla çalışıyorsunuz.

Kendinizi kötü hissetmeyin. Ekosistem o kadar hızlı genişledi ki, günlük kullanıcılar bile tüm parçaları takip edemiyor. Bu yazı, en azından neyin var olduğunu, hepsinin nasıl bağlandığını ve gerçekte neye ihtiyacınız olduğunu belirten bir harita niteliğindedir.

The Ecosystem at a Glance

Ayrıntılara geçmeden önce, genel bir bakış sunalım. Beş katman, her biri farklı bir sorunu çözmektedir:

1. Layer 1: Laravel Boost AI ajanın, belirli uygulamanıza gözler açar.
2. Layer 2: CLAUDE.md ve .claude/ ajanınıza projenizin kurallarını ve kalıplarını öğretir.
3. Layer 3: Resmi eklentiler özel Laravel ajansları sunar.
4. Layer 4: Topluluk eklentileri tüm düzenekleri genişleterek, savaşta test edilmiş beceriler ve iş akışları ekler.
5. Layer 5: MCP sunucuları Claude Code’u harici araçlarla bağlar.

Her katman isteğe bağlıdır. Ancak, daha fazla katman ekledikçe, Claude projenizi daha iyi anlar.

Layer 1: Laravel Boost (The Foundation)

Hiçbir şey kurmazsanız, sadece Boost‘unuzu kurmalısınız. Bu, Claude Code iş akışınızı geliştirebileceğiniz en büyük yükseltmedir.

Boost, Laravel’e entegre edilmiş bir MCP sunucusudur ve AI ajanslarına uygulamanızın iç yapısına doğrudan erişim sunar. 15’ten fazla özel araç ve 17,000’den fazla Laravel’e özgü bilgi içeren bir dokümantasyon API’si ile birlikte gelir. Bu son parça önemlidir. Claude, sizin belirli Laravel sürümünüzde belongsToMany‘ın nasıl çalıştığını sorgularken, eski eğitim verilerinden yola çıkmaz. Boost’un API’sini sorgulayarak doğru, sürüme özel sonuçlar alır.

Installation

composer require laravel/boost --dev
php artisan boost:install

Kurucu, IDE’nizi otomatik olarak algılar ve doğru yapılandırma dosyalarını üretir. Özellikle Claude Code için proje kökünde bir .mcp.json oluşturur ve projenizin gelenekleri ile bir CLAUDE.md üretir. Aynı zamanda Cursor, Codex, Gemini CLI, GitHub Copilot ve Junie’yi de destekler.

Boost, PHP 8.1 veya daha yüksek sürümde çalışan Laravel 10, 11 ve 12 ile uyumlu çalışır. Dolayısıyla, daha eski bir projeyi sürdürseniz bile avantajlarından yararlanabilirsiniz.

What Boost Actually Gives You

Boost yüklendikten sonra, Claude veritabanı şemanızı inceleyebilir, yollarınızı ve middleware’i sorgulayabilir, artisan komutlarını çalıştırabilir, yüklü paketleri ve PHP sürümünü kontrol edebilir ve 17,000’den fazla sürüme özel Laravel dokümantasyonu arayabilir. Projeyi yapılandırmanızı manuel olarak açıklamak yerine, Claude doğrudan onu okuyabilir. Laravel’in AI SDK’sı ile AI destekli özellikler oluşturuyorsanız, Boost’un dokümantasyon araması daha da değerli hale gelir çünkü tam paket sürümlerinizi bilir. Bu, tipik bir oturumda gereksiz iletişimi yarı yarıya azaltır.

Boost’s Three Pillars: Guidelines, Skills, and Tools

Boost sadece bir MCP sunucusu değil; aynı zamanda üç kategori bağlam sunar:

• AI Guidelines önceden yüklenen, bileşen dosyalarıdır. Ajana, Laravel ekosistem paketleri için temel standart ve en iyi uygulamaları sağlar. Onları “her zaman açık” bir bağlam olarak düşünebilirsiniz. Boost, Laravel çekirdek, Livewire, Filament, Inertia ve daha fazlası için yönergeler içerir ve sürüm bilgisine sahiptir.
• Skills, belirli görevler üzerinde çalıştığınızda talep üzerine aktifleşir. Bir Livewire bileşeni oluşturmanız gerekiyorsa, Livewire becerisi yüklenir ve bu alana dair detaylı kalıplar sunar. Beceriler, yalnızca geçerli olduğunda yüklendiği için bağlam karmaşasını azaltır.
• MCP Tools ise çalışma zamanında kullanılan yeteneklerdir: veritabanı sorguları, yol denetimi, artisan komutları, doküman arama gibi. Bunlar, işlem sırasında ajanın çağrısında bulunduğu unsurlardır.

boost:install komutunu çalıştırdığınızda, composer.json dosyanızı algılayarak yığınınız için uygun yönergeleri ve becerileri otomatik olarak yükler. Livewire ve Pest kullanıyorsanız, otomatik olarak Livewire geliştirme yönergeleri ve Pest test becerileri elde edersiniz.

Custom Guidelines and Skills

Boost’u, proje özel bağlamlarınızla genişletmeniz mümkündür. Özel yönergeler .ai/guidelines/ dizinine, özel beceriler ise .ai/skills/{skill-name}/SKILL.md dizinine yerleştirilir. boost:update çalıştırdığınızda, özelleştirmeleriniz yerleşik olanlarla birlikte yüklenir.

Layer 2: CLAUDE.md and the .claude/ Directory

Burada Claude’ya projenizin kişiliğini öğretirsiniz. Boost, ona Laravel bilgisi verir. Bu katman ona sizin bilginizi kazandırır.

CLAUDE.md: Your Project’s README for AI

CLAUDE.md dosyası projenizin kökünde bulunur. Claude Code’un bir oturuma başladığında okuduğu ilk şeydir. Onu insanlar için değil, bir AI ajanı için yazılmış bir README olarak düşünün.

İyi bir CLAUDE.md dosyası aşağıdakileri içerir:

# Proje Adı

## Mimari
- Laravel 12 + Livewire 3 ile Filament admin
- İş mantığı için hizmet/eylem kalıbı
- Kontrolcüler ince, modeller kalın kalmalı

## Gelenekler
- Form İstekleri aracılığıyla doğrulama
- Testler Pest kullanıyor, PHPUnit değil
- Her commit öncesinde Pint
- API yanıtları her zaman API Kaynaklarını kullanmalı

## Yapmaktan Kaçının
- config dosyaları dışındaki env() kullanımı yok
- Mutlaka gerekli olmadıkça ham SQL yok
- Küresel yardımcılar yok

Kısa tutun. CLAUDE.md dosyasındaki her kelime bağlam penceresi alanı için rekabet eder. Uzun paragraflar yazıyorsanız, yanlış yapıyorsunuz demektir.

Pro ipucu: Boost, boost:install sırasında sizin için başlangıç düzeyinde bir CLAUDE.md üretir. Bununla başlayın ve özelleştirin. Sıfırdan yazmayın.

The .claude/ Directory: Automation and Reusable Behavior

CLAUDE.md, insan tarafından okunabilir proje anımsamasına sahiptir. .claude/ dizini ise otomasyonu tutar. İşte standart yapı:

.claude/
├── settings.json      # İzinler ve araç erişimi
├── hooks/             # Olaylarda çalışan betikler
│   └── session-start.sh
├── commands/          # Slash komutları (örneğin /test, /lint)
│   ├── test.md
│   └── lint.md
├── rules/             # Detaylı kodlama standartları
│   ├── php-standards.md
│   └── testing.md
└── skills/            # Özel Claude Code becerileri
    └── my-project/
        └── SKILL.md

Settings.json Claude’un ne yapabileceğini belirler. İlk aşamada kısıtlayıcı başlayın ve gerektiği kadar gevşetin.

Hooks olaylar sırasında otomatik olarak çalışır. Bazı geliştiriciler, $fillable gibi yaygın hataları yakalamak için edit sonrası kancalar kullanır. Projeniz Docker’da çalışıyorsa, kancalar otomatik olarak artisan komutlarını konteynır üzerinden yönlendirebilir.

Commands, /test veya /lint gibi tekrar eden görevleri kaydeder. Kendi komutlarınızı her oturumda tekrar yazmaktan kaçınırsınız.

Rules, CLAUDE.md’ye @rules/ ithalatları aracılığıyla çekilen detaylı kodlama standartlarıdır. Bu, CLAUDE.md’yi ince tutarken standartlarınızı, bakım için ayrı dosyalarda saklar.

The Key Insight: CLAUDE.md vs .claude/ vs .ai/

Üç dizin AI ile ilgili yapılandırmaları içerir ve farklı amaçlara hizmet eder:

• CLAUDE.md + .claude/ Claude Code’un yerel sistemidir. Çerçeveden bağımsız çalışır. Proje anı, kancalar, komutlar ve beceriler burada yer alır.
• Boost’un .ai/ dizini Laravel’e özel. Burada özel yönergeler ve beceriler bulunur. Bunlar, boost:update ile Boost’un yerleşikleriyle birleşir.

Genel kural: proje düzeyindeki kararlar CLAUDE.md’de, Laravel kodlama kalıpları .ai/ dizininde, otomasyon ise .claude/ dizininde bulunmalıdır. Tüm üretilen dosyaları .gitignore dosyasına ekleyebilirsiniz; çünkü boost:install bunları yeniden üretir. Versiyonlar arasındaki değişiklikleri karşılaştırmak için bir diff checker kullanmak iyi bir fikir olacaktır.

Layer 3: Official Laravel Plugins

Ocak 2026’da Taylor Otwell önemli bir şey yaptı. Anthropic’ın kod sadeleştirici ajansını Laravel’e port etti ve Claude Code için ilk resmi Laravel eklenti marketplace’ini oluşturdu.

The laravel-simplifier Plugin

Kurulum iki komutla gerçekleştirilir:

/plugin marketplace add laravel/claude-code
/plugin install laravel-simplifier@laravel

Sadeleştirici, davranış bozulmadan kod temizliği yapma yeteneğine sahiptir. Claude özellikler eklerken yoğun bir kodlama seansı sonrasında çalıştığınızda, bu eklentiyi çalıştırarak her şeyi temizler: iç içe geçmiş yapıları azaltır, hata ayıklama sırasında hayatta kalan geçici değişkenleri kaldırır, kodu Laravel standartlarına göre hizalar ve koşulları sadeleştirir. İşlevselliği asla değiştirmez, sadece okunabilirliğini iyileştirir.

Bu iş akışı, herhangi bir oturumun sonunda doğal olarak oturur: özelliği oluştur, testleri çalıştır, son değişiklikler üzerinde Claude’nun sadeleştiriciyi kullanmasını iste ve sonra commit et. Her seferde temiz difflere sahip olursunuz.

Layer 4: Community Plugins and Configs

Burada ilginç bir hal alıyor. Topluluk, resmi ekosistemden daha hızlı bir şekilde inşa ediyor ve bu projelerin bazıları gerçek uygulamalarla test edilmiştir.

superpowers-laravel

JP Caparas tarafından oluşturulan superpowers-laravel, Laravel geliştirme için tam bir Claude Code eklentisidir. Fikir üretimi, planlama ve TDD için slash komutları getirir, ancak asıl değer, otomatik olarak etkinleşen becerilerde bulunur. Özellik üzerinde mi çalışıyorsunuz? TDD becerisi devreye girer. Hata ayıklıyorsunuz? Sistematik hata ayıklama becerisi yüklenir. Gönderim yapmaya hazır mısınız? Doğrulamalar çalışır.

/plugin marketplace add jpcaparas/superpowers-laravel
/plugin install superpowers-laravel@superpowers-laravel-marketplace

everything-claude-code

Affaan Mustafa (bir Anthropic hackathon kazananı) tarafından oluşturulan everything-claude-code, Laravel’in ötesine geçen kapsamlı bir yapılandırma koleksiyonudur. Planlama, mimari, TDD, kod incelemesi ve güvenlik analizi için özel ajanslar içerir. Ayrıca, güvenlik tarayıcısı olan AgentShield’i içerir ve Claude Code konfigürasyonunuzu zafiyetler için denetler. Öne çıkan özellik, Claude’un zamanla kendine güven puanları oluşturmasını ve kodlama kalıplarınıza yaklaşımını geliştirmesini sağlayan içgüdüsel tabanlı sürekli öğrenme sistemidir.

laravel-claude-code-setup

tek komutla yükleyici ile Claude Code’unuzu GitHub entegrasyonu, Context7, Figma, veritabanı araçları ve daha fazlasıyla yapılandırır. Sıfırdan tamamen yapılandırmaya en hızlı yol.

When to Use What

Öncelikle Boost ile başlayın. Bu resmi, Laravel ekibi tarafından bakımı yapılan, ihtiyacınız olanların %80’ini veren bir araçtır.

Laravel-simplifier’ı ekleyin temizleme işlemleri için. Küçük, odaklanmış, önemli bir eklentidir.

İş akışınıza göre BİR topluluk eklentisi seçin. Laravel’e özel beceriler için superpowers-laravel’ı, daha geniş araçlar ile güvenlik tarayıcısı için everything-claude-code’ı tercih edin. İkisini birden yüklemeyin. Çakışabilir ve eklenti birikimi, bağlam penceresini şişirir.

Layer 5: MCP Servers Beyond Boost

Boost, Laravel’e özgü araçların yönetimini mükemmel şekilde yapar. Ama gerçek projeler, çerçeve bilgisinden daha fazlasına ihtiyaç duyar. MCP sunucuları bu açıkları kapatır.

Context7: Live Documentation Access

Context7, Claude’a Laravel ekosisteminin dışındaki paketler için güncel dokümanlara erişim sağlar. MCP sunucularını Laravel Boost hakkında detaylı yazımda anlattım, bu yüzden burada tekrarlamayacağım.

MCP Tool Search: The Feature Nobody Talks About

Yüklediğiniz her MCP sunucusu, Claude’un bağlam penceresine araç tanımları ekler. On sunucu yüklediğinizde, Claude işe başlamadan önce binlerce token harcamanız muhtemeldir. MCP Tool Search, bunu tembel yükleme ile düzeltir ve bağlam kullanımını %95’e kadar azaltabilir. Claude, her şeyi önceden yüklemek yerine talebe göre araçları keşfeder. Bu, birden fazla MCP sunucusunun pratik olarak çalıştırılmasını sağlar.

Essential MCP Servers for Laravel Projects

Boost dışında değerlendirmeniz gereken MCP sunucuları: GitHub MCP PR yönetimi ve kod inceleme iş akışları için (özellikle geliştirici odaklı AI kullanıyorsanız kritik), Browser DevTools MCP ön uç hata ayıklama için (özellikle Livewire veya Inertia ile), ve Context7 üçüncü taraf paketlerinin canlı dokümanı için.

The “What Goes Where” Decision Framework

Bu, her katmanı yapılandırmadan önce bilmek istediğim bir şeydi. Hangi bilgilerin hangi katmanda yer alması gerektiğine dair net bir çerçeve:

CLAUDE.md’de:

• Proje mimarisi özeti (50 satırın altındaki bir içerik)
• İsimlendirme gelenekleri ve kalıplar
• Kaçınılması gerekenler (projenize özgü anti-kalıplar)
• .claude/rules/ için detaylı standartlar referansları

.claude/ dizininde:

• izinler için settings.json
• Otomasyon için Kancalar (Kaydetme sırasında Pint, Docker yönlendirmesi, hata tespiti)
• Tekrar eden görevler için Slash komutları
• Detaylı kodlama standartları için Kurallar dosyaları

.ai/ dizininde (Boost):

• Özel Laravel yönergeleri
• Projenizin alanına özgü özel beceriler
• Yerleşik Boost becerilerinin geçersiz kılınması

.mcp.json’de:

• Boost MCP sunucu konfigürasyonu
• Ek MCP sunucuları (Context7, GitHub vb.)

eklentilerde:

• temizlik için laravel-simplifier
• İş akışınızın gereksinim duyduğu bir topluluk eklentisi

Getting Started: Three Paths

Herkes her katmana ihtiyaç duymayabilir. Nerede olduğuna bağlı olarak önerilerim:

Path 1: Quick Start (15 minutes)

Claude Code’unuzun Laravel projenizle daha iyi çalışmasını istiyorsanız, bunu yapın:

# Boost'u yükleyin
composer require laravel/boost --dev
php artisan boost:install

# Sadeleştiriciyi yükleyin
/plugin marketplace add laravel/claude-code
/plugin install laravel-simplifier@laravel

Oluşturulan CLAUDE.md dosyasını projenizin gelenekleri ile düzenleyin. Bitti. Bu, 15 dakikalık çalışma ile değerlerin %80’ine ulaşmanızı sağlar.

Path 2: Production Setup (1-2 hours)

Gerçek bir ürün üzerinde çalışıyorsanız ve Claude’un ekip kalıplarınıza uymasını istiyorsanız, önce Path 1’i yapın, ardından: alanınıza özel becerileri .ai/skills/ dizininde oluşturun, otomatik biçimlendirme ve hata tespiti için kancaları ekleyin, yaygın görevler için slash komutlarını ayarlayın, üçüncü taraf belgeleri için Context7 MCP’yi ekleyin ve settings.json dosyanızı uygun izinlerle yapılandırın.

Path 3: Full Ecosystem (Half a day)

Bir ekip lideri olarak tüm ekibiniz için Claude Code’u kuruyorsanız, Path 2’deki her şeyi yapın, ayrıca bir topluluk eklentisi yükleyin (superpowers-laravel veya everything-claude-code), PR iş akışları için GitHub MCP’yi ekleyin, AgentShield güvenlik taramasını ayarlayın ve yapılandırmanızı bir ekip README’sinde belgeleyin. Herkesin aynı standartlarla çalışmasını sağlamak için .claude/ dizinini paylaşın.

Önemli olan, bir yerden başlamak. Yalnızca Boost bile boş Claude Code’dan büyük bir gelişimdir. Diğer tüm öğeler ise kademelidir.

FAQ

Boost’u yalnızca Laravel 10 veya 11 ile mi kullanabilirim, yoksa 12 ile mi?

Boost, PHP 8.1+ ile Laravel 10, 11 ve 12 ile çalışır. En son sürümde olmanıza gerek yok.

Özellikle Claude Code’u mu kullanmalıyım yoksa Cursor ile de mi çalışır?

Boost, birden fazla ajansı destekler: Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot ve Junie. Eklenti katmanı (laravel-simplifier, superpowers-laravel) Claude Code’a özgüdür.

Tüm bu eklentiler ve MCP sunucuları Claude’u yavaşlatmaz mı?

Bunu yapabilirler. MCP Tool Search (tembel yükleme) bu sorunu büyük ölçüde düzeltir; böylece yalnızca ihtiyaç olduğunda araç tanımlarını yükler. Tavsiyem: minimal ile başlayın ve gerçekten bir sınıra çarptığınızda ekleyin. İlk günden 15 MCP sunucusu yüklemeyin.

CLAUDE.md ve .mcp.json dosyalarını git’e eklemeli miyim?

Bu, ekibinize bağlıdır. Boost’un belgeleri bunları .gitignore dosyasına eklemeyi önerir; çünkü boost:install tarafından yeniden üretilir. Ama ekip tutarlılığı istiyorsa, bunları (duyarlı tokenlar hariç) eklemek mantıklıdır.

Bir Claude Code becerisi ile bir Boost becerisi arasındaki fark nedir?

Claude Code becerileri .claude/skills/ dizininde (Claude Code’un yerel sistemi). Boost becerileri ise .ai/skills/ dizininde (Laravel Boost’un yönettiği). Aynı amaca hizmet eder, ancak farklı sistemlerdir. Boost kullanıyorsanız, .ai/skills/ dizinini tercih edin, böylece boost:update her şeyi senkronize tutar.

Wrapping Up

Laravel + Claude Code ekosistemi, şu anda herhangi bir web çerçevesi için en kapsamlı AI destekli geliştirme kurulumudur. Laravel’in standartları, AI ajanslarına yapısal bir avantaj verir ve Boost, eklentiler ve MCP sunucuları bu avantajı gerçek verimlilik kazançlarına dönüştürür.

Boost ile başlayın. Sadeleştiriciyi ekleyin. CLAUDE.md dosyanızı özelleştirin. Artık o kopyala-yapıştır konfigürasyonunu kullanmayın.