Claude Code kurulum rehberi

Claude Code nedir?

Sadece bir sohbet penceresi değil, dosyalarına ve araçlarına erişimi olan, terminalinde koşan Claude. Bir proje klasöründeki dosyaları okur ve yazar, komut çalıştırır ve kendi çıktısını kontrol eder. Bu dosya ve araç erişimi işin tüm özü; dışarıdan ne yapılacağını anlatmak yerine projenin içinde çalışır.

Geçiş, tavsiyeden eyleme doğrudur. Bir sohbet penceresi sana sadece ne yazacağını söyleyebilir; Claude Code ise dosyayı açar, değişikliği yapar, testi koşar ve sonucu okur. Hepsini de yönlendirdiğin dizinin içinde yapar. Akıl yürütmeyi yapan hâlâ aynı modeldir, ama artık projenin bir tarifi üzerinde değil gerçeğin üzerinde çalışır. “Kurulum”un önemli olmasının sebebi tam da budur: kurulum erişimi verir, erişim de işi varsayımsal olmaktan çıkarıp gerçek kılar.

Bir harness yapay zekânın yapabileceğini neden değiştirir?

Çıplak bir sohbet sana tavsiye yazar; bir harness bunu işi yapan bir sisteme çevirir: dosyaları açar, düzenler, komutu çalıştırır ve sonucu doğrular. Model aynıdır ama harness ona eller verir. ‘İşte böyle düzeltirsin’ ile düzeltmenin gerçekten koduna inmesi arasındaki fark budur.

Hafife alınan kısım doğrulamadır. Harness komutu çalıştırıp çıktıyı okuyabildiği için, model sana kendinden emin bir biçimde bozuk tavsiye vermek yerine kendi hatasını yakalayabilir. Düzenler, çalıştırır, hatayı görür, düzeltir. Bu, bir sohbet penceresinin asla kapatamayacağı bir döngüdür; çünkü o, koşan sisteme hiç dokunmaz. Bu kendini kontrol etme döngüsü, elle test etmen gereken bir öneri ile sen bakmadan önce kendini zaten kanıtlamış bir değişiklik arasındaki farktır.

Başlamak için neye ihtiyacın var?

Üç şey: bir Claude hesabı, kurulum ve üzerine yönlendireceğin bir proje klasörü. Önce ayağa kaldırılacak bir sunucu ya da kurulacak bir pipeline yok; bir dizin açar ve çalışmaya başlarsın. Geri kalan her şey, skill’ler ve araç bağlantıları, temel çalıştıktan sonra üstüne biner.

Buradaki dürüst rahatlatma, ne kadar az tören gerektirdiğidir. Önceden hiçbir şey tasarlamazsın; bir klasör açar ve başlarsın, daha güçlü parçalar da gerçekten ihtiyaç duyduğunda sonradan eklenir. Daha ilk gün her konnektörü ve skill’i bağlama dürtüsüne karşı koy. Önce temel döngüyü çalıştır, bir dosya aç, bir değişiklik iste, onun yerine oturmasını izle, gerisini ancak bu çekirdek doğal hissettiren bir hâle gelince ekle. Küçük başlayıp büyüyen bir kurulum, ilk faydalı işten önce her şeyi yapılandırmaya çalışırken tıkanan bir kurulumu geçer.

Skill’ler ve MCP nereye oturur?

Skill, yüklediğin bir disiplindir; modelin belirli bir iş türünde izlediği belgelenmiş bir yöntem. MCP ise gerçek araçlara köprüdür: analitik, reklam platformları, arama, veritabanın. Skill’ler ona bir işi nasıl düşüneceğini söyler; MCP ise tahmin etmek yerine işi yapması için canlı veriyi ve eylemleri verir.

İkisi iki ayrı açığı kapatır ve ciddi işlerin çoğu her ikisine de ihtiyaç duyar. Model verini göremiyorsa, bu bir MCP açığıdır, bir bağlantı sorunu. Veriyi görüyor ama bir uzman gibi değil de bir genelci gibi ele alıyorsa, bu bir skill açığıdır, bir yöntem sorunu. Örneğin bir SEO denetimi, canlı Search Console satırlarını çekmek için bir MCP bağlantısı, onları bir uzmanın yorumladığı gibi yorumlamak için bir skill kullanır. Claude Code, ikisini bir arada tutan harness’tır: eller, yöntem ve canlı veri aynı yerde.

Yöntem ve veri katmanlarını eklemeye hazır olduğunda, katalog çalışan bir kuruluma takabileceğin skill’leri, ajanları ve konnektörleri yaptıkları işe göre düzenlenmiş şekilde listeler. En çok dayanacağın iki parçayı anlamak için, yöntem katmanı için Claude skills nedir ile, canlı veri katmanı için MCP nedir ile başla; çıplak bir kurulumu bir operatöre çeviren iki yarım budur.