Connexions et paramètres par projet

Notions de base

Agent Switchboard gère séparément trois éléments.

• Connexion : l'adresse et la clé API d'une passerelle ou d'un provider. Une connexion enregistrée une seule fois dans 「환경 설정 › 연결 · 인증」 (Préférences › Connexions et authentification) peut être choisie par plusieurs outils. Les outils qui utilisent la même connexion partagent la clé.
• Outil : un CLI d'agent de code comme Codex, Claude Code ou Pi. Pour chaque outil, on définit le mode de connexion (API / 게이트웨이 (API / passerelle) ou OAuth / 기본 인증 (OAuth / authentification par défaut)), le modèle et le niveau de raisonnement.
• Portée : 「전역 기본」 (Défaut global) désigne les valeurs suivies par tous les dossiers enregistrés. Si vous enregistrez des valeurs propres à un dossier, elles s'appliquent uniquement à ce dossier.

Un dossier sans réglage propre utilise les valeurs par défaut globales. Le premier enregistrement depuis un dossier crée des paramètres propres à ce dossier en partant des valeurs actuelles. Le provider, l'authentification, le modèle et les réglages de raisonnement propres au dossier ont priorité sur les valeurs globales.

Connexions prises en charge

Les connexions de Droid, Crush et Kimi Code sont également gérées. Antigravity (agy), Copilot CLI, Cursor CLI, Amp, Goose, Aider, Kilo CLI, Grok Build et Gemini CLI sont seulement détectés et lancés. Leur configuration et leur authentification sont gérées par chaque outil.

Enregistrer une connexion

Clé API ou passerelle

1. Ouvrez 「환경 설정」 (Préférences) en bas de la barre latérale, puis allez dans 「연결 · 인증」 (Connexions et authentification).
2. Cliquez sur 「연결 추가」 (Ajouter une connexion).
3. Choisissez un service dans le catalogue de providers ou saisissez l'adresse de la passerelle, entrez la clé API et enregistrez.

Les adresses distantes doivent être en HTTPS. Le HTTP n'est accepté que pour les adresses du même PC (loopback).

Les clés sont chiffrées connexion par connexion dans le stockage sécurisé du système d'exploitation (Windows DPAPI, macOS Keychain, Linux Secret Service). Une clé enregistrée n'est plus jamais réaffichée. Les fichiers de configuration de Codex, Claude Code et Pi ne contiennent pas la clé, seulement la commande credential helper d'Agent Switchboard. Au lancement de l'outil, le helper lit la clé dans le stockage sécurisé et la transmet.

L'enregistrement d'une connexion ne suffit pas à l'appliquer à un outil. Suivez pour cela la procédure de la section suivante.

Connexion par abonnement (OAuth)

Si vous utilisez la connexion propre à l'outil, comme un abonnement ChatGPT ou Claude, aucune clé API n'est nécessaire.

