Claude API anahtarı nasıl alınır — resmî yol ve ağ geçidi yolu

Claude API anahtarı almanın iki yolu vardır. Bunlar Anthropic konsolundan doğrudan alma ve Anthropic uyumlu uç noktalar sunan bir ağ geçidinden alma yollarıdır. Her ikisi de aynı Claude modelini çağırır; kodda değişen yalnızca base URL ve anahtar dizesidir.

Aşağıda her iki yolu da açıklıyor ve Güney Kore'de özellikle sık karşılaşılan ödeme sorunlarını ele alıyoruz.

Yol 1 — Anthropic konsolundan doğrudan alma

Anthropic hesabı oluşturun, ödeme yöntemi ekleyin ve konsoldan bir API anahtarı oluşturun. Bu yolun anahtarı Anthropic'in liste fiyatına göre ücretlendirilir; avantajı, resmî belgeler ve desteğin doğrudan sunulmasıdır.

Güney Kore'de sorunların çoğu ödeme aşamasında ortaya çıkar. Yurt dışı ödemeleri engellenmiş kartlar kaydedilemez; kart şirketinin uygulamasında yurt dışı ödemelerini etkinleştirip tekrar denemek çoğu sorunu çözer.

Yol 2 — Ağ geçidi anahtarı

Anthropic hesabı olmadan Claude modellerini çağırma yöntemidir. Kunavo hem Anthropic Messages API'sini hem de OpenAI uyumlu API'yi sunduğundan mevcut kodunuzda yalnızca base URL ve anahtarı değiştirmeniz yeterlidir.

Bu yol ödeme aşamasında da daha az engelle karşılaşır. Kunavo'nun ön ödemeli yüklemesinde ödeme sayfası Kore wonu olarak gösterildiğinde KakaoPay, Naver Pay, PAYCO, Samsung Pay ve yurt dışı ödemeleri açık olmayan yerel kartlar ödeme yöntemi olarak sunulur (Toss Pay sunulmaz). Yüklenen bakiye Claude API çağrılarında kullanılır; Anthropic abonelik ücretlerini ödemek için kullanılmaz.

# OpenAI SDK를 그대로 쓰면서 base_url만 바꾸는 방식.
# 코드에서 바뀌는 줄은 base_url 한 줄뿐입니다.
from openai import OpenAI

client = OpenAI(
    base_url="https://api.kunavo.com/v1",
    api_key="sk-kn-...",
)

resp = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "안녕하세요"}],
)
print(resp.choices[0].message.content)

Anthropic'in kendi biçimini kullanan kodlarda base URL'yi https://api.kunavo.com olarak ayarlayın — bu durumda /v1 eklemeyin. İki biçim arasındaki farklar ANTHROPIC_BASE_URL belgelerinde açıklanmıştır.

Oranlar

Oranlar sayfa oluşturulurken katalogdan alındığından bu belge gerçek ücretlendirmeden sapamaz. Ödeme yöntemleri ve yerel kartlarla ilgili ayrıntılar Claude API fiyatlandırması ve ödeme sayfasında yer alır.

Anahtarı aldıktan sonra 30 saniyelik kontrol

Anahtarı aldıktan sonra hemen bir çağrı yapın. Bu kontrolü önce yapmak, sonraki hatanın anahtardan kaynaklanıp kaynaklanmadığını anında ayırt etmenizi sağlar.

# 발급받은 키가 실제로 동작하는지 확인하는 최소 요청.
# 200이 오면 키는 정상입니다.
curl -sS https://api.kunavo.com/v1/messages \
  -H "Authorization: Bearer sk-kn-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":32,
       "messages":[{"role":"user","content":"안녕하세요"}]}'

200 gelirse anahtar düzgün çalışıyor demektir. 401 çoğunlukla kimlik doğrulama üstbilgisi türünün yanlış olduğunu gösterir. 429 hız sınırını, 529 ise üst akış aşırı yükünü gösterir; bu son iki hatanın anahtarla ilgisi yoktur. Her hataya ilişkin çözüm Claude Code hata özeti sayfasındadır.

Anahtarları ayırma

Anahtarları kullanım amacına göre ayırmak daha güvenlidir. Birini iptal etseniz bile diğerleri etkilenmez; ayrıca her anahtar için aylık kullanım sınırı belirleyebilirsiniz. Sınır istek çalıştırılmadan önce kontrol edilir ve her ayın başında sıfırlanır; bu nedenle insan gözetimi olmadan çalışan bir araca anahtar verirken özellikle kullanışlıdır.

Sık sorulan sorular