Claude-API-Leitfaden: Preise, Einrichtung und Ihre erste Anfrage

Um Ihre erste Claude-API-Anfrage zu stellen, erstellen Sie einen Claude-Konsolenschlüssel, speichern Sie ihn in einer Umgebungsvariablen, rufen Sie den „Messages“-Endpunkt auf und lesen Sie die zurückgegebene Verwendung Felder aus und berechnen Sie die Token-Kosten. Diese Anleitung führt Sie Schritt für Schritt durch diesen Vorgang anhand aktueller Modell-IDs und Preise, die am 8. September 2026 überprüft wurden.

Sobald Sie den API-Pfad verstanden haben, stellt sich als Nächstes die Frage, inwieweit Ihre tägliche Arbeit tatsächlich eine maßgeschneiderte Integration erfordert. Für Recherche, das Verfassen von Texten, das Programmieren und die kreative Produktion, GlobalGPT bietet eine kostengünstigere Möglichkeit, Claude zusammen mit GPT-5.6 Sol, Gemini 3 Pro, Kimi K3 und anderen führenden Modellen zu nutzen. Ein einziges Abonnement vereint die Modelle und eine breite Palette an KI-Tools in einem Dashboard, sodass die Arbeit von der Idee bis zum Ergebnis voranschreiten kann, ohne auf verschiedene Dienste aufgeteilt zu werden. Wenn Sie KI in Ihre Entwicklungsumgebung integrieren müssen, verbindet die GlobalGPT-CLI denselben Arbeitsbereich mit Ihrem Terminal und Ihren bestehenden Produktionswerkzeugen.

Probier mal Claude Opus 5 aus

Was ist die Claude-API?

Die Claude-API ist die Entwicklerschnittstelle von Anthropic, über die strukturierte Anfragen von einer Anwendung, einem Skript oder einem Backend-Dienst an Claude-Modelle gesendet werden können. Sie senden Nachrichten an einen HTTPS-Endpunkt und erhalten eine strukturierte Antwort, die generierte Inhalte sowie Metadaten wie das Modell, den Grund für den Abbruch und die Token-Nutzung enthält.

Claude API vs. Claude.ai-Abonnements

Der API-Zugang und die Claude.ai-Abonnements dienen unterschiedlichen Zwecken. Ein Claude.ai-Tarif gewährt einer Person Zugriff auf das Chat-Produkt von Anthropic. Bei der API handelt es sich um einen nutzungsabhängigen Entwicklerzugang über die Claude-Konsole, der separat nach Nutzung abgerechnet wird. Im Hilfe-Center von Anthropic heißt es, dass die Nutzung der Konsolen-API in Claude Pro nicht enthalten ist.

Wenn Sie einen umfassenderen Überblick über die Unterschiede zwischen Privatkunden-Tarifen, dem Claude-Code und der Token-Abrechnung benötigen, lesen Sie unseren vollständigen Claude-Preisliste. Für dieses Tutorial ist der wichtigste Punkt ganz einfach: Erstellen Sie das API-Konto und laden Sie Guthaben darauf, unabhängig von einem eventuellen Claude.ai-Abonnement.

Der fünfstufige Weg zur ersten Anfrage

1. Erstellen Sie einen API-Schlüssel in der Claude-Konsole.
2. Bewahren Sie es in der ANTHROPIC_API_KEY Umgebungsvariable.
3. Senden Sie eine Anfrage an https://api.anthropic.com/v1/messages.
4. Lies den zurückgegebenen Inhalt und Verwendung Objekt.
5. Multiplizieren Sie jede Token-Kategorie mit dem jeweils geltenden Satz pro Million Token.

Preise für die Claude-API und aktuelle Modell-IDs

Anthropic gibt die API-Preise in US-Dollar pro Million Token an, oft abgekürzt als MTok. Eingaben und Ausgaben werden separat abgerechnet. Beim Prompt-Caching gelten unterschiedliche Tarife für Schreibvorgänge im Fünf-Minuten-Takt, Schreibvorgänge im Ein-Stunden-Takt und Lesevorgänge aus dem Cache; daher sollten diese Kategorien bei einer zuverlässigen Schätzung getrennt betrachtet werden.

