Prise en charge en un clic des outils de programmation AI

La fonction de prise en charge en un clic (« Takeover ») vous permet d’orienter vos outils CLI de programmation AI favoris vers la passerelle AI locale sans avoir à modifier manuellement les fichiers de configuration. Une fois la prise en charge effectuée, les requêtes de ces outils sont centralisées via http://127.0.0.1:11580, puis relayées vers les fournisseurs configurés dans la passerelle pour un suivi unifié des usages et des coûts.

Principe de fonctionnement

Pour chaque outil, lors de la prise en charge en un clic, la passerelle effectue les étapes suivantes :

1. Vérification du bon fonctionnement de la passerelle, et s’assure que l’endpoint proxy est disponible.
2. Création automatique d’une clé virtuelle dédiée (la clé brute s’affiche une seule fois à la création ; elle est injectée dans la configuration de l’outil).
3. Sauvegarde du fichier de configuration d’origine en lui ajoutant le suffixe .bak (par ex. ~/.claude/settings.json.bak).
4. Écriture précise / fusion profonde de la configuration pour pointer vers la passerelle, en préservant vos autres réglages.
5. Actualisation de l’interface pour afficher le nouvel état de prise en charge.

La suppression de la prise en charge est elle aussi « ciblée » : seule la clé pointant réellement vers la passerelle sera retirée, évitant toute suppression accidentelle d’autres réglages personnalisés.

États de prise en charge

Dans la page Passerelle AI → Endpoints, chaque outil peut apparaître dans l’un des quatre états suivants :

État	Signification
Prise en charge (cette passerelle)	L’outil pointe sur la passerelle AI locale
Connecté (autre adresse)	L’outil est configuré avec une autre adresse (par réglage manuel ou autre passerelle), la configuration ne sera pas écrasée
Non pris en charge	L’outil est détecté mais ne pointe pas encore vers la passerelle
Non détecté	Le répertoire de configuration de cet outil n’est pas trouvé sur cette machine

Prérequis

• Avoir un compte ServBay connecté et au moins un canal valide configuré dans la section Canaux.
• L’outil AI cible doit être installé localement (la passerelle cherche le dossier de configuration pour détecter sa présence).

Procédure de prise en charge en un clic

Allez dans Passerelle AI → Endpoints, trouvez l’outil désiré dans la liste et cliquez sur Prise en charge en un clic. En cas de succès, son état passera à « Prise en charge (cette passerelle) ». Pour annuler la prise en charge, cliquez simplement sur Retirer / Restaurer.

Détail de la prise en charge selon les outils

Le tableau suivant précise, pour chaque outil, les fichiers de configuration modifiés et leur contenu lors de la prise en charge, afin d’éclairer le fonctionnement ou faciliter tout dépannage :

Outil	Fichier config	Clés ajoutées	Adresse 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] + paramètre racine model_provider = "servbay"	http://127.0.0.1:11580/v1
Gemini CLI	~/.gemini/.env	Lignes GOOGLE_GEMINI_BASE_URL + GEMINI_API_KEY	http://127.0.0.1:11580
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 du modèle	http://127.0.0.1:11580/v1
CodeBuddy	~/.codebuddy/models.json	Fusion profonde du nœud modèle servbay	http://127.0.0.1:11580/v1
opencode	~/.config/opencode/opencode.json	Fusion profonde du nœud provider.servbay (pour l’agrégation des modèles de canaux)	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 ne comporte-t-elle pas /v1

Claude Code utilise le protocole Anthropic, donc la passerelle concatène automatiquement les chemins /v1/messages à la base fournie ; par conséquent, ANTHROPIC_BASE_URL doit absolument être l’adresse racine de la passerelle (donc sans /v1). La plupart des autres outils suivent le protocole OpenAI et exigent le suffixe /v1. La fonction de prise en charge ajuste tout automatiquement, sans intervention manuelle.

Restauration et dépannage

• Restaurer la configuration d’origine — Cliquez sur Retirer pour que la passerelle supprime précisément sa propre configuration dans le fichier, ou restaurez à la main via le fichier de sauvegarde .bak créé dans le même dossier.
• L’état affiche « Connecté (autre adresse) » — Cela signifie que l’outil pointe actuellement vers une autre adresse (configurée manuellement ou via une autre passerelle). Pour éviter de modifier vos paramètres, la passerelle ne prendra pas en charge automatiquement. Vous pouvez d’abord effacer cette configuration manuellement.
• Erreur persistante après la prise en charge — Vérifiez que le service proxy de la passerelle est bien actif, que le canal désigné fonctionne, que la clé virtuelle n’a pas été révoquée et que les requêtes parviennent bien à la passerelle (à vérifier dans la section Statistiques et supervision).

FAQ

• Q : Est-ce que la prise en charge écrase ou corrompt la configuration de mes outils ?
  • R : Non. La passerelle écrit ou fusionne uniquement les clés liées à la passerelle et crée une sauvegarde .bak avant tout changement. Toutes vos autres options restent intactes.
• Q : Puis-je restaurer la config initiale après la prise en charge ?
  • R : Oui. Cliquez sur « Retirer » pour supprimer les réglages de la passerelle ou utilisez le fichier .bak pour restaurer manuellement.
• Q : Où se trouve la clé virtuelle utilisée lors de la prise en charge ?
  • R : La passerelle crée automatiquement une clé virtuelle dédiée pour chaque outil et vous permet de la consulter ou la gérer dans l’onglet Clés.
• Q : Mon outil apparaît comme « Non détecté » dans la liste ?
  • R : Cela signifie que son dossier de configuration n’a pas été trouvé sur votre système. Installez et exécutez l’outil une première fois pour générer ce dossier avant de le prendre en charge.

Conclusion

Grâce à la prise en charge en un clic, la corvée fastidieuse et source d’erreurs de configurer chaque outil manuellement devient un jeu d’enfant : création automatique des clés, sauvegarde, écriture ciblée, restauration à tout moment. Associé au suivi centralisé des canaux et des consommations, tous vos outils de programmation AI partagent désormais un même schéma de configuration fournisseur et une vision globale des coûts. Si vous souhaitez intégrer la passerelle à votre propre code, consultez la section Endpoints & Variables d’environnement.