2026'da Claude API anahtarı nasıl alınır

Hızlı yanıt: bir Claude API anahtarına giden üç adım

Anthropic'ten bir Claude API anahtarı almak için: console.anthropic.com'da bir hesap oluşturun, Plans and billing altında ön ödemeli kredi satın alın (kredi kartı veya banka kartı gerekir), ardından Settings'i açın, API Keys'e gidin ve Create Key'e tıklayın. Anahtar sk-ant- ile başlar ve yalnızca bir kez tam olarak gösterilir, bu yüzden hemen bir şifre yöneticisine veya bir ortam değişkenine kopyalayın. İki şey insanları takılmasına neden olur. Birincisi, bir Claude Pro veya Max chat aboneliği API erişimini içermez; Console, ayrı faturalandırmaya sahip ayrı bir üründür. İkincisi, anahtar oluşturmanın kendisi ödeme olmadan çalışsa da, gerçekten kredi satın alana kadar istekler bir kredi hatasıyla başarısız olur. İlk çağrınız bakiyenizle ilgili bir hata döndürüyorsa neden budur. Kart ekleyemiyorsanız ya da Claude'a artı diğer model ailelerine ulaşan tek bir anahtar istiyorsanız, ön ödemeli bir ağ geçidi pratik alternatiftir. Bu yol, ödünleşimler açıkça belirtilerek bu rehberin sonunda ele alınıyor.

Adım 1: bir Anthropic Console hesabı oluşturun

console.anthropic.com'daki Console, Anthropic'in geliştirici panelidir ve claude.ai chat uygulamasından ayrıdır. Bir e-posta adresi veya bir Google hesabıyla kayıt olun. Anthropic, kayıt sırasında bir telefon numarasını doğrulamanızı ister ve API erişimi desteklenen ülkelerle sınırlıdır, bu yüzden kayıt akışı sizi bu adımda engelliyorsa Anthropic'in kullanılabilirlik listesini kontrol edin. Kurulum sırasında bir organizasyon oluşturursunuz. Anahtarlar, krediler, rate limit'ler ve kullanım günlüklerinin tümü kişisel girişinize değil organizasyona aittir. Ekip arkadaşlarınızı davet ederseniz bu daha sonra önem kazanır: herkes aynı kredi havuzunu paylaşır ve yöneticiler kullanımı anahtara göre ayrıştırılmış olarak görebilir. Bu aşamada henüz hiçbir şey para tutmuyor. Herhangi bir faturalandırma bilgisi eklemeden önce model listesine göz atabilir, API referansını okuyabilir ve Workbench'i açabilirsiniz; Workbench, promptları Claude modellerine karşı test etmek için bir tarayıcı oyun alanıdır. Workbench, bir entegrasyon kodu satırı yazmadan önce bir promptun beklediğiniz gibi davrandığını kontrol etmek için kullanışlıdır.

Adım 2: ilk isteğinizden önce faturalandırmayı kurun

Anthropic'in API'si ön ödemelidir. Plans and billing altında bir kart ekleyin ve ilk bir kredi bloğu satın alın; minimum satın alma tutarı küçüktür, tarihsel olarak beş dolar. Her API çağrısı token başına oranlarla bu bakiyeden düşer, bu yüzden ayın sonunda sürpriz bir fatura olmaz. Bakiye sıfırlandığında istekler durur. İlk günden yapılandırılması değer bulan iki ayar vardır. Auto-reload, bakiye belirlediğiniz bir eşiğin altına düştüğünde otomatik olarak yükleme yapar. Boşalan bir bakiyenin asla bir kesintiye dönüşmemesi için bunu production iş yükleri için etkinleştirin. Deneyler için kapalı bırakın, böylece kaçak bir döngü bilinçli olarak yüklediğinizden fazlasını harcayamaz. Rate limit'ler kullanım katmanlarıyla ölçeklenir. Yeni organizasyonlar en düşük katmanda başlar ve dakika başına istek ve dakika başına token limitleri kümülatif harcamanız arttıkça yükselir. Genç bir hesapta bir trafik patlaması sırasında 429 yanıtları görüyorsanız, genellikle sebep katman sistemidir, kodunuz değil.

Adım 3: anahtarı oluşturun ve ilk çağrınızı yapın

Console'da Settings'i açın, ardından API Keys'e, ardından Create Key'e gidin. Anahtara ait olduğu uygulamayı veya ortamı tanımlayan bir isim verin, çünkü sonunda birden fazla anahtarınız olacak ve isimsiz anahtarları denetlemek imkansız hale gelir. Tam anahtar değeri yalnızca oluşturma anında görüntülenir; diyaloğu kapattıktan sonra Console yalnızca kısaltılmış bir sürüm gösterir. Anahtarı bir ortam değişkeni olarak dışa aktarın ve uygulama koduna dokunmadan önce terminalden test edin. Diğer sağlayıcılardan geçiş yapan insanları yakalayan Anthropic'e özgü iki detay var: kimlik doğrulama Authorization: Bearer yerine bir x-api-key header'ı kullanır ve her istek bir anthropic-version header'ı içermelidir. Eksik bir version header'ı net bir hata mesajıyla başarısız olur, bu yüzden bir şey bozulduğunda yanıt gövdesini okuyun.

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-sonnet-4-6",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Say hello in five words."}]
  }'