Aktuelle Modelle und genaue API-IDs

Welches Modell sollten Sie für dieses Tutorial verwenden?

Der offizielle Schnellstart wurde verwendet claude-opus-5 zum Zeitpunkt der Überprüfung dieses Leitfadens; daher verwenden die folgenden cURL- und Python-Beispiele dieselbe ID. Betrachten Sie Opus als Ausgangspunkt für das Tutorial und wählen Sie anschließend das Produktionsmodell entsprechend der Arbeitslast, den Qualitätsanforderungen, der Latenz und dem Budget aus. Modell-IDs und Lebenszyklusstatus können sich ändern. Überprüfen Sie daher die Seiten „Modelle“ und „Veraltete Funktionen“ erneut, bevor Sie langfristig einsetzbaren Code bereitstellen.

Was Sie vor Ihrer ersten Anfrage benötigen

Erstellen Sie ein Claude-Konsolenkonto und einen API-Schlüssel

Öffnen Sie die Claude-Konsole, erstellen oder wählen Sie die entsprechende Organisation aus und erstellen Sie einen API-Schlüssel. Anthropic weist darauf hin, dass ein neuer Schlüssel nur einmal angezeigt wird. Speichern Sie ihn daher sofort nach der Anzeige in einem zugelassenen Secret Manager oder an einem anderen sicheren Ort. Speichern Sie den Schlüssel nicht in einem Screenshot, einem freigegebenen Dokument, einem öffentlichen Repository oder in browserbasiertem JavaScript.

Speichern Sie den Schlüssel in einer Umgebungsvariablen

In den Beispielen wird die Variable ANTHROPIC_API_KEY. Geben Sie den tatsächlichen Wert ausschließlich in Ihrem privaten Terminal oder Ihrem System zur Verwaltung geheimer Daten ein. Der folgende Befehl liest den Wert ein, ohne ihn auf dem Bildschirm anzuzeigen, und exportiert ihn anschließend für die aktuelle Shell-Sitzung:

read -s ANTHROPIC_API_KEY
export ANTHROPIC_API_KEY

Umgebungsvariablen verringern das Risiko einer versehentlichen Offenlegung, stellen jedoch keine umfassende Strategie zur Verwaltung von Geheimnissen dar. Produktionsanwendungen sollten sich an die Richtlinien der Hosting-Plattform zur Speicherung von Geheimnissen und zur Zugriffskontrolle halten.

Rechnung prüfen und ein sicheres Testlimit festlegen

Die Abrechnung der API erfolgt getrennt von den Claude.ai-Abonnements. Laut Anthropic zahlen die meisten Unternehmen ihre Nutzungskredite im Voraus, während Unternehmen mit monatlicher Rechnungsstellung eine Ausnahme bilden. Vergewissern Sie sich, dass Ihr Konsolenkonto API-Anfragen stellen kann, und halten Sie die erste Anfrage dann klein, indem Sie max_tokens: 128. Dieses Feld begrenzt die generierte Ausgabe; es reserviert oder garantiert keine 128 abgerechnete Ausgabetoken.

Senden Sie Ihre erste Claude-API-Anfrage mit cURL

cURL eignet sich gut, um die Anfrage direkt einzusehen. Das folgende Beispiel verwendet den Endpunkt „Messages“, den Inhaltstyp JSON, den API-Schlüssel-Header, den Versions-Header von Anthropic, die verifizierte Quickstart-Modell-ID und eine Benutzernachricht.

Bevor Sie eines der Beispiele ausführen, fügen Sie Ihren eigenen API-Schlüssel hinzu und vergewissern Sie sich, dass die API-Abrechnung für die Organisation aktiviert ist. Der Code entspricht dem von Anthropic dokumentierten Anfrageformat und hat die lokalen Syntaxprüfungen bestanden; eine Antwort eines Live-Kontos ist hier jedoch nicht enthalten.

curl https://api.anthropic.com/v1/messages \
  --header "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --data '{
    "model": "claude-opus-5",
    "max_tokens": 128,
    "messages": [{
 "role": "user",
 "content": "Antworte mit einem Satz, der erklärt, was eine API ist."
    }]
  }'

