Prise de contrôle en un clic des outils de programmation IA

La prise de contrôle en un clic (Takeover) vous permet, sans éditer manuellement aucun fichier de configuration, de faire pointer vos outils CLI de programmation IA vers la passerelle IA locale. Après la prise de contrôle, les requêtes de ces outils sont acheminées de manière unifiée via http://127.0.0.1:11580 vers les canaux de fournisseurs configurés dans la passerelle, et sont incluses dans les statistiques unifiées d'utilisation et de coûts.

Fonctionnement

Lors de la prise de contrôle en un clic d'un outil, la passerelle effectue successivement :

1. Vérifie l'état de santé de la passerelle, confirme que le point de terminaison proxy est disponible.
2. Crée automatiquement une clé virtuelle dédiée (la passerelle l'écrit dans la configuration de l'outil ; la valeur en clair peut être récupérée à tout moment depuis la page des clés).
3. Sauvegarde le fichier de configuration d'origine avec l'extension .bak (par ex. ~/.claude/settings.json.bak).
4. Écrit précisément / fusionne en profondeur la configuration pointant vers la passerelle, en conservant vos autres réglages.
5. Actualise l'état de l'interface et affiche la prise de contrôle actuelle.

Lorsque vous arrêtez la prise de contrôle, la même logique de « suppression précise » s'applique : les clés correspondantes ne sont retirées que si la configuration pointe réellement vers cette passerelle, afin d'éviter de supprimer par erreur d'autres réglages que vous avez configurés manuellement ; la clé virtuelle créée automatiquement lors de la prise de contrôle est également révoquée.

États de prise de contrôle

Chaque outil affiche l'un des quatre états sur la page Passerelle IA → Gestion des intégrations → Clients :

État	Signification
Sous contrôle (cette passerelle)	L'outil pointe vers la passerelle IA locale
Connecté (autre adresse)	L'outil est configuré avec une autre adresse (configuration manuelle ou autre passerelle) ; la passerelle ne l'écrasera pas sans votre accord
Non contrôlé	L'outil est détecté, mais ne pointe pas encore vers la passerelle
Non détecté	Le répertoire de configuration de l'outil est introuvable sur cette machine

Prérequis

• Vous êtes connecté à un compte ServBay et avez configuré au moins un canal disponible dans la page Canaux.
• L'outil IA cible est installé sur cette machine (la passerelle se base sur son répertoire de configuration pour déterminer s'il existe).

Opération de prise de contrôle en un clic

Accédez à Passerelle IA → Gestion des intégrations → Clients, trouvez l'outil cible dans la liste, puis cliquez sur Prise de contrôle en un clic. Une fois la prise de contrôle réussie, l'état devient « Sous contrôle (cette passerelle) ». Pour l'annuler, cliquez sur Arrêter la prise de contrôle.

Détails de la prise de contrôle par outil

Le tableau ci-dessous liste les fichiers de configuration et le contenu réellement modifiés pour chaque outil lors de la prise de contrôle, pour vous aider à comprendre et à dépanner :

Outil	Fichier de configuration	Contenu écrit	Adresse de la passerelle
Claude Code	~/.claude/settings.json	env.ANTHROPIC_BASE_URL + env.ANTHROPIC_AUTH_TOKEN	http://127.0.0.1:11580 (sans /v1)
Codex	~/.codex/config.toml	Section [model_providers.servbay] + model_provider = "servbay" au niveau supérieur	http://127.0.0.1:11580/v1
Qwen Code	~/.qwen/.env	OPENAI_BASE_URL + OPENAI_API_KEY (compatible OpenAI)	http://127.0.0.1:11580/v1
Kimi CLI	~/.kimi/config.toml	Section [model_providers.servbay] + définition de modèle	http://127.0.0.1:11580/v1
CodeBuddy	~/.codebuddy/models.json	Fusion profonde du nœud de modèle servbay	http://127.0.0.1:11580/v1
opencode	~/.config/opencode/opencode.json	Fusion profonde du nœud provider.servbay (agrège les modèles de chaque canal)	http://127.0.0.1:11580/v1
Crush	~/.config/crush/crush.json	Fusion profonde du nœud providers.servbay	http://127.0.0.1:11580/v1

Pourquoi l'adresse de Claude Code n'inclut-elle pas /v1

Claude Code utilise le protocole Anthropic ; la passerelle ajoute elle-même des chemins tels que /v1/messages. Par conséquent, ANTHROPIC_BASE_URL doit être l'adresse racine de la passerelle (sans /v1). La plupart des autres outils utilisent le protocole compatible OpenAI et nécessitent le suffixe /v1. La prise de contrôle en un clic remplit automatiquement selon les conventions de chaque outil, vous n'avez pas à faire la distinction manuellement.

Restauration et dépannage

• Restaurer la configuration d'origine — Cliquez sur Supprimer ; la passerelle retire précisément la configuration qui pointe vers cette passerelle. Vous pouvez aussi restaurer manuellement à l'aide du fichier de sauvegarde .bak situé dans le même répertoire.
• L'état affiche « Connecté (autre adresse) » — Cela signifie que l'outil pointe actuellement vers une autre adresse (configuration manuelle ou autre passerelle). Pour ne pas écraser vos réglages, la passerelle ne prend pas automatiquement le contrôle ; vous pouvez d'abord nettoyer manuellement cette configuration, puis effectuer la prise de contrôle.
• L'outil renvoie toujours une erreur après la prise de contrôle — Vérifiez que le service proxy de la passerelle est en cours d'exécution, que le canal correspondant est sain et que la clé virtuelle n'a pas été révoquée. Vous pouvez aussi consulter la page Statistiques et supervision pour voir si les requêtes atteignent la passerelle.

Questions fréquentes (FAQ)

• Q : La prise de contrôle en un clic va-t-elle endommager ma configuration d'outil existante ?
  • R : Non. La passerelle écrit / fusionne uniquement les clés liées à la passerelle et sauvegarde le fichier d'origine en .bak avant l'écriture. Les autres réglages restent inchangés.
• Q : Puis-je revenir manuellement en arrière après la prise de contrôle ?
  • R : Oui. Cliquez sur « Supprimer » pour que la passerelle annule la prise de contrôle, ou utilisez la sauvegarde .bak pour restaurer manuellement.
• Q : Où se trouve la clé virtuelle utilisée pour la prise de contrôle ?
  • R : La passerelle crée automatiquement une clé virtuelle dédiée pour chaque outil pris en contrôle. Vous pouvez la consulter et la gérer sur la page Clés.
• Q : L'outil affiche « Non détecté » dans la liste ?
  • R : Cela signifie que le répertoire de configuration de l'outil est introuvable sur cette machine. Installez d'abord l'outil et exécutez-le une fois afin qu'il génère son répertoire de configuration, puis effectuez la prise de contrôle.

Résumé

La prise de contrôle en un clic simplifie une tâche fastidieuse et source d'erreurs — l'édition manuelle des fichiers de configuration de chaque outil — en un seul clic : création automatique de clé, sauvegarde automatique, écriture précise et restauration à tout moment. Associée à des canaux et à des statistiques d'utilisation unifiés, elle permet à tous vos outils de programmation IA de partager la même configuration de fournisseurs et la même vue des coûts. Si vous souhaitez appeler la passerelle depuis votre propre code, consultez Points de terminaison et variables d'environnement.