Claude Code ist eine Schleife: Es bearbeitet Dateien, führt Befehle in Ihrem Terminal aus, liest die Ausgabe und entscheidet, was als Nächstes zu tun ist. Warum sind Ihre API-Tests nicht Teil dieser Schleife? Sie sitzen in Apidog hinter einer GUI und werden ausgeführt, wenn sich jemand daran erinnert, zu klicken. Ihr Agent rührt sie nie an.
Die Lösung ist ein einziger Konfigurationsblock. Die Apidog CLI ist ein npm-Paket, apidog-cli, das die in Apidog erstellten Testszenarien direkt von einem Terminal ausführt. Sobald die CLI installiert ist und Claude Code weiß, dass sie existiert, führt Ihr Agent ein Apidog-Szenario auf die gleiche Weise aus, wie er Ihre Komponententests ausführt: Befehl auslösen, Exit-Code lesen, den Code korrigieren, falls er rot ist.
Dieser Leitfaden behandelt den Claude Code-spezifischen Teil, den die allgemeine Installationsanleitung überspringt: die genaue Zeile für Ihre CLAUDE.md, wie Claude Code apidog run unter seinem Berechtigungsmodell ausführt und wie das Ergebnis innerhalb seiner eigenen Editier-Test-Korrektur-Schleife gelesen wird.
Wenn Sie die CLI noch nicht installiert haben, tun Sie dies zuerst. So installieren Sie die Apidog CLI mit einem KI-Coding-Agenten führt Sie durch die npm-Installation und den ersten Lauf, wobei der Agent die Eingaben vornimmt. Dieser Artikel geht davon aus, dass apidog --version eine Nummer ausgibt und Ihr Apidog-Konto authentifiziert ist.
Um welchen Claude Code es hier geht
Dies ist die Claude Code CLI, Anthropic's Coding-Agent, der in Ihrem Terminal (oder Ihrer Desktop-App) läuft. Er liest Ihr Repository, bearbeitet Dateien und führt Shell-Befehle aus, wobei er je nach Ihrem Berechtigungsmodus um Genehmigung bittet. Es ist nicht die Claude Chat-App und kein einfacher API-Aufruf. Wenn Sie claude in einem Repository ausführen und einen interaktiven Agenten erhalten, der Bearbeitungen und Befehlsausführungen vorschlägt, sind Sie hier richtig. Die Befehle, die Sie für das Terminal schreiben, befinden sich in Ihren Claude Code Schrägstrich-Befehlen und ihrer Regelsdatei, und in dieser Regelsdatei gehört die Apidog CLI hinein.
Die Unterscheidung ist wichtig, weil Claude Code eine eigene Art hat, Projektregeln zu lernen, und dieser Mechanismus ein einmaliges „Meine Tests ausführen“ in etwas verwandelt, das Claude von selbst aufruft. Dieser Mechanismus ist CLAUDE.md.
Schritt 1: Den Apidog-Block zu CLAUDE.md hinzufügen
Claude Code liest CLAUDE.md-Dateien zu Beginn jeder Sitzung. Dies ist das direkte Gegenstück zu AGENTS.md für Codex; tatsächlich weisen die Anthropic-Dokumente darauf hin, dass Claude Code CLAUDE.md liest, nicht AGENTS.md, und schlagen vor, eine vorhandene AGENTS.md mit @AGENTS.md zu importieren, falls Sie eine für einen anderen Agenten verwenden. Wenn Sie die Apidog CLI bereits in Codex eingerichtet haben, ist dies die gleiche Idee mit einem anderen Dateinamen.
Platzieren Sie eine CLAUDE.md im Stammverzeichnis Ihres Repositorys (Claude Code akzeptiert auch ./.claude/CLAUDE.md und eine globale ~/.claude/CLAUDE.md für persönliche Standardeinstellungen). Claude Code durchläuft den Verzeichnisbaum von dem Ort aus, an dem Sie es gestartet haben, und lädt jede gefundene CLAUDE.md, sodass eine Datei im Repo-Stammverzeichnis jede Sitzung erreicht. Fügen Sie einen kurzen Block wie diesen hinzu:
## API-Tests mit Apidog CLI
Dieses Projekt enthält Apidog-Testszenarien. Um die API zu überprüfen, führen Sie Folgendes aus:
`apidog run -t <scenario_id> -e <env_id> -r cli`
- Exit-Code 0 bedeutet, dass jede Assertion bestanden wurde. Ungleich Null bedeutet, dass etwas fehlgeschlagen ist; öffnen Sie den Bericht und beheben Sie den Fehler, bevor Sie fortfahren.
- Die Maschine ist bereits über `apidog login` authentifiziert. Fügen Sie niemals ein `--access-token` Flag hinzu und speichern Sie niemals ein Token in dieser Datei.
- Wenn ein Flag unbekannt ist, führen Sie `apidog run --help` aus und verwenden Sie das genaue Flag von dort.
Deshalb schreiben Sie die CLI in CLAUDE.md, anstatt sie im Chat zu erwähnen. Eine in eine Sitzung eingegebene Szenario-ID ist verschwunden, wenn diese Sitzung endet. Eine in CLAUDE.md ist von nun an für jeden Teamkollegen und jeden Claude Code-Lauf vorhanden. Die Datei wird beim Start vollständig geladen und überlebt einen /compact, sodass die Anweisung für die gesamte Sitzung aktiv bleibt.
Schritt 2: Den Befehl von Apidog erhalten
Die <scenario_id> und <env_id> in diesem Block sind keine Werte, die Sie erraten. Öffnen Sie Ihr Testszenario in Apidog, gehen Sie zum CI/CD-Tab und kopieren Sie den generierten apidog run ... Befehl. Dieser enthält bereits die echte Szenario-ID, die Umgebungs-ID und den -r cli Reporter. Fügen Sie diese genauen IDs in Ihren CLAUDE.md-Block ein.
Der -r cli-Reporter druckt ein Schritt-für-Schritt-Ergebnis und eine Zusammenfassung direkt im Terminal aus, was genau die Ausgabe ist, die Claude Code liest, um seinen nächsten Schritt zu bestimmen. Für eine vollständige Aufschlüsselung aller Flags, siehe den vollständigen Apidog CLI-Leitfaden und die apidog run Befehlsreferenz.
Schritt 3: Claude Code den Test ausführen lassen
Nachdem der Block platziert ist, starten Sie Claude Code in Ihrem Repo:
claude
Claude Code lädt CLAUDE.md beim Start, sodass es bereits weiß, dass die CLI vorhanden ist. Nehmen Sie eine Änderung vor, die Ihre API betrifft, oder bitten Sie es einfach, die Überprüfung durchzuführen. Claude Code gibt den apidog run-Befehl aus Ihrer CLAUDE.md aus.
Hier kommt das Berechtigungsmodell ins Spiel. Im Standardmodus fragt Claude Code nach, bevor es einen Shell-Befehl ausführt, der noch nicht genehmigt wurde. Genehmigen Sie den apidog run-Befehl, wenn Sie dazu aufgefordert werden. Um nicht mehr nach einem Befehl gefragt zu werden, dem Sie vertrauen, fügen Sie eine Berechtigungsregel hinzu, damit die CLI ohne Aufforderung ausgeführt wird: Führen Sie /permissions innerhalb der Sitzung aus oder fügen Sie eine Zulassungsregel für Bash(apidog run *) in .claude/settings.json hinzu. Ein schreibgeschütztes Testszenario gegen Staging ist ein sicherer Befehl für die Whitelist. Für unbeaufsichtigte Ausführungen gibt es --dangerously-skip-permissions, das Aufforderungen vollständig überspringt; verwenden Sie dies für CI, nicht für Ihren täglichen Gebrauch.
Sie möchten sehen, wie der Lauf ausgeführt wird und wie Claude Code sowohl die Zusammenfassung als auch den Exit-Code zurückmeldet, nicht nur einen Satz, der Erfolg behauptet.
Schritt 4: Den Bericht in Claude Code lesen
Wenn ein Lauf fehlschlägt (rot wird), enthält der Bericht die Antwort. Mit -r cli erhält Claude Code eine lesbare Aufschlüsselung im Terminal: jede Anfrage, jede Assertion und welche davon mit erwartetem versus tatsächlichem Wert fehlgeschlagen ist. Die fehlschlagende Assertion benennt das genaue Feld oder den Statuscode, was normalerweise ausreicht, damit Claude Code die Korrektur findet.
Für einen Bericht, den Sie in einem Browser öffnen oder einem Teamkollegen übergeben können, fügen Sie den HTML-Reporter hinzu:
apidog run -t <scenario_id> -e <env_id> -r cli,html
Der html-Reporter schreibt eine eigenständige Datei nach ./apidog-reports. Behalten Sie cli in der Liste, damit Claude Code weiterhin die Inline-Ausgabe erhält, die es liest, um seinen nächsten Schritt zu bestimmen. Für das JUnit-Format, das CI-Dashboards parsen, und die anderen Reporter, siehe Apidog CLI Testberichte.
Claude Code-Tests innerhalb seiner eigenen Schleife
Der springende Punkt ist, was passiert, wenn Sie aufhören zu fragen und Claude Code das Szenario von selbst ausführt, weil CLAUDE.md es ihm gesagt hat.
Stellen Sie sich vor, Claude Code bearbeitet einen Handler, der eine Checkout-Antwort erstellt. Seine Schleife ändert sich: Es bearbeitet den Code, führt dann, anstatt den Erfolg zu verkünden, Ihr Apidog-Szenario gegen Staging aus, liest den Exit-Code und handelt danach. Grün, es geht weiter. Rot, es öffnet den Bericht, liest, welche Assertion fehlgeschlagen ist (den Statuscode, das fehlende Feld, den falschen Wert), versucht eine Korrektur und führt es erneut aus. Der API-Test wird Teil derselben Editier-Test-Korrektur-Schleife, durch die Claude Code bereits Ihre Komponententests führt. Sie haben eine Anweisung geschrieben, und Claude hat den Befehl in seine Funktionsweise integriert.
Dies ist das Delegieren-dann-Verifizieren-Modell, das jeden Agenten-Workflow sicher macht. Claude Code führt den Befehl aus und liest das Ergebnis; Sie erstellen weiterhin Szenarien visuell in Apidog und überprüfen stichprobenartig, ob der Agent Exit-Codes ehrlich liest. Für das breitere Muster, siehe wie man KI-Agenten für API-Tests verwendet und das Apidog AI Test Harness.
Überprüfen Sie, ob Claude Code die CLI tatsächlich ausführt
Agenten melden Erfolge, die sie nicht verdient haben, und Claude Code ist da keine Ausnahme. Drei Überprüfungen, in der Reihenfolge, wie oft sie Probleme aufdecken.
Zuerst bestätigen Sie, dass der Befehl überhaupt ausgeführt wurde. Claude Code zeigt die ausgeführten Befehle und deren Ausgabe inline an. Suchen Sie nach der wörtlichen Zeile apidog run ... und einem Ergebnis darunter. Wenn Claude sagt, es hätte die Tests ausgeführt, Sie aber den Befehl nicht sehen, hat es etwas zusammengefasst, was es nie getan hat. Bitten Sie es, es erneut auszuführen und die Rohausgabe anzuzeigen.
Zweitens, bestätigen Sie den Exit-Code, den der wichtig ist. Fragen Sie direkt: „Was war der Exit-Code dieses apidog run Befehls?“ apidog run beendet mit 0, wenn jede Assertion bestanden wurde, und mit ungleich Null, wenn etwas fehlschlägt. Dieses einzelne Verhalten ermöglicht es Claude Code oder einer Pipeline, den Lauf als sauberes Gate zu behandeln. Wenn Claudes Prosa besagt „Tests bestanden“, aber der Exit-Code ungleich Null ist, ist der Exit-Code korrekt.
Drittens, bestätigen Sie, dass es das reale Szenario verwendet hat. Wenn ein Lauf mit „Szenario nicht gefunden“ fehlschlägt, hat Claude möglicherweise eine ID erfunden oder falsch erinnert. Überprüfen Sie die Werte -t und -e erneut mit CLAUDE.md und dem Befehl, den Apidog im CI/CD-Tab generiert hat. Die IDs in CLAUDE.md sind die Wahrheit.
Optional: Den Apidog MCP-Server verbinden
Das Ausführen von apidog run aus CLAUDE.md deckt das meiste ab, was Sie benötigen. Um einen Schritt weiter zu gehen, verbinden Sie einen MCP-Server, damit Claude Code Ihre API-Spezifikation lesen kann, während es Code schreibt, und nicht nur nachträglich testet.
Claude Code unterstützt das Model Context Protocol. Sie fügen einen Server mit claude mcp add ... hinzu oder indem Sie eine .mcp.json-Datei in Ihrem Projekt-Stammverzeichnis committen und --scope project wählen, damit das gesamte Team darauf zugreifen kann. Der Apidog MCP-Server stellt Ihre API-Spezifikationen über MCP bereit, sodass Claude Ihr Schema beim Codieren liest. Stellen Sie es sich als Arbeitsteilung vor: Die CLI führt die Tests aus, MCP füttert den Agenten mit der Spezifikation.
Wenn Claude Code Fehler macht
Einige Fehler treten während der Einrichtung häufig auf.
Es ignoriert den CLAUDE.md-Block. Wenn Claude einen generischen Befehl oder gar keinen ausführt, wird der Block möglicherweise nicht geladen. Bestätigen Sie, dass die Datei genau CLAUDE.md heißt und sich im Stammverzeichnis Ihres Repositories oder in einem übergeordneten Verzeichnis Ihres aktuellen Verzeichnisses befindet. Führen Sie /memory innerhalb der Sitzung aus, um die Dateien aufzulisten, die Claude tatsächlich geladen hat; wenn Ihre Datei nicht dabei ist, kann Claude sie nicht sehen. Das Neustarten der Sitzung erzwingt ein erneutes Laden.
Es übergibt trotzdem ein Zugriffstoken. Wenn Claude versucht, --access-token hinzuzufügen, rät es von öffentlichen Beispielen. Der Block weist es bereits an, dies nicht zu tun, da die Maschine über apidog login authentifiziert ist. Verstärken Sie diese Zeile und legen Sie niemals ein echtes Token in CLAUDE.md ab. Wie die Maschine einmal authentifiziert wird, siehe Apidog CLI Authentifizierung.
Es erfindet ein Flag. Ein „unbekannte Option“-Fehler bedeutet, dass Claude ein Flag geraten hat, das Ihre Version nicht besitzt. Sagen Sie ihm, es soll apidog run --help ausführen und das genaue Flag von dort kopieren, welches immer für Ihre installierte Version korrekt ist.
Es meldet einen Erfolg bei einem fehlgeschlagenen Lauf. Dies ist der kostspieligste Fehler und der Grund, warum die Exit-Code-Regel in Ihrer CLAUDE.md und Ihrem Verifizierungsschritt steht. Wenn die Zusammenfassung und der Exit-Code nicht übereinstimmen, gewinnt der Exit-Code.
Vom täglichen Agenten zur getesteten Schleife
Das ist die Einrichtung. Installieren Sie apidog-cli einmal gemäß der Installationsanleitung, fügen Sie einen kurzen Apidog-Block zur CLAUDE.md Ihres Repositories hinzu, und Claude Code weiß, wie es Ihre API-Tests ausführt und das Ergebnis innerhalb derselben Schleife liest, die es bereits zum Bearbeiten von Code verwendet. Ein fehlerhafter Endpunkt wird entdeckt, während Claude noch an der Änderung arbeitet, nicht erst, nachdem sie ausgeliefert wurde.
Ein Test hinter einer GUI wird ausgeführt, wenn ein Mensch klickt; ein einzeiliger Befehl wird ausgeführt, wann immer Claude es entscheidet. Sie erstellen weiterhin Szenarien visuell in Apidog, und Ihr Agent führt sie aus, wo Sie nicht zusehen. Laden Sie Apidog herunter, erstellen Sie ein Szenario, fügen Sie dessen apidog run-Befehl in CLAUDE.md ein und beobachten Sie, wie Claude ihn bei der nächsten Änderung aufnimmt. Wenn Sie bereit sind, denselben Befehl in einer Pipeline ohne Claude auszuführen, behandelt Apidog CLI in GitHub Actions die Geheimnisse, Reporter und Exit-Code-Gating.