Documents du guide
Notions de base
Agent Switchboard distingue trois notions.
- 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 servir à plusieurs outils, qui partagent alors la même clé.
- Outil : un CLI d'agent de code comme Codex, Claude Code ou Pi. Pour chaque outil, vous choisissez le mode de connexion (
API / 게이트웨이(API / passerelle) ouOAuth / 기본 인증(OAuth / authentification par défaut)), le modèle et le niveau de raisonnement. - Portée : 「전역 기본」 (Défaut global) désigne les valeurs que suivent tous les dossiers enregistrés. Les valeurs enregistrées depuis un dossier ne s'appliquent qu'à lui.
Un dossier sans réglage propre utilise tel quel le défaut global. Au premier enregistrement depuis un dossier, ses paramètres propres sont créés à partir des valeurs actuelles. Ensuite, le provider, l'authentification, le modèle et le raisonnement définis pour le dossier l'emportent sur les valeurs globales.
Connexions prises en charge
| Outil | OAuth / authentification par défaut | API et passerelles |
|---|---|---|
| Codex | ChatGPT OAuth | OpenAI Responses, LiteLLM Responses, GLM via LiteLLM |
| Claude Code | Claude OAuth | Anthropic API, LiteLLM, GLM, OpenRouter, DeepSeek Anthropic Messages |
| Pi | ChatGPT OAuth, Claude OAuth | OpenAI, Anthropic, LiteLLM, Z.ai, OpenRouter, Gemini, xAI, DeepSeek, Groq, Together, Mistral, Cerebras |
| OpenCode | Authentification provider d'OpenCode, authentification des CLI Claude Code, Codex et Kimi Code | Chat compatible OpenAI, Anthropic Messages, catalogue de providers |
| Qwen Code | Authentification du CLI Qwen Code | OpenAI Chat, Anthropic Messages, catalogue de providers |
| Cline CLI | ChatGPT OAuth, authentification Cline | Providers intégrés par protocole |
L'application gère aussi les connexions de Droid, Crush et Kimi Code. Pour Antigravity (agy), Copilot CLI, Cursor CLI, Amp, Goose, Aider, Kilo CLI, Grok Build et Gemini CLI, elle se limite à vérifier l'installation et à les lancer : leur configuration et leur authentification restent gérées par chaque outil.
Enregistrer une connexion
Clé API ou passerelle
- Ouvrez 「환경 설정」 (Préférences) en bas de la barre latérale, puis allez dans 「연결 · 인증」 (Connexions et authentification).
- Cliquez sur 「연결 추가」 (Ajouter une connexion).
- 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 une adresse du PC lui-même (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 fois enregistrée, une clé 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 récupère la clé dans le stockage sécurisé et la lui transmet.
Enregistrer une connexion ne l'applique pas encore à un outil : suivez pour cela les étapes de la section « Appliquer aux outils » ci-dessous.
Connexion par abonnement (OAuth)
Si vous vous connectez directement dans l'outil, avec un abonnement ChatGPT ou Claude par exemple, aucune clé API n'est nécessaire.
- Dans l'écran de configuration de l'outil, choisissez
OAuth / 기본 인증(OAuth / authentification par défaut). - Cliquez sur 「기본 인증 적용」 (Appliquer l'authentification par défaut).
- 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
Avec Codex, Claude Code, Pi et Qwen Code, l'authentification par défaut accepte plusieurs comptes. Créez un compte dans la liste des comptes de l'outil, connectez-vous, puis choisissez le compte à utiliser, globalement 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
- 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.
- Cliquez sur la carte d'un outil pour ouvrir son écran de configuration.
- Choisissez
API / 게이트웨이(API / passerelle) ouOAuth / 기본 인증(OAuth / authentification par défaut). - Pour une connexion API, choisissez une connexion enregistrée, puis un modèle dans la liste avec recherche. Quand vous changez de modèle, les niveaux de raisonnement (Effort) et la limite de jetons qu'il prend en charge suivent automatiquement.
- Vérifiez l'adresse et l'authentification avec 「연결 테스트」 (Tester la connexion).
- Cliquez sur 「저장 후 적용」 (Enregistrer et appliquer). Pour OpenCode, cliquez sur 「설정 적용」 (Appliquer la configuration).
Au test de connexion comme à l'application, le modèle choisi est vérifié : est-il réellement utilisable ? Sinon, l'application des paramètres s'arrête et un message vous prévient. Choisissez alors un autre modèle disponible dans la liste.
Des réglages différents pour chaque dossier
C'est la fonctionnalité essentielle d'Agent Switchboard : sur un même PC, chaque dossier peut utiliser son propre agent, son modèle, son provider et sa clé.
- Choisissez un projet dans le rail de gauche pour ouvrir l'accueil du projet.
- 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.
- Choisissez le mode de connexion, la connexion, le modèle et le niveau de raisonnement comme pour le défaut global.
- Une fois appliqués, ces réglages ne valent que pour ce dossier.
De haut en bas, l'accueil du projet comporte 「지금」 (Maintenant : sessions en cours, en attente de saisie ou en erreur), Configuration des outils et 「최근 세션」 (Sessions récentes). Un coup d'œil aux cartes d'outils suffit pour connaître l'outil, la connexion, le modèle et le niveau de raisonnement du dossier ; Comparer avec le défaut global les affiche à côté des valeurs globales.
Les paramètres propres au dossier sont écrits dans les fichiers suivants, selon l'outil.
| Outil | Emplacement des paramètres du dossier |
|---|---|
| Codex | Profil propre au dossier dans $CODEX_HOME (sélectionné automatiquement au lancement) |
| Claude Code | .claude/settings.local.json |
| Pi | .pi/settings.json |
| OpenCode | opencode.json |
| Qwen Code | .qwen/settings.json |
Cline CLI ne crée pas de fichier de configuration de projet : il se lance simplement dans le dossier choisi. Les outils sans paramètres de projet portent la mention 「프로젝트 설정 미지원」 (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 utilisés à l'ouverture d'une nouvelle conversation Switcher peuvent aussi être définis pour chaque dossier. Dans le rail, ouvrez le menu Switcher du projet › Paramètres, puis cliquez sur 「이 폴더에 저장」 (Enregistrer pour ce dossier). 「전역 기본값 따르기」 (Suivre les valeurs par défaut globales) efface les valeurs du dossier, qui suit de nouveau le défaut global. Les conversations déjà ouvertes gardent 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 : vous changez de connexion sans ouvrir la fenêtre principale.
- Choisissez un outil, puis
API · 게이트웨이(API · passerelle) ouOAuth · 기본 인증(OAuth · authentification par défaut). - Choisissez un fournisseur : la liste des modèles est chargée avec la connexion enregistrée.
- Choisissez un modèle et cliquez sur 「이 공급자로 전환」 (Passer à ce fournisseur).
Le changement rapide procède exactement comme la fenêtre principale : sauvegarde, test de connexion, puis vérification du résultat.
Protection des fichiers de configuration
- À la première modification, l'original est sauvegardé ; ensuite, chaque changement laisse une sauvegarde de révision.
- Agent Switchboard ne modifie que les éléments qu'il gère et ne touche pas aux autres paramètres de l'utilisateur.
- Après application, les fichiers générés sont relus pour vérification. Si la vérification échoue, les changements de cette application sont annulés et l'état précédent est restauré.
- 「최초 설정 복원」 (Restaurer la configuration initiale) rétablit les fichiers tels qu'ils étaient avant la première intervention d'Agent Switchboard.
- Avant de supprimer une clé enregistrée, l'application rebascule les connexions gérées qui l'utilisaient 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 travailler dans une conversation ou répartir le travail entre plusieurs sessions, consultez Switcher et orchestration.