# Apportez votre propre agent (BYOA) (/fr/docs/verdent-manager/configuration/byoa)
> Exécutez les tâches Worker de Manager sur vos propres runtimes Agent, comme Codex ou Claude Code
## Qu'est-ce que BYOA ? [#quest-ce-que-byoa-]
BYOA (Apportez votre propre agent) vous permet de choisir quel runtime Agent alimente les Workers de Manager. Au lieu d'utiliser uniquement les Agents par défaut de Verdent, les tâches Worker envoyées par Manager peuvent s'exécuter sur un Agent que vous utilisez déjà ou pour lequel vous disposez d'une licence.
Vous souhaitez plutôt utiliser votre propre clé API de fournisseur avec les agents intégrés de Verdent ? Consultez [BYOK](/docs/verdent-manager/configuration/byok).
## Types d'agents pris en charge [#types-dagents-pris-en-charge]
| Agent | Description | Prérequis |
| ------------- | ----------------------------------- | ----------------------------------------------------- |
| Agent intégré | Agent par défaut fourni par Verdent | Aucun |
| Claude Code | CLI Claude Code d'Anthropic | Node.js installé (pour `npx`) |
| Codex | CLI Codex de OpenAI | CLI Codex installée et environnement OpenAI configuré |
## Cas d'usage [#cas-dusage]
* **Accéder à des modèles spécifiques** — Exposez des versions de modèles non incluses dans l'ensemble par défaut de Verdent via le sélecteur de modèles.
* **Standardisation d'équipe** — Utilisez une licence d'entreprise partagée pour que l'usage de l'équipe soit facturé de manière centralisée.
* **Flux de travail familier** — Conservez votre expérience Claude Code ou Codex existante tout en laissant Manager y envoyer des tâches Worker.
## Accès rapide [#accès-rapide]
* Paramètres BYOA : **Settings → Models → CLI Agents**
* Sélection du modèle dans le chat Manager : désactivez le mode **Auto** dans la zone de saisie pour choisir un Task Model
* Les clés API configurées dans BYOA sont stockées uniquement en local et ne sont jamais envoyées aux serveurs de Verdent
## Codex [#codex]
Codex est la CLI d'agent de codage de OpenAI. Contrairement à Claude Code, Codex ne nécessite pas de clé API dans Verdent — il utilise l'authentification déjà configurée dans votre environnement Codex local.
### Prérequis [#prérequis]
* CLI Codex installée (`codex` doit être disponible dans votre `PATH`)
* CLI Codex authentifiée et utilisable dans votre terminal
### Étapes de configuration [#étapes-de-configuration]
Allez dans **Settings → Models → CLI Agents**.
Si la carte Codex n'est pas visible, cliquez sur **Add CLI Agent**. Verdent analyse le `PATH` de votre système à la recherche de la commande `codex`.
Activez le bouton **Codex**.
Verdent détecte automatiquement les modèles disponibles. Sélectionnez ceux que vous souhaitez utiliser.
### Découverte des modèles [#découverte-des-modèles]
Les modèles Codex sont découverts de manière dynamique. Après le lancement de Codex, Verdent récupère les modèles disponibles via son API `/models`. Si de nouveaux modèles sont ajoutés côté Codex, cliquez sur **Refresh Models** pour mettre à jour la liste.
### Authentification [#authentification]
Verdent ne gère pas l'authentification de Codex. Codex s'appuie sur votre environnement shell local (généralement `OPENAI_API_KEY` ou son flux de connexion intégré). Tant que `codex` fonctionne dans votre terminal, l'intégration fonctionne.
## Claude Code [#claude-code]
Claude Code est l'Agent le plus riche en fonctionnalités de BYOA et prend en charge plusieurs fournisseurs. Vous pouvez connecter Anthropic, OpenRouter, Zhipu GLM et d'autres, puis basculer entre eux dans le sélecteur de modèles.
### Prérequis [#prérequis-1]
* Node.js installé (seul `npx` est requis)
Verdent lance Claude Code via :
```bash
npx -y @agentclientprotocol/claude-agent-acp
```
Aucune installation globale n'est requise.
### Étapes de configuration [#étapes-de-configuration-1]
Allez dans **Settings → Models → CLI Agents**.
Si la carte Claude Code n'est pas visible, cliquez sur **Add CLI Agent**. Verdent détecte `npx`.
Activez le bouton **Claude Code**.
Cliquez sur **Add provider** et sélectionnez un fournisseur (par exemple, Anthropic).
Saisissez la clé API. Les valeurs par défaut sont pré-remplies.
Cliquez éventuellement sur **Test Connection**, puis sur **Save**.
Une fois l'enregistrement effectué, les modèles du fournisseur apparaissent dans la liste des modèles. Les modèles activés sont sélectionnés par défaut, mais peuvent être basculés manuellement.
### Fournisseurs pris en charge [#fournisseurs-pris-en-charge]
Claude Code prend en charge plusieurs fournisseurs. Vous pouvez en configurer plusieurs à la fois, et tous les modèles apparaissent dans le sélecteur.
#### Anthropic [#anthropic]
API officielle d'Anthropic pour les modèles Claude.
* **Authentification :** clé API
* **URL de base :** `https://api.anthropic.com`
* **Modèles :** Opus / Sonnet / Haiku
* **Clé :** [platform.claude.com/settings/keys](https://platform.claude.com/settings/keys)
#### OpenRouter [#openrouter]
Accès API unifié à plusieurs fournisseurs de modèles.
* **Authentification :** jeton
* **URL de base :** `https://openrouter.ai/api`
* **Modèles :** Opus / Sonnet / Haiku
* **Clé :** [openrouter.ai/workspaces/default/keys](https://openrouter.ai/workspaces/default/keys)
Vous pouvez remplacer les Role Models pour router vers d'autres modèles OpenRouter (par exemple, `google/gemini-2.5-pro`).
#### Zhipu GLM (Chine) [#zhipu-glm-chine]
* **URL de base :** `https://open.bigmodel.cn/api/anthropic`
* **Modèle :** GLM-5
* **Clé :** [bigmodel.cn/usercenter/proj-mgmt/apikeys](https://bigmodel.cn/usercenter/proj-mgmt/apikeys)
* **Documentation :** [docs.bigmodel.cn](https://docs.bigmodel.cn)
#### Zhipu GLM (Global) [#zhipu-glm-global]
* **URL de base :** `https://api.z.ai/api/anthropic`
* **Modèle :** GLM-5
* **Clé :** [z.ai/manage-apikey/apikey-list](https://z.ai/manage-apikey/apikey-list)
* **Documentation :** [docs.z.ai](https://docs.z.ai)
#### Kimi [#kimi]
* **URL de base :** `https://api.kimi.com/coding/`
* **Modèle :** Kimi K2.5
* **Clé :** [kimi.com/code/console](https://kimi.com/code/console)
* **Documentation :** [kimi.com/code/docs](https://kimi.com/code/docs)
#### Moonshot [#moonshot]
* **URL de base :** `https://api.moonshot.cn/anthropic`
* **Modèle :** Kimi K2.5
* **Clé :** [platform.moonshot.cn/console/api-keys](https://platform.moonshot.cn/console/api-keys)
* **Documentation :** [platform.moonshot.cn/docs](https://platform.moonshot.cn/docs)
Kimi et Moonshot proposent tous deux Kimi K2.5, mais utilisent des points de terminaison et une authentification différents. Choisissez en fonction de l'origine de votre clé.
#### MiniMax (Chine) [#minimax-chine]
* **URL de base :** `https://api.minimaxi.com/anthropic`
* **Modèle :** MiniMax-M2.7
* **Clé :** [platform.minimaxi.com](https://platform.minimaxi.com)
* **Documentation :** [platform.minimaxi.com/docs](https://platform.minimaxi.com/docs)
#### MiniMax (Global) [#minimax-global]
* **URL de base :** `https://api.minimax.io/anthropic`
* **Modèle :** MiniMax-M2.7
* **Clé :** [platform.minimax.io](https://platform.minimax.io)
* **Documentation :** [platform.minimax.io/docs](https://platform.minimax.io/docs)
#### Xiaomi MiMo [#xiaomi-mimo]
* **URL de base :** `https://api.xiaomimimo.com/anthropic`
* **Modèle :** MiMo V2 Pro
* **Clé :** [platform.xiaomimimo.com](https://platform.xiaomimimo.com)
* **Documentation :** [platform.xiaomimimo.com/docs](https://platform.xiaomimimo.com/docs)
#### Xiaomi MiMo (Offre par jeton) [#xiaomi-mimo-offre-par-jeton]
* **URL de base :** `https://token-plan-cn.xiaomimimo.com/anthropic`
* **Modèle :** MiMo V2 Pro
* **Clé :** [platform.xiaomimimo.com](https://platform.xiaomimimo.com)
* **Documentation :** [platform.xiaomimimo.com/docs](https://platform.xiaomimimo.com/docs)
#### Compatible Anthropic (point de terminaison personnalisé) [#compatible-anthropic-point-de-terminaison-personnalisé]
Pour tout service compatible avec le format API d'Anthropic.
* **Authentification :** clé API ou jeton (interchangeable)
* **URL de base :** configurée manuellement
* **Modèles :** spécifiés manuellement
Utilisez cette option si votre fournisseur n'est pas répertorié mais prend en charge des API compatibles Anthropic.
### Options avancées [#options-avancées]
Dans le panneau de configuration du fournisseur, développez **Advanced Options** pour accéder à un éditeur JSON :
* **Mappage des Role Models :**
* `ANTHROPIC_DEFAULT_OPUS_MODEL`
* `ANTHROPIC_DEFAULT_SONNET_MODEL`
* `ANTHROPIC_DEFAULT_HAIKU_MODEL`
* `CLAUDE_CODE_SUBAGENT_MODEL`
* **Variables d'environnement personnalisées** (par exemple, `API_TIMEOUT_MS`)
La plupart des utilisateurs n'ont pas besoin de les modifier — les valeurs par défaut fonctionnent bien telles quelles.
## Utiliser les modèles BYOA dans Manager [#utiliser-les-modèles-byoa-dans-manager]
Après la configuration :
Désactivez le mode **Auto** dans la zone de saisie du chat.
Ouvrez le menu déroulant **Task Model**.
Choisissez un modèle BYOA activé. Les tâches Worker s'exécuteront avec ce modèle.
Les modèles apparaissent sous la forme :
* `GPT-5.4 Codex-CLI` (depuis Codex)
* `Claude-Opus-4.7 ClaudeCode-CLI` (depuis Claude Code)
Le survol affiche des détails tels que la source CLI, le nom du modèle et le fournisseur.
## Sécurité et confidentialité [#sécurité-et-confidentialité]
* **Stockage local uniquement :** les clés API sont stockées en local et ne sont jamais téléchargées.
* **Clés Claude Code :** stockées de manière sécurisée, non écrites dans des fichiers de configuration en clair.
* **Authentification Codex :** entièrement gérée par votre environnement local ; Verdent n'accède pas aux clés OpenAI.
## FAQ [#faq]
### CLI Agent non détecté ? [#cli-agent-non-détecté-]
Vérifiez que les commandes sont disponibles dans `PATH` :
* Claude Code nécessite `npx` (Node.js installé)
* Codex nécessite l'installation de la CLI `codex`
Exécutez :
```bash
which npx
which codex
```
### Échec de Test Connection ? [#échec-de-test-connection-]
* Vérifiez la clé API
* Vérifiez l'URL de base
* Assurez-vous d'avoir un accès réseau au point de terminaison API
* Vérifiez la configuration du proxy si vous en utilisez un
### Fournisseur ajouté mais modèles non visibles ? [#fournisseur-ajouté-mais-modèles-non-visibles-]
* Vérifiez que Claude Code est activé
* Vérifiez que les modèles du fournisseur sont activés
* Redémarrez Verdent si nécessaire