Was die einzelnen Header und JSON-Felder bewirken

Wenn der Befehl einen Fehler zurückgibt, überprüfen Sie den HTTP-Status und die Fehlerart, bevor Sie die Anfrage ändern. Bei Authentifizierungs- und Abrechnungsfehlern muss das Konto korrigiert werden, während bei fehlerhaftem JSON oder einer ungültigen Modell-ID die Anfrage geändert werden muss.

Denselben Aufruf mit dem Python-SDK senden

Installieren Sie das offizielle Anthropic-SDK

python -m pip install anthropic

Verwenden Sie eine virtuelle Umgebung, wenn dies Teil Ihres üblichen Python-Arbeitsablaufs ist. Das SDK liest ANTHROPIC_API_KEY aus der Umgebung, wenn anthropic.Anthropic() wird ohne expliziten Schlüssel erstellt.

Führe den entsprechenden Python-Befehl aus

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-opus-5",
    max_tokens=128,
    messages=[
 {
 "role": "user",
 "content": "Antworte mit einem Satz, in dem du erklärst, was eine API ist.",
 }
    ],
)

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

print(message.usage)

Den zurückgegebenen Text sicher lesen

Eine Antwort auf eine Anfrage kann mehr als einen Inhaltsblock enthalten, daher überprüft das Beispiel den Typ jedes Blocks, bevor der Text ausgegeben wird. In realen Anwendungen sollte außerdem die Anfrage-ID für Supportzwecke und zur Protokollierung verfügbar gehalten werden, ohne sie öffentlich preiszugeben; außerdem sollten das zurückgegebene Modell und der Grund für den Abbruch protokolliert und API-Fehler explizit behandelt werden.

Behalten Sie die Überprüfung auf Inhaltsblöcke auch dann bei, wenn Sie eine kurze Textantwort erwarten. Dadurch lässt sich das Beispiel leichter erweitern, wenn eine Antwort mehrere Blöcke enthält, und die Ausgabe message.usage liefert Ihnen die Zahlen, die Sie für die nachstehende Kostenkalkulation benötigen.

So lesen Sie den Verbrauch ab und berechnen die Kosten

Ermitteln Sie den Antworttext, das Modell, den Grund für den Abbruch und die Anforderungs-ID

Der Antwortkontrakt der Messages-API umfasst generierte Inhalte, das Modell, das die Anfrage bearbeitet hat, sowie einen Abbruchgrund. Die HTTP-Antwort enthält außerdem eine Anfrage-ID, die dem Anthropic-Support bei der Fehlerbehebung helfen kann. Protokollieren Sie IDs sorgfältig; veröffentlichen Sie diese nicht zusammen mit Kundeninhalten oder Anmeldedaten.

Verwendung von Eingabe-, Ausgabe- und Cache-Token ermitteln

Die Verwendung Das Objekt meldet die für die Kostenanalyse erforderlichen Token-Kategorien. Achten Sie mindestens auf Eingabe- und Ausgabetoken. Wenn Prompt-Caching verwendet wird, sollten Sie Cache-Schreibvorgänge im 5-Minuten- und 1-Stunden-Takt sowie Cache-Lesevorgänge getrennt behandeln, da sie unterschiedliche Raten aufweisen. Der Endpunkt „Token Counting“ von Anthropic kann die Anzahl der Eingabetoken vor einer Anfrage schätzen, doch die Schätzung kann geringfügig von der tatsächlichen Eingabeverwendung abweichen und unterliegt eigenen Ratenbeschränkungen.

Die Token-Nutzung in geschätzte Kosten umrechnen

Berechnen Sie jede Kategorie separat und addieren Sie anschließend die Ergebnisse. In einem Planungsbeispiel unter Verwendung von Claude Opus 5 zu globalen Standardtarifen kosten 1.000 nicht zwischengespeicherte Eingabetoken 1.000 × $5 / 1.000.000 = $0,005, während 300 Ausgabetoken kosten 300 × $25 / 1.000.000 = $0,0075. Der geschätzte Gesamtbetrag beträgt $0.0125. Ersetzen Sie diese beispielhaften Token-Anzahlen durch die Verwendung Werte aus Ihrer eigenen Antwort.

Claude API-Preisrechner

