Définir des budgets de tokens pour les agents IA
Plafonnez ce que Claude Code et Codex peuvent dépenser avec un budget de tokens par candidat sur chaque épreuve et un plafond mensuel de tokens pour toute l’organisation.
Il y a deux limites, et toutes deux sont facultatives. Un Budget de tokens par candidat sur une épreuve plafonne ce que l’agent d’un candidat peut dépenser sur cette épreuve. Un Plafond mensuel de tokens sous Intégrations plafonne ce que tous les candidats ensemble peuvent dépenser sur un mois calendaire. Quand l’une ou l’autre est atteinte, le prochain appel de l’agent est refusé avec un message clair dans le terminal. Si aucune n’est définie, la dépense n’est bornée que par votre compte fournisseur.
Ce qui compte comme un token
Les deux limites comptent ce que l’agent lit et écrit : les nouvelles entrées envoyées au modèle plus la sortie du modèle. Le contexte mis en cache n’est pas compté. Les agents de code renvoient toute la conversation à chaque tour, et cette partie répétée est servie depuis le cache du fournisseur ; elle consommerait donc un budget sans refléter de nouveau travail.
Claude Code et Codex puisent dans le même budget. Un candidat qui utilise les deux dépense depuis un seul total. Les budgets ne s’appliquent qu’avec les clés de votre organisation : avec le propre compte du candidat, Kendor ne compte pas les tokens.
Budget par candidat sur une épreuve
Les éditeurs et les propriétaires le définissent dans le créateur d’épreuve, à côté de l’interrupteur qui active les agents.
- Activez Assistants IA dans le terminal sous Options dans le panneau des paramètres.
- Saisissez un nombre dans Budget de tokens par candidat. L’unité est millions de tokens :
1signifie un million et0.5signifie un demi-million. - Laissez le champ vide pour ne mettre aucune limite. Le panneau vous le rappelle alors : « Aucune limite définie. La dépense d'un candidat n'est bornée que par votre compte fournisseur. »
Le budget est par tentative de candidat et s’additionne sur tous les exercices de l’épreuve : une épreuve de trois exercices avec un budget de 2 donne donc au candidat 2 millions de tokens au total, et non 2 millions par exercice. L’utilisation est conservée quand le bac à sable redémarre ou que le candidat revient plus tard : un redémarrage ne la remet donc pas à zéro.
Vous pouvez modifier le budget pendant que des candidats sont en cours d’épreuve. Les bacs à sable en cours d’exécution prennent immédiatement en compte la nouvelle limite.
Ce que voit le candidat
Un petit anneau dans l’en-tête de l’éditeur se remplit à mesure que l’agent travaille. Le survoler affiche, par exemple, « Jetons IA : 400k sur 1M utilisés ». Il passe à l’ambre à 80 % avec « Vous approchez du budget de tokens IA de cette épreuve », pour que l’épuisement ne soit jamais le premier signe. Une fois le budget épuisé, l’infobulle indique « Le budget de tokens IA de cette épreuve est épuisé ».
Plafond mensuel pour l’organisation
Les propriétaires le définissent sur la page Claude Code ou Codex sous Intégrations → Assistants IA. Les deux pages affichent le même champ, car les deux agents partagent un seul plafond.
- Saisissez un nombre dans Plafond mensuel de tokens, en millions de tokens.
- Choisissez Enregistrer.
- Laissez-le vide pour Aucun plafond.
Sous le champ, vous voyez la dépense du mois, par exemple « 6.4M sur 20M tokens utilisés ce mois-ci ». Le mois suit les mois calendaires UTC et repart de zéro le 1er.
Le plafond couvre chaque appel d’agent facturé sur vos clés : les candidats sur les épreuves, les entretiens de codage en direct, et les bacs à sable de votre propre équipe dans le créateur.
Astuce. Si vous utilisez la fédération d’identité pour Claude Code, vous pouvez aussi fixer une limite de dépense sur l’espace de travail Anthropic dans votre Claude Console. Cette limite est appliquée par Anthropic, en plus des plafonds de Kendor.
Entretiens de codage en direct
Les entretiens de codage en direct n’ont pas de budget par candidat. L’usage des agents dans une session en direct ne compte que pour le Plafond mensuel de tokens de votre organisation : définissez-en un si vous voulez un plafond à cet endroit.
Quand un budget est épuisé
La passerelle de Kendor vérifie le budget avant de transmettre chaque appel, y compris les appels déjà en cours en parallèle. Une fois une limite atteinte, l’appel suivant n’est pas envoyé à Anthropic ou OpenAI, et l’agent affiche l’un de ces messages dans le terminal :
| Limite atteinte | Message |
|---|---|
| Budget de tokens par candidat | « The AI token budget for this assessment has been used up » |
| Plafond mensuel de tokens | « The hiring organization's monthly AI token limit has been reached » |
Le tour déjà en cours se termine, de sorte que le dernier décompte peut dépasser légèrement la limite. Le candidat peut continuer à travailler sans l’agent : l’éditeur, le terminal, les tests et l’aperçu ne sont pas affectés.
Pour laisser un candidat continuer avec l’agent, relevez le budget de l’épreuve ou le plafond mensuel. Les bacs à sable en cours d’exécution prennent en compte le changement sans redémarrage.
Remarque. Indépendamment des tokens, chaque session de bac à sable a une limite fixe sur le nombre d’appels que les agents peuvent faire. Quand elle est atteinte, l’agent affiche « This session has reached its AI usage limit ».
Où l’utilisation apparaît dans la relecture
Sur la page de relecture d’un rendu, l’en-tête affiche ce qu’a utilisé l’agent du candidat, comme « IA 1.4M / 2M tokens » avec un budget ou « IA 1.4M tokens » sans. Le survoler explique que le chiffre correspond à ce que l’assistant a lu et écrit pendant la tentative, le contexte mis en cache n’étant pas compté.
Le total courant du mois de votre organisation se trouve sur les pages Claude Code et Codex sous Intégrations. Pour une ventilation des coûts par modèle, utilisez votre console Anthropic ou OpenAI, où l’usage est facturé.