Anthropic API Anahtarı Nasıl Alınır ve İlk Claude İsteğinizi Oluşturun

Bir Anthropic API anahtarı, Claude API'ye yaptığınız her istekte gönderdiğiniz kimlik bilgisidir. sk-ant- ile başlar, Claude Konsolu'nda oluşturulur ve kullanımınızı kuruluşunuzun ön ödemeli kredilerine göre faturalandırır. Daha önce hiç kullanmadıysanız, API anahtarının ne olduğuna dair başlangıç rehberimiz genel fikri kapsar. Bu rehber özel olanı ele alır: Konsol hesabı oluşturma, kredi yükleme, doğru kapsama sahip bir anahtar oluşturma, ilk Mesajlar isteğini curl ve Python SDK ile gönderme ve anahtarı sonrasında sorunlardan uzak tutma.

Anthropic'in resmi API anahtarınızı alın sayfası, düğmenin nerede olduğunu gösterir. Ancak ilk isteğin neden 401 döndürdüğünü, hangi model kimliğinin güncel olduğunu veya anahtarı kabuk geçmişinize yapıştırmadan nasıl test edeceğinizi söylemez. Geri kalan bu bölümde işte bunlar ele alınmaktadır.

Başlamadan önce ihtiyacınız olanlar

• platform.claude.com adresindeki Claude Konsolu için bir e-posta (eskiden console.anthropic.com şimdi oraya yönlendiriyor).

• Bir ödeme kartı. API ön ödemelidir ve yalnızca Yönetici veya Faturalandırma rolü kredi satın alabilir.
• curl veya SDK örneği için Python 3.10+.
• Anahtarı yerel bir değişken olarak saklamak ve isteği tekrarlanabilir bir test olarak kaydetmek için Apidog. Ücretsiz plan dört kişiye kadar olan ekipleri kapsar.

Adım 1: Bir Claude Konsolu hesabı oluşturun

platform.claude.com adresinden kaydolun. Bu, Varsayılan Çalışma Alanı ile bir kuruluş oluşturur ve anahtarlarınız, kredileriniz ve hız limitleriniz bu kuruluşa bağlıdır. Bir ekip arkadaşınız zaten bir tane oluşturduysa, ikinci bir kuruluş oluşturmak yerine davet isteyin: krediler ve kullanım katmanları aktarılmaz.

Adım 2: İlk çağrınızdan önce kredi ekleyin

Evet, önce krediler gelir. Anthropic'in faturalandırma belgeleri açıktır: API'yi kullanmadan önce kredi satın alın ve sıfır bakiye durumunda ne API ne de playground çalışır. Yeni kullanıcılar test etmek için küçük miktarda ücretsiz kredi alır, bu yüzden satın almadan önce bakiyenizi kontrol edin, ancak bunu bir plan yerine bir bonus olarak düşünün.

Ayarlar > Faturalandırma'yı açın ve Kredi satın al'a tıklayın. Denetimsiz bir şey çalıştırıyorsanız otomatik yenilemeyi açın. Güncel adımlar için kredi nasıl satın alınır bölümüne bakın. Kuruluşunuz ayrıca aylık harcama limitine sahip bir kullanım katmanına da düşer, bu hız limitleri bölümünde ele alınmıştır.

Adım 3: API anahtarını oluşturun

Ayarlar > API anahtarları'na gidin ve Anahtar oluştur'a tıklayın. Dört seçim önemlidir:

• Ad: Uygulamanın adını verin, kişinin adını değil. orders-service-staging, anahtarım'dan daha iyidir.
• Süre Sonu: 3 saatten 30 güne kadar, özel veya Asla. Test için kısa bir ömür seçin; daha sonra değiştirilemez.
• Bağlı hesap: Kişisel bir anahtar için kendiniz, paylaşılan herhangi bir şey için bir hizmet hesabı. Kişisel bir anahtar, kuruluştan ayrıldığınızda ölür.
• Çalışma alanı: Bir çalışma alanına kapsamlandırırsanız, anthropic-workspace-id başlığını atlayabilirsiniz. Çoklu çalışma alanı anahtarının her istekte bu başlığı göndermesi gerekir, aksi takdirde 400 hatası alırsınız.

Konsol tam anahtarı tam olarak bir kez gösterir, bu nedenle doğrudan sır yöneticinize kopyalayın. Gösterme düğmesi yoktur. Anahtar oluştur pasif durumdaysa, rolünüz anahtar oluşturamaz; bir yöneticiye danışın.

Adım 4: Her isteğin ihtiyaç duyduğu üç başlık

POST https://api.anthropic.com/v1/messages adresine yapılan her çağrı üç başlık taşır.

