Claude Code Team-Budget: Gemeinsames Limit fürs Gateway

Wenn ein Team Claude Code nutzt, kommt früher oder später die Frage: Wie verhindere ich, dass die KI-Kosten aus dem Ruder laufen? Bisher hieß die Antwort im Claude Apps Gateway: Limits pro Person. Mit dem Update auf Version 2.1.316 kommt ein geteiltes Budget für ganze Gruppen dazu. Dazu gibt es eine neue Einstellung, mit der du festlegst, wie gründlich Subagenten standardmäßig arbeiten. Stand: November 2026.

Was passiert ist

Anthropic hat am 31. Oktober Claude Code v2.1.316 veröffentlicht. Für Teams sind zwei Einträge interessant.

Gemeinsame Gruppenbudgets im Gateway. Laut Release Notes gibt es jetzt „pooled group budgets“ im Claude Apps Gateway: ein Monatsbudget, das sich die Mitglieder einer Gruppe teilen, zusätzlich zum Limit jeder Person. Gesetzt wird es mit dem Feld pooled_budget über die Admin-API für Ausgabenlimits (Quelle).

Effort-Standard für Subagenten. Die neue Umgebungsvariable CLAUDE_CODE_SUBAGENT_EFFORT legt fest, auf welcher Effort-Stufe Subagenten laufen, wenn nichts anderes eine Stufe vorgibt. Bisher haben sie in diesem Fall die Stufe der Sitzung übernommen (Quelle).

Was ist der Claude Apps Gateway?

Der Gateway ist ein Dienst, den du selbst betreibst. Er sitzt zwischen Claude Code und deinem Cloud-Anbieter. Laut Dokumentation lässt er Claude Code über Amazon Bedrock, Claude Platform on AWS, Google Cloud oder Microsoft Foundry laufen, mit Anmeldung per Single Sign-on, Modellfreigaben pro Gruppe und Telemetrie (Quelle).

Anthropic sagt selbst, für wen das gedacht ist: für Organisationen, die die Anfragen über den eigenen Cloud-Anbieter leiten müssen oder wollen, etwa weil die Daten in einer bestimmten Region bleiben sollen. Wer das nicht braucht, ist laut Anthropic mit Claude Enterprise womöglich besser bedient (Quelle). Wichtig: Die Anmeldung am Gateway ersetzt die Anmeldung über Claude for Teams oder Enterprise. Beides gleichzeitig geht nicht (Quelle).

Wie funktionieren Ausgabenlimits im Gateway?

Gruppenbudgets bauen auf den Ausgabenlimits auf, die es im Gateway schon gab. Die Dokumentation zu den Ausgabenlimits beschreibt den Ablauf so:

• Limits setzt ein Admin über eine Admin-API unter /v1/organizations/spend_limits, nicht in der Konfigurationsdatei. Jedes Limit besteht aus Geltungsbereich, Betrag und Zeitraum.
• Es gibt drei Geltungsbereiche: eine einzelne Person, eine Gruppe aus deinem Identitätsanbieter oder die ganze Organisation.
• Als Zeitraum geht täglich, wöchentlich oder monatlich. Beträge werden in US-Cent angegeben. Die Zähler werden um 00:00 Uhr UTC zurückgesetzt: täglich, wöchentlich am Montag, monatlich am Ersten.
• Wer ein Limit überschreitet, bekommt bei der nächsten Anfrage einen Fehler 429 und ist gesperrt, bis der Zeitraum zurückgesetzt wird oder ein Admin das Limit anhebt.
• Claude Code warnt vorher, sobald 75 Prozent und dann 95 Prozent des Limits verbraucht sind.
• Die Beträge sind Schätzungen des Gateways, keine Rechnung. Für die Abrechnung zählt, was dein Cloud-Anbieter ausweist.

Die Doku nennt zwei Beispiele: ein Standardlimit von 500 US-Dollar pro Monat für jede Person in der Organisation und ein strengeres Limit von 100 US-Dollar pro Tag für jedes Mitglied der Gruppe „contractors“ (Quelle).

Ein wichtiger Satz in der Doku: Ein Gruppen- oder Organisationslimit ist ein Standard pro Person, den jedes Mitglied erbt, „not a shared pool“, also kein gemeinsamer Topf (Quelle). Genau diese Lücke soll pooled_budget schließen. Bisher konntest du nur sagen: „Jede Person darf maximal X ausgeben.“ Jetzt kannst du zusätzlich sagen: „Die ganze Gruppe darf im Monat zusammen maximal Y ausgeben.“

Als ich das geprüft habe, beschrieb die Doku das neue Feld noch nicht. Wie die Anfrage für pooled_budget genau aussieht und was beim Erreichen des Gruppenbudgets passiert, steht bisher nur knapp in den Release Notes. Bevor du das einrichtest, lohnt sich ein Blick in die aktuelle Doku.

Was macht CLAUDE_CODE_SUBAGENT_EFFORT?

Subagenten sind Helfer, die Claude Code für Teilaufgaben startet. Die Effort-Stufe bestimmt, wie gründlich das Modell arbeitet. Laut Dokumentation zu Subagenten gibt es die Stufen low, medium, high, xhigh und max. Welche davon verfügbar sind, hängt vom Modell ab.

