Claude Code nedir? Kimler için, ne işe yarar, nasıl başlanır

Claude'u sohbet penceresinden tanıyorsanız fark şurada: sohbette model size metin verir, o metni dosyaya taşıyan, kaydeden ve çalıştıran sizsiniz. Claude Code'da bu işleri araç kendisi yapar; siz ne istediğinizi yazarsınız, o da klasörünüzde iş görür.

Claude Code tam olarak ne?

Anthropic'in belgesi onu tek cümleyle tanımlıyor: kod tabanını okuyan, dosya düzenleyen, komut çalıştıran ve geliştirme araçlarınızla bütünleşen ajan tabanlı bir kodlama aracı.^[1] Adında “kod” geçse de belge daha geniş bir alan çiziyor: komut satırından yapılabilen her işte, örneğin belge yazmakta, dosya aramakta ya da bir konuyu araştırmakta yardım edebileceğini söylüyor.^[2]

İçinde iki parça var. Biri düşünen model, yani Claude. Öbürü modelin eline araç veren ve önüne hangi metnin konacağını yöneten yazılım; belgede bunun adı agentic harness.^[2] Derslerimizde buna düzenek diyoruz. Model “şu dosyayı oku” ya da “şu komutu çalıştır” diye yazar, işi düzenek yapar ve sonucu modele geri verir. Ajan döngüsünün içini Yapay zekâ ajanı nedir? yazısında gerçek kayıtlarla gösterdik.

Belge döngüyü üç evreyle anlatıyor: bağlamı topla, işlemi yap, sonucu doğrula.^[2] Bir soruyu cevaplamak için yalnız okumak yetebilir; bir hatayı düzeltmek için üç evre defalarca döner. Siz de döngünün içindesiniz: istediğiniz an araya girip yön değiştirebilirsiniz.^[2]

Ne işe yarar?

Aracı açtığınız klasör onun çalışma alanıdır. Belgeye göre o klasördeki ve alt klasörlerdeki dosyalara erişir, başka yerdeki dosyalar için izin ister; terminalde sizin çalıştırabildiğiniz her komutu çalıştırabilir.^[2] Belgelerde sayılan işlerden birkaçı:

• Dosya işleri: okumak, düzenlemek, yeni dosya açmak, dosyaları yeniden adlandırıp düzenlemek.^[2]
• Kod işleri: düz Türkçeyle anlattığınız bir özelliği yazmak, hata mesajından yola çıkıp sorunu bulup düzeltmek, test yazıp çalıştırmak.^[1]
• Git: değişiklikleri kaydetmek, kayıt notu yazmak, dal açmak.^[1]
• Dış araçlar: MCP (asistanı takvim, dosya gibi araçlara bağlayan ortak bağlantı biçimi) ile örneğin Google Drive'daki belgeleri okumak.^[1]
• Zamanlanmış işler: belge, bilgisayarınız kapalıyken bulutta çalışan rutinlerden ve masaüstü uygulamasında kendi makinenizde çalışan zamanlanmış görevlerden söz ediyor.^[1]
• İşi bölmek: bir işin parçalarını aynı anda yürüyen alt ajanlara (ana ajanın bir işi verip yalnız sonucunu aldığı ikinci ajan) dağıtmak.^[1]

Yeni başlayanlar için yazılmış terminal rehberindeki örnekler koddan uzak: masaüstündeki ekran görüntülerini içeriklerine göre yeniden adlandırmak, kişisel bir bütçe takibi için neye ihtiyaç olduğunu sormak.^[4] Rehber kod bilmenize gerek olmadığını, ne istediğinizi düz cümlelerle anlatmanın yettiğini yazıyor.^[4]

Kimler için?

Belgenin kendi tarifi bir geliştirici aracı, ama terminal rehberi hiç terminal açmamış biri için yazılmış.^[4] Bizim gördüğümüz ayrım şu: işiniz bir klasördeki dosyalarda duruyorsa ve o işin başında oturuyorsanız bu araç size göredir. Fatura, kira sözleşmesi, okul servisinin yazışmaları gibi düz metin ya da tablo dosyaları da bu kapsama girer.

Kod bilmeden başlayacaksanız sırayı tersten kurmayın. Önce sohbet asistanıyla iyi istem (prompt) yazmayı öğrenin; araca yazdığınız istek de bir istemdir. Hangi sırayla ilerleneceğini yapay zekâ ajanı öğrenme yolu yazısında anlattık. Hiç başlamadıysanız yapay zekâ öğrenmek rehberimiz ilk adımı gösteriyor.

Ücretli mi, hangi plan gerekir?

Evet, ücretli. Claude'un fiyat sayfası Claude Code'un bütün ücretli planlara dahil olduğunu, ücretsiz planda olmadığını yazıyor.^[7] Abonelik yerine Claude Console hesabıyla, önceden yüklenmiş krediyle API üzerinden de giriş yapılabiliyor.^[3]

Planın içindeki kullanım sınırsız değil. Yardım merkezine göre Pro ve Max'te beş saatlik bir oturum sınırı ve haftalık bir sınır var; bu sınırlar Claude ile Claude Code arasında ortak, yani sohbette harcadığınız da aynı paydan düşüyor.^[8] Sınıra gelince sıfırlanmasını beklemek, kullanım kredisini açmak ya da Claude Console'dan API kredisi alıp onunla devam etmek gerekiyor; API kredisi standart API fiyatıyla ücretleniyor.^[8]