1. Dans l'écran de configuration de l'outil, choisissez OAuth / 기본 인증 (OAuth / authentification par défaut).
2. Cliquez sur 「기본 인증 적용」 (Appliquer l'authentification par défaut).
3. Connectez-vous via le parcours de connexion de l'outil.

Chaque CLI conserve et renouvelle lui-même ses jetons OAuth dans son propre stockage. Agent Switchboard ne lit ni ne copie ces jetons.

Utiliser plusieurs comptes

Codex, Claude Code, Pi et Qwen Code peuvent utiliser l'authentification par défaut avec plusieurs comptes. Créez un compte dans la liste des comptes de l'outil, connectez-vous, puis choisissez le compte au niveau global ou par projet. Pi se connecte avec /login dans un terminal ouvert, Qwen Code avec /auth. Le choix du compte ne s'applique pas aux connexions API ou passerelle.

Appliquer aux outils

Défaut global

1. Cliquez sur Défaut global dans le rail de gauche. Vous pouvez aussi l'ouvrir avec 「전역 기본과 비교」 (Comparer avec le défaut global) depuis l'accueil du projet.
2. Cliquez sur la carte d'un outil pour ouvrir son écran de configuration.
3. Choisissez API / 게이트웨이 (API / passerelle) ou OAuth / 기본 인증 (OAuth / authentification par défaut).
4. Pour une connexion API, choisissez une connexion enregistrée, puis un modèle dans la liste avec recherche. Lorsque vous changez de modèle, les niveaux de raisonnement (effort) et la limite de jetons qu'il prend en charge sont repris en même temps.
5. Vérifiez l'adresse et l'authentification avec 「연결 테스트」 (Tester la connexion).
6. Cliquez sur 「저장 후 적용」 (Enregistrer et appliquer). Pour OpenCode, cliquez sur 「설정 적용」 (Appliquer la configuration).

Lors du test de connexion et de l'application, l'application vérifie que le modèle choisi est réellement utilisable. Si ce n'est pas le cas, l'application des paramètres est interrompue et un message s'affiche. Choisissez alors vous-même un modèle disponible dans la liste.

Différent pour chaque dossier de projet

C'est la fonctionnalité centrale d'Agent Switchboard. Sur un même PC, chaque dossier peut utiliser un agent, un modèle, un provider et une clé différents.

1. Choisissez un projet dans le rail de gauche pour ouvrir l'accueil du projet.
2. Dans 「도구 설정」 (Configuration des outils), cliquez sur la carte d'un outil. Pour un outil absent de la liste, ajoutez-le avec le bouton 「도구」 (Outils), qui ajoute un outil à afficher pour ce dossier.
3. Choisissez le mode de connexion, la connexion, le modèle et le niveau de raisonnement comme pour le défaut global.
4. Une fois appliqués, ces réglages deviennent les paramètres propres à ce dossier.

De haut en bas, l'accueil du projet affiche 「지금」 (Maintenant : sessions en cours, en attente de saisie ou en erreur), Configuration des outils et 「최근 세션」 (Sessions récentes). Les cartes d'outils montrent d'un coup d'œil l'outil, la connexion, le modèle et le niveau de raisonnement du dossier. Comparer avec le défaut global permet de les voir côte à côte avec les valeurs globales.

Les paramètres propres au dossier sont écrits dans les fichiers suivants, selon l'outil.

Cline CLI ne crée pas de fichier de configuration de projet et s'exécute dans le dossier choisi. Les outils qui ne prennent pas en charge les paramètres de projet sont signalés par 「프로젝트 설정 미지원」 (Paramètres de projet non pris en charge) et utilisent les paramètres globaux du PC.

Valeurs par défaut des nouvelles conversations Switcher

L'agent, le modèle et le niveau de raisonnement par défaut des conversations Switcher peuvent aussi être définis par dossier. Dans le menu Switcher du projet dans le rail › Paramètres, cliquez sur 「이 폴더에 저장」 (Enregistrer pour ce dossier). 「전역 기본값 따르기」 (Suivre les valeurs par défaut globales) efface les valeurs du dossier, qui suit à nouveau le défaut global. Les conversations déjà ouvertes conservent leur moteur, leur modèle et leur niveau de raisonnement.

Changer rapidement depuis la zone de notification

Cliquez sur l'icône de la zone de notification (barre des menus sous macOS) pour ouvrir le panneau de changement rapide.

1. Choisissez un outil, puis API · 게이트웨이 (API · passerelle) ou OAuth · 기본 인증 (OAuth · authentification par défaut).
2. Choisissez un fournisseur : la liste des modèles est chargée avec la connexion enregistrée.
3. Choisissez un modèle et cliquez sur 「이 공급자로 전환」 (Passer à ce fournisseur).

Le changement rapide passe par les mêmes étapes de sauvegarde, de test de connexion et de vérification que la fenêtre principale.

Protection des fichiers de configuration

• Avant toute modification, l'original est sauvegardé une première fois, puis une sauvegarde de révision est conservée à chaque changement.
• Agent Switchboard ne modifie que les éléments qu'il gère et préserve les autres paramètres de l'utilisateur.
• Après application, les fichiers générés sont relus pour vérification. En cas d'échec, les modifications de cette application sont annulées et l'état précédent est restauré.
• 「최초 설정 복원」 (Restaurer la configuration initiale) rétablit les fichiers dans leur état d'avant la première modification par Agent Switchboard.
• Lorsque vous supprimez une clé enregistrée, la connexion gérée est d'abord basculée vers l'authentification par défaut de l'outil.

Étapes suivantes

• Pour continuer sur votre téléphone, consultez Connexion du téléphone.
• Pour l'interface conversationnelle et la coordination de plusieurs sessions, consultez Switcher et orchestration.