Claude-API Einstieg: Erste Schritte mit der Anthropic-Schnittstelle

Der Claude-API Einstieg führt über die Anthropic Console: Dort legen Sie ein Konto an, hinterlegen Guthaben und erzeugen einen API-Schlüssel. Danach genügt ein kurzes Skript, um mit der Messages-Schnittstelle die erste Antwort von Claude zu bekommen.

Vorbereitung in der Console

1. Konto anlegen und eine Organisation einrichten. Für Teams lassen sich Arbeitsbereiche (Workspaces) mit eigenen Schlüsseln und Limits anlegen.
2. Guthaben aufladen und ein Ausgabenlimit setzen, damit ein Fehler im Code nicht teuer wird.
3. API-Schlüssel erstellen und in der Umgebungsvariable ANTHROPIC_API_KEY ablegen.
4. SDK installieren: pip install anthropic oder npm install @anthropic-ai/sdk.

Die erste Nachricht

import anthropic

client = anthropic.Anthropic()  # liest ANTHROPIC_API_KEY

nachricht = client.messages.create(
    model="MODELL-ID",
    max_tokens=1024,
    system="Du antwortest knapp und auf Deutsch.",
    messages=[{"role": "user", "content": "Was ist ein Kontextfenster?"}],
)
print(nachricht.content[0].text)

Zwei Punkte fallen gegenüber anderen Anbietern auf: Der Parameter max_tokens ist Pflicht, und der Systemprompt wird als eigenes Feld übergeben, nicht als Nachricht in der Liste. Die Antwort besteht aus Inhaltsblöcken; bei reinem Text steht er im ersten Block. Die aktuellen Modell-IDs stehen in der Dokumentation von Anthropic. Fertige Anfragen für curl, Python und JavaScript erzeugt der API-Anfrage-Generator.

Welches Modell für den Anfang?

Anthropic bietet drei Größenklassen an: Haiku für schnelle, günstige Aufgaben, Sonnet als Allrounder und Opus für besonders anspruchsvolle Arbeit. Für die meisten Entwicklungsprojekte ist Sonnet ein guter Startpunkt; für Massenaufgaben wie Klassifizieren lohnt der Test mit Haiku. Die aktuellen Preise in Euro:

Listenpreise Stand 07.10.2026, umgerechnet zum EZB-Kurs vom 07.10.2026.

Eine ausführliche Rechnung mit Beispielen enthält der Ratgeber Claude-API-Kosten; einen Vergleich der Stärken finden Sie unter Modell-Stärken.

Kosten früh im Griff behalten

• Prompt Caching: Lange, gleichbleibende Teile wie Systemprompt oder Dokumente lassen sich zwischenspeichern; gelesene Cache-Tokens kosten nur einen Bruchteil. Details unter Prompt Caching erklärt.
• Batch-Verarbeitung: Aufträge ohne Zeitdruck lassen sich gesammelt und günstiger abarbeiten.
• max_tokens bewusst setzen: Ein passendes Limit verhindert ausufernde Antworten; der Max-Tokens-Rechner hilft bei der Wahl.

Weiterführende Funktionen

Über die Messages-Schnittstelle lassen sich Bilder und PDFs mitsenden, Werkzeuge definieren (Tool Use) und Antworten streamen. Wer Claude mit eigenen Datenquellen verbinden will, sollte sich das Model Context Protocol ansehen: MCP erklärt. Wie aus einzelnen Aufrufen ein Agent mit Werkzeugschleife wird, zeigt KI-Agenten programmieren.

Häufige Fehler beim Start

• Verlauf vergessen: Die API merkt sich nichts. Für ein Gespräch müssen Sie die bisherigen Nachrichten bei jedem Aufruf erneut mitsenden.
• Rollen falsch abwechseln: Nachrichten von Nutzer und Assistent sollten sich abwechseln; der Systemprompt gehört in das eigene Feld.
• Abgeschnittene Antworten übersehen: Endet eine Antwort, weil max_tokens erreicht wurde, gibt das Feld für den Stoppgrund darüber Auskunft. Prüfen Sie es, bevor Sie ein Ergebnis weiterverarbeiten.
• Überlastung nicht abfangen: Bei Fehlern wegen Überlastung oder Rate-Limits mit Wartezeit wiederholen. Das SDK erledigt einfache Wiederholungen bereits selbst.

Datenschutz bei der API

Für den geschäftlichen Einsatz mit personenbezogenen Daten brauchen Sie einen Vertrag zur Auftragsverarbeitung. Welche Punkte dabei zu prüfen sind, fasst der Ratgeber Auftragsverarbeitung bei KI-Anbietern zusammen. Das ist keine Rechtsberatung; im Zweifel sollte die Datenschutzbeauftragte oder der Datenschutzbeauftragte mitprüfen.