Agents
Le volet Agents détermine quels agents de codage sont disponibles dans un espace de travail et comment chacun se connecte. Bromure Agentic Coding est livré avec cinq agents — Claude Code, Codex, Grok Build, Kimi Code et Oh My Pi — et n'importe quel sous-ensemble peut être activé par espace de travail. Le sous-titre du volet énonce le modèle clairement : activez chaque agent que vous voulez rendre disponible dans cet espace de travail ; celui marqué Principal se lance automatiquement dans le premier onglet, et les autres agents activés sont installés et authentifiés mais vous les exécutez à la demande depuis un nouvel onglet.
Quel que soit l'identifiant que vous saisissez ici, il n'atteint jamais la VM. L'agent à l'intérieur du bac à sable reçoit une clé leurre ; le proxy de l'hôte remplace le leurre par la valeur réelle sur le fil. Cette frontière du fil — ainsi que les mécanismes d'enregistrement d'abonnement et d'échange de jetons dont dépendent les modes d'authentification ci-dessous — fait l'objet du chapitre Identifiants.
Activer des agents et choisir le principal
Chaque agent est une carte munie d'un interrupteur d'activation dans son coin supérieur droit. Activez-le pour révéler les options d'authentification de cet agent ; désactivez-le pour replier la carte et retirer l'agent de l'espace de travail.
Un agent activé est toujours le Principal, marqué par une pastille en forme d'étoile orange. Le principal se lance automatiquement dans le premier onglet de terminal à l'ouverture d'une session ; les autres agents activés sont installés et authentifiés mais attendent que vous les démarriez depuis un nouvel onglet. Pour promouvoir un autre agent, activez-le et cliquez sur Définir comme principal sur sa carte — le principal précédent est rétrogradé mais conserve sa propre authentification. Désactiver le principal actuel promeut automatiquement un autre agent activé, et le dernier agent restant ne peut pas être désactivé : un espace de travail comporte toujours au moins un agent.
Modes d'authentification
Lorsqu'un agent est activé, un groupe de boutons radio sélectionne la manière dont il s'authentifie. Les modes proposés dépendent de l'agent — Bedrock est exclusif à Claude Code, et Oh My Pi n'accepte que la clé d'API (ses conditions d'utilisation n'autorisent pas la réutilisation d'un abonnement OAuth) :
| Mode | Claude Code | Codex | Grok Build | Kimi Code | Oh My Pi |
|---|---|---|---|---|---|
| Jeton d'API | Oui | Oui | Oui | Oui | Oui |
| Abonnement (connexion interactive) | Oui | Oui | Oui | Oui | — |
| Bedrock (AWS) | Oui | — | — | — | — |
| Modèle local | Oui | Oui | Oui | Oui | Oui |
Jeton d'API
Collez une clé d'API de fournisseur dans le champ sécurisé — son texte indicatif nomme le fournisseur : Clé d'API Anthropic, Clé d'API OpenAI, Clé d'API xAI, Clé d'API Moonshot ou, pour Oh My Pi, la clé du fournisseur que vous avez choisi (voir ci-dessous). La clé est stockée sur l'hôte, chiffrée ; la VM ne voit jamais qu'un leurre que le proxy réécrit vers la valeur réelle sur les requêtes destinées à ce fournisseur. Une case à cocher Exiger une approbation à l'utilisation (désactivée par défaut) est décrite sous Exiger une approbation à l'utilisation ci-dessous.
Les agents nouvellement activés utilisent ce mode par défaut.
Abonnement (connexion interactive)
Connecte l'agent avec votre abonnement payant (Claude, ChatGPT/Codex, Grok ou Kimi) plutôt qu'avec une clé d'API. Un bouton Enregistrer… en ligne exécute un flux de connexion interactive unique ; une fois terminé, un sceau vert apparaît à côté du mode, accompagné des commandes Réenregistrer… et Oublier. Les véritables jetons OAuth restent sur l'hôte et y sont renouvelés tandis que la VM reçoit des factices — l'état d'activation actuel de cet échange est affiché, et peut être réinitialisé, dans le volet Traçage.
C'est le mode par défaut du modèle d'usine pour Claude Code.
Bedrock (AWS) — Claude Code uniquement
Achemine Claude Code via Amazon Bedrock en utilisant les identifiants AWS que vous configurez sous Identifiants → AWS. Un champ ID de modèle par défaut remplace le modèle Bedrock que Claude Code demande — par exemple us.anthropic.claude-sonnet-4-6-v1:0 ; laissez-le vide pour utiliser la valeur par défaut intégrée de Claude Code. Bedrock n'est pas proposé pour Codex ni Grok Build.
Le sélecteur de fournisseur d'Oh My Pi
Oh My Pi (omp) est agnostique vis-à-vis du fournisseur, sa carte ajoute donc un sélecteur Fournisseur : Anthropic (Claude) (le choix par défaut), OpenAI, xAI (Grok), z.ai (GLM) ou Personnalisé (compatible OpenAI). Choisissez un fournisseur et collez sa clé d'API ; choisir Personnalisé révèle un champ d'URL de base pour n'importe quel point de terminaison compatible OpenAI (https://…/v1). Un champ Modèle facultatif fixe le modèle avec lequel omp démarre (les noms approximatifs comme opus ou gpt-5.2 fonctionnent). Changer de fournisseur — ou basculer l'espace de travail sur Modèle local — se fait en un clic et prend effet à la session suivante.
Modèle local
Exécute l'agent entièrement contre un modèle sur l'appareil servi par l'hôte, sans aucun fournisseur cloud impliqué. L'option est grisée — libellée — téléchargez un modèle dans Modèles locaux — tant qu'au moins un modèle n'est pas installé dans le volet Modèles locaux. Une fois qu'un modèle est disponible, l'agent est dirigé vers le moteur local via sa variable d'environnement d'URL de base (ANTHROPIC_BASE_URL, OPENAI_BASE_URL ou XAI_BASE_URL) et sert le modèle sélectionné dans Modèles locaux. Le moteur, le routage sur l'appareil et le repli hybride sont traités dans le chapitre Modèles locaux.
Remarque : Activer Activer les modèles locaux pour l'espace de travail épingle automatiquement chaque agent activé sur Modèle local, et le désactiver restaure le mode précédent de chaque agent. Vous configurez normalement l'inférence sur l'appareil depuis le volet Modèles locaux plutôt qu'agent par agent.
Exiger une approbation à l'utilisation
En mode Jeton d'API, la case à cocher Exiger une approbation à l'utilisation ajoute une barrière de consentement : avant que le proxy n'échange la clé leurre contre la vraie, l'hôte affiche une boîte de dialogue afin que vous puissiez autoriser l'utilisation une seule fois, pour une courte période, ou pour le reste de la session. Elle est désactivée par défaut. Le même schéma d'approbation par identifiant se répète tout au long du volet Identifiants.
Référence des paramètres
| Paramètre | Description |
|---|---|
| Activer (par agent) | Rend l'agent disponible dans cet espace de travail. Par défaut : Claude Code activé et principal ; Codex, Grok Build, Kimi Code et Oh My Pi désactivés. |
| Principal / Définir comme principal | Marque l'agent qui se lance automatiquement dans le premier onglet. Par défaut : Claude Code. Le dernier agent activé ne peut pas être désactivé. |
| Mode d'authentification | Radio : Jeton d'API / Abonnement (connexion interactive) / Bedrock (AWS) (Claude Code uniquement) / Modèle local (nécessite un modèle local installé). Par défaut : Abonnement (connexion interactive) pour Claude Code dans le modèle d'usine ; les agents nouvellement activés utilisent par défaut Jeton d'API. |
| Clé d'API | Champ sécurisé pour la clé du fournisseur en mode jeton (ANTHROPIC_API_KEY / OPENAI_API_KEY / XAI_API_KEY ; la clé de Kimi est écrite dans son config.toml, celle d'Oh My Pi dans la variable du fournisseur choisi). Injectée dans la VM sous forme de leurre ; échangée sur le fil. Par défaut : vide. |
| Exiger une approbation à l'utilisation | Case à cocher (mode jeton). Boîte de dialogue de consentement avant chaque échange clé leurre→réelle. Par défaut : désactivée. |
| ID de modèle par défaut | Mode Bedrock uniquement. Remplace l'id de modèle Bedrock, par exemple us.anthropic.claude-sonnet-4-6-v1:0. Par défaut : vide (valeur par défaut intégrée de l'agent). |
| Enregistrer… / Réenregistrer… / Oublier | Mode Abonnement uniquement. Exécute ou efface l'enregistrement de connexion interactive. Par défaut : non enregistré. |
| Fournisseur / URL de base / Modèle | Oh My Pi uniquement. Fournisseur en amont (par défaut Anthropic (Claude)), l'URL de base compatible OpenAI lorsque Personnalisé est sélectionné, et un remplacement de modèle facultatif. |
Astuce : Chaque agent se maintient à jour depuis l'intérieur de la VM — exécutez sa propre commande de mise à jour (
claude update,codex update, etc.) dans un onglet de terminal. Les mises à jour sont récupérées à la demande et persistent d'une session à l'autre du même espace de travail.
Chapitres liés
- Identifiants — comment les clés, jetons d'abonnement et identifiants AWS sont conservés sur l'hôte et échangés factice→réel sur le fil.
- Modèles locaux — le moteur sur l'appareil qui sous-tend le mode d'authentification Modèle local.
- Fusion — le volet multi-modèle tire ses branches des agents que vous configurez ici.
- Traçage — les lignes d'état de l'échange de jetons d'abonnement pour les modes Abonnement.