So betreiben Sie einen Claude Agent SDK Agenten auf WhatsApp (mit MonoChat)

Das Claude Agent SDK ist das Agent Harness von Anthropic: dieselbe Schleife aus Nachdenken, Tool-Nutzung und Selbstprüfung, die Claude Code antreibt, verpackt, damit Entwickler eigene Agenten bauen können. Um einen auf WhatsApp zu betreiben, brauchen Sie drei weitere Dinge: eine Verbindung zur WhatsApp Business Platform, einen Weg, dem Agenten Ihre Geschäfts-Tools zu geben, und einen sicheren Weg zu einem Menschen, wenn der Agent aufhören sollte. Mit dem Agent Harness von MonoChat fügen Sie das Claude Agent SDK als KI-Harness hinzu, setzen einen KI-Agent-Node in einen Flow, verbinden Ihre WhatsApp-Nummer und testen. Keine Server, die Sie betreiben müssen.

Dieser Leitfaden erklärt, was das Claude Agent SDK in Kundenunterhaltungen leistet, wie die Einrichtung in MonoChat funktioniert und worauf Sie achten sollten, bevor Kunden zu schreiben beginnen.

Was das Claude Agent SDK ist (und warum es für den Support passt)

Die meiste KI auf WhatsApp ist heute ein einzelner Modellaufruf: Eine Nachricht kommt an, das Modell schreibt eine Antwort, fertig. Das genügt für „Wie sind Ihre Öffnungszeiten?“. Bei „Meine Bestellung ist nicht angekommen, und ich verreise am Freitag“ stößt es an Grenzen.

Ein Harness führt das Modell in einer Schleife aus. Das Modell entscheidet, was als Nächstes zu tun ist, das Harness führt diesen Schritt aus (etwas nachschlagen, ein Tool aufrufen, eine Datei lesen), speist das Ergebnis zurück und wiederholt das, bis die Aufgabe erledigt ist oder eine Person gebraucht wird. Das Claude Agent SDK ist die Version dieser Schleife von Anthropic. Es ist die Grundlage von Claude Code und bringt die Bausteine mit, auf die Entwickler dort setzen: Tool-Nutzung, MCP-Unterstützung, Sub-Agenten, Kontextverwaltung für lange Sitzungen und Berechtigungskontrollen.

Im Kundenmessaging macht diese Schleife aus einer Antwort eine Lösung:

• Es prüft, bevor es etwas verspricht. Lagerbestand, Lieferstatus, Terminfenster oder eine Erstattungsregel werden im Moment der Antwort nachgeschlagen, statt geraten zu werden.
• Es bearbeitet einen Fall in mehreren Schritten. Die Bestellung finden, beim Paketdienst nachsehen, feststellen, dass das Paket festhängt, Ersatz anbieten, alles in einer Unterhaltung.
• Es weiß, wann es aufhören muss. Ein gutes Harness übergibt den Fall an eine Person, statt zu improvisieren, wenn es an die Grenze dessen kommt, was es darf.

Wenn Sie den Hintergrund zu Harnesses im Vergleich zu reiner Inferenz möchten, lesen Sie was ein Agent Harness ist und warum der WhatsApp-Support eines braucht.

Drei Wege, Claude-Agenten in MonoChat zu nutzen

MonoChat unterstützt drei Wege zu einem Claude-gestützten Agenten. Alle drei nutzen denselben KI-Agent-Node, dieselben Kanäle und dieselbe Übergabe.

Option	Wo es läuft	Was Sie brauchen
Claude Agent SDK	Agent Runner von MonoChat; jeder Durchlauf ist ein isolierter Agent-Prozess im Stil von Claude Code	Nichts extra; Ihre KI-Modelle über das Gateway von MonoChat
Claude Managed Agents	Cloud von Anthropic	Ihr Anthropic API-Schlüssel
Custom (Ihr eigener Claude Agent SDK Dienst)	Ihr eigener Server	Eine Endpunkt-URL und ein gemeinsames Secret

Für die meisten Teams ist die erste Option der richtige Start: Sie erhalten das Claude Agent SDK Harness, ohne etwas bereitzustellen oder zu warten. Wählen Sie Claude Managed Agents, wenn Sie bereits auf den gehosteten Agenten von Anthropic aufbauen und sie dort behalten möchten. Wählen Sie Custom, wenn Ihre Entwickler mit dem SDK einen eigenen Agenten gebaut und getestet haben und ihn weiter auf der eigenen Infrastruktur betreiben möchten; unser Leitfaden zum Anbinden Ihres eigenen KI-Agenten an WhatsApp behandelt diesen Weg.

Schritt für Schritt: ein Claude Agent SDK Agent auf WhatsApp

1. Ein KI-Harness hinzufügen

In MonoChat ist ein KI-Harness eine Dienstdefinition, die Sie einmal hinzufügen und wiederverwenden. Fügen Sie eines hinzu und wählen Sie Claude Agent SDK als Anbieter. Für den Anbieter selbst ist nichts weiter zu konfigurieren: Er läuft auf dem Agent Runner von MonoChat und erreicht Ihre KI-Modelle über das Gateway von MonoChat.

2. Einen KI-Agent-Node in einen Flow setzen

Öffnen Sie den Flow, der eingehende Unterhaltungen bearbeitet, oder erstellen Sie einen neuen, und fügen Sie einen KI-Agent-Node hinzu. Wählen Sie das soeben erstellte Harness aus. Hier bekommt der Agent seine Aufgabe: Schreiben Sie Anweisungen, die beschreiben, wen er betreut, was er darf und wann er übergeben muss.

3. Haupt-, Fallback- und Schnell-Modell wählen

Jeder KI-Agent-Node hat drei Modellrollen:

• Hauptmodell: denkt nach, entscheidet und schreibt die Antworten.
• Fallback-Modell: übernimmt nach einem Soft Limit oder wenn das Hauptmodell ausfällt, damit der Kunde trotzdem eine Antwort bekommt.
• Schnell-Modell: übernimmt Hintergrundaufgaben.

Legen Sie auch ein Budgetlimit pro Durchlauf fest. Eine Kundenunterhaltung braucht selten eine lange Schrittkette, und ein Budget verhindert, dass ein ungewöhnlicher Fall teuer wird. Unser Artikel warum Ihr Agent im Kundenkontakt ein Fallback-Modell braucht erklärt, wie Sie das Paar wählen.

4. Dem Agenten Tools geben

Ein Agent ohne Tools kann nur reden. In MonoChat kann der Agent Folgendes nutzen:

• KI-Funktionstools, um Ihre APIs mit strukturierten Eingaben aufzurufen, zum Beispiel „Bestellstatus abrufen“ oder „Retoure erstellen“.
• MCP-Server, um Tools aus jedem MCP-kompatiblen System einzubinden.
• Die KI-Wissensdatenbank für Antworten, die auf Ihren eigenen Richtlinien und Dokumenten beruhen.
• Custom Functions für Geschäftslogik, die innerhalb der Unterhaltung läuft.

Beginnen Sie mit zwei oder drei Tools, die Ihre häufigsten Anfragen abdecken. Jedes Tool, das Sie hinzufügen, ist eine Sache mehr, die der Agent tun kann, und eine mehr, die getestet werden muss.

5. WhatsApp und Ihre anderen Kanäle verbinden

Verbinden Sie Ihre WhatsApp Business Nummer mit MonoChat, falls noch nicht geschehen (MonoChat ist ein offizieller Meta Business Partner und nutzt die offizielle WhatsApp Business Platform). Da der Agent in einem Flow lebt, können Sie denselben Flow an Instagram, Messenger, TikTok, Telegram, Web-Chat, SMS und Voice anhängen, ohne etwas neu zu bauen.

6. Testen, dann live gehen

Senden Sie dem Agenten die Nachrichten, die Ihre Kunden tatsächlich schicken: kurz, mit Tippfehlern, in mehr als einer Sprache, drei Fragen in einer Nachricht. Prüfen Sie, ob er das richtige Tool nutzt, sich an Ihre Regeln hält und im richtigen Moment übergibt. Schalten Sie den Flow dann für echten Traffic ein.