Resmi SDK'lar sizin için üçünü de gönderir. Ham HTTP ve API istemcileri bunları açıkça belirtmelidir, bu da çoğu ilk istek hatasının kaynağıdır. Tam referans: Claude API genel bakış.

Adım 5: İlk Mesajlar isteğinizi gönderin

Gövdenin model, max_tokens ve messages'a ihtiyacı vardır. Güncel bir model kimliği kullanın: Eylül 2026 itibarıyla bu claude-opus-5 (önerilen varsayılan), claude-fable-5-1 (en yetenekli), claude-sonnet-5 ve claude-haiku-4-5'tir. Daha eski 3.x ve 4.x kimlikleri 404 döndürür veya kullanımdan kaldırılmış modellere işaret eder ve güncel kimlikler tarih son eki taşımaz. Claude Opus 5 API kılavuzu düşünme, çaba ve akış konularında daha derinlemesine bilgi verir.

curl

export ANTHROPIC_API_KEY="sk-ant-api03-..."

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Write a one-sentence OpenAPI description for POST /orders, which creates an order and returns 201."}
    ]
  }'

Başarılı bir yanıt (kısaltılmış):

{
  "id": "msg_01...",
  "role": "assistant",
  "model": "claude-opus-5",
  "content": [{"type": "text", "text": "Creates a new order and returns it with a 201 status."}],
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 31, "output_tokens": 24}
}

content[].text'ten metni okuyun, stop_reason'ın end_turn olduğunu kontrol edin ve maliyet takibi için usage'ı saklayın. Destek bir şeyi başarısız olduğunda request-id yanıt başlığını ister.

Python SDK

pip install anthropic

import anthropic

client = anthropic.Anthropic()  # reads ANTHROPIC_API_KEY from the environment

message = client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    messages=[{
        "role": "user",
        "content": "Write a one-sentence OpenAPI description for POST /orders, which creates an order and returns 201.",
    }],
)

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

SDK, ANTHROPIC_API_KEY'i okur, sürüm ve içerik türü başlıklarını ekler ve 429 ile 5xx hatalarını geri çekilmeyle iki kez dener. Anahtarı asla bir dize değişmezi olarak geçirmeyin; ortam değişkeni tüm olayın anahtarıdır.

Adım 6: Anahtarı Apidog'da saklayın ve test edin

Kabuğa yapıştırılan bir anahtar, geçmiş dosyanızda yaşar. Paylaşılan bir istekte saklanan bir anahtar, ekip arkadaşlarınızla senkronize olur. Apidog ikisini ayırır: istek yapısı paylaşılır, sır makinenizde kalır.

Anahtarı yerel bir değişken olarak saklayın. Ortam Yönetimi'ni açın, Anthropic adında bir ortam oluşturun ve ANTHROPIC_API_KEY adında bir değişken ekleyin. Paylaşılan değeri SET_LOCALLY olarak bırakın ve gerçek anahtarı yerel değere yapıştırın, bu anahtar istemcinizin önbelleğinde kalır ve asla senkronize olmaz. Apidog ortamları ve gizli değişkenleri hakkındaki rehberimiz kapsam kurallarını kapsar.

Başlıkları bir kez ayarlayın. Aynı panelde, Başlıklar altında iki genel parametre ekleyin: x-api-key, {{ANTHROPIC_API_KEY}} olarak ayarlanmış ve anthropic-version, 2023-06-01 olarak ayarlanmış. Bunlar projedeki her isteğe uygulanır ve Apidog, JSON gövdesi için content-type'ı otomatik olarak ekler.

İlk isteği gönderin. Yeni istek, https://api.anthropic.com/v1/messages'a POST, curl örneğindeki JSON gövdesini yapıştırın, gönderin. Değişkenin çözülmüş olarak her iki başlığın da gönderildiğini doğrulamak için Gerçek İstek sekmesini açın. Bu sekme, bir 401'in bir anahtar sorunu değil, bir başlık sorunu olduğunu kanıtlamanın en hızlı yoludur.

Bunu bir test olarak kaydedin. İsteği bir uç nokta durumu olarak kaydedin, ardından üç iddia ekleyin: durum 200'e eşit, stop_reason end_turn'a eşit ve usage.output_tokens 0'dan büyük. Apidog CLI'dan çalıştırın ve anahtarı çalışma zamanında CI sır deposundan enjekte edin. Bu, anahtar, başlıklar ve model kimliği için tek tıklamalı bir duman testidir. Takip etmek için Apidog'u indirin; ücretsiz plan dört koltuk içerir.

Hız limitleri ve bir isteğin maliyeti

Limitler kuruluş başına ve model başınadır: dakikadaki istekler (RPM), dakikadaki giriş belirteçleri (ITPM) ve dakikadaki çıkış belirteçleri (OTPM). Yalnızca önbelleğe alınmamış giriş ITPM'ye sayılır, bu nedenle istem önbelleklemesi, katman değişikliği olmadan verimi artırır. Hız limitleri belgelerinden:

