Claude API Kullanım Rehberi

API Key Alma

1. [console.anthropic.com](https://console.anthropic.com) adresine git

2. API Keys bölümüne gir

3. "Create Key" ile yeni bir key oluştur

4. Key'i güvenli bir yerde sakla — bir daha göremezsin

İlk İstek

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: YOUR_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6-20250514",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Merhaba Claude!"}]
  }'

Streaming

stream: true ekle → yanıt parça parça gelir:

const response = await fetch("https://api.anthropic.com/v1/messages", {
  method: "POST",
  headers: {
    "x-api-key": process.env.ANTHROPIC_API_KEY,
    "anthropic-version": "2023-06-01",
    "content-type": "application/json",
  },
  body: JSON.stringify({
    model: "claude-sonnet-4-6-20250514",
    max_tokens: 1024,
    stream: true,
    messages: [{ role: "user", content: "Merhaba!" }],
  }),
});

const reader = response.body.getReader();
const decoder = new TextDecoder();

while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  const text = decoder.decode(value);
  // SSE formatı: "data: {...}" satırları
  process.stdout.write(text);
}

System Prompt

AI'a kim olduğunu ve nasıl davranacağını söyler:

{
  "system": "Sen bir Türkçe teknik yazarsın. Kısa cümleler kur, jargon kullanma.",
  "messages": [{"role": "user", "content": "RAG nedir?"}]
}

Model Seçimi

Model	Ne zaman	Fiyat
-------	----------	-------
Claude Opus 4.6	En zor görevler, kod review, mimari	$$$
Claude Sonnet 4.6	Günlük kullanım, hız+kalite dengesi	$$
Claude Haiku 4.5	Hızlı, ucuz, basit görevler	$

Genel kural: Sonnet ile başla, yetersiz kalırsa Opus'a geç, basit iş için Haiku düşür.

Hata Yönetimi

• 429 Rate Limit: Bekle ve tekrar dene (exponential backoff)
• 400 Bad Request: Mesaj formatını kontrol et
• 500 Server Error: Geçici, 30 saniye sonra tekrar dene
• Context length: Model limitini aşma (Sonnet: 200k token)

Sonuç

Claude API'yi kullanmak 5 dakikalık iş. Gerçek fark prompt kalitesinde — API'yi öğren, sonra Prompt Engineering makalesine geç.