Panoramica della fatturazione

CodeCourier opera con un modello di fatturazione basato sull’utilizzo in cui i costi sono determinati dai servizi esterni consumati durante le operazioni degli agenti IA. Invece di addebitare un canone di abbonamento fisso, CodeCourier traccia il tuo consumo effettivo di tempo di calcolo delle sandbox, token dei modelli IA ed elaborazione dei job in background, quindi calcola i costi in base alle tariffe pubblicate. Questa pagina fornisce una panoramica di come funziona la fatturazione, dei tipi di account e di come gestire i tuoi costi in modo efficace.

Modello di fatturazione

La fatturazione di CodeCourier ruota attorno al concetto di tracciamento dei costi basato sull’utilizzo. Ogni operazione che consuma risorse esterne viene registrata con il suo costo associato. I servizi tracciati includono:

• Claude Code -- Utilizzo di token dei modelli Claude di Anthropic (token di input, token di output), tracciato per livello di modello.
• E2B -- Tempo di calcolo delle sandbox misurato in secondi di attività della VM.
• Trigger.dev -- Tempo di esecuzione dei job in background e risorse di calcolo.
• Convex -- Operazioni di database e consumo di banda.
• OpenCode -- Utilizzo di token di strumenti di coding IA alternativi.
• Codex -- Utilizzo di token di strumenti basati su OpenAI Codex.

Ogni servizio ha tariffe di costo configurabili memorizzate nella tabella usageCostRates. Le tariffe possono essere definite per tipo di metrica (token di input, token di output, ore di sandbox, archiviazione) e per modello o livello (ad esempio, Claude Opus e Claude Sonnet hanno costi per token diversi).

Come vengono calcolati i costi

Quando un task Trigger.dev completa un passaggio (iterazione designer, revisione checker, issue session, ecc.), riporta le metriche di utilizzo a Convex tramite l’operazione di callback usage.computeCostAndRecord. Questa operazione:

1. Cerca la tariffa di costo applicabile per il servizio e il tipo di metrica.
2. Moltiplica la quantità consumata per il costo per unità.
3. Crea una voce usageRecord con il costo calcolato in USD, collegata al progetto, al run e alla sandbox che l’hanno generata.

Questo approccio fornisce un’attribuzione dettagliata: puoi vedere esattamente quale run, quale passaggio e quale modello ha generato ogni costo, fino al conteggio dei singoli token.

Tipi di account

Account individuali

Ogni utente di CodeCourier inizia con un account individuale. Puoi creare progetti, configurare le chiavi API dei provider, avviare sandbox ed eseguire workflow. Tutto l’utilizzo viene tracciato a livello di progetto.

Account di team

I progetti possono avere più membri con ruoli diversi (owner, admin, member). L’utilizzo viene aggregato a livello di progetto indipendentemente da quale membro del team ha avviato l’operazione. Ciò significa che il proprietario del progetto vede una vista unificata di tutto l’utilizzo del team.

Ciclo di fatturazione

L’utilizzo viene tracciato continuamente e aggregato su base giornaliera. La tabella usageRecords memorizza i record con una stringa di data ISO (formato AAAA-MM-GG), abilitando le query per intervallo di date. La tabella dailyStats fornisce statistiche giornaliere preaggregate per un rendering rapido della dashboard.

Puoi visualizzare il tuo utilizzo per qualsiasi periodo tramite la dashboard di utilizzo, che supporta le seguenti viste:

• Ripartizione giornaliera -- Costo per giorno su un intervallo di date selezionato.
• Ripartizione per servizio -- Costo per servizio (Claude Code, E2B, Trigger.dev, ecc.).
• Ripartizione per modello -- Costo per modello specifico (utile per ottimizzare la selezione del modello).
• Attribuzione per run -- Costo per singolo run, inclusa la ripartizione per passaggio.

Metodi di pagamento

CodeCourier usa un modello bring-your-own-key per i servizi esterni. Invece di addebitarti tramite un sistema di fatturazione centrale, fornisci le tue chiavi API per ogni servizio:

• E2B -- Ti registri direttamente con E2B e fornisci la tua chiave API. E2B ti addebita direttamente il tempo di calcolo delle sandbox.
• Anthropic -- Usi la tua chiave API o token OAuth Anthropic. Anthropic ti addebita direttamente l’utilizzo dei token.
• OpenRouter / OpenAI -- Stesso modello: fornisci la tua chiave e vieni addebitato dal provider.

Il tracciamento dei costi di CodeCourier è una funzionalità informativa che ti aiuta a comprendere e ottimizzare la tua spesa su questi servizi. I costi mostrati nella dashboard vengono calcolati in base alle tariffe pubblicate e potrebbero differire leggermente dalle fatture effettive del provider a causa di variazioni delle tariffe o sconti sul volume.

Gestione dei costi

Impostare budget

Sebbene CodeCourier non imponga limiti di spesa rigidi (poiché vieni addebitato da provider esterni), il sistema di tracciamento dell’utilizzo ti aiuta a rimanere informato. Monitora la tua spesa giornaliera e settimanale tramite la dashboard di analytics e configura i tuoi avvisi tramite le dashboard dei tuoi provider.

Ottimizzare i costi

Diverse strategie possono aiutare a ridurre i costi:

• Scegli modelli appropriati. Usa modelli più piccoli e veloci per i task semplici e riserva i modelli più grandi per il lavoro complesso. Il sistema di personas ti consente di assegnare modelli specifici a diversi passaggi del workflow.
• Imposta limiti di iterazione ragionevoli. I workflow designer-checker con iterazioni illimitate possono consumare molti token. Imposta un limite maxIterations che bilanci qualità e costo.
• Usa i timeout delle sandbox. Configura timeout appropriati per evitare che le sandbox girino più a lungo del necessario.
• Termina le sandbox inattive. Usa l’azione « Termina tutte le sandbox » quando hai finito per fermare gli addebiti E2B non necessari.
• Rivedi le analytics dei run. La ripartizione dei costi per run aiuta a identificare i run costosi e a ottimizzare i workflow di conseguenza.

Tracciamento enterprise

I record di utilizzo di CodeCourier includono campi di tracciamento di livello enterprise per le organizzazioni che necessitano di un’attribuzione dettagliata dei costi:

• toolId -- Quale strumento CLI è stato usato (claude, opencode, codex).
• modelId -- L’ID esatto del modello usato.
• stepType -- Quale passaggio della pipeline ha generato l’utilizzo.
• stepIndex -- Il numero di iterazione.
• inputTokens / outputTokens -- Conteggi grezzi dei token per una verifica precisa dei costi.
• durationMs -- Durata di esecuzione del passaggio.
• userId -- Quale membro del team ha avviato l’operazione.
• personaId -- Quale persona era responsabile.

Questi campi abilitano report dettagliati e l’allocazione dei costi tra team, progetti e workflow.