Verwenden Sie den Rechner, um das Modell, die Anzahl der Anfragen, die Token-Kategorien, den Abrechnungsmodus und den geografischen Geltungsbereich für die Inferenz anzupassen. Bei der Stapelverarbeitung werden berechtigte Nutzungen mit 50% der Standardtarife abgerechnet. Bei Inferenz ausschließlich in den USA wird für alle Token-Kategorien bei berechtigten Claude 4.6+-Modellen ein Faktor von 1,1 angewendet; Claude Haiku 4.5 ist nicht berechtigt, sodass diese Kombination den Status „nicht unterstützt“ zurückgibt.

Der Kostenvoranschlag dient als Planungshilfe und stellt keine Rechnung dar. Nicht enthalten sind Steuern, Währungsumrechnungen, ausgehandelte Konditionen, der „Fast Mode“, Gebühren für Server-Tools sowie kontospezifische Bedingungen. Preise und Teilnahmebedingungen können sich ändern. Bitte überprüfen Sie daher die offizielle Preisseite noch einmal, bevor Sie eine Kauf- oder Architekturentscheidung treffen.

Der obige Rechner zeigt die Kostenentwicklung für programmierbare, nach Verbrauch abgerechnete Claude-API-Aufrufe. Für alltägliche Aufgaben, die mehrere Modelle und KI-Funktionen umfassen, GlobalGPT bietet einen ganz anderen Mehrwert: Ein einziges Abonnement vereint zahlreiche gängige Modelle und Tools in einem Dashboard, wodurch sich die Kosten leichter einschätzen lassen und gleichzeitig Recherche, Texterstellung, Programmierung und kreative Arbeit nicht auf separate Abonnements und verstreute Benutzeroberflächen verteilt werden. Die CLI erweitert diese Plattform auf die terminale Entwicklung und die Produktionswerkzeuge, die Sie bereits nutzen. Unser Leitfaden zu Arbeiten mit mehreren KI-Modellen an einem Ort zeigt, wie die gesamte Plattform ineinandergreift.

Häufige Claude-API-Fehler und deren Behebung

Beginnen Sie mit dem HTTP-Status und dem Fehlertyp „Anthropic“ und überprüfen Sie dann die Anfrage, ohne den Schlüssel offenzulegen. Die offizielle Bedeutung grenzt die Suche ein; die wahrscheinliche Ursache hängt jedoch weiterhin von Ihrem Konto, dem ausgewählten Modell, der Form der Anfrage und dem Datenverkehr ab.

Eine sichere Reihenfolge beim Debuggen

1. Erfassen Sie den Status, die Fehlerart, den Zeitstempel und die Anfrage-ID, ohne den API-Schlüssel zu protokollieren.
2. Überprüfen Sie den Endpunkt, die Header, die JSON-Syntax, die Modell-ID und die Begrenzung der Anfragegröße.
3. Überprüfen Sie die Abrechnung der Organisation, die Berechtigungen, die Header zur Ratenbegrenzung und den aktuellen Lebenszyklus des Modells.
4. Wiederhole nur die Fehler, bei denen vernünftigerweise davon ausgegangen werden kann, dass sie vorübergehend sind, und verwende dabei ein begrenztes exponentielles Backoff und Jitter.
5. Sollte der Fehler weiterhin auftreten, reduzieren Sie die Anfrage auf den kleinsten reproduzierbaren Fall, bevor Sie sich an den Support wenden.

Die offiziellen SDKs von Anthropic versuchen standardmäßig zweimal, Verbindungsfehler, 429-Antworten und 5xx-Antworten erneut zu bearbeiten. Die Wiederholungslogik auf Anwendungsebene erfordert jedoch weiterhin Begrenzungen und die Berücksichtigung der Idempotenz, insbesondere wenn eine Anfrage Tools oder eine andere externe Aktion auslösen kann.

So kontrollieren Sie die Kosten für die Claude-API

Konservative Ausgabegrenzwerte festlegen

