Claude-API-Schlüssel erhalten — offizielle und Gateway-Wege

Es gibt zwei Wege, einen Claude-API-Schlüssel zu erhalten. Der offizielle Weg führt direkt über die Anthropic-Konsole; der andere über ein Gateway mit Anthropic-kompatiblem Endpunkt. Beide rufen dieselben Claude-Modelle auf, und im Code ändern sich nur base URL und Schlüsselzeichenfolge.

Im Folgenden werden beide Wege erläutert, einschließlich der Zahlungsprobleme, die in Südkorea besonders häufig auftreten.

Weg 1 — Direkt über die Anthropic-Konsole

Erstellen Sie ein Anthropic-Konto, hinterlegen Sie eine Zahlungsmethode und generieren Sie anschließend in der Konsole einen API-Schlüssel. Bei diesem Weg wird der Schlüssel zu den Anthropic-Listenpreisen abgerechnet. Der Vorteil besteht darin, dass Sie die offiziellen Dokumente und den offiziellen Support direkt nutzen können.

In Südkorea treten die meisten Probleme während der Zahlung auf. Karten, die für Auslandszahlungen gesperrt sind, können nicht registriert werden. Aktivieren Sie Auslandszahlungen in der App Ihres Kartenanbieters und versuchen Sie es erneut; meistens ist das Problem damit gelöst.

Weg 2 — Gateway-Schlüssel

Damit können Sie Claude-Modelle ohne Anthropic-Konto aufrufen. Kunavo bietet sowohl die Anthropic Messages API als auch eine OpenAI-kompatible API. Sie müssen in bestehendem Code daher nur base URL und Schlüssel ändern.

Dieser Weg ist auch im Zahlungsschritt weniger anfällig für Blockierungen. Beim Aufladen des Kunavo-Prepaid-Guthabens werden bei einem in koreanischen Won angezeigten Zahlungsbildschirm KakaoPay, Naver Pay, PAYCO, Samsung Pay und inländische Karten ohne freigeschaltete Auslandszahlungen als Zahlungsmethoden angeboten (TOSS Pay wird nicht angeboten). Das aufgeladene Guthaben wird für API-Aufrufe von Claude verwendet und dient nicht zur Zahlung von Anthropic-Abonnementgebühren.

# 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)

Wenn Ihr Code das native Anthropic-Format verwendet, setzen Sie die base URL auf https://api.kunavo.com — in diesem Fall fügen Sie /v1 nicht hinzu. Die Unterschiede zwischen den beiden Formaten sind in der ANTHROPIC_BASE_URL-Dokumentation zusammengefasst.

Preise

Die Preise werden beim Rendern der Seite aus dem Katalog gelesen, daher kann dieses Dokument nicht von den tatsächlichen Kosten abweichen. Einzelheiten zu Zahlungsmethoden und inländischen Karten finden Sie unter Claude-API-Preise und -Zahlungen.

30-Sekunden-Prüfung nach der Ausstellung

Senden Sie nach Erhalt des Schlüssels sofort einen Aufruf. Wenn Sie diese Prüfung zuerst durchführen, können Sie spätere Fehler direkt als Schlüsselproblem oder als etwas anderes einordnen.

# 발급받은 키가 실제로 동작하는지 확인하는 최소 요청.
# 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":"안녕하세요"}]}'

Wenn 200 zurückgegeben wird, funktioniert der Schlüssel. Bei 401 stimmt meist die Art des Authentifizierungs-Headers nicht. 429 bedeutet eine Ratenbegrenzung und 529 eine Überlastung des Upstreams; diese beiden Fehler haben nichts mit dem Schlüssel zu tun. Die Maßnahmen für die einzelnen Fehler sind in Zusammenfassung der Fehler von Claude Code beschrieben.

Schlüssel aufteilen

Es ist sicherer, Schlüssel nach Zweck zu trennen. Wenn einer widerrufen wird, bleiben die übrigen unbeeinträchtigt, und Sie können für jeden Schlüssel ein monatliches Nutzungslimit festlegen. Das Limit wird vor der Ausführung einer Anfrage geprüft und zu Beginn jedes Monats zurückgesetzt, was besonders nützlich ist, wenn Sie Schlüssel an unbeaufsichtigte Agenten übergeben.

Häufig gestellte Fragen