Anleitungsdokumente
Die Apps gibt es derzeit nur mit koreanischer Oberfläche. Bezeichnungen und Meldungen aus der App stehen beim ersten Vorkommen auf Koreanisch mit deutscher Übersetzung in Klammern, danach nur auf Deutsch.
Zuerst prüfen
- Aktualisieren Sie die App. Viele Probleme sind in neueren Versionen bereits behoben. Bei Funktionen, die mit dem Smartphone oder anderen PCs zusammenspielen, muss auch der verbundene PC auf dem neuesten Stand sein.
- Lesen Sie die Fehlermeldung genau. Je nach Ursache gibt die App unterschiedliche Hinweise.
Installation und Updates
Windows zeigt eine SmartScreen-Warnung
Die Warnung erscheint, weil die Windows-Installationsdateien noch nicht mit Authenticode signiert sind. Vergewissern Sie sich, dass die Datei von der offiziellen Download-Seite stammt, und klicken Sie auf Weitere Informationen → Trotzdem ausführen. Mehr dazu unter Installation und erster Start.
Die Portable-Version aktualisiert sich nicht
Windows Portable kann Updates nicht selbst installieren. Laden Sie die neue Datei von der Download-Seite und ersetzen Sie die alte. Wenn Sie automatische Updates möchten, nehmen Sie die Setup-Version.
Der Update-Server ist nicht erreichbar
Erreicht die App die Update-Adresse nicht, öffnet sie die Release-Seite im Standardbrowser. Dort laden Sie die Installationsdatei direkt herunter. Ein Konto oder Zugriffstoken brauchen Sie für Updates nicht.
Es kommen keine Update-Hinweise
- Haben Sie 나중에 (Später) gewählt, meldet sich die App in dieser Sitzung 4 Stunden lang nicht wieder.
- Haben Sie 이번 버전 건너뛰기 (Diese Version überspringen) gewählt, weist die App auf diese Version nicht mehr von selbst hin.
- Suchen Sie über das Download-Symbol oben selbst nach Updates, erscheinen zurückgestellte und übersprungene Versionen wieder.
Das Update lässt sich nicht installieren
Den Grund nennen das Update-Fenster und das Bestätigungsfenster für den Neustart.
- macOS: Tritt bei der Installationsprüfung ein Fehler oder nach 120 Sekunden eine Zeitüberschreitung auf, können Sie es erneut versuchen.
- Linux .deb: Bei der Installation sollte eine Abfrage nach Administratorrechten erscheinen. Kommt sie nicht innerhalb von 3 Minuten, bricht die App die Installation ab und zeigt Ihnen den Befehl, mit dem Sie im Terminal selbst installieren. Ob Sie die Abfrage abgebrochen haben oder keine Rechte erteilt wurden, erklärt die App jeweils gesondert.
- Linux, App aus einer Sandbox-Shell gestartet: Die Einschränkung
NoNewPrivskann verhindern, dass Rechte erhöht werden. Die App öffnet die Anmeldeabfrage dann über systemd des Benutzers. Klappt auch das nicht, erklärt sie, wie Sie in einem Terminal außerhalb der App mitsudoinstallieren.
Smartphone-Verbindung und QR-Code
„연결 QR 만들기“ (Verbindungs-QR erstellen) lässt sich nicht anklicken
Einen QR-Code gibt es erst, wenn der PC mit dem Relay-Server verbunden ist. Prüfen Sie unter 환경 설정 › 휴대폰 (Einstellungen › Smartphone), ob 휴대폰 연결 켜기 (Smartphone-Verbindung einschalten) aktiv ist und der Status „verbunden“ lautet.
Die Smartphone-Verbindung lässt sich nicht einschalten
Kann der PC den sicheren Speicher des Betriebssystems nicht nutzen, bleibt die Smartphone-Verbindung aus – ersatzweise im Klartext gespeichert wird nichts. Unter Linux richten Sie einen Keyring wie Secret Service ein und starten die App neu.
Der QR-Code ist abgelaufen oder schon benutzt
Ein QR-Code gilt 5 Minuten und nur für eine Verbindung. Erstellen Sie am PC einen neuen und verbinden Sie sich erneut.
„연결 시도가 너무 잦습니다“ (Zu viele Verbindungsversuche)
Verbindungen, bei denen die Authentifizierung fehlschlägt, sperrt der PC über den Relay-Server kurz (etwa 1 Minute). Warten Sie rund eine Minute und versuchen Sie es dann mit einem neuen QR-Code.
„연결이 해제되었습니다“ (Die Verbindung wurde getrennt)
Diese Meldung erscheint, wenn der PC dieses Smartphone getrennt oder die Desktop-Identität neu erstellt hat. Erstellen Sie am PC einen neuen QR-Code und verbinden Sie sich erneut. Waren Sie über ein Google-Konto verbunden, genügt es, die Verbindung im Freigabefenster des PCs wieder zuzulassen.
Der PC wird als ausgeschaltet angezeigt
Prüfen Sie, ob der PC läuft und Agent Switchboard gestartet ist. Sobald der PC wieder an ist, verbindet er sich von selbst.
Die Android-App zeigt nur „네트워크 연결을 확인하세요“ (Prüfen Sie die Netzwerkverbindung)
Android-Apps, die mit dem Release-Schlüssel signiert sind (ab 0.6.0), lassen sich nur mit einer PC-App ab Version 0.65.2 über das Google-Konto verbinden. Aktualisieren Sie die PC-App.
„Google 계정을 확인하지 못했습니다“ (Das Google-Konto konnte nicht bestätigt werden)
Geht die Uhr des PCs nach, kann die Prüfung des Google-Anmeldenachweises scheitern. Für leicht nachgehende Uhren ist das seit PC-Version 0.65.3 behoben. Aktualisieren Sie die PC-App und schalten Sie die automatische Zeitsynchronisierung des Betriebssystems ein.
Am PC erscheint „Google에 다시 로그인해 주세요“ (Bitte erneut bei Google anmelden)
Die Google-Anmeldung des PCs ist abgelaufen. Klicken Sie unter Einstellungen › Smartphone auf Google 다시 로그인 (Erneut bei Google anmelden). Bis dahin können sich keine weiteren Geräte neu verbinden.
Die Android-App lässt sich nicht installieren
Haben Sie früher ein APK mit anderer Signatur installiert, lässt sich das neue nicht darüber installieren. Deinstallieren Sie die alte App, installieren Sie das neue APK und verbinden Sie den PC und Ihr Google-Konto anschließend neu.
Nach dem Adresswechsel der Web-App ist die PC-Liste leer
Die Web-App für das Smartphone liegt jetzt unter https://app.switchboard.twentyoz.kr. Verbindungsdaten von der alten Adresse werden nicht übernommen. Verbinden Sie sich per QR-Code neu oder melden Sie sich, falls Sie ein Google-Konto genutzt haben, erneut an, um die PC-Liste zu laden.
Schlüssel und Authentifizierung
„저장 후 적용“ (Speichern und anwenden) ist ausgegraut (Linux)
Ohne sicheren Speicher des Betriebssystems (Keyring) kann die App keine API-Schlüssel speichern. Den Grund zeigt sie über der Schaltfläche an. Richten Sie den Keyring ein und starten Sie die App neu.
Das gewählte Modell wird nicht übernommen
Beim Verbindungstest und beim Anwenden prüft die App, ob das gewählte Modell tatsächlich nutzbar ist, und bricht andernfalls ab. Wählen Sie ein verfügbares Modell aus der Liste.
Die CLI meldet „credential is not configured“
Das kann passieren, wenn nach einer Änderung der Ordnerverbindung eine CLI mit einem alten Startprofil gestartet wird. Wenden Sie die Verbindung in den Tool-Einstellungen erneut an und starten Sie die CLI neu. Gibt es im Ordner Codex-Einstellungen, aber kein Verbindungsprofil mehr, erstellt die App das Profil aus den gespeicherten Einstellungen neu.
„SECURE_STORAGE_BOOTSTRAP_FAILED“ erscheint immer wieder
- Stellen Sie sicher, dass Agent Switchboard und alle zugehörigen Prozesse beendet sind.
- Wurde die App während der Initialisierung zwangsweise beendet und ist nur die Sperrdatei
.secure-storage-bootstrap.lockübrig, kopieren Sie diese Datei an einen anderen Ort, löschen Sie sie und starten Sie die App neu. - Löschen oder bearbeiten Sie weder die Datei
Local Statenoch den Ordnercredentials. Lassen Sie die Originale unverändert und wenden Sie sich an uns.
Die Unterstützung des Reasoning-Aufwands ließ sich nicht prüfen
Ist nicht geklärt, ob eine Reasoning-Stufe unterstützt wird, schickt die App den Standardwert des Tools und weist darauf hin. Konnten Sie wegen dieser Meldung in einer älteren Version keinen Chat beginnen, aktualisieren Sie die App.
Unter Windows öffnet sich das OAuth-Anmeldefenster nur als leeres Terminal
Hier hat das PowerShell-Startprofil des Benutzers den Anmeldebefehl blockiert. Seit Version 0.61.2 überspringt das Anmeldefenster das Startprofil. Aktualisieren Sie die App.
Wenn Sie uns schreiben
Hängen Sie bei der Meldung eines Sicherheitsproblems keine API-Schlüssel, OAuth-Tokens, Anmeldedateien oder vollständigen Konfigurationsdateien an. Es genügen Verbindungsadresse, Betriebssystem, App-Version, die Schritte zum Nachstellen und die Fehlermeldung mit unkenntlich gemachten sensiblen Werten. Schreiben Sie an hello@twentyoz.kr.