Comment ça fonctionne
Suivez les coûts des agents de code IA à partir des journaux locaux.
Passcard aide les équipes et les indépendants à suivre les coûts des agents de programmation par personne, projet et client. Une application de bureau collecte l’utilisation localement et vérifie les budgets avant les actions prises en charge ; le tableau de bord web regroupe les données de tous les appareils.
De l'installation à une vue des coûts par projet
- Téléchargez une version de bureau disponible de Passcard, puis associez-la à votre espace de travail dans le navigateur. Chaque appareil reçoit son propre token révocable et est associé à un membre de l'espace de travail.
- L'application de bureau détecte les dossiers de journaux pris en charge, y compris ceux des profils supplémentaires. Vous pouvez vérifier, ajouter ou désactiver des dossiers dans les paramètres. Elle lit les journaux existants et collecte la nouvelle utilisation à mesure qu'ils changent.
- Associez les dépôts aux projets dans le tableau de bord. Les adresses distantes des dépôts relient l'utilisation de différents clones et appareils ; les projets peuvent être regroupés par client. Les espaces de travail d'équipe peuvent aussi comparer l'utilisation par personne et par équipe.
- Pour activer l'application des budgets, installez les hooks Passcard pour chaque agent pris en charge depuis l'application de bureau. La lecture des journaux d'utilisation ne suffit pas à installer le coupe-circuit.
Suivez les guides de configuration de Claude Code et CodexDisponible en anglais
Quels agents de code Passcard prend-il en charge ?
Passcard dispose de collecteurs locaux et d'intégrations par hooks pour huit agents. Les informations présentes dans les journaux de chaque agent déterminent l'exhaustivité et la rapidité du suivi de son utilisation.
| Agent | Mesure et limites |
|---|---|
| Claude Code | Lit les nombres de tokens enregistrés, déduplique les instantanés répétés des messages et tient compte des lectures et écritures du cache. |
| Codex CLI | Lit l'utilisation des tokens par tour dans les journaux de session et sépare les entrées en cache des autres tokens d'entrée. |
| Cursor | Estime les tokens à partir de la longueur des transcriptions. Celles-ci ne fournissent ni nombres de tokens, ni noms de modèles, ni horodatages par tour ; l'utilisation est donc signalée comme estimée. |
| Gemini CLI | Lit les nombres de tokens des sessions, sépare les entrées en cache et inclut les tokens de réflexion dans l'utilisation en sortie. |
| Grok CLI | Lit l'utilisation des tours terminés dans les journaux de session et la répartit par modèle. |
| Copilot CLI | Lit les totaux de tokens à la fermeture d'une session CLI. Les sessions en cours ou qui ne se sont pas fermées correctement peuvent ne fournir aucune donnée d'utilisation des tokens. |
| OpenCode | Lit l'utilisation des tokens dans la base SQLite locale ou dans l'ancien format de stockage des sessions. |
| pi | Lit l'utilisation des tokens dans les journaux de session locaux, y compris les lectures et écritures du cache. |
La prise en charge concerne ces agents locaux et leurs formats de journaux compatibles. Elle ne couvre pas toutes les extensions d'éditeur, tous les agents hébergés ni toutes les activités d'un compte fournisseur.
Ces coûts correspondent-ils à la facture de mon fournisseur ?
Passcard calcule le coût en multipliant la consommation de tokens par les tarifs API publiés des modèles pour l’entrée, la sortie et la mise en cache. Cela permet de comparer le travail des personnes et des projets sur une base commune. Votre facture peut différer en raison des abonnements, de l’utilisation incluse, des tarifs négociés, des crédits ou des règles de facturation.
Le serveur vérifie les sources publiques de tarifs chaque heure. Les prix connus changent lorsqu’au moins deux sources concordent, et un nouveau prix s’applique à l’utilisation à partir de sa date d’effet. L’utilisation antérieure conserve le tarif en vigueur à ce moment-là. Lorsqu’un tarif de modèle manque, Passcard utilise si possible un tarif de remplacement de la même famille de modèles et enregistre ce choix. Les détails des sessions signalent ces cas. Le calcul peut être corrigé lorsqu’un tarif exact devient disponible.
Les nombres de tokens de Cursor sont déduits de la longueur des transcriptions. Des compteurs manquants ou des tarifs non résolus peuvent exclure une partie de l’utilisation du total ; les détails des sessions présentent les informations disponibles.
Reproduisez un calcul de coût étape par étapeDisponible en anglais
Comment le coupe-circuit applique-t-il un budget ?
Les budgets peuvent s'appliquer à un espace de travail, une équipe, une personne ou un projet, avec des limites quotidiennes, hebdomadaires, mensuelles ou totales. Choisissez un seuil d'alerte et une action d'avertissement ou de blocage. Les budgets partagés et les contrôles du coupe-circuit pour les entreprises sont inclus dans Team et Business.
Les hooks installés demandent une décision à l’application de bureau Passcard en cours d’exécution avant les actions prises en charge des agents. L’application combine le dernier état des coûts du serveur avec l’utilisation locale enregistrée que le serveur n’a pas encore confirmée. Lorsqu’un budget bloquant est épuisé, elle renvoie la réponse de blocage prise en charge par l’agent.
Que se passe-t-il hors ligne ?
Les budgets en cache et l'utilisation locale peuvent continuer d'alimenter les vérifications sans connexion réseau. La nouvelle utilisation des autres appareils et les budgets modifiés ne sont connus qu'après synchronisation. Si aucun état de budget n'est disponible, l'application en cours d'exécution suit le réglage fail-open ou fail-closed de l'espace de travail.
Les dépenses peuvent-elles dépasser la limite ?
Oui. L'application des budgets utilise les données déjà enregistrées dans les journaux. Les requêtes en cours, les journaux retardés et les appareils actifs simultanément peuvent donc dépasser un seuil avant qu'une action ultérieure soit bloquée. Un état quotidien, hebdomadaire ou mensuel expiré ne bloque pas une nouvelle période. Passcard n'impose pas de plafond strict de dépenses au compte d'un fournisseur.
L'application de bureau doit être en cours d'exécution, et les hooks doivent être installés et pris en charge par l'agent. Si le hook local ne peut pas joindre l'application, il laisse l'agent continuer, même si l'espace de travail est configuré en mode fail-closed lorsque les données de budget sont indisponibles.
Quelles données quittent la machine ?
Le collecteur de bureau envoie des métadonnées normalisées d'utilisation et de fonctionnement. Il n'envoie ni texte des prompts, ni données complètes des arguments des outils, ni contenu des fichiers, ni chemins absolus, ni valeurs des variables d'environnement.
- Utilisation : noms des agents et des modèles, nombres de tokens, horodatages, identifiants de session et indication du caractère estimé de l'utilisation.
- Contexte de session : noms des dépôts et des branches, horaires des sessions, nombres de tours, noms et nombres d'appels des outils, chemins relatifs des fichiers utilisés et versions des agents lorsqu'elles sont disponibles.
- Informations sur les appareils : nom, système d'exploitation, version de l'application et état de connexion utilisés pour gérer les machines associées.
Les noms des dépôts, des branches et des fichiers relatifs peuvent contenir des informations confidentielles. Tenez compte de ces métadonnées pour déterminer si Passcard répond aux exigences de votre espace de travail en matière de données. Les tokens des appareils peuvent être révoqués depuis le tableau de bord.
Bêta optionnelle de suivi des tickets Linear et GitHub
L'attribution aux tickets est désactivée par défaut et doit être activée par un administrateur. Une fois connectée, elle utilise des éléments Git et certaines métadonnées d'issues Linear et de pull requests GitHub pour attribuer l'utilisation aux tickets. Désactiver la bêta arrête les nouveaux traitements liés aux fournisseurs et l'application des budgets de tickets ; l'historique d'attribution existant est conservé.