← Blog'a dön
Claude Code 6 Nisan 2026

Claude Code Nedir? Kurulum, Kullanım ve AI Ajan Rehberi (2026)

Kod bilmeye gerek yok! Claude Code ile yapay zeka destekli yazılım ve AI ajan kurma rehberi. Adım adım kurulum, VS Code, gerçek proje örnekleri ve otomasyon.

Kod bilmeye gerek yok. Claude Code’a Türkçe konuşarak ne istediğini söylüyorsun, kodu o yazıyor. Bu rehberde gördüğün her kod ekranını Claude yazdı - sen sadece yönlendirdin.

Claude Code, Anthropic tarafından geliştirilen bir yapay zeka asistanı. Onu diğer araçlardan ayıran şey, sadece kod yazması değil - tüm bilgisayarını kullanabilmesi.

Dosya okur, dosya yazar, terminal komutları çalıştırır, Git ile çalışır, API’lere istek atar, test koşturur. Sen sadece ne istediğini söyle, gerisini o halleder.

Bu rehberde Claude Code’un ne olduğunu, nasıl kurulacağını, yazılım projesi ve AI ajanları nasıl oluşturulacağını adım adım göstereceğim.

Claude Code ile Diğer AI Araçları Arasındaki Fark

Piyasada birçok AI kodlama aracı var. Hepsi farklı seviyelerde çalışır:

  • GitHub Copilot - Satır satır kod tamamlar. Yazarken yardımcı olur ama “projeyi kur” diyemezsin.
  • ChatGPT - Kod üretir ama kopyala-yapıştır. Dosyalarını görmez, projeni bilmez.
  • Cursor - Akıllı editör. İyi ama kendi ekosistemi var, terminal erişimleri sınırlı.
  • Claude Code - Tüm sisteme erişir. Dosya yaratır, komut çalıştırır, proje yönetir. Gerçek bir asistan.

Diğer araçlar “kod yaz” der, Claude Code “proje kur” der. Fikir aşamasından çalışan ürüne kadar tek başına götürür.

Claude Code Kimler İçin?

  • Yazılımcılar - Hızlı prototipleme, refactoring, test yazma, debug. 10x verimlilik artışı.
  • Girişimciler - Teknik ekip olmadan MVP oluşturma. Fikri ürüne çevirme.
  • İçerik Üreticileri - Otomasyon, veri analizi, içerik planlama ajanları kurma.
  • Öğrenciler - Kodlamayı yaparak öğrenme. Gerçek projelerle pratik.
  • Herkes - Teknik bilgi gerekmiyor. Türkçe konuşarak kod yazabilirsin.

Claude Code Nasıl Kurulur? (Adım Adım)

Claude Code’u kullanmak için iki şey lazım: VS Code ve Claude hesabı (en az Pro plan).

Adım 1: VS Code’u İndir

code.visualstudio.com adresinden ücretsiz indir. Windows, Mac ve Linux için mevcut. Zaten yüklüyse bu adımı atla.

Adım 2: Claude Code Eklentisini Yükle

VS Code’u aç, sol taraftaki Extensions (eklentiler) ikonuna tıkla. Arama kutusuna “Claude Code” yaz. Anthropic’in resmi eklentisini bul ve Install butonuna bas.

Adım 3: Hesabını Bağla (Authorize)

Eklenti yüklendikten sonra Claude Code paneli açılır. “Subscribe” veya “Sign in” butonuna tıkla. Tarayıcıda Anthropic sayfası açılacak - burada “Authorize” butonuna basarak VS Code’u hesabınla bağla.

Henüz Claude hesabın yoksa önce claude.ai adresinden ücretsiz hesap oluştur, sonra bu adıma dön.

Adım 4: Doğru Planı Seç

Claude Code’u kullanmak için en az Pro plan gerekiyor. Ücretsiz planda çalışmaz.

PlanFiyatClaude Code
Free$0Yok
Pro$20/ayVar - başlangıç için yeterli
Max$100/ayTavsiyem - 5x kullanım, Opus modeli

Pro ile başla, alış. Günlük limitine takılmaya başlarsan Max’e geç. Bir freelancer veya girişimci için Max planın maliyeti, kazandırdığı zamanla birkaç günde amorti olur.

Adım 5: İlk Mesajını Yaz

Her şey hazır! VS Code’da Claude Code panelini aç (Ctrl+L veya Cmd+L) ve ilk mesajını yaz. Türkçe konuşabilirsin.

İlk Komutlar ve Prompt Örnekleri

Claude Code açtıktan sonra doğal dilde konuşarak çalışırsın. İşte başlangıç için örnekler:

  • Projeyi anlamak için: “Bu klasördeki dosyaları incele ve projenin ne yaptığını özetle”
  • Sıfırdan proje: “React ile basit bir todo uygulaması oluştur”
  • Debug için: “Bu kodda neden hata alıyor olabilirim? Fix et.”
  • Test için: “Testleri çalıştır ve başarısız olanları düzelt”