Anahtar güvenliği: kötü bir haftayı önleyen beş alışkanlık

Bu alışkanlıkları ilk günden benimsemek ucuzdur, bir olaydan sonra sonradan eklemek pahalıdır. Yanlışlıkla bir anahtarı commit'lerseniz, özel bir repository'de bile olsa onu sızmış sayın: iptal edin, döndürün ve commit geçmişini temizleyin. Bir pre-commit hook'unda gitleaks gibi secret scanner'lar bu hatayı makinenizden çıkmadan önce yakalar.

• Yalnızca ortam değişkenleri veya bir secrets manager. Kaynak koduna yapıştırılan bir anahtar er ya da geç commit'lenir ve scraper'lar özellikle sk-ant- ön ekini aramak için genel repository'leri izler.
• Uygulama ve ortam başına bir anahtar. Development, staging ve production için ayrı anahtarlar kullanım günlüklerini okunabilir yapar ve diğerlerini bozmadan bir yüzeyi iptal etmenize izin verir.
• Bir anahtarı asla tarayıcı veya mobil kodunda göndermeyin. Client-side JavaScript'teki her şey tanımı gereği herkese açıktır. Çağrıları kendi backend'iniz üzerinden yönlendirin ve anahtarı sunucu tarafında tutun.
• Şüphelenilen herhangi bir sızıntıda hemen iptal edin. Console'da bir anahtarı silmek onu anında öldürür; rotasyon sırasında uygulamanın çalışır kalması gerekiyorsa önce yerine geçecek anahtarı oluşturun.
• Harcama bildirimleri ayarlayın. Bir faturalandırma uyarı eşiği, sızdırılmış veya döngüye giren bir anahtarı büyük bir faturadan küçük bir faturaya dönüştürür ve yapılandırmanın hiçbir maliyeti yoktur.

Bir Claude çağrısının maliyeti, yakınındaki daha ucuz seçeneklerle

Claude token başına faturalandırılır, input ve output için ayrı oranlarla ve output token'lar uzun formatlı üretimde faturaya hakim olur. Yalnızca öne çıkan input fiyatına değil her iki sütuna da bakın. Ölçek için, aşağıdaki tablo Claude'u bir sonraki bölümde anlatılan ağ geçidi kataloğu üzerinden erişilebilen diğer modellerin yanında listeliyor. DeepSeek, yüksek hacimli bütçe trafiği için topluluğun yaklaşık favorisidir ve öncelik metin kalitesi olduğunda Claude tercih edilen model olmaya devam eder.

Kart yok mu? Bir ağ geçidi üzerinden çalışan bir anahtar edinin

Kart gereksinimi, bir bölge engeli ya da hesap kurulumunun kendisi engelse, APIsRouter bu sitenin belgelediği ağ geçidi yoludur. OpenAI uyumlu bir ağ geçididir: /topup'taki checkout kayıt gerektirmez, önce siz ödersiniz ve anahtar e-posta ile gelir. Faturalandırma abonelik olmadan kullandıkça ödemedir. Global modeller resmi liste fiyatlandırmasının 20% altında çalışır, Çin modelleri resmi oranlarının altında yer alır ve ilk yüklemeniz bakiyeye 100% ekler. Herhangi bir OpenAI SDK'sını https://api.apisrouter.com/v1'e yönlendirin ve bir katalog model ID'si geçin: Claude ailesi için claude-sonnet-4-6 veya claude-opus-4-7, aynı anahtardan daha ucuz token'lar istediğinizde deepseek-v4-flash veya glm-5. Aynı anahtar son kullanıcı uygulamalarında da çalışır. SillyTavern kullanıcıları /v1 ile biten base URL'yi yapıştırır ve model listesi anahtarınızla /v1/models'ten otomatik olarak dolar. JanitorAI, tam endpoint https://api.apisrouter.com/v1/chat/completions'a artı bir model adına ve anahtara ihtiyaç duyar. Doğrudan bir Anthropic anahtarına karşı ödünleşim dürüst ve basittir: trafiğinizi bir aracıya emanet ediyorsunuz ve Anthropic tarafındaki özellikler ağ geçidinin takvimine göre gelir. Artısı ise, sağlayıcı başına ayrı bir faturalandırma hesabı yerine Claude, GPT, Gemini, DeepSeek ve GLM genelinde tek bir bakiye ve tek bir endpoint'tir.

from openai import OpenAI

client = OpenAI(
    api_key="sk-...",  # arrives by email after checkout
    base_url="https://api.apisrouter.com/v1",
)

response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Say hello in five words."}],
)
print(response.choices[0].message.content)

Sık sorulan sorular