Installation und erster Start

Die Benutzeroberfläche der Desktop-App ist derzeit nur auf Koreanisch verfügbar. Bezeichnungen aus der App stehen in dieser Anleitung beim ersten Vorkommen auf Koreanisch mit deutscher Übersetzung in Klammern, danach nur auf Deutsch.

Unterstützte Umgebungen

Agent Switchboard läuft in den folgenden drei Umgebungen.

<버전> steht für die Versionsnummer.

macOS wird nur auf Apple Silicon unterstützt. Für Intel-Macs gibt es keine Datei.

Die Installationsdateien erhalten Sie auf der Download-Seite. Die Download-Seite zeigt zuerst das Betriebssystem an, das Sie gerade verwenden.

Windows

Setup oder Portable

• Setup (Agent-Switchboard-Setup-…exe) wird empfohlen. Nach der Installation können Sie neue Versionen direkt in der App herunterladen und installieren.
• Portable (Agent-Switchboard-Portable-…exe) läuft ohne Installation. Die automatische Installation in der App wird nicht unterstützt. Wenn eine neue Version erscheint, müssen Sie die Datei erneut von der Download-Seite herunterladen.

SmartScreen-Warnung

Die Windows-Installationsdateien haben noch keine Authenticode-Codesignatur. Deshalb kann Windows SmartScreen beim Herunterladen im Browser oder beim ersten Start warnen, dass der Herausgeber nicht überprüft werden kann.

1. Prüfen Sie, ob Sie die Datei von der offiziellen Download-Seite (switchboard.twentyoz.kr) heruntergeladen haben.
2. Klicken Sie im Warnfenster auf Weitere Informationen und dann auf Trotzdem ausführen.

Updates, die Sie nach der Installation in der App erhalten, werden separat geprüft. Installiert wird erst, nachdem die Signatur der Update-Richtlinie und der SHA-512-Hash der Installationsdatei mit dem in der App eingebauten öffentlichen Schlüssel bestätigt wurden. Diese Prüfung ersetzt keine Codesignatur des Betriebssystems.

macOS

1. Öffnen Sie die Datei …-mac-arm64.dmg.
2. Ziehen Sie Agent Switchboard in den Ordner „Programme“.
3. Starten Sie die App aus dem Ordner „Programme“.

Die macOS-Dateien werden mit Developer-ID-Signatur und Apple-Beglaubigung (Notarization) veröffentlicht. Vor der Veröffentlichung müssen sie außerdem die Gatekeeper-Prüfung bestehen. Dateien von der offiziellen Download-Seite öffnen sich daher wie gewöhnliche Apps.

Linux

AppImage

Ein AppImage muss nicht installiert werden, 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- und Ubuntu-basierte Systeme)

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

Sicherer Speicher (Keyring)

API-Schlüssel werden verschlüsselt im sicheren Speicher des Betriebssystems verwahrt. Unter Linux ist dafür ein Desktop-Keyring wie Secret Service nötig. Steht kein Keyring zur Verfügung, wird der Schlüssel nicht im Klartext gespeichert, sondern oberhalb von 저장 후 적용 (Speichern und anwenden) der API-Schlüssel-Verbindung wird angezeigt, warum nicht gespeichert werden kann. Aktivieren Sie den Keyring und starten Sie die App neu. Auch die Smartphone-Verbindung lässt sich nur mit einem sicheren Speicher aktivieren.

Erster Start

Beim ersten Öffnen der App sehen Sie links die Leiste (Rail) und den Arbeitsbereich. Gehen Sie in dieser Reihenfolge vor.

1. Projektordner registrieren: Klicken Sie unten in der linken Leiste auf das Symbol 폴더 추가 (Ordner hinzufügen) und wählen Sie den Arbeitsordner. Danach öffnet sich die Projektstartseite dieses Ordners.
2. Verbindung registrieren: Öffnen Sie unten in der Seitenleiste 환경 설정 (Einstellungen) (Tastenkürzel unter Windows und Linux Ctrl+,, unter macOS ⌘,) und registrieren Sie unter 연결 · 인증 (Verbindung · Authentifizierung) einen API-Schlüssel oder ein Gateway. Wenn Sie nur die Abo-Anmeldung (OAuth) nutzen, können Sie diesen Schritt überspringen.
3. Auf Tools anwenden: Wählen Sie auf der Projektstartseite unter 도구 설정 (Tool-Einstellungen) ein Tool und legen Sie Verbindung und Modell fest. Einzelheiten finden Sie unter Verbindungen und Projekteinstellungen.
4. Starten: Starten Sie ein Tool direkt aus der Kopfzeile der Projektstartseite oder wählen Sie es im Projektmenü der Leiste unter ⋯ → 새 세션 (Neue Sitzung). Standardmäßig wird es in einem Terminal-Tab in der App gestartet.

Dieselbe Reihenfolge wird in der App unter 도움말 (Hilfe) → 처음 연결하기 (Erste Verbindung) erklärt.

Agent Switchboard ersetzt die CLIs der einzelnen Coding-Agents wie Codex oder Claude Code nicht. Die App erkennt, ob ein Tool installiert ist, und verweist für nicht installierte Tools auf den offiziellen Installationsweg.

Automatische Updates

Wann geprüft wird

• Etwa 2,5 Sekunden nach dem Start der App wird nach einer neuen Version gesucht.
• Solange die App läuft, wird alle 15 Minuten geprüft.
• Nach dem Aufwachen aus dem Ruhezustand wird nach 5 Sekunden erneut geprüft.
• Über das Download-Symbol oben können Sie jederzeit selbst prüfen.

Updates werden vom offiziellen Server (https://switchboard.twentyoz.kr/releases) bezogen. Ein Konto oder Zugriffstoken ist nicht nötig.

Wenn eine neue Version verfügbar ist

1. Wählen Sie 업데이트 다운로드 (Update herunterladen), 이번 버전 건너뛰기 (Diese Version überspringen) oder 나중에 (Später).
2. Der Download läuft im Hintergrund und zeigt Fortschritt, Größe und Geschwindigkeit an. Sie können ihn unterwegs abbrechen.
3. Auch nach Abschluss des Downloads wird nicht automatisch installiert. Erst wenn Sie auf 재시작하여 설치 (Neu starten und installieren) klicken und noch einmal bestätigen, wird die App beendet und installiert.

Wenn Sie Später wählen, werden Sie während der laufenden Sitzung 4 Stunden lang nicht erneut benachrichtigt. Bei einer manuellen Prüfung werden auch zurückgestellte und übersprungene Versionen wieder angezeigt. Im Update-Fenster können Sie das Änderungsprotokoll bis einschließlich der übersprungenen Versionen lesen.

Verhalten je Betriebssystem

Schlägt die Installation fehl, wird der Grund im Update-Fenster und im Bestätigungsfenster für den Neustart angezeigt. Lösungen finden Sie unter Fehlerbehebung.