Fang mit dem Kleinsten an max_tokens Wert, der dennoch zu einem brauchbaren Ergebnis führen kann. Messen Sie die tatsächliche Ausgabeverwendung, bevor Sie diese erhöhen. Kürzere Eingabeaufforderungen können helfen, doch das Entfernen von Anweisungen, die Wiederholungsversuche, Fehler oder unbrauchbare Ausgaben verhindern, kann insgesamt höhere Kosten verursachen.

Verwende Prompt-Caching und Batch nur, wenn sie geeignet sind

• Verwenden Sie das Prompt-Caching, wenn sich ein wesentlicher Teil des Prompt-Präfixes wiederholt und die Cache-Lebensdauer zum Workflow passt.
• Nutzen Sie „Batch“ für Aufgaben, die asynchron ausgeführt werden können; die Kosten für die zulässige Nutzung von „Batch“ belaufen sich auf 50% der Standardtarife.
• Trennen Sie Cache-Schreib- und Lesevorgänge in der Berichterstellung voneinander, damit die Einsparungen sichtbar werden und nicht nur angenommen werden.
• Verwenden Sie die ausschließlich auf die USA bezogene Inferenz nur dann, wenn die Wohnsitzvoraussetzung den Faktor von 1,1 des Token-Preises rechtfertigt und das ausgewählte Modell dafür in Frage kommt.

Nutzung, Ratenbegrenzungen und Ausgabenobergrenzen überwachen

Erfassen Sie die Anzahl der Anfragen, die Modell-ID, die Ein- und Ausgabennutzung, die Cache-Kategorien, Wiederholungsversuche und Fehler. Richten Sie Warnmeldungen oder Ausgabenkontrollen ein, die in Ihrer Organisation verfügbar sind, gehen Sie jedoch nicht davon aus, dass die Stufe oder das Limit eines anderen Kontos auch für Ihr Konto gilt. Unser ausführlicher Leitfaden zu Claude-Tarife, API-Kosten und Limits deckt die umfassenderen Abrechnungswege ab.

Die nächsten Schritte nach Ihrer ersten Anfrage

Wählen Sie den richtigen Weg für Ihr nächstes Projekt

Für eine Anwendung sollten Sie sich an die offizielle Referenz zur Messages-API von Anthropic, die Anleitungen zum Streaming, die Dokumentation zur Tool-Nutzung, die Seiten zum Modelllebenszyklus sowie Ihren eigenen Protokollierungs- und Auswertungsplan halten. Legen Sie eine Modellstrategie bewusst fest, beheben Sie Fehler, bevor Sie Datenverkehr hinzufügen, und berechnen Sie die Kosten anhand der beobachteten Nutzung und nicht allein anhand der Länge der Eingabeaufforderungen.

Wenn das Programmieren Ihr Hauptanwendungsfall ist, finden Sie in unserem Leitfaden zu Verwendung von Claude AI für die Codierung behandelt praktische Ansätze, wie man von einer interaktiven Programmieraufgabe zu einem wiederholbaren Entwickler-Workflow gelangt.

Wann ein Multi-Modell-Arbeitsbereich das bessere Werkzeug ist

Der direkte API-Zugriff ist die richtige Wahl, wenn Sie eine Integration auf Code-Ebene, eine Abrechnung für Entwickler, Metadaten zu Anfragen oder offizielle Plattformsteuerungsfunktionen benötigen. Wenn Sie interaktiv Texte verfassen, recherchieren, planen oder Ergebnisse verschiedener Anbieter vergleichen möchten, ohne eine eigene Anwendung zu entwickeln, ist ein multimodeller Arbeitsbereich möglicherweise die praktischere Lösung.

Häufig gestellte Fragen

Ist die Claude-API kostenlos?

Es wird hier kein allgemeines kostenloses API-Kontingent zugesichert. Die Nutzung der Claude-API wird separat über die Claude-Konsole abgerechnet, und laut Anthropic finanzieren die meisten Unternehmen die Nutzung mit Prepaid-Guthaben, während Unternehmen mit monatlicher Abrechnung eine Ausnahme darstellen. Bitte überprüfen Sie vor dem Absenden von Anfragen die aktuellen Informationen in der Konsole sowie die offiziellen Preisangaben für Ihr Unternehmen.

Wie erhalte ich einen Claude-API-Schlüssel?

