Claude API Nedir, Nasıl Kullanılır?

Claude API, yazılımların Claude modellerine kod üzerinden mesaj gönderip cevap almasını sağlayan arayüzdür. API, bir yazılımın başka bir yazılıma istek gönderip cevap alabildiği arayüzdür. Anthropic'in belgelerine göre Claude API, https://api.anthropic.com adresinde çalışır ve Claude modellerine kod üzerinden erişim sağlar. Claude API'yi kullanmak için bir Claude Console hesabı ve bir API anahtarı gerekir. Claude Console, Claude Console hesabının, API anahtarlarının ve harcamasının yönetildiği web panelidir. API anahtarı ise bir yazılımın API'ye kimliğini göstermek için kullandığı gizli koddur.

Claude API ne işe yarar?

Claude API ile bir yazılım Claude'a metin gönderir ve gelen cevabı kendi ekranında gösterir ya da başka bir işlemde kullanır. Token, dil modelinin metni işlerken kullandığı küçük metin parçasıdır. Belgelere göre Claude API'nin başlıca bölümleri şunlardır:

Örnek: Bir geliştirici, kendi not uygulamasına bir özet düğmesi ekler. Kullanıcı düğmeye basınca uygulama notu Messages API ile Claude'a gönderir. Claude'un yazdığı özet notun altında görünür.

Belgelere göre Claude, Claude API'nin yanında Amazon Web Services (AWS), Google Cloud ve Microsoft Azure bulut platformları üzerinden de kullanılabilir. Claude API en yeni modellere ve özelliklere doğrudan erişim sağlar. Bulut platformlarında ödeme ve kimlik doğrulama bulut sağlayıcısının kendi sistemi üzerinden yapılır. Claude API'nin otomasyonda nasıl kullanıldığı Claude ile otomasyon nasıl yapılır yazısında anlatılır.

Claude API ile Claude sohbet uygulaması arasındaki fark ne?

Claude sohbet uygulaması, claude.ai adresinde Claude'la yazışarak çalışmayı sağlar. Claude API ise Claude'u bir kişinin ya da şirketin kendi yazılımına bağlar. JSON, verileri adlar ve değerlerle düzenli biçimde yazan bir metin biçimidir.

Belgelere göre API kullanımı Anthropic tarafından faturalandırılır. Claude Console'daki Billing sayfasında hesabın spend limit (aylık harcama sınırı) değeri görülür. Rate limits sayfasında ise dakikadaki istek ve token sınırları yer alır. Belgelere göre her hesap bir usage tier'a (kullanım katmanı) kendiliğinden yerleştirilir. Bu katman, hesabın istek ve harcama sınırlarını belirler.

Örnek: Bir içerik üreticisi, video fikirlerini claude.ai'de Claude'la yazışarak olgunlaştırır. Ekibindeki geliştirici ise video açıklamalarının taslağını, ekibin kendi yönetim aracına API ile yazdırır. Taslaklar yönetim aracında her videonun kaydında görünür.

Claude API anahtarı nasıl alınır?

Belgelere göre anahtarlar Console'daki Account Settings bölümünde oluşturulur. Anahtar şu adımlarla alınır:

1. Tarayıcıda platform.claude.com adresini aç ve Claude Console hesabınla giriş yap. Hesabın yoksa bu adreste bir Claude Console hesabı aç.
2. Account Settings bölümünde API anahtarlarının bulunduğu sayfayı aç. Bu sayfaya platform.claude.com/settings/keys adresinden de ulaşılır.
3. Yeni bir API anahtarı oluştur. Oluştururken anahtarın türünü ve geçerlilik süresini seç.
4. Oluşan anahtarı kopyala ve bir sonraki bölümde kullanmak üzere sakla.

Console'daki playground, API'yi tarayıcıda denemeyi sağlayan bölümdür. Workspace ise Console'da deneme çalışmasını ve gerçek kullanıcılara açılan yazılımı birbirinden ayırmayı sağlayan bölümdür. Belgelere göre API önce playground'da denenebilir, anahtar ise sonra oluşturulabilir.

Örnek: Bir geliştirici, yazılımına ekleyeceği özellik için yazdığı mesajı önce Console'daki playground'da dener. Sonuç istediği gibi olunca Account Settings bölümünde bir API anahtarı oluşturur. Deneme ve canlı kullanımı ayırmak için iki ayrı workspace kullanır.

Claude API'ye ilk istek nasıl gönderilir?

