CodingAgent Accounts : vos comptes, leur utilisation et la rotation

Vue d'ensemble

Une Specification peut mobiliser un Builder et un Reviewer en même temps, tandis qu'un autre Workspace utilise une troisième session. Ces sessions n'ont pas à se disputer la même connexion à votre insu : CodingAgent Accounts affiche la capacité de vos comptes et vous permet de choisir comment les CodingAgents l'utilisent.

Le pool vous appartient et se partage entre vos Workspaces. Ce n'est pas un moyen de partager des comptes avec d'autres personnes. Sa configuration est facultative : avec la seule connexion native du provider, vous continuez à travailler comme auparavant.

La connexion déjà présente sur l'ordinateur constitue le compte principal, Main. Lorsque le provider fournit votre adresse e-mail, Kavor utilise cette adresse seule comme nom d'affichage ; si l'identité n'est pas disponible, il affiche Main. Ajouter un compte dans Kavor ne remplace pas cette connexion et ne déconnecte pas les applications du provider qui l'utilisent.

Commencez par le groupe Accounts dans l'en-tête du Workspace. Survolez un provider pour voir le résumé, puis cliquez dessus pour ouvrir le panneau. Ce panneau réunit utilisation, comptes, choix du Workspace et préférences ; il n'existe pas d'autre gestionnaire de comptes dans Settings.

Utilisation

Les pourcentages indiquent la capacité restante, pas le nombre d'agents. Plusieurs CodingAgents peuvent utiliser le même compte et consommer ses fenêtres d'utilisation simultanément.

Voir l’image en taille réelle

Illustration de l’interface avec les valeurs relevées dans la capture de référence ; il ne s’agit pas d’une nouvelle mesure d’utilisation des providers.

Lire le résumé de l'en-tête

• Chaque indicateur reprend la couleur de son provider et affiche jusqu'à deux fenêtres générales du compte, de la plus courte à la suivante. Un compte avec une fenêtre de cinq heures et une fenêtre hebdomadaire affiche ces deux fenêtres ; un compte uniquement mensuel ne se voit pas attribuer une fenêtre fictive de cinq heures. Les pourcentages de comptes différents ne sont pas additionnés.
• Lorsque plusieurs comptes sont utilisés dans ce Workspace, le résumé représente celui dont la capacité restante est la plus faible dans l'une de ces fenêtres. Le survol identifie les comptes utilisés et les fenêtres de chacun.
• Si aucun CodingAgent n'utilise ce provider, l'indicateur s'estompe et affiche le meilleur compte disponible connu parmi ceux que le Workspace peut choisir en Automatic. Cela ne signifie pas qu'il a déjà été sélectionné.
• +N indique la réserve d'autres comptes dont la capacité est connue pour la sélection automatique de ce Workspace, et non une réserve exclusive. Des comptes également utilisés par d'autres CodingAgents peuvent y figurer. +N? signale des relevés encore inconnus ; un provider avec un seul compte n'affiche pas de réserve.
• Une fenêtre devient ambrée lorsqu'elle atteint le seuil de rotation. L'indicateur entier devient rouge clair lorsque tous les comptes qu'Automatic peut utiliser dans ce Workspace ont atteint ou dépassé le seuil configuré, d'après des relevés confirmés. C'est une information de capacité, pas un blocage du travail.

Vérifier les fenêtres et le relevé

Dans le panneau, chaque fenêtre affiche sa capacité restante et son prochain renouvellement. Les fenêtres propres à un modèle figurent dans les détails du compte, pas dans l'indicateur général. Ouvrez More pour consulter l'heure Read, le forfait, les crédits, les réinitialisations en réserve et les autres données réellement fournies par le provider.

Les relevés visibles sont actualisés périodiquement. Pendant l'actualisation, le dernier relevé valide reste affiché avec son heure réelle ; fermer et rouvrir le panneau ne transforme pas d'anciennes données en nouvelle observation. Un échec indique une indisponibilité ou une marche à suivre pour se connecter, sans remplacer les derniers pourcentages valides par des valeurs inventées. Utilisez Refresh, à côté du sélecteur de provider, pour demander une actualisation.

Unavailable ou — ne signifient ni 0 % ni 100 %. Un relevé inconnu ne confirme ni l'épuisement de la capacité du compte ni l'expiration de la connexion. Vérifiez l'erreur et l'heure ; essayez d'actualiser ou reconnectez-vous si cela vous est demandé. Un échec de consultation de l'utilisation ne masque pas les actions d'ajout de compte ou de reconnexion.

Les consultations passent par le canal natif du provider, sans demander de travail à un modèle. Consulter un solde n'autorise pas à le dépenser.

Comptes