Erstellen Sie in der Claude-Konsole einen Schlüssel für die entsprechende Organisation. Anthropic weist darauf hin, dass der neue Schlüssel nur einmal angezeigt wird. Bewahren Sie ihn daher sicher auf, sobald er erscheint. Laden Sie ihn über eine serverseitige Umgebungsvariable oder einen Secret-Manager und geben Sie ihn niemals im Browser-Code, in Screenshots oder in einem öffentlichen Repository preis.

Welche Claude-Modell-ID soll ich verwenden?

In diesem Tutorial wird Folgendes verwendet: claude-opus-5 denn dies war das Modell, das im offiziellen Quickstart von Anthropic bei der Überprüfung am 8. September 2026 aufgeführt war. Wählen Sie das Modell aus, das zu Ihrer Arbeitslast und Ihrem Budget passt, und überprüfen Sie die Seiten „Modelle“ und „Auslaufende Modelle“ von Anthropic noch einmal, da sich Modell-IDs, Aliase und der Lebenszyklusstatus ändern können.

Welchen Endpunkt verwendet die Claude-API?

Die erste Anfrage in dieser Anleitung nutzt den „Messages“-Endpunkt unter https://api.anthropic.com/v1/messages. Sie sendet JSON mit den Headern „content-type“, „x-api-key“ und „anthropic-version“. Anthropic bietet auch weitere API-Funktionen an. Nutzen Sie daher die Referenzseite für den Vorgang, den Sie implementieren möchten.

Sind im Claude Pro API-Guthaben enthalten?

Im Hilfe-Center von Nr. Anthropic heißt es, dass Claude Pro die Nutzung über die Claude-Konsole nicht umfasst. Ein Claude.ai-Abonnement und die API-Abrechnung sind separate Produkte. Richten Sie die API-Abrechnung in der Konsole für Entwickleranfragen ein und nutzen Sie unsere Claude-Preisliste für einen umfassenderen Vergleich der Tarife.

Wie viel kostet eine Claude-API-Anfrage?

Die Kosten hängen vom ausgewählten Modell, den Eingabe-Token, den Ausgabe-Token, den Cache-Schreibvorgängen, den Cache-Lesevorgängen, dem Batch-Modus und der zulässigen Inferenzregion ab. Berechnen Sie jede Kategorie, indem Sie die Anzahl der Anfragen mit der Anzahl der Token und dem effektiven Preis pro Million Token multiplizieren und das Ergebnis durch eine Million dividieren; addieren Sie anschließend die einzelnen Kategorien. Verwenden Sie den obenstehenden Rechner für eine Schätzung.

Warum erhalte ich einen 401-Fehler?

Ein 401 ist ein Authentifizierungsfehler. Vergewissern Sie sich, dass der API-Schlüssel vorhanden und aktiv ist, zur vorgesehenen Organisation gehört und den Server in der x-api-key Kopfzeile. Drucken Sie den Schlüssel während der Fehlersuche nicht aus und geben Sie ihn nicht weiter. Wiederholte Versuche beheben ein fehlendes oder ungültiges Anmeldedaten nicht.

Warum erhalte ich einen 429-Fehler?

Der Code 429 bedeutet, dass die Anfrage eine Ratenbegrenzung überschritten hat. Die Begrenzungen können je nach Organisation und Nutzungsstufe variieren. Überprüfen Sie daher die zurückgegebenen Ratenbegrenzungs-Header sowie die aktuelle Konsole oder Dokumentation. Reduzieren Sie die Anzahl gleichzeitiger Anfragen, halten Sie die Wartezeiten für Wiederholungsversuche ein und verwenden Sie einen begrenzten exponentiellen Backoff mit Jitter, anstatt denselben Burst sofort zu wiederholen.

Hinweis zu Herkunft und Frische: Modell-IDs, Preise, API-Verhalten und Supportrichtlinien wurden am 8. September 2026 anhand der offiziellen Dokumentation zu Anthropic überprüft. Sehen Sie sich vor dem Einsatz in der Produktion die aktuellen Modell- und Preisseiten an und führen Sie die Beispiele anschließend mit Ihrem eigenen Claude-Konsolenschlüssel, Ihren Abrechnungseinstellungen und Ihrem Kontozugang aus.