Nasıl başlanır?

Türkiye, Anthropic'in hizmet verdiği ülkeler listesinde.^[9] Kurulumu yalnız resmî belgedeki komutla yapın; bir arama sonucundan ya da videonun açıklamasından komut kopyalamayın. Belgedeki yol şu:^[3][4]

1. Terminali açın. macOS'ta Cmd + Boşluk ile Spotlight'ı açıp “Terminal” yazın; Windows'ta Win + X ile PowerShell'i seçin. macOS 13 ya da sonrası, Windows'ta 10 sürüm 1809 ya da sonrası gerekiyor.^[4]
2. Kurulum komutunu yapıştırın. macOS ve Linux'ta curl -fsSL https://claude.ai/install.sh | bash, Windows PowerShell'de irm https://claude.ai/install.ps1 | iex. Komut indirirken ilerleme göstermez; bitince yeni bir pencerede claude --version yazın, bir sürüm numarası görmelisiniz.^[3]
3. Bir klasöre girip başlatın. Örneğin cd faturalar, ardından claude. İlk açılışta tarayıcıda Claude hesabınızla giriş yaparsınız.^[3][4]
4. Önce soru sorun. “Bu klasörde ne var?” gibi bir soruyla başlayın; araç dosyaları gerektikçe kendisi okur.^[3]
5. Çıkmak için exit yazın; çalışan bir işi durdurmak için Esc'e basın.^[4]

Terminal istemiyorsanız masaüstü uygulamasını indirip giriş yaptıktan sonra Code sekmesine geçebilirsiniz; uygulama Claude Code'u içinde taşır, ayrıca kurmanız gerekmez, ama ücretli abonelik ister.^[1] Hiçbir şey kurmadan kullanmak için claude.ai/code adresi tarayıcıda, Anthropic'in bulutunda çalışır.^[1][2]

Bu klasördeki fatura dosyalarının adlarına bak. Her birini “yıl-ay-kurum” biçiminde yeniden adlandırmak için bir plan yaz, ama henüz hiçbir dosyayı değiştirme. Hiçbir dosyayı silme.

Son iki cümle bilerek orada. Plan kipinde araç klasörü okuyup bir plan önerir, kaynak dosyalarınıza dokunmaz; plan doğruysa ikinci adımda uygulatırsınız.^[5] Kipler arasında Shift+Tab ile geçilir.^[5]

Dosyalarıma zarar verir mi?

Verebilir; bu yüzden iki güvenlik düzeni var. Birincisi izin kipi. Manual kipinde araç dosya düzenleyen, komut çalıştıran ya da ağa çıkan işlemlerin çoğundan önce size sorar.^[5] 2.1.283 ve sonraki sürümlerde etkileşimli terminal ve VS Code oturumları ise Auto kipinde başlıyor: bu kipte işlemleri sizin yerinize ayrı bir sınıflandırıcı model denetliyor.^[5] İlk haftanızda Manual'ı seçip neyin sorulduğunu görmek daha öğreticidir. Bütün denetimleri kapatan kip, belgede yalnız yalıtılmış kapsayıcılar ve sanal makineler için öneriliyor.^[5]

İkincisi geri alma. Araç bir dosyayı düzenlemeden önce dosyanın o anki hâlini saklıyor; Esc'e iki kez basarak önceki bir ana dönebiliyorsunuz.^[2] Bu yalnız dosya değişikliklerini kapsıyor: veritabanına, bir siteye ya da dış bir sisteme yapılan işlem geri alınamıyor.^[2] Pro'daki kurulum dersinde ikinci bir sigorta öneriyoruz: aracı asıl klasörünüzde değil, dosyaların kopyasını koyduğunuz ayrı bir klasörde açmak.

Her oturumda aynı kuralları yeniden yazmamak için klasörün köküne CLAUDE.md adlı bir yönerge dosyası (her oturumun başında okunan kalıcı kurallar) koyabilirsiniz; /init komutu sizin için bir başlangıç dosyası çıkarır.^[2][6] Belge bir sınırı da açıkça yazıyor: bu dosya bağlamdır, zorunlu ayar değildir; bir işi kesin engellemek için izin kuralı ya da hook (aracın belirli bir anda kendiliğinden çalıştırdığı küçük betik) gerekir.^[5][6] Talimat, skill ve MCP'nin farkını skill, MCP ve talimat farkı yazısında anlattık.

Derslerde Claude Code nerede geçiyor?

Claude Code'u adıyla gösterdiğimiz yer Max'teki Ajanı söküp bakmak modülü: döngü, araç, düzenek ve dört aracın yan yana karşılaştırması. Orkestrasyon modülü, Claude Code'un alt ajan fikrini kendi yazdığımız betiklerle açıyor: şef ve işçi, görev yazmak, rapor istemek. Pro'daki Kodlama ajanıyla ilk proje ise kurulum ilkelerini, izinleri, plan kipini ve Git ile geri almayı işliyor.