Ajouter un compte et s'authentifier

1. Ouvrez le panneau d'un provider compatible : Codex, Claude Code ou Grok.
2. Utilisez Add account, attribuez un nom reconnaissable, comme Trabalho, puis confirmez avec Add account and sign in.
3. Terminez la connexion native sur la page du provider et utilisez le code affiché si nécessaire. L'adresse d'autorisation s'ouvre une fois pour le parcours que vous avez lancé ; lorsque le CLI du provider ouvre lui-même le navigateur, Kavor n'ouvre pas un deuxième onglet.
4. Vérifiez l'état d'authentification et le relevé d'utilisation. Ouvrir le navigateur ne signifie pas que la connexion est terminée.
5. Pour inclure ce nouveau compte dans la sélection automatique, activez sa participation dans le Workspace voulu. Un compte nouvellement ajouté est exclu d'Automatic dans tous les Workspaces ; le pool global ne l'active pas de lui-même.

Kavor prépare un profil isolé pour le compte ajouté. Les identifiants restent dans le stockage utilisé par le CLI de ce compte, pas dans la base de données de Kavor. La connexion native Main reste à son emplacement d'origine.

Pour une connexion expirée, utilisez Sign in again. Pour les comptes gérés, le panneau propose aussi cette action lorsque l'état d'authentification n'a pas pu être déterminé ; cela ne transforme pas un relevé inconnu en expiration confirmée. Chaque clic qui lance une connexion, y compris une nouvelle tentative, ouvre l'adresse d'autorisation une fois lorsqu'elle devient disponible. Si l'ouverture échoue, utilisez manuellement Continue provider sign-in. Rouvrir le panneau ou restaurer une opération en attente n'ouvre pas d'onglet de sa propre initiative.

Main n'est pas une copie de votre connexion

Main utilise la connexion native à l'endroit même où le provider la conserve. Le panneau ne propose ni connexion, ni déconnexion, ni suppression pour Main ; gérez cette connexion avec les outils du provider. Lorsque vous changez de compte natif en dehors de Kavor, Main représente cette nouvelle connexion, sans proposer de récupérer le compte précédent.

Une connexion native sans identité ou sans données d'utilisation, comme une clé API Codex, continue de fonctionner comme auparavant, mais ne participe pas à la rotation automatique. Kavor ne lit pas les identifiants pour tenter d'en déduire une identité.

Déconnecter n'est pas supprimer

Sign out conserve le compte dans la liste pour vous permettre de vous reconnecter. Remove account retire le compte de la liste et supprime son profil isolé géré par Kavor ; cela ne supprime ni la connexion Main ni l'historique partagé des sessions.

Si des CodingAgents utilisent le compte, Kavor affiche ceux qui sont concernés et demande confirmation. Le changement attend le point sûr entre deux tours et la libération de l'ancien processus. Un choix fixe de ce compte revient à Automatic ; si c'était le compte par défaut d'un Workspace, ce défaut revient à Main. Sans autre compte, l'exécution utilise la connexion native.

Copie de la configuration personnelle

Lors de l'ajout d'un compte, vous recevez une copie initiale de la configuration personnelle du provider issue de l'environnement natif. Cela évite de recréer les préférences, skills et MCPs pour chaque compte. Le contenu dépend du provider et de ce qui existe à la source :

Les secrets intégrés à ces configurations sont également copiés. Cela comprend les valeurs d'environnement des MCPs, les en-têtes HTTP statiques et les clés de providers personnalisés enregistrés dans ces fichiers. Les fichiers conservent leurs permissions ; ces valeurs ne sont ni consignées dans les logs ni stockées dans la base de données de Kavor.

La connexion native, les fichiers d'authentification, les éléments du Keychain et l'identité du compte ne sont jamais copiés. Le compte ajouté nécessite sa propre connexion. Les entrées d'intégration appartenant à Kavor ne sont pas non plus héritées : Kavor prépare son intégration pour ce compte.

Il s'agit d'une copie, pas d'une synchronisation. Un MCP ajouté plus tard dans Main doit aussi être configuré dans les comptes où vous voulez l'utiliser. Modifier un compte ajouté ne change pas Main ; se reconnecter ne recopie pas les préférences.

Si la préparation signale une erreur de configuration, vérifiez le TOML ou JSON personnel indiqué avant de réessayer. Ne copiez pas les fichiers d'authentification et ne supprimez pas tout le profil natif pour tenter de réparer le problème.

Changement de compte

Choisir le comportement de chaque Workspace

Un choix Manual dans les paramètres du CodingAgent fixe un compte pour ce Node et l'emporte sur la politique du Workspace. Un CodingAgent en Auto (Automatic) suit les choix de son Workspace pour ce provider.

