Die Claude API in Ihre Anwendung integrieren

Eine Claude API-Integration ist am ersten Tag überschaubar — eine SDK-Installation und ein authentifizierter Aufruf —, doch die Eignung für den Produktivbetrieb entscheidet sich an den Komponenten rund um diesen Aufruf: Streaming, Wiederholungsversuche, Tokenbudgets und Observability. Dieser Leitfaden deckt den gesamten Weg ab und enthält funktionsfähigen Code, den Sie direkt anpassen können.

Authentifizierung und Ihre erste Anfrage

Installieren Sie das offizielle SDK (pip install anthropic oder npm install @anthropic-ai/sdk), hinterlegen Sie Ihren Schlüssel in einer Umgebungsvariablen – niemals im Quellcode – und führen Sie einen Aufruf der Messages API aus, um die Verarbeitungskette zu überprüfen. Die API wird über den Header anthropic-version versioniert, den die SDKs für Sie setzen.

Schlüssel funktionieren gleich, unabhängig davon, ob sie aus der Anthropic Console oder von einem Anthropic-kompatiblen Gateway wie AI Prime Tech stammen (einem unabhängigen Dienst ohne Verbindung zu Anthropic): Der einzige Unterschied ist die base_url, mit der Ihr Client erstellt wird.

Modelle nach Aufgabe auswählen

Integrationen, die ein einzelnes Modell fest im Code hinterlegen, verursachen zu hohe Kosten oder liefern unzureichende Leistung. Wählen Sie das Modell je nach Aufgabe: Haiku 4.5 für Klassifizierung, Extraktion und Routing; Sonnet 4.6 für die meisten Produktfunktionen und Programmieraufgaben; Opus 4.8, wenn tiefgehendes Schlussfolgern den Kern des Produkts bildet; Fable 5, wenn Sie das Kontextfenster von 1M benötigen – den vollständigen Vergleich finden Sie unter <a href="/de/learn/claude-api-models-compared/">Claude-Modelle im Vergleich</a>.

Hinterlegen Sie das Modell als Konfigurationswert statt als Konstante – Modellnamen ändern sich im Abstand von Monaten, und Sie werden neue Versionen per A/B-Test vergleichen wollen, ohne ein Deployment durchführen zu müssen.

Streaming, Zeitüberschreitungen und Wiederholungsversuche

Nutzen Sie Streaming für alle Ausgaben, die Menschen mitverfolgen: Server-Sent Events liefern Tokens direkt bei ihrer Erzeugung und senken die wahrgenommene Latenz von vielen Sekunden auf unter eine Sekunde. Aufrufe ohne Streaming mit hohen max_tokens-Werten überschreiten außerdem eher die Lesezeitlimits von Proxys – eine Fehlerklasse, die erst im Produktionsbetrieb auftritt.

Wiederholen Sie Anfragen bei 429- und 5xx-Antworten mit exponentiellem Backoff und zufälliger Streuung, beachten Sie vorhandene retry-after-Header und begrenzen Sie die Gesamtzahl der Versuche. Behandeln Sie 400-Antworten als dauerhafte Fehler – die Nutzlast selbst ist fehlerhaft (häufig ist die Eingabe zu groß; siehe <a href="/de/learn/claude-api-errors-troubleshooting/">Claude-API-Fehler</a>), und Wiederholungsversuche verbrauchen lediglich Kontingent.

Checkliste für den Produktionsbetrieb

Vor dem Start: Token-Budgets für Eingabe und Ausgabe durchsetzen; Kosten pro Anfrage protokollieren (Nutzungsdaten werden mit jeder Antwort zurückgegeben); Prompt-Caching für wiederholte System-Prompts aktivieren; ein Ausweichmodell oder einen Ausweichendpunkt für Störungen vorsehen; und auf Prompt-Injection prüfen, wenn Nutzereingaben in den Prompt gelangen.

Die meisten Integrationsprobleme entstehen nicht durch die API selbst, sondern durch unbegrenztes Kontextwachstum und fehlende Beobachtbarkeit. Protokollieren Sie Eingabe- und Ausgabetokens von Anfang an, und überraschende Kosten bleiben aus.

import os, anthropic

client = anthropic.Anthropic(
    api_key=os.environ["ANTHROPIC_API_KEY"],
    base_url=os.environ.get("ANTHROPIC_BASE_URL", "https://aiprimetech.io"),
)

with client.messages.stream(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Summarize our launch plan in 3 bullets."}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

Häufig gestellte Fragen

AI Prime Tech ist ein unabhängiges API-Gateway. Es ist weder mit Anthropic verbunden noch von Anthropic empfohlen und auch kein Wiederverkäufer von Anthropic. Claude und zugehörige Modellnamen sind Marken ihrer jeweiligen Inhaber.