Vue d’ensemble de la facturation

CodeCourier fonctionne selon un modèle de facturation basé sur l’usage où les coûts sont déterminés par les services externes consommés lors des opérations des agents IA. Plutôt que de facturer un abonnement forfaitaire, CodeCourier suit votre consommation réelle de temps de calcul de sandbox, de tokens de modèle IA et de traitement de tâches de fond, puis calcule les coûts selon les tarifs publiés. Cette page fournit une vue d’ensemble du fonctionnement de la facturation, des types de compte et de la manière de gérer vos coûts efficacement.

Modèle de facturation

La facturation de CodeCourier s’articule autour du concept de suivi des coûts basé sur l’usage. Chaque opération qui consomme des ressources externes est enregistrée avec son coût associé. Les services suivis incluent :

• Claude Code -- Utilisation de tokens des modèles Claude d’Anthropic (tokens d’entrée, tokens de sortie), suivie par palier de modèle.
• E2B -- Temps de calcul de sandbox mesuré en secondes de temps de fonctionnement actif de la VM.
• Trigger.dev -- Temps d’exécution des tâches de fond et ressources de calcul.
• Convex -- Opérations de base de données et consommation de bande passante.
• OpenCode -- Utilisation de tokens d’outils de codage IA alternatifs.
• Codex -- Utilisation de tokens d’outils basés sur OpenAI Codex.

Chaque service a des taux de coût configurables stockés dans la table usageCostRates. Les taux peuvent être définis par type de métrique (tokens d’entrée, tokens de sortie, heures de sandbox, stockage) et par modèle ou palier (par exemple, Claude Opus et Claude Sonnet ont des coûts par token différents).

Comment les coûts sont calculés

Lorsqu’une tâche Trigger.dev termine une étape (itération designer, revue checker, issue session, etc.), elle rapporte les métriques d’usage à Convex via l’opération de callback usage.computeCostAndRecord. Cette opération :

1. Recherche le taux de coût applicable pour le service et le type de métrique.
2. Multiplie la quantité consommée par le coût par unité.
3. Crée une entrée usageRecord avec le coût calculé en USD, liée au projet, au run et à la sandbox qui l’ont généré.

Cette approche fournit une attribution détaillée : vous pouvez voir exactement quel run, quelle étape et quel modèle a généré chaque coût, jusqu’au décompte de tokens individuel.

Types de compte

Comptes individuels

Chaque utilisateur de CodeCourier commence avec un compte individuel. Vous pouvez créer des projets, configurer les clés API de fournisseur, lancer des sandboxes et exécuter des workflows. Tout l’usage est suivi au niveau du projet.

Comptes d’équipe

Les projets peuvent avoir plusieurs membres avec différents rôles (owner, admin, member). L’usage est agrégé au niveau du projet, quel que soit le membre de l’équipe qui a initié l’opération. Cela signifie que le propriétaire du projet voit une vue unifiée de tout l’usage de l’équipe.

Cycle de facturation

L’usage est suivi en continu et agrégé sur une base quotidienne. La table usageRecords stocke les enregistrements avec une chaîne de date ISO (format AAAA-MM-JJ), permettant les queries par plage de dates. La table dailyStats fournit des statistiques quotidiennes préagrégées pour un rendu rapide du tableau de bord.

Vous pouvez consulter votre usage pour n’importe quelle période via le tableau de bord d’utilisation, qui prend en charge les vues suivantes :

• Ventilation quotidienne -- Coût par jour sur une plage de dates sélectionnée.
• Ventilation par service -- Coût par service (Claude Code, E2B, Trigger.dev, etc.).
• Ventilation par modèle -- Coût par modèle spécifique (utile pour optimiser la sélection de modèle).
• Attribution par run -- Coût par run individuel, y compris la ventilation par étape.

Moyens de paiement

CodeCourier utilise un modèle bring-your-own-key pour les services externes. Plutôt que de vous facturer via un système de facturation central, vous fournissez vos propres clés API pour chaque service :

• E2B -- Vous vous inscrivez directement auprès d’E2B et fournissez votre clé API. E2B vous facture directement le temps de calcul de sandbox.
• Anthropic -- Vous utilisez votre propre clé API ou token OAuth Anthropic. Anthropic vous facture directement l’utilisation des tokens.
• OpenRouter / OpenAI -- Même modèle : vous fournissez votre propre clé et êtes facturé par le fournisseur.

Le suivi des coûts de CodeCourier est une fonctionnalité informative qui vous aide à comprendre et optimiser vos dépenses sur ces services. Les coûts affichés dans le tableau de bord sont calculés selon les tarifs publiés et peuvent différer légèrement de vos factures réelles de fournisseur en raison de changements de tarifs ou de remises sur volume.

Gestion des coûts

Définir des budgets

Bien que CodeCourier n’impose pas de limites de dépenses strictes (puisque vous êtes facturé par des fournisseurs externes), le système de suivi de l’usage vous aide à rester informé. Surveillez vos dépenses quotidiennes et hebdomadaires via le tableau de bord d’analytique et configurez vos propres alertes via les tableaux de bord de vos fournisseurs.

Optimiser les coûts

Plusieurs stratégies peuvent aider à réduire les coûts :

• Choisissez des modèles appropriés. Utilisez des modèles plus petits et plus rapides pour les tâches simples et réservez les modèles plus grands pour le travail complexe. Le système de personas vous permet d’assigner des modèles spécifiques à différentes étapes de workflow.
• Définissez des limites d’itération raisonnables. Les workflows designer-checker avec des itérations illimitées peuvent consommer beaucoup de tokens. Définissez une limite maxIterations qui équilibre qualité et coût.
• Utilisez des délais d’expiration de sandbox. Configurez des délais appropriés pour empêcher les sandboxes de tourner plus longtemps que nécessaire.
• Arrêtez les sandboxes inactives. Utilisez l’action « Arrêter toutes les sandboxes » lorsque vous avez terminé pour stopper les frais E2B inutiles.
• Examinez l’analytique des runs. La ventilation des coûts par run aide à identifier les runs coûteux et à optimiser les workflows en conséquence.

Suivi entreprise

Les enregistrements d’usage de CodeCourier incluent des champs de suivi de niveau entreprise pour les organisations qui ont besoin d’une attribution détaillée des coûts :

• toolId -- Quel outil CLI a été utilisé (claude, opencode, codex).
• modelId -- L’ID de modèle exact utilisé.
• stepType -- Quelle étape du pipeline a généré l’usage.
• stepIndex -- Le numéro d’itération.
• inputTokens / outputTokens -- Décomptes de tokens bruts pour une vérification précise des coûts.
• durationMs -- Durée d’exécution de l’étape.
• userId -- Quel membre de l’équipe a déclenché l’opération.
• personaId -- Quelle persona était responsable.

Ces champs permettent des rapports détaillés et une répartition des coûts entre les équipes, les projets et les workflows.