Claude Ustalık Rehberi

Ekosistemi Tanı

Hedef: “Claude” dediğimizde tam olarak neyi kastettiğimizi bilmek.

Claude tek bir uygulama değil; bir model ailesi ve onun etrafındaki ürün ekosistemidir. Yeni başlayanların en sık hatası web arayüzü, kodlama ajanı ve API katmanını birbirine karıştırmasıdır. Doğru aracı doğru iş için seçmek hem zamanını hem bütçeni korur.

Model ailesini doğru konumlandır

Planlar & Ücretsiz Kullanım

Hedef: Para harcamadan maksimum değer; ödeyeceksen doğru yere ödemek.

Ücretsiz şeritte hızlı gitme taktikleri

• Free planı stratejik kullan: Yoğun çalışmayı oturumlara böl; bir oturumda öğren, sonrakinde uygula.
• Tek mesajda çok iş: Beş ayrı soru yerine iyi yapılandırılmış tek bir mesajda beş talebi netleştir.
• Uzun sohbetlerden kaç: Her mesajda geçmiş bağlam maliyete dönüşür; konu değişince yeni sohbet aç.
• Geçiş sinyali: Haftada birkaç kez limite çarpıyorsan, kaybettiğin zaman abonelik maliyetinden pahalı olabilir.

Prompt Mühendisliği

Hedef: İlk denemede istediğin sonucu almak; çünkü düzeltme turları en pahalı turlardır.

Kötü prompt vasat cevaba, vasat cevap çok sayıda düzeltme turuna, düzeltme turları da şişmiş bağlama ve tükenen kotaya dönüşür. İyi prompt bu zinciri en baştan keser.

5 katmanlı prompt iskeleti

# 1. ROL — Claude kim olsun?
Sen 10 yıllık deneyimli bir Python backend mimarısın.

# 2. GÖREV — net, ölçülebilir tek cümle
Aşağıdaki API kodunu gözden geçir ve güvenlik açıklarını bul.

# 3. BAĞLAM — gerekli bilgi, gereksiz hiçbir şey
Bu kod bir fintech uygulamasında çalışıyor; PCI-DSS uyumu kritik.

# 4. KISITLAR — format, uzunluk, ton, dil
- Her bulguyu önem derecesiyle etiketle
- Her bulgu için düzeltilmiş kod parçası ver
- En fazla 5 bulgu, Türkçe açıklama

# 5. ÖRNEK — çıktıyı kilitle
Örnek format: [KRİTİK] SQL Injection — satır 42 — düzeltme: ...

Arayüz Süper Güçleri

Hedef: Claude.ai’ı sohbet kutusu değil, çalışma istasyonu gibi kullanmak.

Skills — Claude’a Uzmanlık Öğret

Hedef: Tekrarlayan işleri bir kez tanımlayıp sürekli kullanılabilir hale getirmek.

Skill, Claude’un belirli bir görev türünde nasıl davranacağını anlatan talimat klasörüdür. Kalbi YAML başlıklı bir SKILL.md dosyasıdır. Claude başta yalnızca ad ve açıklamayı görür; göreve uyduğunda dosyanın tamamını okur. Bu yaklaşım token tasarrufu sağlar.

---
name: fatura-analizi
description: Kullanıcı fatura/fiş PDF'i yüklediğinde veya harcama analizi istediğinde kullan.
---

# Fatura Analizi

## Adımlar
1. PDF'ten tablo verisini çıkar
2. KDV'yi oranlara göre ayrıştır
3. Kategorileri şemaya eşle
4. Çıktıyı xlsx olarak ver ve özet sayfası ekle

## Yapma
- Para birimini asla varsayma; faturadan oku

• Description en kritik alandır: Skill’in ne zaman tetikleneceğini belirler.
• Kısa tut: Ana dosya öz olsun; uzun referansları yan dosyalara koy.
• Script ekleyebilirsin: Python veya Bash scriptleriyle iş akışını somutlaştır.

Agentlar & Claude Code

Hedef: “Soru soran” kullanıcıdan “iş devreden” yöneticiye geçiş.

Agent; hedef alan, araç kullanan, çok adımlı plan yapıp kendini düzeltebilen Claude kullanım biçimidir. Kod tarafında bu yaklaşımın en görünür kapısı Claude Code’dur.

# Kurulum
npm install -g @anthropic-ai/claude-code

# Proje klasöründe başlat
cd projem && claude

# Örnek görevler
> bu repo'yu analiz et ve mimariyi özetle
> login sayfasındaki bug'ı bul, düzelt, test yaz, commit et

API Entegrasyonu

Hedef: 15 dakikada ilk istek; 1 saatte tool use mantığını anlamak.

İlk istek — Python

import anthropic

client = anthropic.Anthropic()

msg = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=500,
    system="Kısa ve Türkçe yanıt ver.",
    messages=[{"role": "user", "content": "MCP nedir, 2 cümlede?"}],
)
print(msg.content[0].text)

Tool use mantığı

tools = [{
    "name": "doviz_kuru",
    "description": "Verilen para biriminin TL kurunu döndürür",
    "input_schema": {
        "type": "object",
        "properties": {"birim": {"type": "string"}},
        "required": ["birim"]
    }
}]

# stop_reason == "tool_use" gelirse aracı çalıştır,
# sonucu tool_result olarak yeni mesajla geri gönder.

Token Ekonomisi

Hedef: Aynı kaliteyi 5–10 kat daha az tokenle üretmek.

Token, modelin işlem birimidir. Hem girdi hem çıktı sayılır. Profesyonel kullanımda hedef yalnızca iyi çıktı almak değil, aynı kaliteyi daha kısa bağlam ve daha doğru model seçimiyle üretmektir.

30 Günlük Yol Haritası

Hedef: Günde yaklaşık 45 dakika ile bir ayda profesyonel çalışma düzenine geçmek.