Cline ist eine Schleife: Sie plant eine Änderung, bearbeitet Dateien, führt Befehle aus, liest die Ausgabe und entscheidet, was als Nächstes zu tun ist. Warum sind Ihre API-Tests dann nicht in dieser Schleife? Sie sitzen in Apidog hinter einer GUI und warten darauf, dass sich jemand daran erinnert, zu klicken. Ihr Agent berührt sie nie.
Die Lösung ist ein Konfigurationsblock. Die Apidog CLI ist ein npm-Paket, apidog-cli, das die in Apidog erstellten Testszenarien direkt von einem Terminal aus ausführt. Sobald die CLI installiert ist und Cline weiß, dass sie existiert, führt Ihr Agent ein Apidog-Szenario auf dieselbe Weise aus wie Ihre Unit-Tests: Befehl abfeuern, Exit-Code lesen, den Code korrigieren, falls er rot zurückkommt.
Wenn Sie die CLI noch nicht installiert haben, tun Sie das zuerst. So installieren Sie die Apidog CLI mit einem KI-Code-Agenten führt Sie durch die npm-Installation, Authentifizierung und den ersten Lauf, wobei Cline die Eingabe übernimmt. Dieser Artikel geht davon aus, dass apidog --version eine Zahl ausgibt und Ihr Apidog-Konto authentifiziert ist.
Um welche Cline es hier geht
Cline ist der quelloffene autonome Code-Agent, der als VS Code-Erweiterung läuft (es gibt auch einen JetBrains-Build und eine CLI). Er liest Ihr Repository, plant im Plan-Modus und wechselt dann in den Act-Modus, um Dateien zu bearbeiten und Shell-Befehle auszuführen, wobei er um Genehmigung bittet, basierend auf Ihren Auto-Genehmigungs-Einstellungen. Es ist kein gehosteter Chatbot; das Modell läuft auf Ihrem Computer gegen Ihre Codebasis. Wenn Sie das Cline-Panel in VS Code geöffnet haben und es während der Arbeit Diffs und Terminalausgaben anzeigt, sind Sie hier richtig. Wie man Cline verwendet behandelt die Grundlagen der Installation und Modellauswahl.
Die Unterscheidung ist wichtig, da Cline eine eigene Methode zum Lernen von Projektregeln hat, und dieser Mechanismus verwandelt ein einmaliges „Führe meine Tests aus“ in etwas, das Cline von selbst anstrebt. Dieser Mechanismus ist das Verzeichnis .clinerules/.
Schritt 1: Fügen Sie die Regel zu .clinerules hinzu, nicht als Chat-Erinnerung
Cline lädt Projektregeln aus einem Verzeichnis .clinerules/ in Ihrem Workspace-Stammverzeichnis, bevor es eine Aufgabe startet. Es liest jede .md- und .txt-Datei in diesem Ordner und kombiniert sie zu dem Anweisungssatz, den es während der Sitzung verwendet. Sie können auch eine einzelne .clinerules-Datei verwenden, wenn Sie dies bevorzugen, aber das Verzeichnis skaliert besser, wenn Ihre Regeln wachsen. Dies ist in der Cline-Regelreferenz dokumentiert.
Erstellen Sie eine Datei wie .clinerules/apidog.md in Ihrem Repository-Stammverzeichnis mit einem kurzen Block wie diesem:
# API-Tests mit Apidog
- Um die API zu testen, führen Sie die Apidog CLI aus, nicht curl oder Ad-hoc-Skripte.
- Befehl: apidog run -t <scenario_id> -e <env_id> -r cli
- Die Szenario-ID und die Umgebungs-ID stammen aus dem CI/CD-Tab von Apidog. Verwenden Sie genau diese Werte.
- Exit-Code 0 bedeutet, dass jede Behauptung bestanden wurde. Ungleich Null bedeutet einen Fehler; der Exit-Code ist die Quelle der Wahrheit, nicht Ihre Zusammenfassung.
- Die Maschine ist bereits über `apidog login` authentifiziert. Fügen Sie niemals --access-token hinzu und legen Sie niemals ein Token in diese 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 .clinerules/ anstatt sie im Chat zu erwähnen. Eine in eine Cline-Nachricht eingegebene Szenario-ID ist verschwunden, wenn die Aufgabe endet. Eine in .clinerules/apidog.md ist für jedes Teammitglied, das das Repository auscheckt, und für jede Cline-Aufgabe von nun an vorhanden. Die Datei ist versionskontrolliert, sodass die Regel mit dem Code mitreist.
Schritt 2: Holen Sie sich den Befehl von Apidog
Sie benötigen den echten Befehl apidog run, keinen geratenen. Öffnen Sie das Testszenario in Apidog, gehen Sie zum CI/CD-Tab und kopieren Sie den generierten Befehl. Er sieht so aus:
apidog run -t 8291 -e 42 -r cli
Der Wert -t ist Ihre Test-Szenario-ID und -e ist die Umgebungs-ID. Dies sind die genauen Werte, die in .clinerules/apidog.md gehören. Fügen Sie sie in den Regelblock ein, damit Cline immer die richtigen IDs hat. Für den vollständigen Flagsatz siehe die apidog run Befehlsreferenz.
Schritt 3: Lassen Sie Cline den Test ausführen
Wenn die Regel vorhanden ist, starten Sie eine Aufgabe im Cline-Panel. Cline lädt .clinerules/ 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 auszuführen:
Run the Apidog test scenario and tell me the result.
Cline plant den Schritt und wechselt dann in den Act-Modus, um den Befehl apidog run aus Ihren Regeln auszuführen. Wie viel es zuerst fragt, hängt von Ihren Genehmigungseinstellungen ab. Cline bewertet jeden Befehl und markiert ihn als sicher oder als genehmigungspflichtig; ein Nur-Lese-Testszenario gegen Staging ist die Art von Befehl, die es als sicher behandelt. Wenn Ihre Auto-Genehmigungs-Einstellungen die Ausführung sicherer Befehle zulassen, läuft apidog run ohne Aufforderung. Wenn nicht, pausiert Cline und fragt; genehmigen Sie es und aktivieren Sie die automatische Genehmigung für execute-safe-commands, wenn Sie möchten, dass es zukünftige Szenarien von selbst ausführt. Der -r cli-Reporter gibt ein schrittweises Ergebnis und eine Zusammenfassung direkt im Terminal aus, wo Sie jede Anfrage und Behauptung sehen, wie sie geschieht.
Schritt 4: Den Bericht in Cline lesen
Wenn ein Lauf rot wird, hat der Bericht die Antwort. Mit -r cli erhält Cline eine lesbare Aufschlüsselung im Terminalausgabefenster: jede Anfrage, jede Behauptung und welche fehlgeschlagen ist, mit erwartetem versus tatsächlichem Wert. Die fehlerhafte Behauptung nennt das genaue Feld oder den Statuscode, was normalerweise ausreicht, damit Cline die Korrektur beim nächsten Durchlauf 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 8291 -e 42 -r cli,html
Der html-Reporter schreibt eine eigenständige Datei in ./apidog-reports. Behalten Sie cli in der Liste, damit Cline weiterhin die Inline-Ausgabe erhält, die es liest, um seinen nächsten Schritt zu entscheiden. Für jedes Flag und jeden Reporter, einschließlich des JUnit-Formats, das CI-Dashboards parsen, siehe den vollständigen Apidog CLI-Leitfaden und den Apidog CLI-Testberichte-Leitfaden.
Cline-Tests innerhalb ihrer eigenen Schleife
Der Nutzen zeigt sich, wenn Sie aufhören zu fragen und Cline das Szenario von selbst ausführt, weil .clinerules/ es angewiesen hat.
Stellen Sie sich vor, Cline bearbeitet einen Handler, der eine Checkout-Antwort erstellt. Ihre Schleife ändert sich: Sie bearbeitet den Code, führt dann, anstatt den Sieg zu erklären, 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 Behauptung fehlgeschlagen ist (der Statuscode, das fehlende Feld, der falsche Wert), versucht eine Korrektur und führt es erneut aus. Der API-Test wird Teil derselben Bearbeitungs-Test-Fix-Schleife, durch die Cline bereits Ihre Unit-Tests laufen lässt. Sie haben eine Anweisung geschrieben, und Cline hat den Befehl in seine bereits vorhandene Funktionsweise integriert.
Dies ist das Delegate-then-Verify-Modell, das jeden Agenten-Workflow sicher macht. Cline 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 Cline tatsächlich die CLI ausführt
Agenten melden Erfolge, die sie nicht verdient haben, und Cline ist da keine Ausnahme. Drei Prüfungen, in der Reihenfolge, wie oft sie Probleme aufdecken.
Bestätigen Sie zunächst, dass der Befehl überhaupt ausgeführt wurde. Cline zeigt die ausgeführten Befehle und deren Ausgabe inline in der Aufgabenansicht an. Suchen Sie nach der wörtlichen Zeile apidog run ... und einem Ergebnis darunter. Wenn Cline sagt, es hätte die Tests ausgeführt, Sie den Befehl aber nicht sehen, hat es etwas zusammengefasst, was es nie getan hat. Bitten Sie es, den Befehl erneut auszuführen und die Rohausgabe anzuzeigen.
Zweitens, bestätigen Sie den Exit-Code, den wichtigen:
What was the exit code of that apidog run command?
apidog run beendet mit 0, wenn jede Behauptung bestanden wird, und mit einem Wert ungleich Null, wenn etwas fehlschlägt. Dieses einzige Verhalten ermöglicht es Cline oder einer Pipeline, den Lauf als sauberes Gate zu behandeln. Wenn Clines Text sagt „Tests bestanden“, der Exit-Code aber ungleich Null ist, ist der Exit-Code korrekt.
Drittens, bestätigen Sie, dass es das echte Szenario verwendet hat. Wenn ein Lauf mit „Szenario nicht gefunden“ fehlschlägt, hat Cline möglicherweise eine ID erfunden oder falsch erinnert. Überprüfen Sie die Werte -t und -e erneut anhand von .clinerules/apidog.md und dem von Apidog im CI/CD-Tab generierten Befehl. Die IDs in der Regelfile sind die Wahrheit.
Optional: Apidog MCP-Server verbinden
Das Ausführen von apidog run aus .clinerules/ deckt das meiste ab, was Sie benötigen. Ein Weg geht noch weiter.
Cline bietet erstklassigen Support für das Model Context Protocol. Klicken Sie in der VS Code-Erweiterung auf das MCP-Server-Symbol im Cline-Panel, öffnen Sie „Konfigurieren“ und klicken Sie auf „MCP-Server konfigurieren“, um cline_mcp_settings.json zu öffnen; fügen Sie Ihren Server unter dem Objekt mcpServers hinzu. Sie können auch den MCP-Marktplatz in Cline durchsuchen, um Server zu installieren, ohne JSON manuell zu bearbeiten, wie in der Cline MCP-Dokumentation beschrieben. Der Apidog MCP-Server macht Ihre API-Spezifikationen über MCP zugänglich, sodass Cline Ihr Schema lesen kann, während es Code schreibt, und nicht erst nachträglich. Die CLI führt die Tests aus; MCP versorgt den Agenten mit der Spezifikation.
Cline ist eine interaktive Erweiterung, daher gibt es keinen nicht-interaktiven Testmodus, wie ihn ein Headless-Runner bieten würde. Um apidog run in einer Pipeline ohne Cline auszuführen, behandelt Apidog CLI in GitHub Actions die Geheimnisse, Reporter und Exit-Code-Abschottung, und der Apidog CLI CI/CD-Pipeline-Leitfaden behandelt die breitere Einrichtung.
Wenn Cline Fehler macht
Einige Fehler treten häufig während der Einrichtung auf.
Es ignoriert die Regelfile. Wenn Cline einen generischen Befehl ausführt oder gar keinen, wird die Regel möglicherweise nicht geladen. Bestätigen Sie, dass der Ordner genau .clinerules benannt ist und sich in Ihrem Workspace-Stammverzeichnis befindet und dass die Datei darin auf .md oder .txt endet. Das Starten einer neuen Aufgabe zwingt Cline, die Regeln neu zu laden.
Es übergibt trotzdem einen Zugriffstoken. Wenn Cline versucht, --access-token hinzuzufügen, rät es aus öffentlichen Beispielen. Die Regel sagt ihm bereits, dies nicht zu tun, da die Maschine über apidog login authentifiziert ist. Verstärken Sie die Zeile und legen Sie niemals ein echtes Token in .clinerules/ ab. Wie die Authentifizierung tatsächlich funktioniert, erfahren Sie im Apidog CLI-Authentifizierungsleitfaden.
Es erfindet ein Flag. Ein Fehler „unbekannte Option“ bedeutet, dass Cline ein Flag geraten hat, das Ihre Version nicht besitzt. Sagen Sie ihm, er solle apidog run --help ausführen und das genaue Flag von dort kopieren, was immer für Ihre installierte Version korrekt ist.
Es meldet einen Erfolg bei einem fehlgeschlagenen Lauf. Der kostspieligste Fehler und der Grund, warum die Exit-Code-Regel sowohl in Ihrer .clinerules/-Datei als auch in Ihrem Verifizierungsschritt enthalten ist. 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 eine kurze Apidog-Regel zum Verzeichnis .clinerules/ Ihres Repos hinzu, und Cline weiß, wie Ihre API-Tests ausgeführt und das Ergebnis innerhalb derselben Schleife gelesen werden, die es bereits zum Bearbeiten von Code verwendet. Ein defekter Endpunkt wird erkannt, während Cline noch an der Änderung arbeitet, nicht erst, nachdem sie ausgeliefert wurde.
Ein Test hinter einer GUI läuft, wenn ein Mensch klickt; ein einzeiliger Befehl läuft, wann immer Cline dies 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 den Befehl apidog run in .clinerules/apidog.md ein und beobachten Sie, wie Cline ihn bei der nächsten Änderung aufgreift.