Für einen Subagenten konntest du die Stufe schon vorher auf mehreren Wegen festlegen: mit dem Feld effort in der Definition des Subagenten, mit einem Effort-Parameter beim einzelnen Aufruf oder mit der Variable CLAUDE_CODE_EFFORT_LEVEL, die über beidem steht (Quelle). Die neue Variable CLAUDE_CODE_SUBAGENT_EFFORT greift nur, wenn keiner dieser Wege eine Stufe nennt. Dann übernimmt der Subagent nicht mehr automatisch die Stufe deiner Sitzung (Quelle).

Praktisch heißt das: Du kannst selbst gründlich arbeiten und die Helfer trotzdem auf eine andere Stufe setzen, ohne jeden Subagenten einzeln zu konfigurieren. Wie viele Agenten ein Projekt überhaupt braucht, habe ich in Anthropics Rat zu einem statt vielen Agenten zusammengefasst.

Was es für dich bedeutet

Für die meisten Selbstständigen und kleinen Teams in meinem Umfeld ändert dieses Update wenig. Der Gateway ist kein Schalter in einem Abo. Du betreibst ihn selbst, brauchst einen Identitätsanbieter mit Single Sign-on, eine Postgres-Datenbank für die Zähler und ein Konto bei einem der unterstützten Cloud-Anbieter (Quelle). Für drei Leute, die mit einem Claude-Abo arbeiten, ist das zu viel Technik.

Wann es sich lohnt: wenn dein Unternehmen Claude Code ohnehin über Amazon Bedrock, Google Cloud oder Microsoft Foundry nutzt, zum Beispiel weil Daten in der EU bleiben sollen. Dann bekommst du mit dem Gruppenbudget eine Obergrenze für ein ganzes Projektteam oder eine Abteilung, statt nur die einzelnen Limits aufzusummieren. Das hilft vor allem, wenn einzelne Leute stark schwanken: Eine Person braucht diesen Monat viel, die andere wenig, und trotzdem bleibt die Gesamtsumme gedeckelt.

Wann nicht: wenn du Claude Code mit einem normalen Abo nutzt. Was die Pläne kosten und welche Limits dort gelten, steht in meinem Ratgeber Was kostet Claude Code?. Wer im Team über die API abrechnet, findet in Claude API Kosten: Neue Analytics-API zeigt Verbrauch eine einfachere Möglichkeit, den Verbrauch im Blick zu behalten.

Die Subagent-Variable ist dagegen für alle interessant, die Claude Code mit Subagenten nutzen, ganz ohne Gateway. Wenn deine Sitzung auf einer hohen Effort-Stufe läuft und die Subagenten nur Routinearbeit erledigen, kannst du für sie einen eigenen Standard setzen (Quelle).

Wenn du vor der Frage stehst, welche Claude-Variante für dein Unternehmen passt, hilft dir Claude für Unternehmen: Team, Enterprise und Kosten bei der Entscheidung, bevor du über einen eigenen Gateway nachdenkst.

Quellen

• Primärquelle: Release Notes Claude Code v2.1.316 auf GitHub
• Claude-Code-Dokumentation: Ausgabenlimits im Claude Apps Gateway
• Claude-Code-Dokumentation: Claude Apps Gateway
• Claude-Code-Dokumentation: Subagenten und Effort-Stufen

Häufige Fragen

Kann ich in Claude Code ein gemeinsames Budget für mein Team festlegen?

Ja, aber nur über den Claude Apps Gateway. Seit Version 2.1.316 gibt es dort ein monatliches Gruppenbudget, das sich die Mitglieder einer Gruppe teilen. Gesetzt wird es mit dem Feld pooled_budget über die Admin-API für Ausgabenlimits. Es gilt zusätzlich zum Limit jeder einzelnen Person.

Was passiert, wenn jemand sein Claude-Code-Limit im Gateway überschreitet?

Der Gateway beantwortet die nächste Anfrage mit einem Fehler 429 und blockiert die Person, bis der Zeitraum zurückgesetzt wird oder ein Admin das Limit anhebt. Claude Code warnt vorher, sobald 75 Prozent und dann 95 Prozent des Limits verbraucht sind.

Was macht CLAUDE_CODE_SUBAGENT_EFFORT?

Die Umgebungsvariable legt fest, auf welcher Effort-Stufe Subagenten arbeiten, wenn sonst nichts eine Stufe vorgibt. Bisher haben Subagenten in diesem Fall die Stufe der laufenden Sitzung übernommen.

Brauche ich den Claude Apps Gateway als kleines Team?

Meist nicht. Der Gateway ist für Organisationen gedacht, die Claude Code über den eigenen Cloud-Anbieter wie Amazon Bedrock, Google Cloud oder Microsoft Foundry laufen lassen wollen oder müssen. Man betreibt ihn selbst, mit Single Sign-on und einer Postgres-Datenbank. Wer mit einem normalen Claude-Abo arbeitet, hat davon nichts.