Dans le panneau Accounts du Workspace :

• Avec Auto Rotate activé, les interrupteurs de participation définissent les comptes utilisables par Automatic. Chaque Workspace a sa propre sélection, même s'ils utilisent le même pool. Un compte exclu de cette sélection reste visible et peut être choisi manuellement dans le CodingAgent ou utilisé dans un autre Workspace.
• Avec un seul compte participant, Automatic le conserve même s'il a atteint le seuil. Sans participant, il utilise la connexion native Main, sans rotation automatique dans ce Workspace.
• Avec Auto Rotate désactivé, les boutons de sélection unique définissent le compte par défaut des CodingAgents en Automatic. La désactivation fait de Main le compte par défaut ; elle ne restaure pas un ancien choix. Les participations sont conservées pour la prochaine activation d'Auto Rotate.

L'enregistrement d'Auto Rotate ou d'une participation est immédiat et ne redémarre ni ne redistribue les agents en cours d'exécution. Une participation prend effet au prochain choix automatique réel, par exemple à l'ouverture ou lors d'une rotation déclenchée par le seuil. En revanche, choisir explicitement un autre compte par défaut ou un autre compte Manual peut déplacer les CodingAgents concernés au point sûr entre deux tours. Un agent dont le compte effectif ne change pas n'est pas redémarré.

Voir l’image en taille réelle

Des Workspaces indépendants peuvent rester ouverts dans des fenêtres séparées. La participation des comptes se configure dans le panneau Accounts de chaque Workspace.

Comment Automatic choisit un autre compte

Le seuil par défaut est de 95 % d'utilisation, réglable dans Rotate at used capacity (%), sous Global rotation preferences. Kavor tient compte de l'authentification, de l'éligibilité du forfait, du modèle choisi, de la participation au Workspace et de toutes les fenêtres signalées. Il ne change pas de modèle pour rendre un compte admissible à la sélection.

Le compte actuel est conservé s'il est valide. Lorsqu'il faut choisir parmi des comptes éligibles sous le seuil dans toutes les fenêtres, Kavor préfère, dans cet ordre :

1. Un compte déjà utilisé par les CodingAgents de ce Workspace.
2. Un compte qu'aucun autre Workspace n'utilise.
3. Le compte partagé avec le moins d'autres Workspaces.

À égalité, il préfère celui dont la capacité se renouvelle le plus tôt. Avec quatre Workspaces et quatre comptes éligibles disponibles, cela permet de répartir un compte par Workspace. Ce n'est pas une réservation exclusive : les comptes peuvent être partagés si nécessaire. Ouvrir ou fermer un Workspace ne provoque pas de redistribution générale.

Le changement redémarre le harness sur l'autre compte entre deux tours, en reprenant la même session native et son historique. Le Node affiche les étapes réelles d'attente, de choix, de redémarrage et de reprise. Une indication d'attente ne bloque pas un terminal encore utilisable ; pendant le redémarrage du CLI, le terminal se ferme puis revient lorsque la session est prête. Un changement réussi ne génère pas de notification système ; celles-ci sont réservées aux échecs réels, avec indication du Workspace et du CodingAgent.

Capacité épuisée et échecs de tour

Une capacité faible ou épuisée, à elle seule, ne met pas le CodingAgent en pause, ne bloque pas un message et ne désactive pas la saisie du terminal. Sans autre compte disposant de capacité, il reste sur le compte actuel. Une première ouverture en Automatic sans compte éligible disposant de capacité utilise Main et signale cette situation. Les limites réelles et la facturation du tour restent appliquées par le provider.

Une connexion dont l'expiration est confirmée est ignorée dans les choix automatiques ; un échec réseau ou un relevé inconnu ne confirme pas l'expiration. Cela ne remplace pas un choix Manual.

Avec Codex et Claude Code, un tour ayant échoué à cause d'un quota de compte confirmé par le provider peut être repris sur un autre compte, selon les mêmes règles d'Automatic et lorsque le renvoi est sûr. Une livraison incertaine, un problème d'authentification, un rate limit, une surcharge générale ou une cause inconnue n'autorisent pas à répéter une demande. Un tour Grok ayant échoué n'est pas renvoyé automatiquement, car le signal natif ne distingue pas quota et rate limit ; la rotation au seuil d'utilisation reste disponible.

Crédits et réinitialisations en réserve

Allow spending credits et Allow spending banked resets sont deux permissions distinctes, désactivées par défaut. Elles régissent la sélection et la rotation effectuées par Kavor ; voir un solde n'active aucune des deux. Lorsque les crédits sont désactivés, un compte au seuil configuré ne devient pas éligible automatiquement sous prétexte qu'il possède encore un solde. Cela n'interrompt pas une session déjà en cours et ne modifie pas votre choix Manual.

