Installation et premier lancement

Environnements pris en charge

Agent Switchboard fonctionne dans les trois environnements suivants.

macOS est pris en charge uniquement sur Apple Silicon. Aucun fichier n'est fourni pour les Mac Intel.

Les fichiers d'installation se trouvent sur la page de téléchargement. Celle-ci affiche d'abord le système d'exploitation que vous utilisez.

Windows

Choisir entre Setup et Portable

• Setup (Agent-Switchboard-Setup-…exe) est recommandé. Après l'installation, vous pouvez télécharger et installer les nouvelles versions depuis l'application.
• Portable (Agent-Switchboard-Portable-…exe) s'exécute sans installation. L'installation automatique depuis l'application n'est pas prise en charge : à chaque nouvelle version, téléchargez à nouveau le fichier depuis la page de téléchargement.

Avertissement SmartScreen

Les fichiers d'installation Windows ne sont pas encore signés avec Authenticode. Lors du téléchargement dans le navigateur ou du premier lancement, Windows SmartScreen peut donc signaler qu'il ne peut pas vérifier l'éditeur.

1. Vérifiez que le fichier provient de la page de téléchargement officielle (switchboard.twentyoz.kr).
2. Dans la fenêtre d'avertissement, cliquez sur Informations complémentaires puis sur Exécuter quand même.

Les mises à jour reçues dans l'application après l'installation font l'objet d'une vérification distincte. L'application vérifie, avec la clé publique qu'elle embarque, la signature de la politique de mise à jour et le hachage SHA-512 du fichier d'installation, et n'installe qu'ensuite. Cette vérification ne remplace pas la signature de code du système d'exploitation.

macOS

1. Ouvrez le fichier …-mac-arm64.dmg.
2. Faites glisser Agent Switchboard dans le dossier Applications.
3. Lancez l'application depuis le dossier Applications.

Les fichiers macOS sont publiés après signature Developer ID et notarisation Apple (notarization). Ils doivent aussi passer la vérification Gatekeeper avant publication. Un fichier téléchargé depuis la page officielle s'ouvre donc comme une application ordinaire.

Linux

AppImage

L'AppImage ne nécessite pas d'installation : il suffit de lui donner le droit d'exécution.

chmod +x Agent-Switchboard-<version>-linux-x86_64.AppImage
./Agent-Switchboard-<version>-linux-x86_64.AppImage

.deb (distributions de type Debian ou Ubuntu)

sudo apt install ./Agent-Switchboard-<version>-linux-amd64.deb

Stockage sécurisé (keyring)

Les clés API sont chiffrées dans le stockage sécurisé du système d'exploitation. Sous Linux, un keyring de bureau tel que Secret Service est nécessaire. Si aucun keyring n'est disponible, la clé n'est pas enregistrée en clair : la raison pour laquelle l'enregistrement est impossible s'affiche au-dessus de 「저장 후 적용」 (Enregistrer et appliquer) dans la connexion par clé API. Activez un keyring puis redémarrez l'application. La connexion du téléphone nécessite elle aussi un stockage sécurisé.

Premier lancement

À la première ouverture, l'application affiche le rail à gauche et l'espace de travail. Commencez dans l'ordre suivant.

1. Enregistrer un dossier de projet : cliquez sur l'icône 「폴더 추가」 (Ajouter un dossier) en bas du rail de gauche et choisissez le dossier de travail. L'accueil du projet de ce dossier s'ouvre.
2. Enregistrer une connexion : ouvrez 「환경 설정」 (Préférences) en bas de la barre latérale (raccourci Ctrl+, sous Windows et Linux, ⌘, sous macOS), puis enregistrez une clé API ou une passerelle dans 「연결 · 인증」 (Connexions et authentification). Si vous utilisez uniquement une connexion par abonnement (OAuth), vous pouvez passer cette étape.
3. Appliquer aux outils : dans 「도구 설정」 (Configuration des outils) de l'accueil du projet, choisissez un outil et définissez sa connexion et son modèle. Pour le détail, consultez Connexions et paramètres par projet.
4. Lancer : lancez un outil directement depuis l'en-tête de l'accueil du projet, ou choisissez-le dans le menu du projet du rail ⋯ → 새 세션 (Nouvelle session). Par défaut, l'outil s'exécute dans un onglet de terminal de l'application.

La même procédure est décrite dans l'application, sous 「도움말」 (Aide) → 「처음 연결하기」 (Première connexion).

Agent Switchboard ne remplace pas les CLI des agents de code comme Codex ou Claude Code. L'application détecte si chaque outil est installé et, sinon, indique la procédure d'installation officielle.

Mises à jour automatiques

Moment des vérifications

• Environ 2,5 secondes après le démarrage, l'application recherche une nouvelle version.
• Tant qu'elle est ouverte, elle vérifie toutes les 15 minutes.
• Au retour de veille, elle vérifie à nouveau après 5 secondes.
• Vous pouvez vérifier vous-même à tout moment avec l'icône de téléchargement en haut de la fenêtre.

Les mises à jour sont téléchargées depuis le serveur officiel (https://switchboard.twentyoz.kr/releases). Aucun compte ni jeton d'accès n'est nécessaire.

Lorsqu'une nouvelle version est disponible

1. Choisissez 「업데이트 다운로드」 (Télécharger la mise à jour), 「이번 버전 건너뛰기」 (Ignorer cette version) ou 「나중에」 (Plus tard).
2. Le téléchargement s'effectue en arrière-plan et affiche la progression, la taille et la vitesse. Vous pouvez l'annuler en cours de route.
3. Une fois le téléchargement terminé, rien n'est installé automatiquement. L'application se ferme et s'installe seulement après un clic sur 「재시작하여 설치」 (Redémarrer et installer) et une seconde confirmation.

Si vous choisissez Plus tard, aucun nouveau rappel n'est affiché pendant 4 heures au cours de la session en cours. Une vérification manuelle réaffiche la mise à jour reportée ainsi que les versions ignorées. La fenêtre de mise à jour permet de lire le journal des modifications jusqu'à la version ignorée.

Comportement selon le système d'exploitation

En cas d'échec de l'installation, la raison s'affiche dans la fenêtre de mise à jour et dans la fenêtre de confirmation du redémarrage. Pour les solutions, consultez Dépannage.