AI-translated from English; not yet reviewed by a fluent editor.

# Eine fehlschlagende Repository-Prüfung mit einem KI-Goal beheben und verifizieren

> Setzen Sie ein begrenztes Goal in Claude Code oder Codex CLI für eine bereits fehlschlagende Prüfung und prüfen Sie Originalbefehl und finalen Diff vor der Annahme.

By BIG CHANGE Editorial

Published: 2026-10-20T05:48:37.854Z
Updated: 2026-10-20T05:48:37.854Z
Canonical: https://bigchange.ai/blog/ai-goal-failing-repository-check-guide

![Conceptual charcoal illustration of a developer reviewing a code diff beside a laptop showing an unresolved check.](https://bigchange.ai/api/media/file/ai-goal-failing-check-review-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE.

Ein KI-Programmierassistent kann an einer fehlschlagenden Prüfung weiterarbeiten; Prüfung und fertiger Code brauchen dennoch Ihre Kontrolle. Dieser Leitfaden richtet sich an Entwickler mit einem Repository, in dem ein Test-, Build- oder Lint-Befehl bereits scheitert. Er verwendet ein begrenztes Goal in Claude Code oder alternativ die interaktive Codex CLI. Wählen Sie einen Weg. Fertig ist die Arbeit erst, wenn der Originalbefehl mit einer geprüften Änderung besteht, die das vorab festgelegte Verhalten erhält. Ist das nicht nachweisbar, behalten Sie Fehler und konkreten Hinderungsgrund. Das Verfahren basiert auf Dokumentation; BIG CHANGE hat dafür kein Goal ausgeführt und kein Repository repariert.

## Die große Veränderung

- **Was sich geändert hat:** Die dokumentierten Aufrufe von `/goal` halten ein Ziel über mehrere Dialogrunden aktiv. Der Assistent kann einen Fehler untersuchen, eine begrenzte Änderung machen und erneut prüfen, ohne nach jeder Runde eine neue Anweisung zu benötigen.
- **Warum das wichtig ist:** Sie können Originalbefehl, erlaubte Dateien und zu schützendes Verhalten vor Beginn festlegen. So haben aufeinanderfolgende Versuche dasselbe Abnahmeziel.
- **Worauf zu achten ist:** Ein Goal-Status oder Modellurteil beweist keine Reparatur. Lesen Sie die wirkliche Prüfausgabe und den finalen Diff und entscheiden Sie selbst über die Annahme.

## Vor dem Start: Fehler und Grenzen dokumentieren

Verwenden Sie ein Repository, das Sie ändern dürfen. Lesen Sie lokale Anweisungen einschließlich `AGENTS.md` oder `CLAUDE.md` , sofern vorhanden, und prüfen Sie Zweig, bestehende Änderungen und nicht verfolgte Dateien. In einem Git-Repository liefern diese Befehle eine Ausgangsübersicht:

```sh
git status --short
git diff --stat
git diff
```

Bewahren Sie die Übersicht auf, um Assistentenänderungen von bestehender Arbeit zu unterscheiden. Führen Sie die **tatsächlich fehlschlagende Prüfung** einmal aus oder sichern Sie einen aktuellen verlässlichen Lauf mit exaktem Befehl, vollständigem Fehler und Exit-Status. Ersetzen Sie ihn nicht durch einen Beispielbefehl dieses Artikels. Dokumentieren Sie vorher Abhängigkeiten von unzugänglichen Diensten, Geheimnissen oder Plattformen. Eine bekannte einzelne Änderung ist mit einer normalen Anfrage oft einfacher; ein Goal ist sinnvoll, wenn jedes Ergebnis den nächsten Diagnoseschritt bestimmt.

Schreiben Sie außerhalb des Goal eine kurze Abnahmenotiz: Originalbefehl, aktuelle Ausgabe, erlaubte Pfade und Werkzeuge, zu erhaltendes Verhalten und weitere Prüfungen sowie Entscheidungen, vor denen Sie stoppen und prüfen müssen. Schützen Sie bestehende fremde Änderungen ausdrücklich. Der Assistent darf die Prüfung nicht löschen oder lockern, um Erfolg vorzutäuschen. Lesen Sie die Notiz vor der Werkzeugfreigabe. Eine Bitte, nach einer bestimmten Zahl von Runden anzuhalten, kann das Modell lenken, garantiert aber kein Ausgabenlimit.

## 1. Eine Goal-Oberfläche auswählen

Für **Claude Code**öffnen Sie die vorgesehene Repository-Sitzung und prüfen, ob `/goal` verfügbar ist. Das [Goal-Handbuch](https://code.claude.com/docs/en/goal), geprüft am 20. Oktober 2026, nennt Workspace-Vertrauen und Hook-Einstellungen als Voraussetzungen. Pro Sitzung kann ein Goal aktiv sein. Eine neue Bedingung ersetzt die erste und beginnt sofort. Ein Goal ändert den Berechtigungsmodus nicht: Im manuellen Modus können Werkzeugaufrufe weiterhin Rückfragen auslösen; Automatik ist eine eigene Einstellung. Behalten Sie die üblichen Kontrollen für Dateien, Befehle und Netzwerkzugriff bei.

Für die **alternative interaktive Codex CLI**prüfen Sie installierte Version und Slash-Befehlsliste. OpenAIs [Goals-Praxisanleitung](https://developers.openai.com/cookbook/examples/codex/using_goals_in_codex) nennt Codex 0.128.0 als erste Version. Der [Anwendungsleitfaden](https://learn.chatgpt.com/use-cases/follow-goals) dokumentiert die Einstellung `features.goals` für den Fall, dass der Befehl fehlt. Diese Prüfungen führen Sie in Ihrer Installation aus; für den Artikel wurden sie nicht ausgeführt:

```sh
codex --version
codex features enable goals
```

Aktivieren Sie die Funktion nur bei Bedarf und mit Erlaubnis Ihrer Organisation. Diese Codex-Anweisungen betreffen die interaktive CLI. Erwarten Sie nicht dieselbe Unterstützung in `codex exec` oder jeder Desktop-Version. Fehlt der Befehl weiterhin, stoppen Sie und prüfen Sie Version, Funktionsschalter und Konto- oder Workspace-Zugang vor einem anderen Verfahren.

## 2. Begrenzte Bedingung festlegen

Verwenden Sie `/goal` gefolgt von Ihrer geprüften Bedingung. Nennen Sie den echten Prüfbefehl und erlaubte Pfade; fügen Sie keinen erfundenen Testnamen ein. Zum Beispiel: „Bringe meine bereits fehlschlagende Prüfung nur mit den Pfaden und Werkzeugen meiner Abnahmenotiz zum Bestehen. Zeige nach jedem Versuch Befehl, vollständiges Ergebnis und geänderte Dateien. Erhalte geschütztes Verhalten und fremde Änderungen. Kann die Prüfung nicht laufen oder bleibt keine sichere Änderung im Rahmen, stoppe mit genauem Fehler, versuchten Änderungen und den von mir benötigten Angaben.“ Ersetzen Sie „meine Prüfung“ durch den exakten Befehl und fügen Sie die geprüfte Notiz bei oder verweisen Sie darauf.

Beide dokumentierten Aufrufe von `/goal` akzeptieren eine nicht leere Bedingung bis zu 4.000 Zeichen. Lassen Sie Einzelvorgaben in der Notiz, statt sie in die Grenze zu pressen. In Claude Code startet `/goal <condition>` sofort eine Runde. In der interaktiven Codex CLI bindet `/goal <objective>` ein dauerhaftes Ziel an den aktuellen Chat. Kein Weg gewährt neue Datei-, Befehls- oder Kontorechte. Braucht eine Reparatur weitere Pfade, externe Dienste, Geheimnisse, Zusammenführung oder Bereitstellung, halten Sie für die Entscheidung des Verantwortlichen an.

## 3. Während der Arbeit die Belege prüfen

Fordern Sie nach jedem wesentlichen Versuch die exakte Ausgabe und die Liste geänderter Dateien an. Führen Sie `/goal` ohne Argument für den Status aus. Claude Code zeigt verstrichene Zeit, bewertete Runden, Tokenverbrauch und den letzten Bewertungsgrund. Der Bewerter liest, was Claude im Gespräch offengelegt hat; er führt die Prüfung **nicht** selbst aus und prüft keine Dateien unabhängig. Ein Urteil „met“ fordert zur Kontrolle auf und beweist keine Reparatur. Auch Codex’ Goal-Status braucht tatsächliche Befehlsausgabe und Diff als Ergebnisbeleg.

Halten Sie die Schleife im ursprünglichen Umfang. Lesen Sie vorgeschlagene Befehle vor der Freigabe, besonders beim Löschen, Umschreiben der Historie, externen Datenversand oder Ändern von Rechten. Stoppen Sie bei geschwächter Originalprüfung, unerklärter Änderung fremder Dateien oder drohender Offenlegung privater Daten. Ist der nächste Schritt nicht sicher freizugeben, dokumentieren Sie den Goal-Status und verlangen einen engeren Plan.

## 4. Abschluss selbst verifizieren

Meldet der Assistent Erfolg, prüfen Sie den gesamten finalen Diff gegen die Ausgangsübersicht. Gleichen Sie jede geänderte und neue Datei mit erlaubten Pfaden ab. Führen Sie **denselben ursprünglichen Prüfbefehl** nach Möglichkeit erneut aus und sichern Sie vollständige Ausgabe und Exit-Status. Führen Sie relevante unveränderte Tests der Notiz aus und prüfen Sie das zu erhaltende Verhalten. Eine erfolgreiche Ersatzprüfung erfüllt den Auftrag nicht.

Nehmen Sie die Änderung nur an, wenn die Belege zur geprüften Bedingung passen und Sie den Diff freigeben. Commit, Zusammenführung und Bereitstellung bleiben getrennt autorisierte Entscheidungen. Bei fehlgeschlagener Verifikation behalten Sie Originalbefehl und Ausgabe, geänderte Dateien, Goal-Status und genau fehlende Berechtigung, Abhängigkeit oder Entscheidung. Ein pausiertes, unterbrochenes, unmögliches, blockiertes oder budgetbegrenztes Goal ist keine fertige Reparatur.

## Wenn das Goal stoppt oder festhängt

In **Claude Code**zeigt `/goal` Bedingung und letzten Grund; `/goal clear` entfernt ein aktives Goal. Das [Handbuch](https://code.claude.com/docs/en/goal) beschreibt, dass eine aktive Bedingung bei Sitzungsfortsetzung zurückkehren kann, während Zeit-, Runden- und Token-Basiswerte zurückgesetzt werden. Die Wiederherstellung über die Sitzungsauswahl wurde in v2.1.239 korrigiert. Authentifizierungsfehler bei von Claude Code verwalteten Zugangsdaten, verbrauchtes Guthaben, nicht behebbarer Kontextüberlauf und fehlende Modelle können das Goal löschen. Hostverwaltete Authentifizierung kann es aktiv lassen. Andere Fehler können es erhalten und erneut versuchen oder pausieren; interaktive Hinweise sind ab v2.1.269 dokumentiert. Lesen Sie Warnung, Status, gesicherte Ausgabe und Arbeits-Diff vor neuem Setzen oder Fortsetzen. Eine neue Bedingung ersetzt die alte.

In der **interaktiven Codex CLI**zeigt `/goal` das Ziel; `/goal edit`, `/goal pause`, `/goal resume` und `/goal clear` sind in der [CLI-Befehlsreferenz](https://learn.chatgpt.com/docs/developer-commands?surface=cli#cli-set-or-view-a-task-goal-with-goal)dokumentiert. Die [Praxisanleitung](https://developers.openai.com/cookbook/examples/codex/using_goals_in_codex) unterscheidet Abschluss von Pause, Unterbrechung, Budgetgrenze und Blockade. Prüfen Sie aktuellen Status und tatsächliche Repository-Belege vor Fortsetzung oder Zieländerung. Bei einem Budget- oder Zugangsstopp ist ein genauer Hinderungsgrund womöglich nützlicher als ein weiterer Versuch.

Modellrunden verbrauchen Kontokontingent oder Guthaben; Claude Codes eigener Bewerter benötigt ebenfalls Tokens. Prüfen Sie die aktuellen Kontoeinstellungen und Grenzen. Eine Zeit- oder Rundenvorgabe in Prosa garantiert keine Dollarobergrenze. Verwenden Sie nur erlaubtes Repository-Material, halten Sie Geheimnisse und fremde private Dateien heraus und prüfen Sie Anweisungen im Repository, bevor der Assistent ihnen folgt.

Für eine getrennte Einrichtungsaufgabe erklärt unser [Codex-Cloud-Umgebungsleitfaden](https://bigchange.ai/blog/codex-cloud-environment-setup-guide) die Verbindung und Vorbereitung eines entfernten Repositorys. Unser [Leitfaden zu gemeinsamen Team Tasks](https://bigchange.ai/blog/chatgpt-team-tasks-shared-recurring-work-guide) behandelt wiederkehrende Arbeit in ChatGPT. Keine Einrichtung ist Voraussetzung für das obige lokale Prüfverfahren.

## Quellen und weiterführende Informationen

- [Claude Code: Claude auf ein Ziel hinarbeiten lassen](https://code.claude.com/docs/en/goal) beschreibt `/goal`, Bewertersichtbarkeit, Rechte, Fortsetzung, Fehler und Nutzung. Verifiziert keine Reparatur Ihres Repositorys.
- [OpenAI: Goals in Codex verwenden](https://developers.openai.com/cookbook/examples/codex/using_goals_in_codex) beschreibt CLI-Mindestversion, Zielvertrag, Lebenszyklus und Belegprüfungen. Beispiele sind keine Ergebnisse dieses Leitfadens.
- [OpenAI: einem Ziel folgen](https://learn.chatgpt.com/use-cases/follow-goals) erklärt Funktionsschalter und dauerhaftes Ziel. Zugang hängt von Installation und Konto ab.
- [OpenAI: Codex-CLI-Entwicklerbefehle](https://learn.chatgpt.com/docs/developer-commands?surface=cli#cli-set-or-view-a-task-goal-with-goal) dokumentiert interaktive `/goal` -Steuerung. Prüfen Sie die Unterstützung lokal.

## Sources

- [Claude Code, Claude auf ein Ziel hinarbeiten lassen](https://code.claude.com/docs/en/goal) — Dokumentiert Sitzungs-Goal, Bewertergrenzen, Rechte, Verbrauch und versionsabhängige Wiederherstellung. Belegt keinen erfolgreichen Test oder repariertes Repository unabhängig.
- [OpenAI, Goals in Codex verwenden](https://developers.openai.com/cookbook/examples/codex/using_goals_in_codex) — Dokumentiert CLI-Mindestversion, begrenztes Ziel, Lebenszyklus und Belegprüfung. Beispiele wurden für diesen Artikel nicht ausgeführt.
- [OpenAI, einem Ziel folgen](https://learn.chatgpt.com/use-cases/follow-goals) — Dokumentiert interaktives Goal und Funktionsschalter. Belegt keinen Zugang in Ihrer Installation oder Ihrem Konto.
- [OpenAI, Codex-CLI-Entwicklerbefehle](https://learn.chatgpt.com/docs/developer-commands?surface=cli#cli-set-or-view-a-task-goal-with-goal) — Dokumentiert genaue interaktive /goal-Steuerung für Status, edit, pause, resume und clear sowie die Grenze von 4.000 Zeichen; keine Zusage für codex exec oder sämtliche Desktop-Versionen.
