danielkremen818/ultracost

Was macht ultracost?

Reduzieren Sie die Kosten dynamischer Workflows in Claude Code: Weisen Sie jedem Subagenten-Stage das passende Modell und den passenden Aufwand zu, schätzen Sie die Ausgaben vor dem Start und blockieren Sie Skripte, die unbemerkt jeden Stage auf Opus ausführen würden.

Warum ultracost?

Standardmäßig führen dynamische Workflows in Claude Code jeden Stage auf dem teuersten konfigurierten Modell (oft Opus) aus. Das kann schnell teuer werden – insbesondere bei Workflows mit vielen Subagenten. Ultracost gibt Ihnen die Kontrolle zurück.

Funktionen

• Modell-Pinning: Legen Sie für jeden Subagenten-Stage explizit fest, welches Modell verwendet werden soll (z. B. claude-sonnet-4-20250514 für einfache Aufgaben, claude-opus-4-20250514 für komplexe Analysen).
• Aufwand-Steuerung: Definieren Sie den „effort“ (Aufwand) pro Stage, um Rechenzeit zu optimieren.
• Kostenschätzung: Lassen Sie sich vor dem Start eines Workflows die geschätzten Kosten anzeigen.
• Opus-Blocker: Verhindern Sie, dass Skripte versehentlich jeden Stage auf Opus ausführen, indem Sie einen Budgetgrenzwert setzen.

Installation

1. Fügen Sie ultracost als MCP-Server in Claude Code hinzu:

   claude add mcp danielkremen818/ultracost
   

2. Erstellen Sie eine ultracost.json-Konfigurationsdatei im Stammverzeichnis Ihres Projekts:

   {
     "stages": {
       "stage-name": {
         "model": "claude-sonnet-4-20250514",
         "effort": "low",
         "budget": 0.05
       },
       "stage-name-2": {
         "model": "claude-opus-4-20250514",
         "effort": "high",
         "budget": 0.50
       }
     },
     "defaultModel": "claude-sonnet-4-20250514",
     "defaultEffort": "medium",
     "maxBudget": 2.00
   }
   

Verwendung

• Kostenschätzung anzeigen: Führen Sie ultracost estimate aus, um eine Kostenaufstellung für Ihren aktuellen Workflow zu erhalten.
• Workflow ausführen: Starten Sie Ihren Workflow wie gewohnt – ultracost überschreibt automatisch die Modelle und Aufwände gemäß Ihrer Konfiguration.
• Budget einhalten: Überschreitet ein Workflow das maxBudget, wird die Ausführung gestoppt, bevor Kosten anfallen.

Konfigurationsoptionen

Schlüssel	Typ	Beschreibung	Standardwert
stages	Objekt	Ein Map von Stage-Namen zu deren Konfiguration (Modell, Aufwand, Budget)	{}
defaultModel	String	Das Standardmodell für Stages, die nicht explizit konfiguriert sind	claude-sonnet-4-20250514
defaultEffort	String	Der Standardaufwand für nicht konfigurierte Stages (low/medium/high)	medium
maxBudget	Zahl	Maximales erlaubtes Budget (in USD) für einen Workflow	1.00

Beispiele

Einfache Konfiguration

{
  "stages": {
    "code-review": {
      "model": "claude-sonnet-4-20250514",
      "effort": "high"
    },
    "test-generation": {
      "model": "claude-haiku-3-5-sonnet-20241022",
      "effort": "low"
    }
  },
  "defaultModel": "claude-sonnet-4-20250514",
  "maxBudget": 0.50
}

Kostenschätzung abfragen

ultracost estimate --workflow my-workflow

Lizenz

MIT