Anleitungsdokumente
Die Desktop-App gibt es derzeit nur mit koreanischer Oberfläche. Bezeichnungen aus der App stehen in dieser Anleitung beim ersten Vorkommen auf Koreanisch mit deutscher Übersetzung in Klammern, danach nur auf Deutsch.
Unterstützte Systeme
Agent Switchboard läuft auf diesen drei Systemen:
| Betriebssystem | Architektur | Installationsdatei |
|---|---|---|
| Windows | x64 | Agent-Switchboard-Setup-<버전>-x64.exe, Agent-Switchboard-Portable-<버전>-x64.exe |
| macOS | Apple Silicon (arm64) | Agent-Switchboard-<버전>-mac-arm64.dmg, ZIP |
| Linux | x64 | Agent-Switchboard-<버전>-linux-x86_64.AppImage, Agent-Switchboard-<버전>-linux-amd64.deb |
<버전> steht für die Versionsnummer.
Unter macOS wird nur Apple Silicon unterstützt. Für Intel-Macs gibt es keine Datei.
Die Installationsdateien finden Sie auf der Download-Seite. Dort sehen Sie zuerst die Dateien für das System, das Sie gerade verwenden.
Windows
Setup oder Portable?
- Wir empfehlen Setup (
Agent-Switchboard-Setup-…exe). Einmal installiert, lädt die App neue Versionen selbst herunter und installiert sie. - Portable (
Agent-Switchboard-Portable-…exe) läuft ohne Installation. Updates kann die App dann allerdings nicht selbst installieren: Für jede neue Version laden Sie die Datei erneut von der Download-Seite.
SmartScreen-Warnung
Die Windows-Installationsdateien sind noch nicht mit Authenticode signiert. Beim Herunterladen oder beim ersten Start kann Windows SmartScreen deshalb melden, dass der Herausgeber nicht überprüft werden konnte.
- Vergewissern Sie sich, dass die Datei von der offiziellen Download-Seite (
switchboard.twentyoz.kr) stammt. - Klicken Sie in der Warnung auf Weitere Informationen und dann auf Trotzdem ausführen.
Updates, die die App nach der Installation selbst lädt, werden gesondert geprüft: Mit dem öffentlichen Schlüssel, der in der App steckt, kontrolliert sie die Signatur der Update-Richtlinie und den SHA-512-Hash der Installationsdatei. Installiert wird nur, wenn beides stimmt. Eine Codesignatur des Betriebssystems ersetzt diese Prüfung allerdings nicht.
macOS
- Öffnen Sie die Datei
…-mac-arm64.dmg. - Ziehen Sie Agent Switchboard in den Ordner „Programme“.
- Starten Sie die App aus dem Ordner „Programme“.
Die macOS-Dateien sind mit einer Developer ID signiert und von Apple beglaubigt (Notarization). Vor der Veröffentlichung müssen sie außerdem die Gatekeeper-Prüfung bestehen. Haben Sie die Datei von der offiziellen Download-Seite, öffnet sie sich wie jede andere App.
Linux
AppImage
Ein AppImage brauchen Sie nicht zu installieren. Es genügt, die Datei ausführbar zu machen.
chmod +x Agent-Switchboard-<버전>-linux-x86_64.AppImage
./Agent-Switchboard-<버전>-linux-x86_64.AppImage
.deb (Debian, Ubuntu und verwandte Systeme)
sudo apt install ./Agent-Switchboard-<버전>-linux-amd64.deb
Sicherer Speicher (Keyring)
API-Schlüssel legt die App verschlüsselt im sicheren Speicher des Betriebssystems ab. Unter Linux brauchen Sie dafür einen Desktop-Keyring wie Secret Service. Fehlt der Keyring, speichert die App den Schlüssel nicht etwa im Klartext, sondern zeigt über der Schaltfläche 저장 후 적용 (Speichern und anwenden) der API-Schlüssel-Verbindung an, warum das Speichern nicht möglich ist. Richten Sie den Keyring ein und starten Sie die App neu. Auch die Smartphone-Verbindung lässt sich nur mit sicherem Speicher einschalten.
Erster Start
Beim ersten Start sehen Sie links die Seitenleiste (Rail) und daneben den Arbeitsbereich. Am einfachsten gehen Sie so vor:
- Projektordner hinzufügen: Klicken Sie unten in der Seitenleiste auf das Symbol 폴더 추가 (Ordner hinzufügen) und wählen Sie den Ordner, in dem Sie arbeiten. Danach öffnet sich die Projektstartseite dieses Ordners.
- Verbindung anlegen: Öffnen Sie unten in der Seitenleiste 환경 설정 (Einstellungen) – unter Windows und Linux mit
Ctrl+,, unter macOS mit⌘,– und legen Sie unter 연결 · 인증 (Verbindung · Authentifizierung) einen API-Schlüssel oder ein Gateway an. Wenn Sie nur die Abo-Anmeldung (OAuth) nutzen, können Sie diesen Schritt überspringen. - Tool einrichten: Wählen Sie auf der Projektstartseite unter 도구 설정 (Tool-Einstellungen) ein Tool und legen Sie Verbindung und Modell fest. Wie das im Einzelnen geht, steht unter Verbindungen und Projekteinstellungen.
- Starten: Starten Sie ein Tool direkt aus der Kopfzeile der Projektstartseite oder wählen Sie es im Projektmenü der Seitenleiste unter
⋯ → 새 세션(Neue Sitzung). Standardmäßig öffnet es sich in einem Terminal-Tab der App.
Dieselben Schritte finden Sie auch in der App unter 도움말 (Hilfe) → 처음 연결하기 (Erste Verbindung).
Die CLIs der Coding-Agents wie Codex oder Claude Code ersetzt Agent Switchboard nicht. Die App prüft, ob ein Tool installiert ist, und verweist für fehlende Tools auf die offizielle Installationsanleitung.
Automatische Updates
Wann die App nach Updates sucht
- etwa 2,5 Sekunden nach dem Start
- alle 15 Minuten, solange die App läuft
- 5 Sekunden nach dem Aufwachen aus dem Ruhezustand
- jederzeit, wenn Sie oben auf das Download-Symbol klicken
Updates kommen vom offiziellen Server (https://switchboard.twentyoz.kr/releases). Ein Konto oder Zugriffstoken brauchen Sie dafür nicht.
Wenn eine neue Version bereitsteht
- Wählen Sie 업데이트 다운로드 (Update herunterladen), 이번 버전 건너뛰기 (Diese Version überspringen) oder 나중에 (Später).
- Der Download läuft im Hintergrund. Sie sehen Fortschritt, Größe und Geschwindigkeit und können jederzeit abbrechen.
- Nach dem Download wird nicht sofort installiert. Erst wenn Sie auf 재시작하여 설치 (Neu starten und installieren) klicken und noch einmal bestätigen, schließt sich die App und installiert das Update.
Wählen Sie Später, meldet sich die App in dieser Sitzung 4 Stunden lang nicht wieder. Suchen Sie selbst nach Updates, erscheinen auch zurückgestellte und übersprungene Versionen wieder. Was sich bis einschließlich der übersprungenen Versionen geändert hat, lesen Sie im Update-Fenster.
Verhalten je nach System
| Installationsart | Installation direkt aus der App |
|---|---|
| Windows Setup | Ja |
| Windows Portable | Nein. Laden Sie die neue Datei von der Download-Seite herunter |
| macOS (signierte App) | Ja. Die App schließt sich erst, wenn die Installationsprüfung abgeschlossen ist. Bei einem Fehler oder nach 120 Sekunden Zeitüberschreitung können Sie es erneut versuchen |
| Linux AppImage | Ja. Die neue Version startet, sobald die alte App beendet ist |
| Linux .deb | Ja. Bei der Installation werden Sie nach Administratorrechten gefragt |
Schlägt die Installation fehl, nennen das Update-Fenster und das Bestätigungsfenster für den Neustart den Grund. Lösungen finden Sie unter Fehlerbehebung.