Abrechnungs-Übersicht

CodeCourier arbeitet mit einem nutzungsbasierten Abrechnungsmodell, bei dem die Kosten durch die während des KI-Agentenbetriebs verbrauchten externen Dienste bestimmt werden. Statt einer pauschalen Abonnementgebühr erfasst CodeCourier Ihren tatsächlichen Verbrauch an Sandbox-Rechenzeit, KI-Modell-Tokens und Hintergrundjob-Verarbeitung und berechnet die Kosten anhand der veröffentlichten Tarife. Diese Seite bietet einen Überblick darüber, wie die Abrechnung funktioniert, welche Kontoarten es gibt und wie Sie Ihre Kosten effektiv verwalten.

Abrechnungsmodell

Die Abrechnung von CodeCourier basiert auf dem Konzept der nutzungsbasierten Kostenerfassung. Jede Operation, die externe Ressourcen verbraucht, wird mit den zugehörigen Kosten erfasst. Die erfassten Dienste umfassen:

• Claude Code -- Token-Nutzung der Claude-Modelle von Anthropic (Input-Tokens, Output-Tokens), erfasst pro Modell-Stufe.
• E2B -- Sandbox-Rechenzeit gemessen in Sekunden aktiver VM-Laufzeit.
• Trigger.dev -- Ausführungszeit und Rechenressourcen für Hintergrundjobs.
• Convex -- Datenbankoperationen und Bandbreitenverbrauch.
• OpenCode -- Token-Nutzung alternativer KI-Coding-Tools.
• Codex -- Token-Nutzung von Tools auf Basis von OpenAI Codex.

Jeder Dienst verfügt über konfigurierbare Kostensätze, die in der Tabelle usageCostRates abgelegt sind. Tarife können pro Metrikart (Input-Tokens, Output-Tokens, Sandbox-Stunden, Speicher) und pro Modell oder Stufe definiert werden (beispielsweise haben Claude Opus und Claude Sonnet unterschiedliche Kosten pro Token).

Wie Kosten berechnet werden

Wenn ein Trigger.dev-Task einen Schritt abschließt (Designer-Iteration, Checker-Review, Issue-Sitzung usw.), meldet er Nutzungsmetriken über die Callback-Operation usage.computeCostAndRecord an Convex zurück. Diese Operation:

1. ermittelt den anwendbaren Kostensatz für Dienst und Metrikart,
2. multipliziert die verbrauchte Menge mit den Kosten pro Einheit und
3. erstellt einen Eintrag usageRecord mit den berechneten Kosten in USD, verknüpft mit dem Projekt, dem Run und der Sandbox, die den Verbrauch erzeugt haben.

Dieser Ansatz liefert eine detaillierte Zuordnung: Sie können genau sehen, welcher Run, welcher Schritt und welches Modell die jeweiligen Kosten verursacht hat - bis hin zur einzelnen Token-Anzahl.

Kontoarten

Einzelkonten

Jeder Nutzer von CodeCourier startet mit einem Einzelkonto. Sie können Projekte anlegen, Anbieter-API-Schlüssel konfigurieren, Sandboxes starten und Workflows ausführen. Die gesamte Nutzung wird auf Projektebene erfasst.

Team-Konten

Projekte können mehrere Mitglieder mit unterschiedlichen Rollen haben (Owner, Admin, Member). Die Nutzung wird unabhängig davon, welches Teammitglied die Operation gestartet hat, auf Projektebene aggregiert. Damit erhält der Projekt-Owner eine einheitliche Sicht auf die gesamte Nutzung im Team.

Abrechnungszyklus

Die Nutzung wird kontinuierlich erfasst und auf Tagesbasis aggregiert. Die Tabelle usageRecords speichert Datensätze mit einem ISO-Datumsstring (Format YYYY-MM-DD), wodurch Abfragen nach Zeitraum möglich sind. Die Tabelle dailyStats liefert voraggregierte Tagesstatistiken für ein schnelles Rendering des Dashboards.

Sie können Ihre Nutzung für beliebige Zeiträume über das Nutzungs-Dashboard einsehen, das folgende Ansichten unterstützt:

• Tagesaufschlüsselung -- Kosten pro Tag über einen ausgewählten Zeitraum.
• Aufschlüsselung nach Dienst -- Kosten nach Dienst (Claude Code, E2B, Trigger.dev usw.).
• Aufschlüsselung nach Modell -- Kosten nach konkretem Modell (nützlich zur Optimierung der Modellauswahl).
• Zuordnung pro Run -- Kosten pro Run, inklusive Aufschlüsselung nach Schritt.

Zahlungsmethoden

CodeCourier setzt für externe Dienste ein Bring-your-own-Key-Modell ein. Statt Sie zentral abzurechnen, stellen Sie Ihre eigenen API-Schlüssel für jeden Dienst bereit:

• E2B -- Sie registrieren sich direkt bei E2B und stellen Ihren API-Schlüssel bereit. E2B rechnet die Sandbox-Rechenzeit direkt mit Ihnen ab.
• Anthropic -- Sie verwenden Ihren eigenen Anthropic-API-Schlüssel oder OAuth-Token. Anthropic rechnet die Token-Nutzung direkt mit Ihnen ab.
• OpenRouter / OpenAI -- Gleiches Modell: Sie stellen Ihren eigenen Schlüssel bereit und werden vom Anbieter abgerechnet.

Die Kostenerfassung von CodeCourier ist eine informative Funktion, die Ihnen hilft, Ihre Ausgaben über diese Dienste hinweg zu verstehen und zu optimieren. Die im Dashboard angezeigten Kosten basieren auf veröffentlichten Tarifen und können aufgrund von Tarifänderungen oder Mengenrabatten geringfügig von Ihren tatsächlichen Anbieterrechnungen abweichen.

Kostenmanagement

Budgets festlegen

CodeCourier erzwingt keine harten Ausgabenobergrenzen (da Sie von externen Anbietern abgerechnet werden), aber die Nutzungserfassung hilft Ihnen, informiert zu bleiben. Beobachten Sie Ihre täglichen und wöchentlichen Ausgaben über das Analyse-Dashboard und richten Sie eigene Benachrichtigungen über die Dashboards der Anbieter ein.

Kosten optimieren

Mehrere Strategien können helfen, Kosten zu senken:

• Wählen Sie passende Modelle. Verwenden Sie kleinere, schnellere Modelle für einfache Aufgaben und reservieren Sie größere Modelle für komplexe Arbeiten. Das Persona-System ermöglicht es Ihnen, bestimmten Workflow-Schritten spezifische Modelle zuzuweisen.
• Setzen Sie sinnvolle Iterationsgrenzen. Designer-Checker-Workflows mit unbegrenzten Iterationen können erhebliche Tokens verbrauchen. Setzen Sie eine maxIterations-Grenze, die Qualität und Kosten ausbalanciert.
• Nutzen Sie Sandbox-Timeouts. Konfigurieren Sie passende Timeouts, damit Sandboxes nicht länger als nötig laufen.
• Beenden Sie inaktive Sandboxes. Verwenden Sie die Aktion „Alle Sandboxes beenden“, sobald Sie fertig sind, um unnötige E2B-Gebühren zu vermeiden.
• Überprüfen Sie Run-Analysen. Die Kostenaufschlüsselung pro Run hilft, teure Runs zu identifizieren und Workflows entsprechend zu optimieren.

Enterprise-Tracking

Die Nutzungsdatensätze von CodeCourier enthalten Tracking-Felder auf Enterprise-Niveau für Organisationen, die eine detaillierte Kostenzuordnung benötigen:

• toolId -- Welches CLI-Tool verwendet wurde (claude, opencode, codex).
• modelId -- Die exakt verwendete Modell-ID.
• stepType -- Welcher Pipeline-Schritt die Nutzung erzeugt hat.
• stepIndex -- Die Iterationsnummer.
• inputTokens / outputTokens -- Rohe Token-Zählungen für präzise Kostenüberprüfung.
• durationMs -- Ausführungsdauer des Schritts.
• userId -- Welches Teammitglied die Operation ausgelöst hat.
• personaId -- Welche Persona dafür verantwortlich war.

Diese Felder ermöglichen detaillierte Berichte und Kostenzuordnung über Teams, Projekte und Workflows hinweg.