Etkili Prompt Yazma İpuçları

Claude Code’dan maksimum verim almak için prompt yazma şeklin çok önemli:

1. Net ol, belirsiz olma

Zayıf: “Bir web sitesi yap”

Güçlü: “Next.js ile tek sayfalık bir landing page yap. Koyu tema, hero section, 3 özellik kartı ve bir CTA butonu olsun.”

2. Bağlam ver

Claude Code proje klasöründekileri otomatik görür. Ama ekstra bağlam verirsen daha iyi sonuç alırsın: “Bu bir e-ticaret sitesi, müşteriler 25-35 yaş arası”

3. Adım adım iste

Büyük bir şey istiyorsan parçala. Önce iskelet, sonra detay. Claude Code her adımda sana ne yaptığını gösterir, onay alır, devam eder.

CLAUDE.md Dosyası ile Kalıcı Kurallar

CLAUDE.md dosyası oluşturarak projenin kurallarını, stilini ve tercihlerini kalıcı hale getirebilirsin. Claude Code her seferinde bu dosyayı okur ve ona göre davranır. Proje bazlı hafıza gibi düşün.

Yazılım Projesi: Sıfırdan Landing Page

Şimdi gerçek bir proje yapalım. Bir SaaS ürününün landing page’ini sıfırdan oluşturacağız.

Bu bölümde kod ekranları göreceksin - ama hiçbirini sen yazmıyorsun. Hepsini Claude yazıyor. Sen sadece Türkçe olarak ne istediğini söylüyorsun.

Projeyi Başlat

mkdir saas-landing && cd saas-landing
claude

Sonra Claude Code’a söyle:

“Next.js ile modern bir SaaS landing page oluştur. Koyu tema, hero bölümüyle başlasın. Başlık: ‘İşini Yapay Zeka ile Büyüt’. Altında açıklama ve CTA butonu olsun. Türkçe yaz.”

Tek bir prompt ile Claude Code şunları yapar:

  • Next.js projesi oluşturur (TypeScript, Tailwind CSS dahil)
  • 5 dosya yazar - layout, sayfa, 3 bileşen
  • Koyu tema, gradient arkaplan, animasyonlar ekler
  • Geliştirme sunucusunu başlatır

İterasyon ile Geliştir

Landing page’i gördün ama birkaç şey değiştirmek istiyorsun? Devam et:

  • “Hero’daki başlık fontunu büyüt ve gradient yap. CTA butonuna hover animasyonu ekle.”
  • “Mobilde iyi görünmüyor, responsive yap.”
  • “Sayfayı Vercel’e deploy et.”

Her değişiklik için Claude Code ilgili dosyaları bulur, düzenler ve sonucu gösterir. Sen sadece geri bildirim verirsin.

Claude Code her dosya değişikliği için senden onay ister. Neyi neden değiştirdiğini gösterir. Kontrolün her zaman sende.

AI Ajanları: Claude Code’un Asıl Gücü

Bir web sitesi yapmak güzel. Ama ya Claude Code’a “her gün sabah 9’da Instagram için içerik planı çıkar” deseydin? Ya da “yeni gelen her müşteriyi ara ve nitelendirmeyi yap”?

İşte AI ajanları tam olarak bu. Belirli bir görevi otonom olarak yapan, kurallara göre çalışan, sonuçları raporlayan dijital çalışanlar.

AI Ajanı Nasıl Kurulur?

Bir AI ajanı üç parçadan oluşur:

  1. AGENT.md - Ajanın rolü, sorumluluk alanı, çalışma kuralları
  2. skills/ - Her beceri ayrı bir dosya: araştırma, planlama, yazma, yükleme
  3. outputs/ - Ajanın çıkardığı her şey: planlar, raporlar, analizler
agents/instagram/
├── AGENT.md              # Rol ve kurallar
├── skills/
│   ├── OUTLIER_RESEARCH.md  # Rakip analizi
│   ├── CONTENT_PLAN.md      # Haftalık plan
│   ├── CAPTION_WRITER.md    # Metin yazma
│   └── UPLOAD.md            # Otomatik paylaşım
├── config/
│   └── competitors.txt      # Takip edilen hesaplar
└── outputs/
    └── daily/               # Günlük çıktılar

Her ajan bir klasör. İçinde AGENT.md, skills/ klasörü ve outputs/ klasörü var. Bu kadar. Karmaşık framework yok, veritabanı yok, Docker yok. Sadece dosyalar.

Aşağıdaki dosyaları da sen yazmak zorunda değilsin. Claude’a “bana bir Instagram ajanı kur” de, bu dosyaları o oluşturur.