Ces options ne bloquent pas la facturation native au cours d'un tour. Réglez les limites de dépenses et la consommation payante du compte chez le provider lui-même. Kavor n'achète pas de crédits et ne modifie pas les paramètres de facturation de votre connexion.

Les réinitialisations en réserve et leurs dates d'expiration n'apparaissent que si elles sont signalées. La consommation d'une réinitialisation en réserve n'a pas été vérifiée ; la présence d'un solde ou d'une préférence ne doit pas être interprétée comme une garantie de consommation effective.

Outils pour les CodingAgents

Un CodingAgent peut consulter vos comptes sans recevoir d'identifiants :

• kavor_coding_agent_account_list_usage consulte le pool global et les connexions natives, avec pagination, fenêtres, réinitialisations, éligibilité et heure d'observation ; il peut filtrer par provider.
• kavor_coding_agent_account_request_change demande le changement du propre compte du CodingAgent appelant pour la fin du tour, en respectant Automatic et les comptes autorisés dans ce Workspace.

La demande est refusée en Manual et ne garantit pas l'existence d'une autre option éligible. Ces outils ne permettent ni de changer le compte d'un autre CodingAgent, ni de se connecter, ni de supprimer des comptes, ni de modifier les permissions de dépenses, ni d'accéder aux tokens.

Par exemple :

Compare les fenêtres et renouvellements de mes comptes sans modifier aucune sélection. Si tu recommandes un changement pour ta propre session, explique quels relevés étayent cette suggestion et respecte mon choix Manual.

Commandes d'Agent Kavor

Dans la conversation d'Agent Kavor, y compris via un Channel activé, les commandes agissent sur le Workspace sélectionné, sans tour de modèle pour interpréter le contrôle. Utilisez les noms réellement affichés par Kavor :

/accounts
/accounts codex
/account
@Reviewer /account "Trabalho"
@Reviewer /account auto
/autorotate codex off
/autorotate codex on
/status

• /accounts [provider] affiche le résumé de l'utilisation, des renouvellements et de la réserve du Workspace. Ce n'est pas un export complet de tous les comptes : s'il reste des résultats ou des relevés inconnus, la réponse indique ses limites et renvoie au panneau.
• /account [@Nome] consulte le compte et le mode de l'agent sélectionné ou indiqué. Ajoutez le nom ou l'e-mail d'un compte pour le fixer ; utilisez auto pour revenir à Automatic. Les noms contenant des espaces doivent être entre guillemets.
• /autorotate [provider] on|off active ou désactive Auto Rotate dans ce Workspace, sans déplacer les agents en cours d'exécution. Sans provider, la commande utilise celui du CodingAgent par défaut ; sans agent par défaut, vous devez préciser le provider.
• /status inclut le compte et ses fenêtres générales ; /help présente les contrôles et exemples disponibles.

Fixer un autre compte respecte les mêmes validations, le même point sûr et les mêmes retours que sur le desktop. Une réponse à la commande ne prouve pas que la reprise est terminée. Ajouter des comptes, se connecter, se déconnecter, supprimer, modifier les participations et choisir le compte par défaut du Workspace restent des actions du panneau desktop. Les règles d'autorisation du Channel ne changent pas.

Consultez Agent Kavor et Channels pour sélectionner le Workspace et le destinataire avant d'utiliser ces contrôles.

Prise en charge et limites par provider

• Codex, Claude Code et Grok proposent des comptes gérés et des changements avec continuité de session. Le forfait du compte et le modèle doivent autoriser l'exécution. Une configuration isolée ne rend pas admissible un forfait qui ne l'est pas.
• Grok ne fournit pas l'identité native du compte. Main garde ce nom neutre ; forfait et solde ne servent pas à déduire un e-mail. L'exception concernant le renvoi des tours est décrite plus haut.
• Antigravity permet de suivre le compte de la machine, sans pool, changement de compte ni copie de configuration tels que décrits dans ce guide.
• OpenCode est exclu du suivi et de la gestion des comptes décrits ici ; ses limites dépendent du provider configuré dans son propre harness.
• Les connexions sans identité ou utilisation signalée restent disponibles par la voie native, sans inventer de quota ni activer la rotation automatique. Les informations disponibles et les fenêtres peuvent varier selon les comptes et les modes d'authentification.
• Des données absentes ne sont pas des soldes nuls. Un changement de format natif peut rendre une observation indisponible ; vérifiez l'heure, le message et la connexion avant de conclure que le quota est épuisé.

Pour organiser le travail avec ces comptes, poursuivez avec le guide CodingAgent et la répartition des agents et des rôles.