Keine Wartezeit mehr bei Codex-Kontingentende: Hermes fügt /usage reset hinzu

Für Entwickler, die täglich in Codex arbeiten, ist der frustrierendste Moment nicht eine falsche Antwort, sondern die plötzliche Kontingentgrenze mitten in einer langen Aufgabe. Der Kontext ist bereits aufgebaut, Tool-Aufrufe wurden ausgeführt, und nun muss man den Flow unterbrechen, um irgendwo anders einen Reset einzulösen.

Hermes Agent hat gerade PR #64280 gemerged und den Befehl /usage reset hinzugefügt. Ab sofort kannst du gesammelte Codex-Kontingent-Resets direkt in Hermes einlösen, ohne die Codex-CLI oder die Website zu öffnen und ohne die Sitzung zu verlieren.

Welches Problem damit gelöst wird

OpenAI gibt Nutzern von ChatGPT-plan mit Codex Rate-Limit-Reset-Gutschriften. Stell sie dir als Notfallaufladung vor: Wenn du das 5-Stunden- oder das wöchentliche Limit erreichst, füllt ein eingelöster Guthabenpunkt das gesamte Kontingent wieder auf.

Bisher musste man dafür eines der folgenden verwenden:

  • Die Codex-CLI
  • Die Codex-Desktop-App
  • Das OpenAI-Web-Dashboard

Für Entwickler, die Hermes als Haupteinstiegspunkt nutzen, bedeutete das einen zusätzlichen Kontextwechsel. /usage reset verbindet denselben Einlösefluss direkt mit dem Tool, das du ohnehin nutzt.

Kernanwendung: In drei Schritten wieder aufladen

1. Hermes aktualisieren

hermes update

2. Sicherstellen, dass das ChatGPT-Konto angemeldet ist

hermes auth

Du brauchst einen ChatGPT-plan, der Codex-Zugriff enthält.

3. Aktuellen Verbrauch prüfen

/usage

Wenn du gesammelte Resets hast, zeigt Hermes jetzt etwa Folgendes an:

You have 2 resets banked - use /usage reset to activate

4. Kontingent zurücksetzen

/usage reset

Wenn eines der Rate-Limit-Fenster vollständig aufgebraucht ist, löst Hermes eine Gutschrift ein und stellt das volle 5-Stunden- plus wöchentliche Kontingent wieder her.

hero

Erzwungener Reset und die Sicherheitsmechanismen

Der Befehl ist vorsichtiger, als er auf den ersten Blick wirkt. Ein einzelner gesammelter Reset stellt das gesamte 5-Stunden- und wöchentliche Kontingent wieder her, sodass eine vorzeitige Einlösung verschwenderisch wäre.

Hermes lehnt die Einlösung daher ab, wenn kein Fenster vollständig aufgebraucht ist, und zeigt an, wie viel vom aktivsten Fenster noch übrig ist. Mit --force kannst du das überschreiben:

/usage reset --force

Mögliche Ergebnisse:

Ergebnis Bedeutung
reset Einlösung erfolgreich, Kontingent wiederhergestellt
nothing_to_reset Kein Fenster war vollständig aufgebraucht, Gutschrift nicht verbraucht
no_credit Keine gesammelten Resets verfügbar
already_redeemed Diese Gutschrift wurde bereits eingelöst (Idempotenz-UUID-Schutz)
reset_wrong_provider Aktueller Provider ist nicht openai-codex

Warum das für Entwickler wichtig ist

Beim Programmieren gibt es zwei Arten von Unterbrechungen, die besonders wehtun:

  1. Flow-Unterbrechung — man ist tief in einer komplexen Refaktorierung und das Modell antwortet nicht mehr.
  2. Kontext-Unterbrechung — Codex hat das Projekt bereits gelesen, Befehle ausgeführt und Zwischendateien erzeugt; ein Toolwechsel bedeutet, dass man den gesamten Zustand wiederherstellen muss.

/usage reset hält die Reset-Aktion in derselben Chat-Oberfläche, die du ohnehin nutzt. Besonders hilfreich ist das bei:

  • Langen Refaktorierungssitzungen — die Aufgabe läuft bereits über Hunderte Zeilen, dann trifft sie das Limit.
  • Mehrfachdatei-Analyse — der Projektkontext ist geladen; ein Toolwechsel würde bedeuten, die Aufgabe neu zu erklären.
  • Cron- oder Hintergrundjobs — ein unbeaufsichtigter Lauf, der das Limit erreicht, kann vollständig fehlschlagen; ein Reset-Befehl bietet einen Wiederherstellungspfad.
  • Intensiven Debug-Schleifen — häufige Codex-Aufrufe verbrauchen das Kontingent schneller; manuelle Resets sparen viel Wartezeit.

Wie es technisch funktioniert

Laut PR #64280 ist die Implementierung sauber und folgt der offiziellen Semantik des Codex-Clients:

  • Wiederverwendung des vorhandenen dreistufigen Codex-Credential-Resolvers von Hermes.
  • Aufruf des OpenAI-Endpunkts /rate-limit-reset-credits/consume mit einem UUID-Idempotenz-Schlüssel, genau wie der offizielle Codex-Client.
  • Behandlung von PathStyle-Unterschieden (/wham vs /api/codex) und des ChatGPT-Account-Id-Headers.
  • Verfügbar sowohl in der CLI als auch im Gateway, also sowohl im Terminal als auch auf Messaging-Plattformen wie Telegram oder Discord.
  • Neue i18n-Schlüssel in allen 16 Sprachvarianten und Dokumentationsaktualisierungen in cli.md sowie im Messaging-Index.

Die Testabdeckung ist ebenfalls gründlich: Unit-Tests, Gateway-Kommandotests, i18n-Paritätstests und ein realer Socket-E2E gegen einen lokalen Fake-Codex-Backend, der die Hinweisanzeige, den Guard-Block, die --force-Einlösung, den Idempotenz-Schlüssel auf dem Draht und beide CLI-Einstiegspunkte überprüft hat.

Ein weiteres tägliches Update vom „Workhorse“-Team

Wer das Hermes-Commit-Log verfolgt, weiß, dass dieses Projekt fast täglich neue Commits bekommt. PR #64280 wurde vor zwei Tagen gemerged, während das Repository bereits Commits von vor vier, sieben und neunzehn Stunden hatte. Das Wartungstempo des Nous-Research-Teams ist der „Workhorse“-Rhythmus, der Hermes verlässlich am Leben hält.

/usage reset ist kein aufsehenerregendes Headline-Feature. Es ist eine kleine, praktische Verbesserung, die einen echten Schmerzpunkt für Menschen löst, die Hermes wirklich zur Arbeit nutzen. Das sind oft die besten Updates.

Wichtigste Punkte

  • /usage reset ermöglicht es dir, gesammelte Codex-Resets direkt in Hermes einzulösen, ohne zur Codex-CLI oder Website wechseln zu müssen.
  • Führe hermes update aus, bestätige hermes auth und verwende dann bei Bedarf /usage reset.
  • Standardmäßig schützt es vor verschwendeten Gutschriften; nur vollständig aufgebrauchte Fenster lösen einen Reset aus. Mit --force überschreibst du das.
  • Ergebnisse sind reset, nothing_to_reset, no_credit, already_redeemed und reset_wrong_provider.
  • Funktioniert sowohl in der CLI als auch im Gateway, also für Terminal- und Chat-Plattform-Nutzer gleichermaßen.

Referenzen: