Nach der Einführung von /goal durch Codex im April 2026 hat Anthropic im Mai mit Claude Code 2.1.139 einen gleichnamigen Befehl nachgezogen. Dabei handelt es sich um einen neuen Workflow, bei dem Claude „nicht locker lässt, bis das Ziel erreicht ist“: Sobald Sie in einer Sitzung eine Abschlussbedingung definieren, lässt Claude nach jeder Runde ein kleines, schnelles Modell prüfen, ob das Ziel erreicht wurde. Ist dies nicht der Fall, wird die nächste Runde gestartet, bis die Bedingung erfüllt ist und die Kontrolle wieder an Sie übergeben wird.
Dieser Artikel erläutert systematisch die 6 wichtigsten Punkte des Claude Code goal-Modus, einschließlich des Funktionsmechanismus der Evaluatorschleife, der Unterschiede zu /loop und Stop-Hooks, der Formulierung effektiver Bedingungen, der 3 Modi (interaktiv / -p / Remote Control) sowie Risiken und Best Practices.
Kernnutzen: Nach der Lektüre dieses Artikels können Sie langwierige Aufgaben wie Code-Migrationen, das Abarbeiten von Issues oder die Abnahme von Dokumentationen innerhalb von 10 Minuten an den Claude Code goal-Modus delegieren und wissen genau, wann Sie auf andere autonome Workflows umsteigen sollten.
Kernpunkte des Claude Code goal-Modus
Bevor Sie loslegen, sollten Sie sich die 6 Schlüsselfakten des Claude Code goal-Modus verdeutlichen. Diese Punkte entscheiden darüber, ob Ihre definierten Bedingungen korrekt ausgeführt werden und ob Sie tatsächlich /goal anstelle anderer autonomer Workflows verwenden sollten.
| Punkt | Inhalt | Auswirkung |
|---|---|---|
| Befehlsformat | /goal <Bedingung> |
Direkt in der Sitzung festlegen, keine Konfigurationsdatei erforderlich |
| Evaluator | Standardmäßig Haiku (kleines, schnelles Modell) | Die Zielerreichung wird durch ein „anderes Modell“ beurteilt, unabhängig vom ausführenden Modell |
| Gültigkeitsbereich | Aktuelle Sitzung (session-scoped) | Beeinflusst keine anderen Sitzungen, ideal für temporäre Aufgaben |
| Auslösungsrhythmus | Evaluierung sofort nach jeder Runde | Stoppt bei Erfolg, startet bei Nichterfüllung eine neue Runde |
| Bedingungslimit | Maximal 4000 Zeichen | Bietet Platz für detaillierte Abnahmekriterien |
| Beendigung | Evaluierung erfolgreich / /goal clear / Strg+C |
Drei Abbruchpfade, Kombination aus aktiv und passiv |
Viele Nutzer denken beim ersten Anblick von /goal an einen gewöhnlichen Loop-Befehl, doch im Kern handelt es sich um eine von Anthropic bereitgestellte Kapselung eines prompt-basierten Stop-Hooks als sitzungsweiten Kurzbefehl. Diese grundlegende Positionierung unterscheidet ihn stark von der klassischen cron-artigen Automatisierung.
Falls Ihr Team die fortgeschrittenen Hook-Mechanismen von Claude Code noch nicht genutzt hat, können Sie über die Plattform APIYI (apiyi.com) die API von Claude Sonnet / Opus / Haiku testen, um sich mit dem Tool-Ökosystem von Anthropic vertraut zu machen. Danach wird Ihnen der Umstieg auf den goal-Modus von Claude Code deutlich leichter fallen.
Detaillierte Funktionsweise des Claude Code /goal-Modus
Um den /goal-Befehl korrekt einzusetzen, muss man verstehen, was in jeder Iteration genau passiert. Die offizielle Dokumentation beschreibt den Mechanismus als „Anhängen eines Evaluators nach jeder Runde“. Das klingt einfach, doch die Details bestimmen die tatsächlichen Leistungsgrenzen.
Das Hauptmodell erledigt die Arbeit, während ein kleineres, schnelles Modell die Fertigstellung beurteilt. Der Vorteil dieser Arbeitsteilung ist, dass der Evaluator neutral bleibt und Entscheidungen mit geringerem Rechenaufwand trifft. Der Nachteil: Der Evaluator kann nur das lesen, was das Hauptmodell bereits im Dialog präsentiert hat; er hat keinen direkten Einblick in den Dateisystemstatus oder die tatsächliche Ausführung externer Befehle.
Der Beurteilungsprozess nach jeder Runde lässt sich in 4 Schritte unterteilen:
- Kontext bündeln: Die aktuelle Bedingung und das gesamte Dialogtranskript werden an den Evaluator gesendet.
- Modellentscheidung: Der Evaluator gibt ein „Ja/Nein“ sowie eine Begründung zurück.
- Routing: Bei „Nein“ wird die Begründung als Anweisung an das Hauptmodell zurückgegeben, um weiterzuarbeiten. Bei „Ja“ wird das Ziel automatisch gelöscht und als „erreicht“ markiert.
- Indikator-Aktualisierung: Die UI zeigt kontinuierlich
◎ /goal activemit den drei Metriken: verstrichene Zeit (elapsed), Runden (turns) und Token-Verbrauch (tokens).
Denken Sie beim Formulieren der Bedingungen unbedingt an die Einschränkung aus Schritt 1: Der Evaluator sieht nur das Transkript. Die Bedingung muss also etwas sein, das das Hauptmodell im Dialog beweisen kann. „npm test Exit-Code ist 0“ ist eine gute Bedingung, da das Hauptmodell den Test ausführt und das Ergebnis einfügt. „Die Datenbank in der Produktionsumgebung enthält keine fehlerhaften Daten“ ist hingegen eine schlechte Bedingung, da sie nicht direkt aus dem Dialog verifiziert werden kann.
Die Kosten für den Evaluator sind in der Regel vernachlässigbar. Der Stückpreis der Haiku-Modelle liegt weit unter dem von Sonnet oder Opus, und da pro Runde nur eine Zusammenfassung des Transkripts bewertet wird, ist der Token-Verbrauch selbst bei langen Sitzungen minimal. Teams, die die Kosten für den Evaluator weiter senken möchten, können über APIYI (apiyi.com) den API-Proxy-Dienst nutzen, um die kleinen, schnellen Modelle von Claude Code auf Haiku 4.5 oder 3.5 zu lenken und Kontingente auf Workspace-Ebene zu steuern.
Vergleich des Claude Code „Goal“-Modus mit anderen autonomen Workflows
Claude Code bietet insgesamt vier Mechanismen, um eine Sitzung „am Laufen zu halten“. Für Einsteiger ist es oft schwierig, diese auseinanderzuhalten. Die folgende Tabelle stellt die vier Mechanismen nach Auslösebedingungen, Abbruchbedingungen und typischen Szenarien gegenüber, um die Auswahl zu erleichtern.
| Mechanismus | Auslöserhythmus | Abbruchbedingung | Anwendungsfall |
|---|---|---|---|
/goal |
Sofort nach Ende der Runde | Evaluator bestätigt Zielerreichung | Langfristige Aufgaben mit klaren Abnahmekriterien |
/loop |
In festen Zeitintervallen | Manuell durch Benutzer oder Claude | Periodisches Polling, Statusprüfungen |
| Stop hook | Sofort nach Ende der Runde | Benutzerskript oder benutzerdefinierter Prompt | Teamebene, sitzungsübergreifend wirksam |
| Auto mode | Bei Tool-Aufruf innerhalb einer Runde | Ende der Tool-Sequenz | Reduzierung von Bestätigungsdialogen pro Tool |
Der entscheidende Punkt ist, dass /goal und „Stop hook“ fast dasselbe tun. /goal gilt jedoch nur für die aktuelle Sitzung und kann direkt im Terminal eingegeben werden. Ein „Stop hook“ muss in der Einstellungsdatei hinterlegt werden, wirkt sich auf alle Sitzungen innerhalb des Scopes aus und eignet sich daher besser für verbindliche Vorgaben auf Teamebene.
„Auto mode“ und /goal ergänzen sich perfekt: „Auto mode“ löst das Problem, dass man innerhalb einer Runde ständig durch Tool-Bestätigungen unterbrochen wird, während /goal Aufgaben bewältigt, die sich über mehrere Runden erstrecken. Durch die Kombination beider Mechanismen bei komplexen Aufgaben lässt sich der Prozess nahezu unbeaufsichtigt ausführen. Teams, die Claude Code nicht in ihrer eigenen Umgebung ausführen, können über APIYI (apiyi.com) Claude zunächst in lokale Skripte einbinden, um die Logik zu testen, bevor sie auf das vollständige Claude Code-Tool umsteigen.
Die 3 Säulen für effektive „Goal“-Bedingungen in Claude Code
Schlecht formulierte Bedingungen sind der Hauptgrund für das Scheitern von /goal. Die offizielle Dokumentation von Anthropic weist darauf hin, dass eine Bedingung, die über Dutzende Runden stabil bleiben soll, drei Elemente enthalten muss:
Erstens: Ein messbarer Endpunkt. Der Endpunkt muss ein diskretes, beobachtbares Ereignis sein: Test-Exit-Codes, Dateianzahl, verbleibende Einträge in einer Warteschlange oder ein erfolgreicher Build. Vage Metriken führen dazu, dass der Evaluator zwischen „Ja“ und „Nein“ hin- und herspringt, was den /goal-Modus in eine Endlosschleife stürzen lässt.
Zweitens: Eine klare Verifizierungsmethode. Die Bedingung sollte explizit beschreiben, wie Claude nachweisen kann, dass das Ziel erreicht wurde, z. B. „npm test Ausgabe enthält PASS“ oder „git status Ausgabe ist leer“. Je konkreter die Verifizierung, desto weniger lässt sich der Evaluator durch mehrdeutige Formulierungen täuschen.
Drittens: Unveränderliche Einschränkungen. Wenn bestimmte Dateien oder Konfigurationen unverändert bleiben müssen, sollte dies direkt in der Bedingung untersagt werden, z. B. „Ändere keine Dateien unter tests/legacy/“. Dies verhindert, dass das Modell destruktive Änderungen vornimmt, nur um das Ziel „zu erreichen“.
Kombiniert man diese drei Elemente, sieht eine hochwertige /goal-Bedingung etwa so aus: „Alle Tests unter tests/auth bestehen, npm run lint Exit-Code ist 0, ändere keine Dateien unter tests/legacy/, maximal 20 Runden ausführen.“ Der Zusatz „maximal 20 Runden“ dient als Sicherheitsnetz, um Endlosschleifen in Extremfällen zu verhindern.
Da die Bedingung bis zu 4000 Zeichen unterstützt, können Sie dort problemlos ein kurzes PRD hinterlegen. Wenn Sie die APIYI-Plattform (apiyi.com) nutzen, um Claude-Modelle für Agenten-Orchestrierung aufzurufen, können Sie diesen Ansatz auch für das Design Ihrer eigenen Evaluator-Prompts verwenden, um die Abbruchbedingungen Ihrer Agenten ebenso klar und messbar zu gestalten.
Claude Code goal-Modus: 3 praktische Ausführungsmodi
Der /goal-Befehl unterstützt drei Aufrufarten: interaktiv, nicht-interaktiv (-p) und Remote Control. Wenn Sie diese drei Methoden beherrschen, können Sie Claude Code effektiv in CI-Pipelines, lokale Skripte und Workflows für die Remote-Zusammenarbeit integrieren.
Schnelleinstieg in den interaktiven Modus
# Geben Sie dies direkt in der Claude Code-Sitzung ein
/goal all tests in test/auth pass and the lint step is clean, or stop after 20 turns
Nach der Einrichtung erscheint in der Benutzeroberfläche die Anzeige ◎ /goal active, die in Echtzeit die Metriken elapsed (verstrichene Zeit), turns (Schritte) und tokens anzeigt. Sie können den Status jederzeit durch Eingabe von /goal ohne Parameter abrufen. Mit /goal clear (oder den Aliasen stop, off, reset, none, cancel) lässt sich der Vorgang vorzeitig beenden.
Nicht-interaktiver Modus (ideal für CI)
claude -p "/goal CHANGELOG.md has an entry for every PR merged this week, or stop after 15 turns"
Der -p-Modus lässt /goal so lange laufen, bis die Bedingung erfüllt ist oder Sie den Vorgang mit Strg+C unterbrechen. Dies eignet sich hervorragend für automatisierte Prozesse in GitHub Actions, GitLab CI oder Jenkins-Pipelines. Wenn Sie den API-Proxy-Dienst von APIYI (apiyi.com) für die zentrale Steuerung Ihrer Claude-API-Aufrufe nutzen, können Sie dasselbe Schleifenmuster in Ihre eigenen Skripte kapseln, um auch Nicht-Claude-Code-Clients ähnliche Fähigkeiten zu verleihen.
Sitzungswiederherstellung
claude --resume <session-id>
# oder
claude --continue
Beim Wiederherstellen einer Sitzung wird der aktive goal-Status übernommen, jedoch werden die Zähler für turns, timer und tokens auf 0 zurückgesetzt. Diese Funktion ist besonders bei langwierigen Refactoring-Projekten hilfreich: Sie können Ihren Computer am Wochenende ausschalten, ohne den Fortschritt zu verlieren, und am Montag nahtlos weitermachen.
Vorlagen für häufige Zielbedingungen (zum Ausklappen klicken)
# Vorlage 1: Code-Migration
/goal migrate all usages of legacy_api.* to new_api.* in src/, run npm test until exit 0, do not modify tests/legacy/, or stop after 30 turns
# Vorlage 2: Bereinigung des Issue-Backlogs
/goal close all GitHub issues labeled "needs-triage" by either resolving or relabeling, run gh issue list --label needs-triage and verify the output is empty, or stop after 25 turns
# Vorlage 3: Abnahme von Designdokumenten
/goal implement every acceptance criterion in docs/design.md, prove each by referencing the exact section, do not edit docs/design.md itself, or stop after 40 turns
# Vorlage 4: Dateiaufteilung
/goal split src/megafile.ts into modules under src/parts/ where each file is < 300 lines, run npm run typecheck until exit 0, or stop after 20 turns
Risiken und Best Practices für den Claude Code goal-Modus
Der /goal-Modus überträgt die Entscheidungsbefugnis an das Modell, wodurch sich die Risiken von klassischen Befehlen unterscheiden. Die folgende Tabelle zeigt die vier kritischsten Risikobereiche und entsprechende Schutzmaßnahmen.
| Risiko | Auslöser | Schutzmaßnahme |
|---|---|---|
| Kostenkontrollverlust | Fehlbeurteilung oder zu vage Bedingungen | Obergrenze „or stop after N turns“ einbauen |
| Evaluator-Halluzination | Bedingung nicht durch Transkript verifizierbar | Beobachtbare Syntax: „Führe X aus, um Y zu verifizieren“ |
| Destruktive Änderungen | Modell ändert geschützte Dateien | „do not modify …“-Einschränkung hinzufügen |
| Missbrauch der Arbeitsumgebung | Versehentliche Ausführung in nicht vertrauenswürdiger Umgebung | Trust-Dialog erforderlich; disableAllHooks zur Deaktivierung |
Das erste Risiko ist am unmittelbarsten. Weder Codex noch Claude Code bieten derzeit eine offizielle Funktion für „Ausgabenobergrenzen pro Ziel“. Bei langen Aufgaben kann dies schnell zu einem Vielfachen der erwarteten Token-Kosten führen. Die sicherste Methode ist es, ein turns-Limit direkt in die Bedingung zu schreiben und dies mit Budget-Warnungen auf Plattformebene zu kombinieren.
Ebenso wichtig ist die Bereitstellung eines stabilen, kleinen Modells für den Evaluator. Wenn Ihr schnelles Modell Haiku ist, bleiben Evaluierungsgeschwindigkeit und Kosten überschaubar; bei größeren Modellen wie Sonnet steigen die Kosten für den /goal-Prozess deutlich an. Entwicklungsteams können über die Plattform APIYI (apiyi.com) separat eine base_url und Kontingente für Haiku konfigurieren, um die Kosten für Evaluator und Hauptmodell getrennt zu überwachen.
Abschließend ein Hinweis zur Compliance: /goal basiert auf dem Hook-System von Anthropic und erfordert, dass der Arbeitsbereich den Trust-Dialog akzeptiert hat und weder disableAllHooks noch allowManagedHooksOnly gesetzt sind. Wenn Ihr Team Hooks durch eine einheitliche Richtlinie deaktiviert hat, wird /goal ebenfalls blockiert und der Befehl informiert Sie direkt über den Grund, anstatt stillschweigend zu scheitern.
Häufig gestellte Fragen
Q1: Was bietet /goal im Vergleich zu einem selbst geschriebenen while-Schleifen-Skript?
Der entscheidende Vorteil ist ein unabhängiger, modellgesteuerter Evaluator. Bei einem selbst geschriebenen while-Skript müssen Sie die Abbruchbedingungen manuell definieren und programmieren. Mit /goal hingegen übertragen Sie die Entscheidung an ein kleines, schnelles Modell. Dies ermöglicht die Handhabung nicht-programmatischer Szenarien, wie etwa: „Lass das Modell den Dialog lesen, um zu verstehen, ob die Aufgabe abgeschlossen ist.“
Q2: Verbraucht die Nutzung von /goal nicht extrem viele Token?
Das Risiko besteht, ist aber kontrollierbar. Zwei Empfehlungen: Erstens sollten Sie in den Bedingungen zwingend ein Limit für die „Turns“ festlegen. Zweitens empfiehlt es sich, den Evaluator fest auf ein kleines Modell wie Haiku zu setzen. Wenn Sie die Claude-Serie über APIYI (apiyi.com) einbinden, können Sie dem Evaluator ein separates Kontingent zuweisen, um die Kosten präzise zu überwachen.
Q3: Wann sollte ich /goal und wann /loop wählen?
Wenn die Aufgabe einen klar definierten „Abschlusszustand“ hat, wählen Sie /goal. Wenn es sich um eine periodische Statusabfrage handelt (z. B. alle 10 Minuten den Fortschritt einer Bereitstellung prüfen), ist /loop die richtige Wahl. Beide basieren auf völlig unterschiedlichen Mechanismen; eine Vermischung führt oft dazu, dass die Abbruchbedingungen unklar werden.
Q4: Kann man den /goal-Modus von Claude Code auch in China nutzen?
Ja. /goal ist ein Befehl des Claude Code-Clients. Solange der Client eine Verbindung zu den von Anthropic bereitgestellten Modellen herstellen kann, funktioniert er. Entwickler nutzen hierfür meist Aggregator- und API-Proxy-Dienste wie APIYI (apiyi.com). Sobald die Umgebung korrekt konfiguriert ist, verhält sich /goal genauso wie bei Nutzern im Ausland.
Q5: Wer hat die Nase vorn: Codex /goal oder Claude Code /goal?
Beide zielen auf unterschiedliche Workflows ab. Codex /goal betont „persistente Workflows“ und kann prozessübergreifend neu gestartet werden. Claude Code /goal ist auf die Sitzung begrenzt, kann aber mit --resume auch über mehrere Tage hinweg wiederaufgenommen werden. Für komplexe, mehrtägige Aufgaben ist Codex besser geeignet, für reguläre Iterationsaufgaben von ein bis zwei Tagen ist Claude Code intuitiver.
Fazit
Der Kern des Claude Code goal-Modus liegt darin, dass Anthropic den „Evaluator-Loop“ aus den Hook-Konfigurationsdateien befreit und in einen Einzeiler verwandelt hat, der in jeder Sitzung spontan genutzt werden kann. Das Hauptproblem, das damit gelöst wird: Wenn eine Aufgabe mehrere Runden erfordert, man aber nicht ständig vor dem Terminal sitzen und Enter drücken möchte, fungiert ein kleines, schnelles Modell als „Richter“ und entscheidet, wann Claude die Arbeit wirklich erledigt hat.
Unsere Empfehlung für die Umsetzung: Gehen Sie in drei Schritten vor. Definieren Sie zuerst die Bedingungen vollständig mit dem „Vier-Säulen-Modell“ (Ziel + Validierung + Einschränkungen + Turn-Limit). Entscheiden Sie sich dann für den Modus (interaktiv, -p oder Remote Control). Zuletzt sollten Sie über Plattformen wie APIYI (apiyi.com) die Kontingente für den Evaluator und das Hauptmodell getrennt überwachen. So profitieren Sie von der Effizienz autonomer Workflows, ohne die Kontrolle über die Token-Kosten zu verlieren.
Autor: APIYI Technik-Team
Kontakt: Erhalten Sie Unterstützung für die gesamte Claude-Modellreihe und die Claude Code-Anbindung über APIYI (apiyi.com)
Aktualisiert am: 13.05.2026