Sonnet 5 ve Haiku 4.5, her katmanda Opus 5 sayılarını paylaşır. Her yanıt, anthropic-ratelimit-*-remaining ve -reset başlıklarını taşır, böylece Konsol'u sorgulamadan boşluk alanını izleyebilirsiniz.

Fiyatlandırma sayfasından milyon belirteç başına: Opus 5 için 5 $ giriş / 25 $ çıkış, Sonnet 5 için 2 $ / 10 $, Fable 5.1 için 10 $ / 50 $, Haiku 4.5 için 1 $ / 5 $. Önbellek okumaları girişin %10'u maliyetindedir (Fable 5.1'de %2.5) ve Batch API her iki tarafı da yarıya indirir. Bu ilk curl isteği bir kuruşun kesirine mal olur.

Yaygın hatalar ve bunları nasıl düzelteceğiniz

Hatalar, error.type ve request_id ile JSON olarak geri döner. Hatalar referansı her kodu listeler; bunlar ilk karşılaşacağınız hatalardır.

Anahtar hijyeni: rotasyon, kapsam belirleme ve asla istemci kodunda kullanmama

Anahtarı asla bir tarayıcıya veya mobil uygulamaya göndermeyin. Bir JavaScript paketindeki veya bir APK'daki herhangi bir şey dakikalar içinde herkese açık hale gelir. Çağrıyı kendi arka ucunuzun arkasına koyun. Claude'u doğrudan çağırması gereken Apple uygulamaları için, App Attest statik bir anahtar yerine doğrulanmış yapılar için kısa ömürlü jetonlar yayınlar.

Uygulama ve ortama özel bir anahtar. Ayrı çalışma alanlarındaki ayrı hazırlık ve üretim anahtarları, hazırlık harcamalarını sınırlamanıza ve diğerine dokunmadan birini iptal etmenize olanak tanır.

Programlı olarak döndürün. Yeni anahtarı oluşturun, dağıtın, çalıştığını onaylayın, ardından eskiyi silin. Devre Dışı Bırak geri alınabilir; Sil kalıcıdır. Bir sızıntıdan şüpheleniyorsanız, önce devre dışı bırakın ve sonra araştırın. Deponuzdaki bir sır tarayıcısı, fark edilmeden önce işlenen anahtarları yakalar.

Üretimde kısa ömürlü kimlik bilgilerini tercih edin. İş Yükü Kimlik Federasyonu, bulut sağlayıcınızın kimlik jetonunu kısa ömürlü bir Claude jetonuyla değiştirir, böylece sızdırılacak bir sk-ant- dizisi kalmaz.

SSS

Bir Anthropic API anahtarı, bir Claude API anahtarı ile aynı mıdır?

Evet. Konsol, SDK'lar ve belgeler artık "Claude API" diyor ve anahtar biçimi ile başlıklar aynıdır. "Anthropic API anahtarı" diyen eski eğitimler aynı kimlik bilgisini kastetmektedir.

Ücretsiz bir Anthropic API anahtarı alabilir miyim?

Anahtar oluşturmak ücretsizdir. Kullanımı ön ödemeli kredilerden düşülür ve Anthropic'in fiyatlandırma sayfası, yeni kullanıcıların test etmek için küçük miktarda ücretsiz kredi aldığını belirtir. Gerçek iş yüklerini ödeme yapmadan çalıştırmaya çalışıyorsanız, herhangi bir şey inşa etmeden önce ücretsiz Claude API erişimi hakkındaki dürüst analizimizi okuyun.

Claude Pro veya Max aboneliği API erişimi içerir mi?

Hayır. Claude.ai abonelikleri ve Konsol API kredileri ayrı ayrı faturalandırılır. Claude.ai için zaten ödeme yapıyor olsanız bile kredili bir Konsol kuruluşuna ihtiyacınız vardır.

Anahtarımın süresi dolduğunda ne olur?

İstekler 401 authentication_error döndürür. Süresi dolmuş anahtarlar yeniden etkinleştirilemez, bu nedenle yeni bir anahtar oluşturun ve ortam değişkenini güncelleyin. Anthropic, anahtarın yaratıcısına, yeterince uzun ömürlü anahtarlar için süresi dolmadan yedi gün ve bir gün önce e-posta gönderir.

Sonraki adım

Anahtarı 7 günlük sona erme süresiyle oluşturun, bir Apidog yerel değişkenine koyun, duman testini çalıştırın ve ancak o zaman koda bağlayın. Bu geçerse, kimlik bilgisi, başlıklar ve model kimliği hepsi doğru demektir ve bundan sonraki her 401, bir yazım hatasından ziyade gerçek bir sorundur.