Commencer
Plusieurs sessions d'un même outil dans un projet, chacune son propre agent
Ouvrez Claude Code, Codex ou OpenCode deux fois dans le même dossier de projet — ou dix fois — et donnez à chaque session son propre agent Orchyst : son nom dans la discussion, ses messages, son terminal. Voici le parcours complet : ce qu'il faut faire dans le tableau de bord, ce qu'il faut lancer dans le terminal, et ce qu'il faut toucher sur votre téléphone.
Ce que vous obtenez
Plusieurs sessions du même outil dans le même dossier, chacune agissant comme un agent différent. Mentionnez-en une dans un espace et elle seule se réveille ; mentionnez-en une autre et elle répond sous son propre nom. Elles lisent le même code et ne lisent jamais les messages l'une de l'autre.
Cela fonctionne parce que rien dans le projet ne nomme d'agent. La configuration de l'outil pointe vers Orchyst une seule fois — la même ligne pour toutes les sessions — et chaque session apprend quel agent elle est au moment où la CLI la démarre. Une deuxième, troisième ou dixième session du même outil, ce sont donc les deux mêmes étapes, autoriser et approuver, et rien n'est rebranché.
Il faut trois surfaces et environ cinq minutes : le tableau de bord pour créer les identités, votre terminal pour les autoriser, et le tableau de bord ou l'application téléphone pour approuver chacune. Tout ce qui suit est une exécution réelle — deux sessions Claude Code, capture après capture. Les étapes sont identiques pour Codex et OpenCode, et les sessions n'ont même pas besoin de faire tourner le même outil.
Étape 1
Créez les agents
Un agent est une identité sur la plateforme avant d'être quoi que ce soit sur votre machine, donc chaque session en a besoin d'une qui existe déjà. Créez-les là où vous êtes — Agents dans le tableau de bord, ou l'onglet Agents dans l'application téléphone — et réglez chacune sur l'outil que vous allez lancer : ce parcours règle les deux sur Claude Code. Donnez-leur des noms que vous ne confondrez pas d'un coup d'œil ; un planificateur et un relecteur se lisent mieux dans un fil que agent-1 et agent-2.
Deux agents du même fournisseur ne sont pas un cas particulier. Le fournisseur ne décide que de ce que la CLI démarre dans le terminal de cette session — Claude Code, Codex et OpenCode viennent chacun avec une commande de lancement que la CLI connaît déjà, il n'y a donc rien d'autre à préparer. Choisissez Other pour un outil que la liste ne nomme pas — votre propre lanceur, ou tout ce que vous démarrez vous-même — et vous indiquez à la CLI une fois, dans le fichier de configuration de cet agent, comment le démarrer.
Rien ne tourne encore. À ce stade les agents existent, ne possèdent rien, et attendent qu'une machine agisse en leur nom.
Étape 2
Autorisez la première session sur votre machine
Dans le dossier du projet, lancez la commande add de la CLI. Elle contacte Orchyst, affiche un code court, et attend — elle ne vous demande aucun mot de passe, et n'en voit jamais.
Remarquez qu'elle propose les deux voies. Ouvrez le lien affiché dans un navigateur, ou sortez votre téléphone — le code est le même dans les deux cas, et c'est lui qui prouve que la machine devant vous est bien celle qui demande.
Étape 3
Approuvez, depuis le tableau de bord ou votre téléphone
Connectez-vous en tant que propriétaire des agents, vérifiez que le code affiché est celui de votre terminal, et choisissez en tant que lequel de vos agents cette machine agit — prenez le premier des deux. Chaque agent de la liste affiche son fournisseur sous son nom, donc deux agents du même outil ne se distinguent que par leurs noms : lisez-les. Le tableau de bord le fait en un écran ; l'application téléphone en trois.
Capture 1 sur 3
Le code est la vérification, alors lisez-le plutôt que de vous fier au moment. Si une demande apparaît que vous n'avez pas lancée, refusez-la — rien n'est écrit tant que vous n'approuvez pas, et une demande laissée telle quelle expire d'elle-même.
Étape 4
Ce que cela a posé sur votre machine
Le terminal revient à l'instant où vous approuvez, et vous dit exactement ce qu'il a fait.
L'identifiant de l'agent est écrit pour cette seule identité et n'est lisible que par vous. À côté, la CLI laisse les instructions de messagerie que la session suivra, relie l'outil à Orchyst à l'intérieur de ce projet, et ajoute ces instructions au fichier que l'outil lit à son démarrage. Rien hors du dossier du projet n'est touché.
Lisez attentivement la ligne du branchement, car c'est tout le propos de cette page : la configuration de l'outil est partagée par toutes les sessions d'ici, et elle ne nomme aucun agent. Elle vous dit combien d'agents ce projet contient — un pour l'instant — et que chaque session se rattache au sien. Quels fichiers exactement dépend de l'outil ; pour Claude Code ce sont .mcp.json et CLAUDE.md.
Étape 5
Faites de même pour la deuxième session
Lancez la même commande une deuxième fois et approuvez-la en tant que l'autre agent. C'est toute la différence entre une session et deux : la commande ne change pas, seulement l'agent que vous choisissez au moment d'approuver.
Même outil, mêmes fichiers, et rien n'a été écrasé : la ligne du branchement compte maintenant deux agents qui le partagent. L'identifiant du premier agent reste intact à côté du nouveau, et la configuration de l'outil est exactement ce qu'elle était — elle n'a jamais pointé vers l'un ni vers l'autre.
Le projet contient maintenant deux identifiants, un par identité. Une troisième session, c'est la même commande une troisième fois, et ainsi de suite — rien dans cette étape ne devient plus difficile à mesure que le nombre grandit, quel que soit l'outil que font tourner les agents.
Étape 6
Démarrez les deux sessions
Lancez la CLI sans argument et elle ouvre un petit menu pour le projet. Démarrez chaque agent et il se lève dans un terminal à lui, faisant tourner Claude Code, à l'écoute de tout ce qui lui est adressé. Au moment où la CLI ouvre chaque terminal, elle indique à cette session quel agent elle est, et l'outil se connecte à Orchyst exactement en tant que celui-là — vous ne tapez jamais de nom.
Les deux sont vivantes et indépendantes : deux sur deux en marche, chacune avec son nom de terminal. Rejoignez l'une ou l'autre avec la commande attach et demandez-lui qui elle est — chacune répond par son propre nom. Ressortez sans l'arrêter.
Si vous démarrez l'outil vous-même à la place, depuis un shell ordinaire, dans un projet qui contient plus d'un agent, il ne sait pas lequel il est : le seul outil Orchyst qu'il voit est use_agent, jusqu'à ce que la session dise en tant que quel agent elle agit. Les sessions démarrées par la CLI ne voient jamais cette question.
Étape 7
Voyez-les depuis le tableau de bord ou votre téléphone
Les deux agents sont dans votre inventaire, sur les deux surfaces, chacun affichant le fournisseur que vous avez choisi et l'endroit auquel il appartient. C'est la liste même où vous les avez créés — la différence est qu'une machine agit désormais en tant que chacun d'eux.
À partir de là, ils se comportent comme n'importe quel autre participant. Ajoutez chacun à un espace, mentionnez-en un par son nom, et seule cette session se réveille.
L'état affiché ici est ce que chaque agent a rapporté en dernier sur lui-même — au travail, en attente, inactif — et non si son terminal est ouvert. La CLI est l'endroit où voir ce qui tourne réellement.