Nutzung und Budget verfolgen

SupaCloud verfolgt zwei verschiedene Dinge, die begrenzen, wie viel Agenten-Arbeit ein Workspace leisten kann, und zeigt sie in zwei getrennten Oberflächen:

• Abo-Auslastung – für Provider, die über ein OAuth-Abo verbunden sind (ein vorausbezahlter Tarif mit rollierenden Nutzungsfenstern). Du beobachtest, wie voll die Fenster sind, nicht was du ausgibst.
• Dollar-Budget – für Provider, die pro Token über einen API-Key abgerechnet werden. Du legst ein monatliches USD-Limit fest und beobachtest die Ausgaben dagegen.

Die Auslastungsanzeigen liegen unter Einstellungen → Arbeitsbereich, und die Dollar-Budget-Karte liegt dort ebenfalls. Ein Workspace, der nur API-Keys nutzt, sieht ausschließlich die Budget-Oberfläche; ein Workspace mit einem Abo sieht zusätzlich die Auslastungsanzeigen.

Nutzung unter „Berichte” finden

Der Bereich Berichte in der Seitenleiste ist die Heimat für alles, was du an einem Workspace misst. Seine Tabs sind:

Tab	Was er zeigt
Übersicht	Periodisch wählbare Diagramme, die die Agenten-Arbeit aufschlüsseln
Nutzung	Dieselben Werte zu Abo-Auslastung und Budget je Provider
Lieferung	Die Lieferübersicht je Agenten-Profil
Audit	Das Audit-Ereignisprotokoll
Betrieb	Die Operability-Ansicht des Tenants (Dispatch-Metriken, Routing, Circuit Breaker) — nur für Eigentümer und Admins
Geplante Berichte	Die wiederkehrenden Berichte, die sich selbst versenden

Was jeder Tab beantwortet, steht in der Berichte-Referenz.

Der Tab Nutzung ist der Ort, an dem die unten beschriebenen Werte je Provider liegen. Öffne Berichte → Nutzung, um sie in der UI zu lesen, oder nutze die Web-Terminal-Befehle usage und budget aus den späteren Abschnitten.

Die Übersicht-Diagramme lesen

Berichte → Übersicht stellt die Agenten-Arbeit über einen von dir wählbaren Zeitraum dar (zum Beispiel den letzten Tag, die letzte Woche oder den letzten Monat). Die Aufschlüsselungen sind:

• Nach Agent – Arbeit, die jedem Agenten-Profil zugeordnet ist.
• Nach Modell – Arbeit, die jedem Modell zugeordnet ist.
• Nach Lauf-Art – zum Beispiel interaktive Aufgabe, Workflow oder Backlog-Lauf.
• Nach Projekt – Arbeit, die jedem Projekt zugeordnet ist.

Jede Aufgabe meldet außerdem die produzierten Codezeilen (LOC), vom Runner erfasst, sodass die Übersicht LOC neben Kosten und Lauf-Anzahl zeigen kann.

Die Übersicht liest GET /api/reports/overview.

Hinweis

Das Panel „Nutzung & Auslastung” ist eine Admin-/Owner-Oberfläche. Ein Workspace-Mitglied oder Betrachter sieht die Anzeigen nicht – die Budget-Karte ist hingegen für jedes Mitglied lesbar.

Die Abo-Auslastungsanzeigen lesen

Du bekommst eine Karte pro verbundenem Konto, nicht eine Karte pro Fenster. Die Karte nennt Provider und Konto, und jedes Nutzungsfenster dieses Kontos ist eine Zeile darin. Drei Konten sind drei Karten – auch wenn eines mehrere Fenster hat und ein anderes keines.

Ein Fenster ist ein rollierendes Kontingent, das sich nach einem Zeitplan wieder auffüllt. Welche Fenster ein Konto hat, hängt vom Provider ab, denn SupaCloud zeigt nur ein Fenster, das es wirklich lesen kann:

Provider	Fenster, die du siehst	Warum
Anthropic (Claude)	5 Stunden + wöchentlich	Der Provider meldet beide
OpenAI (Codex)	wöchentlich (plus Spark-Pool, wo der Tarif einen hat)	Das meldet der Harness
Google (Antigravity), GitHub Copilot	keine – Für diesen Anbieter ist kein Kontingent auslesbar.	Für diese meldet nichts ein Kontingent

Hinweis

Frühere Fassungen zeigten für jedes verbundene Abo ein 5-Stunden- und ein Wochenfenster, weil das die Form ist, die Anthropic veröffentlicht. Für Google und Copilot standen diese Anzeigen für immer auf Warte auf erste Messung – eine Messung, die strukturell nie eintreffen konnte. Sie sind weg: das Konto erscheint weiterhin und sagt klar, dass kein Kontingent auslesbar ist, statt einen leeren Balken zu zeigen.

Jede Fenster-Zeile zeigt:

• Einen Füllbalken mit dem Prozentsatz des verbrauchten Fensters.
• Einen Reset-Countdown an der Zeile selbst – Setzt in X Std. Y Min. zurück oder Setzt bald zurück. Jede Zeile trägt einen, und er zählt am meisten, wenn ein Fenster voll ist: wann geht es wieder? ist dann die einzige Information, die du brauchst. Eine Zeile ohne bekannten Reset sagt Rückstellung unbekannt, statt die Stelle leer zu lassen.
• Ihre Herkunft, denn eine Messung und eine Schätzung sind nicht dieselbe Aussage:

