Un rôle de votre profil AI peut s'exécuter sur un agent de codage sur votre propre machine au lieu d'un modèle que CoRoid appelle. L'agent effectue le raisonnement du rôle à cet endroit, connecté avec les identifiants que vous avez configurés, sur votre propre compte auprès du fournisseur. CoRoid lui fournit les outils du rôle et conserve tout le reste du workflow : la tâche, les vérifications et les étapes, ainsi que l'historique des actions réalisées.
Ce qu'il couvre
- Tous les rôles d'un profil sauf le moteur de décision : le Architecte et le coordinateur, le Développeur, QA, le Réviseur, le testeur web, le traducteur et les autres. Le moteur de décision n'est pas un agent exécuté : il demande à un modèle de décision la probabilité de chaque réponse autorisée, ce qu'un agent de codage ne fournit pas.
- Quatre agents : Codex et OpenCode, et pour certaines organisations uniquement, pour l'instant, Claude Code et Cursor. Chacun fonctionne dans le cadre de votre propre abonnement auprès du fournisseur (voir L'abonnement de votre agent).
- Toutes les façons dont une tâche peut être exécutée. En mode coordinateur, le coordinateur et les rôles auxquels il confie le travail s’exécutent sur l’agent comme tout autre rôle.
L'abonnement de votre agent
L'agent travaille sous vos propres identifiants et dans le cadre de votre abonnement auprès du fournisseur : Anthropic pour Claude Code, OpenAI pour Codex, Cursor pour Cursor, et tous les fournisseurs que vous avez configurés dans OpenCode. CoRoid ne voit jamais ces identifiants, et ne revend pas ni ne partage l'abonnement de quiconque : chaque personne connecte sa propre machine, et l'agent réalise le travail qu'elle a initié.
La question de savoir si les conditions de l'abonnement permettent son utilisation via un autre produit, et pour quel type de travail, relève d'un accord entre vous et le fournisseur. Cela varie selon les fournisseurs, entre leurs abonnements personnels et professionnels, peut dépendre du volume de travail effectué, et peut évoluer. Consultez les conditions de votre abonnement et interrogez le fournisseur si elles ne sont pas claires.
Une organisation qui attribue des rôles aux agents doit vérifier la même chose concernant les abonnements de ses membres. Sa politique peut autoriser uniquement les agents dont les conditions ont été vérifiées (voir Ce que votre organisation autorise).
Comment cela se connecte-t-il ?
Votre machine
Connecteur CoRoid
Logiciel open source. Démarre l'agent pour une session dans un répertoire vide et l'arrête ensuite.
Votre agent de codage
L'agent que vous utilisez, connecté en votre nom, avec ses propres outils désactivés.
- 1Demande du travail. Chaque requête est maintenue jusqu'à 25 secondes ; le connecteur transmet les commentaires de l'agent toutes les 3 secondes.
- 2Utilise les outils associés au rôle. Un jeton valable uniquement pour cette session, qui devient inactif à la fin de celle-ci.
- 3Interroge son modèle. Comme cela se passerait sans CoRoid. CoRoid ne voit jamais cet identifiant.
CoRoid
Orchestrateur
Attribue le travail lié au rôle à la machine de la personne ayant lancé la tâche (1).
Les outils associés au rôle
Exécution dans l'environnement isolé de la tâche, où votre code reste conservé (2).
Le fournisseur de l'agent
Répond aux requêtes du modèle de l'agent sous votre propre identifiant, selon votre abonnement (3).
Rien n'accède à la machine : le connecteur n'ouvre aucun port, n'envoie aucun fichier et n'exécute aucune commande propre.
Sur la machine restent votre identifiant pour l'agent et tout ce que l'agent conserve de la session.
La machine travaille pour CoRoid via le connecteur CoRoid, un petit programme open source que vous installez et exécutez. Chaque connexion démarre sur la machine : le connecteur demande du travail à CoRoid, l'agent utilise les outils du rôle dans l'environnement isolé de la tâche, et l'agent sollicite son propre fournisseur pour obtenir les réponses du modèle, sous vos identifiants. Le connecteur n'ouvre aucun port et n'envoie aucun fichier de la machine. La sécurité du connecteur décrit ce qu'il fait et ne fait pas, ainsi que la manière de vérifier une version.
Connecter une machine
-
Installez l'agent sur la machine et connectez-vous-y, comme vous le feriez pour l'utiliser vous-même.
-
Installez le connecteur, avec Homebrew sur macOS ou Linux :
brew install coroid-ai/tap/coroid-connectorou avec npm, n'importe où avec Node.js 20 ou ultérieur :
npm install --global @coroid/connector -
Pour Codex ou Claude Code, ajoutez l'agent :
coroid-connector add codex(ouadd claude). Cela installe l'adaptateur ACP de l'agent, qui apporte sa propre copie de l'agent (environ 350 Mo), dans~/.coroid/connector, depuis les paquets dont le connecteur verrouille les empreintes par hachage. OpenCode et Cursor n'ont pas besoin d'être ajoutés : CoRoid utilise votre propre installation. -
Ouvrez Paramètres → Connexions → Vos machines et exécutez la commande indiquée là (
coroid-connector --api …). Votre navigateur s'ouvre : approuvez la machine pour votre organisation. N'approuvez que le connecteur que vous avez lancé il y a un instant.
Le connecteur continue ensuite de fonctionner jusqu'à ce que vous l'arrêtiez, en demandant du travail à CoRoid. Vos machines liste la machine comme connectée, avec les agents que le connecteur a trouvés dessus et leur version respective. Un agent n'apparaît comme prêt que sur une version que CoRoid a testée ; sur une autre version, il est affiché mais non utilisé.
coroid-connector status affiche la même information depuis la machine, avec le modèle que chaque
agent utilise.
Seuls vous voyez vos machines. Déconnecter met fin à la connexion de la machine et arrête son connecteur en moins d'une minute.
Attribuer un rôle à un agent
Le propriétaire d'une organisation effectue cette opération dans un profil personnalisé, sous Paramètres → Profil AI (voir Profils AI).
- Ouvrez les détails du profil. Dans le premier champ d'un rôle, la liste commence par Sur votre propre machine: les agents proposés à votre organisation, et à côté de chacun, si une machine de votre parc les possède déjà.
- Choisissez l'agent. Deux autres champs apparaissent :
- Modèle dans : le modèle que l'agent doit utiliser pour ce rôle, parmi les modèles que vos machines connectées signalent pour lui. Tel que défini sur la machine laisse l'agent sur le modèle que son propriétaire a configuré.
- Sans machine connectée: le modèle qui exécute le rôle lorsqu'aucune machine ne prend en charge le travail. C'est le modèle que possédait le rôle.
- Enregistrer.
Choisir à nouveau un modèle dans le premier champ retire l'agent et le modèle associé avec lui.
Que se passe-t-il lorsqu'une tâche est exécutée ?
L'affectation relève de l'organisation ; la machine appartient à l'utilisateur. Lorsqu'un rôle démarre, CoRoid cherche une machine de la personne ayant lancé la tâche :
- connectée à cette organisation au cours de la dernière minute,
- avec l'agent assigné prêt sur une version que CoRoid a déjà testée,
- et proposant le modèle nommé, si l'affectation en spécifie un.
S'il en existe une, le travail du rôle est envoyé à cette machine. Sinon, le rôle fonctionne sur le modèle sous Sans machine connectée, exactement comme il l'aurait fait. Rien n'attend une machine. Le travail non initié par un utilisateur (automatisation déclenchée par un événement ou un planning) n'a pas de machine associée et s'exécute sur son modèle.
Sur la machine, le connecteur lance l'agent dans un répertoire vide et lui fournit un ensemble d'outils : les outils de CoRoid pour ce rôle, accessibles uniquement pour ce travail. Le développeur modifie le code via ces outils, dans l'espace de travail de la tâche sous CoRoid, comme le ferait un modèle ; le QA et le réviseur évaluent ces modifications grâce à eux. Un message ajouté à la tâche pendant que l'agent travaille lui parvient avec le prochain résultat de l'outil.
Un rôle en attente retourne vers l'agent. Le coordinateur confie le travail au développeur, au QA et au réviseur, puis attend la réponse de chacun ; un sous-élément peut attendre la réponse du coordinateur. Une fois l'attente terminée, le rôle retourne vers l'agent, qui reçoit l'historique des échanges jusqu'à présent. Une machine peut exécuter jusqu'à quatre rôles simultanément (connecteur 0.4.0), donc les explorateurs lancés par le développeur fonctionnent en parallèle.
Si la machine cesse de répondre au milieu d'un rôle, le rôle continue dans la même conversation sur son modèle cloud, auquel on indique ce qui s'est passé. Une tâche interrompue arrête également l'agent. Une fois le rôle terminé, son agent est arrêté et le répertoire est supprimé.
Ce qui reste sur votre machine
Le connecteur supprime le répertoire dans lequel le rôle a été exécuté. Ce que l'agent conserve du travail dans son propre stockage dépend de l'agent :
| Agent | Ce qu'il conserve |
|---|---|
| Claude Code | Aucune transcription : le connecteur le lance avec la persistance de session désactivée |
| Codex | Une transcription de chaque session dans ~/.codex/sessions, y compris les fichiers qu'il a lus |
| OpenCode | Ses sessions dans sa propre base de données sous ~/.local/share/opencode |
| Cursor | Chaque session dans sa propre base de données sous ~/.cursor/acp-sessions |
Codex, OpenCode et Cursor ne proposent pas encore d'option pour cela. Si votre organisation doit empêcher le stockage de code sur les ordinateurs portables, autorisez uniquement Claude Code dans sa politique (voir ci-dessous).
Ce que votre organisation autorise
Un propriétaire ou administrateur décide dans Paramètres → Identité et accès → Politique d'organisation, sous Agents de codage sur les postes de travail des utilisateurs, pour chaque forfait :
- Autoriser les agents de codage sur les postes de travail des utilisateurs. Lorsque cette option est désactivée, chaque rôle fonctionne sur son modèle, y compris un rôle déjà assigné à un agent par un profil.
- Un interrupteur par agent votre organisation dispose de cette option, en plus de ce que l'agent conserve sur la machine. Avec tous les agents activés, tout agent que CoRoid proposera ultérieurement sera également activé.
Le formulaire de profil AI n'affiche que les agents autorisés par la politique, et un rôle ne peut pas être réassigné à un autre. Un rôle assigné avant le changement de politique conserve son affectation, et le formulaire indique qu'il fonctionne sur son modèle. La politique d'un projet peut restreindre celle de l'organisation, mais jamais l'élargir.
Ce que l'agent peut ou ne peut pas faire
- Uniquement les outils de CoRoid. Les outils propres à chaque agent (son shell, l'édition de fichiers, la recherche web, ses serveurs MCP et connecteurs) sont désactivés pour la session, selon ce que l'agent fournit. Toute demande d'utilisation d'autres outils est refusée.
- Rien de la machine. L'agent ne travaille pas dans votre espace de travail et n'accède pas aux fichiers de la machine. CoRoid n'a pas non plus accès à la machine : le connecteur se contente de demander du travail à CoRoid et de rapporter ce que l'agent dit.
- Les mêmes vérifications. Les modifications apportées par l'agent passent par les mêmes processus de QA, de révision, de contrôles et de limites d'étapes que le travail d'un modèle.
- Ce qui est envoyé. Ce dont le rôle a besoin (le code qu'il lit, les exigences, les résultats de ses outils, les images d'une pièce jointe) est envoyé à la machine, puis au fournisseur de l'agent via le compte de connexion de celui-ci. Si votre organisation doit limiter le stockage de code chez certains fournisseurs, prenez cela en compte avant d'assigner un rôle à un agent.
Coûts et journaux
Le raisonnement de l'agent est attribué à la personne dont l'appareil a exécuté le travail, et non aux dépenses liées au modèle de CoRoid. L'activité d'une tâche affiche une exécution de ce type, par exemple : Codex (gpt-6-luna) sur l'ordinateur portable d'Ada · hors forfait de mesure, jamais avec zéro jeton. Si un rôle utilise son modèle cloud, cette partie est facturée comme d'habitude.
CoRoid enregistre chaque tâche confiée à une machine : quelle machine et quel agent, le nom du modèle utilisé, son résultat final et le nombre d'appels d'outils effectués.
Exporter et importer
L'agent d'une affectation et son modèle sont inclus dans l'export des paramètres du profil, tout comme le choix des agents déterminé par la politique de l'organisation. Une organisation qui ne dispose pas d'agents locaux, pour laquelle cet agent n'est pas proposé ou dont la politique l'interdit, importe l'affectation avec uniquement son modèle cloud, et l'importation le précise. Voir Exporter et importer les paramètres.