SMS-Verifizierungs-API mit Claude Code nutzen: Einrichtungsanleitung

Claude Code baut die SMS-Verifizierung selbst in dein Projekt ein: mit dem Skill für die SMS Activate App API und deinem API-Key in einer Umgebungsvariablen.

Claude Code kann die SMS-Verifizierung selbst in dein Projekt einbauen: Gib ihm den Skill für die SMS Activate App API, lege deinen API-Key in einer Umgebungsvariablen ab und prüfe jeden Schritt, der Geld kostet.

Mit dieser Anleitung richtest du das in etwa zehn Minuten ein. Das funktioniert genauso mit Codex, Cursor oder jedem anderen Coding-Agenten, der Dateien liest und Befehle ausführt.

Was der Agent mit der API tun kann

Mit einem Key kann ein Coding-Agent alles tun, was auch dein eigener Code kann:

  • Live-Nummern in einem Land suchen und deinen Preis sehen.
  • Eine private Nummer für 28 Tage kaufen, mit einem Idempotency-Key, damit ein erneuter Versuch dein Guthaben nie doppelt belastet.
  • Die eingehenden SMS lesen, ebenso die Anrufe: Seit November 2026 kommt ein kurzer Anruf mit seinem Text und dem darin vorgelesenen Code.
  • Eine Nummer freigeben oder ihre Verlängerung ausschalten.
  • Einen Webhook einrichten, damit Codes ohne Polling bei deinem Server ankommen.

Typische Aufgaben, die du dem Agenten übertragen kannst: ein End-to-End-Test deines Registrierungsablaufs, ein Helfer, der in der CI auf einen Code wartet, oder ein Webhook-Empfänger mit Signaturprüfung.

Schritt 1: Key erstellen und aus dem Code heraushalten

  • Erstelle auf der Registrierungsseite ein Konto und lade Guthaben auf.
  • Erstelle einen persönlichen API-Key im Tab „API-Keys“ deines Kontos oder im Telegram-Bot.
  • Lege den Key in deiner Shell oder im Secret-Store deines Projekts ab, nie in einer Datei, die der Agent committet:

Der Key verbraucht dein Guthaben. Claude Code liest die Variable, wenn es einen Befehl ausführt, und muss den Wert nicht im Chat sehen. Landet der Key doch einmal in einer Datei, einem Commit oder einem Log, widerrufe ihn in deinem Konto und erstelle einen neuen.

Schritt 2: Claude Code den Skill geben

Die Website veröffentlicht eine fertige Skill-Datei für Coding-Agenten unter /api-skill.md. Sie nennt die Basis-URL, die Routen, die Limits und die Fehler, die du behandeln musst. Speichere sie als Projekt-Skill:

Claude Code lädt einen Skill, wenn eine Aufgabe zu seiner Beschreibung passt, zum Beispiel „warte in meinem Registrierungstest auf den SMS-Code“. Committe die Skill-Datei, wenn dein Team sie teilen soll. Sie enthält keinen Key.

Dein Agent unterstützt keine Skills? Öffne die API-Dokumentation und klicke auf den Button, der den Agenten-Prompt kopiert. Er enthält dieselben Regeln in einem Textblock, den du in jeden Chat einfügen kannst.

Schritt 3: Hausregeln festlegen

Füge der CLAUDE.md deines Projekts ein paar Zeilen hinzu, damit jede Sitzung sie befolgt:

Die zweite Regel ist die wichtigste. Ein Kauf ist endgültig und nicht erstattbar, sobald eine Nummer vergeben ist, deshalb sollte ein Mensch jeden Kauf sehen, bevor er passiert. Claude Code fragt um Erlaubnis, bevor es einen Befehl ausführt. Lass das für Befehle eingeschaltet, die die Kaufroute aufrufen.

Schritt 4: Eine Aufgabe stellen

Bitte um das Ergebnis, nicht um die einzelnen Aufrufe. Zum Beispiel:

Füge eine pytest-Fixture hinzu, die über die SMS Activate App API eine US-Nummer mietet, bis zu fünf Minuten auf eine SMS an diese Nummer wartet und den Code zurückgibt. Verwende über alle Läufe hinweg eine sich verlängernde Nummer, statt jedes Mal eine neue zu kaufen.

So sieht ein gutes Ergebnis aus:

  • Es sucht mit GET /v1/public/numbers/search?country=US und zeigt dir die Nummer und ihren Preis, bevor es kauft.
  • Es kauft mit POST /v1/public/numbers und einem Idempotency-Key.
  • Es fragt GET /v1/public/numbers/{id}/sms alle 5 bis 15 Sekunden mit einem Timeout ab oder richtet einen Webhook ein.
  • Es behandelt insufficientbalance, numberunavailable und rate_limited als Antworten, nicht als Abstürze.

Rät der Agent eine Route, die nicht im Skill steht, verweise ihn auf die OpenAPI-Datei und bitte ihn, sie zu prüfen.

Schritt 5: Vor dem Merge prüfen

Bevor du mergst, was der Agent geschrieben hat, prüfe vier Dinge:

  • Kein Key im Diff, in der Testausgabe oder in den CI-Logs.
  • Jeder Kauf sendet einen Idempotency-Key, und ein erneuter Versuch verwendet ihn wieder.
  • Jedes Warten hat ein Timeout und eine klare Fehlermeldung, die die Nummer nennt.
  • Der Test kauft nicht bei jedem Lauf eine neue Nummer, wenn eine sich verlängernde Nummer genügt.

Kosten, die du kennen solltest

Jede Nummer wird für 28 Tage zu dem Preis gemietet, den die Suche zeigt, und verlängert sich vom Guthaben, solange die automatische Verlängerung aktiv ist. Seit November 2026 werden auch eingehende Anrufe (pro Minute) und SMS auf einer Nummer dem Guthaben belastet, und zwar zu einem Preis pro Land, den die API als usagePricing zurückgibt. Sieh dir die aktuellen Zahlen unter Preise an, bevor du einen Agenten eine Testsuite nach Zeitplan ausführen lässt.

Wann du sie nicht nutzen solltest

Die API empfängt SMS und Anrufe, sie sendet keine. Nutze sie für deine eigenen Apps, Konten und Tests. Ob die Plattform, bei der du dich verifizierst, eine Nummer akzeptiert, entscheidet sie selbst und nicht wir. Prüfe eine Nummer deshalb mit deinem Zieldienst, bevor du eine Pipeline darauf aufbaust: So prüfst du eine Nummer, bevor du sie mietest.

Nächste Schritte