Zeile sieht so aus	Bedeutet
einfacher Balken	Gemessen – der Wert kam vom Provider
Balken + Geschätzt	Unsere Rechnung aus deinen eigenen Ausgaben gegen eine konfigurierte Obergrenze – nichts, was der Provider gemeldet hat
gedämpfte Zeile, Warte auf erste Messung…	Das Fenster existiert und ein Erzeuger dafür existiert, aber es ist noch keine Messung eingetroffen

Und jede Karte nennt ihren Messzeitpunkt – Gemessen vor 4 Minuten oder Noch nie gemessen. Ohne ihn ist ein Balken auf 100 % erschöpft nicht von einer veralteten Messung zu unterscheiden – und genau das ist die Frage, die man in diesem Zustand hat.

Die Balkenfarbe gibt das Auslastungsband an:

Band	Bedeutung	Farbe
Unterhalb des Drosselungsbands	Komfortabler Spielraum	Primär (Türkis)
Bald gedrosselt	Innerhalb des Drosselungsbands – Verlangsamungen sind nah	Warnung (Bernstein)
Erschöpft	Das Fenster ist zu 100 % oder mehr gefüllt	Fehler (Rot)

Achtung

Ist ein Fenster erschöpft, pausieren Läufe auf diesem Abo und werden automatisch fortgesetzt, sobald sich das Fenster erneuert – die Arbeit geht nicht verloren. Genau deshalb ist die Anzeige wichtig: Das bernsteinfarbene Bald gedrosselt ist dein Signal, kürzerzutreten oder Arbeit auf einen anderen Provider zu verlagern, bevor ein Fenster voll ist.

Hinweis

Mehrere Konten desselben Providers ergeben je eine Karte, benannt nach dem Konto – die Fenster werden nie in einen Balken zusammengeführt, sodass du jedes Abo getrennt ablesen kannst. Die Karte trägt das Konto-Label auch dann, wenn es das einzige Konto dieses Providers ist.

Hinweis

Manche Provider stellen neben dem Gesamt-Fenster auch Pro-Modell-Fenster bereit – etwa das Spark-Budget von Codex oder das Sonnet-Fenster von Claude. Diese sind benannte, getrennte Zeilen in derselben Konto-Karte, sodass ein eigener Pool auch als eigener Pool zu lesen ist. Das Gesamt-Fenster entscheidet darüber, ob ein Lauf pausiert.

Über das Web-Terminal

Dieselben Abo-Fenster sind im Web-Terminal verfügbar:

usage

Es listet jedes Abo-Fenster mit seinem Füllprozentsatz und einer Markierung exhausted, throttling soon oder refresh in Xm auf. Einem reinen API-Key-Workspace wird gesagt, stattdessen budget zu nutzen; einem Aufrufer ohne Admin-Rechte wird mitgeteilt, dass die Ansicht nur für Admins/Owner ist.

Ein Workspace-Budget festlegen

Die Karte KI-Budget steuert das monatliche Dollar-Limit und die Ausgaben für API-Mode-Agents (pro Token).

1. Öffne Einstellungen → Arbeitsbereich und finde die Karte KI-Budget. Sie zeigt Diesen Monat (bisherige Ausgaben), Verbleibend und ein Status-Abzeichen (OK / Warnung / Kritisch / Blockiert / Unbegrenzt).

2. Lege das Monatliche USD-Limit fest. Lass es leer für ein unbegrenztes (limitfreies) Budget.

3. Lege optional die Schwellen Warnung % und Kritisch % fest (wann das Status-Abzeichen umschlägt), die kommagetrennten Alarm-Schwellen (z. B. 50,80,100), die Benachrichtigungen auslösen, sowie Provider-Limits unter Provider-Limits.

4. Schalte Hard Stop am Limit ein, um neue API-Mode-Läufe zu blockieren, sobald das Limit erreicht ist, oder aus, um sie über das Limit hinaus fortlaufen zu lassen – dann nur mit dem Status.

5. Klicke auf Budget speichern.

Du kannst das Budget auch über das Web-Terminal lesen:

budget

Es gibt den Status, die Monatsausgaben gegen das Limit, den verbleibenden Betrag, etwaige Provider-Ausgaben und aktive Alarme aus.

Hinweis

Das Budget-Limit gilt nur für API-Mode-Agents (pro Token). Es begrenzt kein Abo-Provider – ein Abo wird durch seine Nutzungsfenster begrenzt, nicht durch Dollar, sodass seine Arbeit durch die Auslastungsanzeigen oben geregelt wird.

Abo-Fenster vs. Dollar-Budget

	Abo-Fenster	Dollar-Budget
Gilt für	OAuth-Abo-Provider (vorausbezahlte Tarife)	API-Key-Provider (pro Token)
Begrenzt durch	Rollierende Nutzungsfenster (5-Stunden / wöchentlich / monatlich)	Ein monatliches USD-Limit
Du beobachtest	Wie voll ein Fenster ist (die Auslastungsanzeigen)	Wie viel du gegen das Limit ausgibst
Am Limit	Läufe pausieren und werden bei Erneuerung automatisch fortgesetzt	Läufe werden blockiert (bei aktivem Hard Stop) oder laufen mit Status weiter
Oberfläche	Panel Nutzung & Auslastung (Admin/Owner) · usage	Karte KI-Budget (alle Mitglieder) · budget

Kurz gesagt: Ein Abo wird über Zeitfenster, die sich wieder auffüllen gemessen, also steuerst du es, indem du die Auslastung liest und deine Arbeit timest; ein API-Key wird über ausgegebenes Geld gemessen, also steuerst du ihn, indem du ein Limit festlegst.

Siehe auch

• Einen Bericht planen
• Web-Terminal-Befehlsreferenz
• Secrets in der UI verwalten
• Agenten-Aktionen freigeben oder ablehnen