Anweisungen für einen WhatsApp-Agenten schreiben

Das Claude Agent SDK ist im Coding groß geworden, wo lange, detaillierte Antworten willkommen sind. WhatsApp ist das Gegenteil. Ein paar Regeln machen einen großen Unterschied:

• Antworten kurz halten. Zwei oder drei Sätze pro Nachricht, jeweils eine Frage. Kunden lesen auf dem Smartphone.
• Vor dem Handeln bestätigen. „Ich kann Bestellung 4821 stornieren und €39 erstatten. Soll ich fortfahren?“ vor allem, was Geld kostet oder nicht rückgängig zu machen ist.
• Die Übergaberegel ausdrücklich nennen. Zum Beispiel: „Übergib an eine Person bei Beschwerden über Mitarbeiter, rechtlichen Drohungen, Erstattungen über €100 oder wenn der Kunde nach einem Menschen fragt.“
• Im Rahmen Ihres Unternehmens bleiben. Seit dem 15. Januar 2026 halten die Bedingungen von WhatsApp universelle KI-Assistenten von der Plattform fern. Ein Agent, der Ihre eigenen Kunden betreut, ist in Ordnung; einer, der Aufsätze zu beliebigen Themen schreibt, nicht. Unser Leitfaden zur WhatsApp KI-Chatbot-Richtlinie erklärt die Regel.
• Das 24-Stunden-Fenster beachten. Freie Antworten sind innerhalb von 24 Stunden nach der letzten Nachricht des Kunden erlaubt. Danach braucht eine Nachricht ein genehmigtes Template.

Übergabe: der Teil, der über Vertrauen entscheidet

Kunden verzeihen einem Agenten, der sagt „Ich hole einen Kollegen“. Sie verzeihen keinen, der sich im Kreis dreht. In MonoChat übergibt der Agent die Unterhaltung mit dem vollständigen Verlauf an Ihr Team im gemeinsamen Posteingang: was der Kunde gefragt hat, was der Agent nachgeschlagen hat und was er bereits versucht hat. Die Person, die übernimmt, muss den Kunden nicht bitten, von vorn zu beginnen.

Planen Sie Ihre Übergaberegeln, bevor Sie Ihre Tools planen. Entscheiden Sie, welche Fälle der Agent nie allein bearbeiten soll, wer sie erhält und was der Agent dem Kunden sagt, während er wartet.

Kosten und Kontrolle

Bei einem Agenten kommen zu Ihrem MonoChat Plan zwei Kostenpositionen hinzu: die Nutzung der KI-Modelle und die WhatsApp-Gebühren von Meta. Seit dem 1. Oktober 2026 berechnet Meta Service-Antworten nach den ersten 1.000 pro Geschäftsnummer und Monat; unser Leitfaden zu WhatsApp-API-Preisen enthält die Details.

Auf der KI-Seite erhebt MonoChat keinen Aufschlag, wenn Sie Ihre eigenen Anbieter-Schlüssel nutzen. Ein Budgetlimit pro Durchlauf, ein sinnvolles Fallback-Modell und ein Schnell-Modell für Hintergrundaufgaben halten die Nutzung bei wachsendem Volumen planbar.

Wann Sie ein anderes Harness wählen sollten

Das Claude Agent SDK ist eine starke Standardwahl für Agenten, die mehrere Schritte durchdenken müssen. Doch Agent Harness ist so gebaut, dass Sie nicht gebunden sind. Wenn Ihr Team bereits mit dem OpenAI Agents SDK, Pi, einem gehosteten OpenAI- oder Anthropic-Agenten oder einem eigenen Framework arbeitet, können Sie ein weiteres KI-Harness hinzufügen und den KI-Agent-Node umstellen, ohne Ihre Kanäle, Tools oder die Übergabe anzufassen. Alle Optionen sehen Sie auf der Agent Harness Seite.