So integrierst du die Claude API in deine App

Um die Claude API zu integrieren, erstellst du einen API-Schlüssel in der Claude Console von Anthropic, speicherst ihn als Geheimnis auf dem Server (meist ANTHROPIC_API_KEY) und rufst die Messages API von einer Route auf deinem eigenen Server aus auf, mit einem der offiziellen SDKs von Anthropic. Jede Anfrage nennt ein Modell, setzt max_tokens (die längste Antwort, die du akzeptierst) und schickt die Unterhaltung als messages. Deine Anweisungen stehen in einem separaten system-Prompt. Setze ein Ausgabelimit, streame lange Antworten und behandle Rate-Limit-Fehler (429) und Überlastungsfehler (529) mit Wiederholungsversuchen.

Dieser Leitfaden behandelt Einrichtung, einen sicheren Anfrageablauf, Prompts für einen KI-Baukasten und die Fehler, auf die du dich vorbereiten solltest. Die Angaben zu Anthropic stammen aus der Dokumentation von Anthropic, Stand September 2026. Wie Tokens und Preise allgemein funktionieren, erklärt So nutzt du LLM-APIs.

Was du damit bauen kannst

• Chat-Assistenten und Hilfe-Widgets (So baust du eine KI-Chatbot-App)
• Zusammenfassungen, Umformulierungen und Antwortentwürfe
• Extraktion von Feldern aus Dokumenten, E-Mails und Formularen
• Beantwortung von Fragen aus deinen eigenen Inhalten
• Agenten, die über Tool-Use Funktionen deiner App aufrufen

Weitere Ideen findest du unter So fügst du deiner App KI-Funktionen hinzu.

Die Messages API kurz erklärt

Laut der API-Referenz von Anthropic ist eine Anfrage ein POST an https://api.anthropic.com/v1/messages mit:

Die API ist zustandslos: Um eine Unterhaltung fortzusetzen, schickst du die bisherigen Beiträge bei jeder Anfrage erneut. Deshalb kostet eine lange Unterhaltung pro Nachricht mehr.

Anthropic bietet offizielle SDKs für Python, TypeScript, C#, Go, Java, PHP und Ruby. Sie setzen die Header, lesen die Antworten aus und unterstützen Streaming. Nutze sie statt roher HTTP-Aufrufe, außer du hast einen guten Grund dagegen.

Modell auswählen

Anthropic bietet mehrere Claude-Modelle, die Leistung gegen Geschwindigkeit und Preis abwägen, und das Angebot ändert sich. Wähle das kleinste Modell, das deine Aufgabe gut erledigt, teste es mit echten Beispielen und halte die Modell-ID in der Konfiguration, damit du ohne Codeänderung wechseln kannst. Aktuelle Optionen und Preise findest du auf den Seiten zu Modellen und Preisen von Anthropic.

Konto einrichten

1. Melde dich in der Claude Console auf platform.claude.com an und richte die Abrechnung ein.
2. Erstelle einen API-Schlüssel. Verwende je Umgebung (Test und Produktion) einen eigenen Schlüssel, damit du den einen widerrufen kannst, ohne den anderen zu gefährden.
3. Setze ein Ausgabelimit. Laut der Fehlerseite von Anthropic liefert die API einen 400-Fehler, wenn die Nutzung das von dir gesetzte Ausgabelimit erreicht. Deine App sollte in diesem Fall eine klare Meldung zeigen.
4. Prüf die Rate-Limits deines Kontos in der Console. Sie werden pro Organisation gemessen.

Der Anfrageablauf

1. Der Nutzer handelt in deiner App: Er sendet eine Nachricht oder klickt auf „Zusammenfassen“.
2. Der Browser ruft deine Serverroute auf, nie direkt Anthropic.
3. Dein Server prüft, ob der Nutzer angemeldet ist und die Funktion nutzen darf, und wendet ein Limit pro Nutzer an.
4. Er baut die Anfrage: einen System-Prompt mit deinen Regeln, die Eingabe des Nutzers und die Daten aus deiner Datenbank, die die Aufgabe braucht.
5. Er ruft die Messages API mit dem Schlüssel aus der Umgebung und einem sinnvollen max_tokens auf.
6. Er streamt die Antwort an den Browser und protokolliert den Tokenverbrauch aus der Antwort.

Optionen und Abwägungen

Prompts für deinen KI-Baukasten

Ein erstes Feature:

Füge ein Panel „Frag zu diesem Dokument“ hinzu. Es ruft eine Serverroute POST /api/ask auf, die prüft, ob der Nutzer angemeldet ist und das Dokument besitzt, und dann die Claude Messages API mit dem offiziellen Anthropic-SDK und dem Geheimnis ANTHROPIC_API_KEY aufruft. Lies die Modell-ID aus dem Geheimnis CLAUDE_MODEL. System-Prompt: „Beantworte nur anhand des bereitgestellten Dokuments. Steht die Antwort nicht darin, sag das.“ Sende den Dokumenttext und die Frage, setze max_tokens auf 800, streame die Antwort auf die Seite und gib den Schlüssel niemals an den Browser weiter.

Schutzmechanismen und Fehler:

Begrenze jeden Nutzer auf 20 Fragen pro Stunde, gespeichert in der Datenbank. Protokolliere die Eingabe- und Ausgabe-Tokens jeder Antwort zusammen mit Nutzer-ID und Anfrage-ID. Bei Fehlern 429 oder 529 wiederhole die Anfrage mit exponentiellem Backoff bis zu dreimal und beachte dabei einen retry-after-Header. Danach zeige „Der Assistent ist gerade ausgelastet, versuch es gleich noch einmal.“ Meldet die API ein Ausgabelimit, zeige „KI-Funktionen sind pausiert“ und benachrichtige den Admin.

Fehler, auf die du dich vorbereiten solltest

Aus der Fehlerdokumentation von Anthropic sind das die Fehler, mit denen deine App tatsächlich zu tun bekommt:

Laut der Dokumentation von Anthropic wiederholen die offiziellen SDKs vorübergehende Fehler (Verbindungsfehler, Rate-Limits und 5xx-Fehler) standardmäßig zweimal mit exponentiellem Backoff; das lässt sich konfigurieren. Jede Antwort enthält einen request-id-Header. Protokolliere ihn, damit der Support Probleme nachverfolgen kann.

Häufige Fehler

• Die API aus dem Browser aufrufen. Dein Schlüssel wird öffentlich. Geh immer über deinen Server. Siehe So schützt du API-Schlüssel.
• Vergessen, dass max_tokens eine Obergrenze und kein Ziel ist. Setze den Wert auf das, was die Funktion braucht. Zu niedrig schneidet Antworten ab, zu hoch riskiert lange, teure Antworten.
• Regeln in die Nutzernachricht schreiben. Dauerhafte Anweisungen gehören in den system-Prompt, Berechtigungen in deinen Code.
• Den gesamten Chatverlauf endlos mitschicken. Kürze oder fasse ältere Beiträge zusammen, wenn Unterhaltungen länger werden.
• Kein Ausgabelimit und keine Obergrenze pro Nutzer.
• Eine Modell-ID fest eincodieren. Modelle werden aktualisiert und abgekündigt.
• Den Stop-Grund ignorieren. Wenn die Antwort wegen max_tokens abbricht, sag es dem Nutzer oder erhöhe die Obergrenze.

Checkliste

• API-Schlüssel in der Claude Console erstellt und als Geheimnis auf dem Server gespeichert
• Getrennte Schlüssel für Test und Produktion
• Ausgabelimit gesetzt; klare Meldung, wenn es erreicht ist
• Alle Anfragen laufen über deinen Server mit Berechtigungsprüfung
• Der System-Prompt enthält die Regeln; die Modell-ID ist konfigurierbar
• max_tokens je Funktion gesetzt; lange Antworten gestreamt
• Rate-Limit pro Nutzer in deiner App
• 429 und 529 mit Backoff behandelt; Anfrage-IDs protokolliert
• Freundlicher Fehlerzustand, der die Seite nicht zerstört
• Mit leeren, sehr langen und feindseligen Eingaben getestet

Die Claude API in Mythex nutzen

In Apps, die du mit Mythex baust, nutzen Claude-Funktionen deinen eigenen Anthropic-Schlüssel, und die Kosten werden deinem Anthropic-Konto belastet, nicht den Mythex-Build-Credits. Das ist getrennt vom Mythex-Agenten, der deinen Code schreibt. Füge ANTHROPIC_API_KEY als Projektgeheimnis über /secrets, die Projekteinstellungen oder die Geheimnis-Karte im Chat hinzu, und beschreibe die Funktion mit Prompts wie den oben. Veröffentliche die App nach einer Änderung an Geheimnissen erneut, wenn sie live ist. Eine Einführung mit Startprompt findest du im Rezept KI-Funktionen mit deinen eigenen API-Schlüsseln hinzufügen. Wenn du zwischen Anbietern vergleichst, behandelt So integrierst du die OpenAI API dasselbe für OpenAI.

Fragen