Belgeler ilk istek için hem curl komutu hem de programlama dillerinde kod örneği verir. Terminal, bilgisayara yazılı komut verilen metin penceresidir. İlk örnekte kullanılan curl, terminalden web adreslerine istek gönderen bir araçtır. Ortam değişkeni, bilgisayardaki programların okuyabildiği adlı bir ayardır.

Önce terminali aç ve API anahtarını ANTHROPIC_API_KEY adlı ortam değişkenine kaydet. Belgelerdeki bu komut macOS ve Linux terminali içindir. Komuttaki your-api-key-here yerine kendi anahtarını yaz:

export ANTHROPIC_API_KEY="your-api-key-here"

Sonra aşağıdaki komutu terminale yapıştır ve çalıştır. Komut, Messages API'ye veri gönderen bir istek (POST) yapar:

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 1000,
    "messages": [
      {
        "role": "user",
        "content": "What should I search for to find the latest developments in renewable energy?"
      }
    ]
  }'

İstekteki başlıca alanlar şunlardır:

Belgelere göre Claude cevabını JSON biçiminde döndürür. Cevap metni content alanındaki text alanında yer alır. Cevaptaki usage alanı, girdi ve çıktı token sayılarını gösterir. Kendi mesajını göndermek için istekteki messages alanının içinde bulunan content metnini değiştir. Claude'a yazılan mesajın nasıl hazırlanacağı Prompt nedir, nasıl yazılır yazısında anlatılır.

SDK, bir API'yi belirli bir programlama dilinden kullanmayı kolaylaştıran resmî kod kitaplığıdır. Belgelere göre Anthropic'in SDK'leri Python, TypeScript, C#, Go, Java, PHP ve Ruby için vardır. SDK'ler API anahtarını ve sürüm bilgisini isteğe kendiliğinden ekler. Belgelerdeki Python örneğinde aynı istek şu kodla gönderilir:

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1000,
    messages=[
        {
            "role": "user",
            "content": "What should I search for to find the latest developments in renewable energy?",
        }
    ],
)

for block in message.content:
    if block.type == "text":
        print(block.text)

Bu kodu çalıştırmak için bilgisayarda Python kurulu olmalıdır. pip, Python'un paket kurma aracıdır.

Python kitaplığını pip install anthropic komutuyla kur. Yukarıdaki kodu quickstart.py adlı dosyaya kaydet ve python quickstart.py komutuyla çalıştır.

Örnek: Bir öğrenci, terminalde curl komutuyla Claude'a ilk mesajını gönderir. Ardından istekteki content alanına kendi ödev konusuyla ilgili bir mesaj yazar. Terminalde Claude'un cevabını içeren JSON metnini görür.

Claude API'de hangi modeller kullanılır?

Ajan, bir işi adım adım kendi başına yürüten yapay zekâ uygulamasıdır. Belgelere göre Ekim 2026 itibarıyla güncel Claude modelleri şunlardır:

İstekteki model alanına tablodaki API adını yaz.

Belgeler, model seçiminden emin olunmadığında çoğu iş için Claude Opus 5.5 ile başlamayı önerir. Belgelere göre bütün güncel modeller metin ve görsel girdiyi, metin çıktısını ve çok dilli kullanımı destekler.

Bağlam penceresi (context window), modelin bir istekte işleyebildiği en fazla token miktarıdır. Belgelere göre Claude Fable 5.1, Claude Opus 5.5 ve Claude Sonnet 5.5'in bağlam penceresi 1 milyon token'dır. Claude Haiku 4.5'te bu sınır 200 bin token'dır. Modellerin güncel ücretleri belgelerdeki Pricing sayfasında yer alır.

Örnek: Bir hukuk ekibi, uzun bir sözleşmeyi tek mesajda Claude'a gönderir. Metin bağlam penceresine sığdığı için Claude sözleşmenin tamamını okur ve kısa bir özet yazar.

Örnek: Bir geliştirici, müşteri mesajlarını konularına göre ayıran bir araç yazar. Mesajları konularına göre ayırmak hızlı cevap isteyen basit bir iş olduğu için bu araçta Claude Haiku 4.5'i seçer. Uzun raporlar hazırlayan başka bir aracında ise Claude Opus 5.5'i kullanır.

Sonraki adım

Claude Console'da bir API anahtarı oluştur ve terminalde belgelerdeki curl isteğini gönder. Ardından istekteki content alanına kendi işinle ilgili bir mesaj yaz ve Claude'un cevabını oku.

Gönderdiğin bu ilk istek, Claude'u kendi yazılımına bağlayan kalıcı bir sistemin ilk adımıdır.