AGENT.md Nasıl Yazılır?

# Instagram Ajanı

Sen bir Instagram içerik strateji uzmanısın.
Görev alanın:
- Rakip hesapları analiz et, outlier içerikleri bul
- Haftalık içerik planı oluştur
- Caption ve hook yaz
- Paylaşım zamanlama öner

## Kurallar
- Hedef kitle: AI ve otomasyon ilgilenen girişimciler
- Ton: Samimi, pratik, jargonsuz
- Her post için hook + value + CTA formülü kullan
- Çıktıları outputs/ altına tarihle kaydet

Hangi Ajanlar Kurabilirsin?

Sınır yok. Her tekrarlayan görevi bir ajan haline getirebilirsin:

  • İçerik Ajanı - Blog, sosyal medya, newsletter planlama ve yazma
  • Satış Ajanı - Lead nitelendirme, takip e-postaları, CRM güncelleme
  • Araştırma Ajanı - Rakip analizi, pazar araştırması, trend takibi
  • Finans Ajanı - Gelir-gider takibi, fatura hatırlatma, vergi planlama
  • Sekreter Ajanı - Günlük brifing, e-posta özeti, öncelik sıralama
  • Topluluk Ajanı - Üye takibi, churn önleme, win-back kampanyaları

İlk ajanını kurarken tek bir beceriyle başla. Örneğin sadece “haftalık içerik planı” yapan bir ajan. İşleyince yeni beceriler ekle.

Gerçek Hayat: 16 Ajanlı Workspace

Bu sistemi 6 aydır kullanıyorum. Tek başıma 16 ajan ve 100’den fazla beceriyle çalışıyorum:

AjanGörev
YouTubeVideo konuları, scriptler, SEO
Content RepurposeVideo → tweet, reel, carousel
InstagramOutlier araştırma, içerik planlama
TwitterTweet, thread, reply mining
CommunitySkool topluluk yönetimi
Hey-SalesLead takip, sesli arama, CRM
SecretaryGünlük brifing, öncelik sırası
CourseKurs içeriği, müfredat
CFOGelir-gider, vergi, nakit akışı

Tipik Bir Günüm

  • 09:00 - “Günlük brifingimi hazırla” → Sekreter ajanı: e-postalar, takvim, öncelikler
  • 10:00 - “YouTube için bu haftanın video konusunu belirle” → YouTube ajanı: trend analizi
  • 11:00 - “Dünkü videoyu tweet thread’ine çevir” → Content Repurpose ajanı
  • 14:00 - “Yeni gelen lead’leri nitelendir” → Sales ajanı: lead skorlama
  • 16:00 - “Toplulukta churn riski olan üyeleri bul” → Community ajanı

Sonuçlar

  • İçerik üretimi 5x hızlandı - Eskiden bir YouTube videosu için 2 gün harcıyordum, şimdi scriptini 30 dakikada çıkartıyorum
  • Hiçbir lead kaybetmiyorum - Satış ajanı her lead’i takip ediyor
  • Topluluk retention %82’ye çıktı - Community ajanı risk olan üyeleri erken yakalıyor
  • Günlük 2 saat tasarruf - Rutin işler otomatik, ben strateji ve içeriğe odaklanıyorum

Bu sistem bir gecede kurulmadı. 6 ayda, her gün bir şey ekleyerek, deneyerek, iyileştirerek bu noktaya geldi. Sen de tek bir ajanla başlayabilirsin.

Hazır Ajan Şablonunu İndir ve Hemen Başla

Sıfırdan başlamana gerek yok. Sana hazır bir agents klasörü hazırladım. İçinde CLAUDE.md, örnek ajan yapıları ve beceri şablonları var.

Agents Başlangıç Paketini İndir (Google Drive)

3 Adımda Başla

  1. İndir ve bilgisayarına kaydet - Linke tıkla, Google Drive’dan klasörü indir
  2. VS Code’da aç - VS Code → File → Open Folder → Agents klasörünü seç
  3. Claude’a söyle, gerisini o yapsın - Claude Code panelini aç ve söyle: “Bu klasörü incele. Bana bir Instagram içerik planlama ajanı oluştur.”

Claude, CLAUDE.md’yi okur, yapıyı anlar ve sana özel ajanları kurar. Dosya yapısını, kuralları, becerileri - hepsini Claude halleder. Sen sadece ne istediğini söyle.

Kaynaklar

Video Rehberler

Bu konuyu detaylı videolarımda da anlattım:

Tek başına çalışıyorsan, bu yolculukta yalnız değilsin. Ben de tek başıma başladım - şimdi 16 ajanlık bir ekibim var. İş Güç Yapay Zeka topluluğuna katıl ve birlikte öğrenelim.