Documents du guide
Environnements pris en charge
Agent Switchboard fonctionne sur les trois environnements ci-dessous.
| Système d'exploitation | Architecture | Fichiers d'installation |
|---|---|---|
| Windows | x64 | Agent-Switchboard-Setup-<version>-x64.exe, Agent-Switchboard-Portable-<version>-x64.exe |
| macOS | Apple Silicon (arm64) | Agent-Switchboard-<version>-mac-arm64.dmg, ZIP |
| Linux | x64 | Agent-Switchboard-<version>-linux-x86_64.AppImage, Agent-Switchboard-<version>-linux-amd64.deb |
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. Les fichiers correspondant à votre système s'affichent en premier.
Windows
Choisir entre Setup et Portable
- Setup (
Agent-Switchboard-Setup-…exe) est recommandé : une fois installé, il télécharge et installe les nouvelles versions depuis l'application. - Portable (
Agent-Switchboard-Portable-…exe) se lance sans installation. En contrepartie, il ne peut pas installer de mise à jour depuis l'application : à chaque nouvelle version, il faut retélécharger le fichier sur la page de téléchargement.
Avertissement SmartScreen
Les fichiers d'installation Windows ne sont pas encore signés avec Authenticode. Au téléchargement ou au premier lancement, Windows SmartScreen peut donc vous avertir que l'éditeur n'a pas pu être vérifié.
- Vérifiez que le fichier provient de la page de téléchargement officielle (
switchboard.twentyoz.kr). - Dans la fenêtre d'avertissement, cliquez sur Informations complémentaires puis sur Exécuter quand même.
Les mises à jour reçues ensuite dans l'application sont vérifiées à part. Avec la clé publique intégrée, l'application contrôle la signature de la politique de mise à jour et l'empreinte SHA-512 du fichier d'installation, et n'installe rien si l'un des deux contrôles échoue. Cette vérification ne remplace toutefois pas la signature de code du système d'exploitation.
macOS
- Ouvrez le fichier
…-mac-arm64.dmg. - Faites glisser Agent Switchboard dans le dossier Applications.
- Lancez l'application depuis le dossier Applications.
Les fichiers macOS sont signés avec un Developer ID et notarisés par Apple (notarization), et passent la vérification Gatekeeper avant publication. Téléchargés depuis la page officielle, ils s'ouvrent comme n'importe quelle autre application.
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 étant chiffrées dans le stockage sécurisé du système, Linux a besoin d'un keyring de bureau tel que Secret Service. Sans keyring, la clé n'est jamais enregistrée en clair : la raison s'affiche au-dessus du bouton 「저장 후 적용」 (Enregistrer et appliquer) de la connexion par clé API. Activez un keyring, puis redémarrez l'application. La connexion du téléphone exige elle aussi un stockage sécurisé.
Premier lancement
À la première ouverture, vous voyez le rail à gauche et l'espace de travail. Il suffit ensuite de suivre ces étapes.
- Enregistrer un dossier de projet : cliquez sur l'icône 「폴더 추가」 (Ajouter un dossier) en bas du rail de gauche et choisissez le dossier sur lequel vous travaillez. L'accueil du projet s'ouvre alors.
- 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 n'utilisez qu'un abonnement (OAuth), passez cette étape. - Appliquer aux outils : dans 「도구 설정」 (Configuration des outils) de l'accueil du projet, choisissez un outil et définissez sa connexion et son modèle. Le détail est expliqué dans Connexions et paramètres par projet.
- 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'ouvre dans un onglet de terminal de l'application.
Vous retrouverez ces étapes dans l'application, sous 「도움말」 (Aide) → 「처음 연결하기」 (Première connexion).
Agent Switchboard ne remplace pas les CLI d'agents de code comme Codex ou Claude Code. L'application vérifie qu'ils sont installés et, s'il en manque un, indique la méthode d'installation officielle.
Mises à jour automatiques
Quand l'application vérifie
- 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 aussi lancer la vérification à tout moment en cliquant sur 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
- Choisissez 「업데이트 다운로드」 (Télécharger la mise à jour), 「이번 버전 건너뛰기」 (Ignorer cette version) ou 「나중에」 (Plus tard).
- Le téléchargement s'effectue en arrière-plan et affiche la progression, la taille et la vitesse. Vous pouvez aussi l'annuler en cours de route.
- Le téléchargement terminé, rien n'est encore installé : l'application ne se ferme pour s'installer qu'après un clic sur 「재시작하여 설치」 (Redémarrer et installer), puis une confirmation.
Si vous choisissez Plus tard, l'application ne vous relance pas pendant 4 heures tant qu'elle reste ouverte. Une vérification manuelle réaffiche la version reportée comme les versions ignorées. Le journal des modifications jusqu'à la version ignorée se lit dans la fenêtre de mise à jour.
Comportement selon le système d'exploitation
| Format d'installation | Installation automatique dans l'application |
|---|---|
| Windows Setup | Prise en charge |
| Windows Portable | Non prise en charge. Téléchargez le nouveau fichier depuis la page de téléchargement |
| macOS (application signée) | Prise en charge. L'application se ferme une fois la vérification de l'installation terminée ; en cas d'erreur ou de dépassement du délai de 120 secondes, vous pouvez réessayer |
| Linux AppImage | Prise en charge. La nouvelle version se lance après la fermeture de l'ancienne |
| Linux .deb | Prise en charge. Une fenêtre de privilèges administrateur s'ouvre pendant l'installation |
Si l'installation échoue, la raison s'affiche dans la fenêtre de mise à jour et dans celle de confirmation du redémarrage. Les solutions sont dans Dépannage.