Verbindungen und Projekteinstellungen

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

Grundbegriffe

Agent Switchboard verwaltet drei Dinge getrennt.

• Verbindung: Adresse und API-Schlüssel eines Gateways oder Providers. Einmal unter 환경 설정 › 연결 · 인증 (Einstellungen › Verbindung · Authentifizierung) registriert, können mehrere Tools dieselbe Verbindung auswählen. Tools mit derselben Verbindung teilen sich den Schlüssel.
• Tool: Eine Coding-Agent-CLI wie Codex, Claude Code oder Pi. Für jedes Tool legen Sie Verbindungsart (API / 게이트웨이 (API / Gateway) oder OAuth / 기본 인증 (OAuth / Standardauthentifizierung)), Modell und Reasoning-Aufwand fest.
• Geltungsbereich: 전역 기본 (Globaler Standard) sind die Werte, denen alle registrierten Ordner folgen. Speichern Sie in einem Ordner eigene Werte, gelten diese nur für diesen Ordner.

Hat ein Ordner keine eigenen Einstellungen, verwendet er den globalen Standard unverändert. Beim ersten Speichern in einem Ordner werden die aktuellen Werte als Ausgangswerte für die ordnereigenen Einstellungen übernommen. Ordnereigene Provider-, Authentifizierungs-, Modell- und Reasoning-Einstellungen haben Vorrang vor den globalen.

Unterstützte Verbindungen

Auch für Droid, Crush und Kimi Code werden Verbindungen verwaltet. Antigravity (agy), Copilot CLI, Cursor CLI, Amp, Goose, Aider, Kilo CLI, Grok Build und Gemini CLI werden nur erkannt und gestartet. Einstellungen und Authentifizierung dieser Tools verwaltet das jeweilige Tool selbst.

Verbindung registrieren

API-Schlüssel und Gateways

1. Öffnen Sie unten in der Seitenleiste die Einstellungen und wechseln Sie zu „Verbindung · Authentifizierung“.
2. Klicken Sie auf 연결 추가 (Verbindung hinzufügen).
3. Wählen Sie einen Dienst aus dem Provider-Katalog oder geben Sie eine Gateway-Adresse ein, tragen Sie den API-Schlüssel ein und speichern Sie.

Entfernte Adressen werden nur mit HTTPS akzeptiert. HTTP ist nur für Adressen auf demselben PC (Loopback) erlaubt.

Schlüssel werden pro Verbindung verschlüsselt im sicheren Speicher des Betriebssystems (Windows DPAPI, macOS Keychain, Linux Secret Service) verwahrt. Gespeicherte Schlüssel werden nicht wieder angezeigt. In die Konfigurationsdateien von Codex, Claude Code und Pi wird statt des Schlüssels nur der Befehl des credential helper von Agent Switchboard geschrieben. Beim Start des Tools holt der helper den Schlüssel aus dem sicheren Speicher und übergibt ihn.

Das Registrieren einer Verbindung allein wendet sie noch nicht auf ein Tool an. Wenden Sie sie wie im nächsten Abschnitt beschrieben auf das Tool an.

Abo-Anmeldung (OAuth)

Wenn Sie die eigene Anmeldung eines Tools nutzen, etwa ein ChatGPT- oder Claude-Abo, brauchen Sie keinen API-Schlüssel.

1. Wählen Sie in den Tool-Einstellungen OAuth / 기본 인증 (OAuth / Standardauthentifizierung).
2. Klicken Sie auf 기본 인증 적용 (Standardauthentifizierung anwenden).
3. Melden Sie sich über den Anmeldeablauf des Tools an.

OAuth-Tokens verwahrt und erneuert jede CLI selbst in ihrem eigenen Speicher. Agent Switchboard liest oder kopiert diese Tokens nicht.

Mehrere Konten verwenden

Bei Codex, Claude Code, Pi und Qwen Code lässt sich die Standardauthentifizierung mit mehreren Konten nutzen. Legen Sie in der Kontenliste des Tools ein Konto an, melden Sie sich an und wählen Sie dann global oder pro Projekt ein Konto. Bei Pi melden Sie sich im geöffneten Terminal mit /login an, bei Qwen Code mit /auth. Die Kontoauswahl gilt nicht für API- und Gateway-Verbindungen.

Auf Tools anwenden

Globaler Standard

1. Klicken Sie in der linken Leiste auf 전역 기본 (Globaler Standard). Sie erreichen ihn auch über 전역 기본과 비교 (Mit globalem Standard vergleichen) auf der Projektstartseite.
2. Klicken Sie auf eine Tool-Karte, um die Einstellungen zu öffnen.
3. Wählen Sie API / 게이트웨이 (API / Gateway) oder OAuth / 기본 인증 (OAuth / Standardauthentifizierung).
4. Bei einer API-Verbindung wählen Sie die registrierte Verbindung und anschließend in der durchsuchbaren Liste ein Modell. Wenn Sie das Modell wechseln, werden auch der vom Modell unterstützte Reasoning-Aufwand (effort) und das Token-Limit übernommen.
5. Prüfen Sie Adresse und Authentifizierung mit 연결 테스트 (Verbindungstest).
6. Klicken Sie auf 저장 후 적용 (Speichern und anwenden). Bei OpenCode klicken Sie auf 설정 적용 (Einstellungen anwenden).

Beim Verbindungstest und beim Anwenden wird geprüft, ob das gewählte Modell tatsächlich nutzbar ist. Ist es nicht nutzbar, wird die Anwendung abgebrochen und Sie werden benachrichtigt. Wählen Sie in diesem Fall ein verfügbares Modell aus der Liste.

Unterschiedlich pro Projektordner

Dies ist die zentrale Funktion von Agent Switchboard. Auch auf demselben PC können Sie pro Ordner unterschiedliche Agents, Modelle, Provider und Schlüssel verwenden.

1. Wählen Sie in der linken Leiste ein Projekt, um die Projektstartseite zu öffnen.
2. Klicken Sie unter 도구 설정 (Tool-Einstellungen) auf eine Tool-Karte. Tools, die nicht in der Liste stehen, fügen Sie über die Schaltfläche 도구 (Tools; fügt diesem Ordner anzuzeigende Tools hinzu) hinzu.
3. Wählen Sie wie beim globalen Standard Verbindungsart, Verbindung, Modell und Reasoning-Aufwand.
4. Nach dem Anwenden werden dies die ordnereigenen Einstellungen.

Die Projektstartseite zeigt von oben nach unten 지금 (Jetzt; laufende, auf Eingabe wartende und fehlerhafte Sitzungen), die Tool-Einstellungen und 최근 세션 (Letzte Sitzungen). Auf den Tool-Karten sehen Sie Tool, Verbindung, Modell und Reasoning-Aufwand dieses Ordners auf einen Blick. Mit „Mit globalem Standard vergleichen“ stellen Sie sie den globalen Werten gegenüber.

Ordnereigene Einstellungen werden je Tool in folgende Dateien geschrieben.

Cline CLI legt keine Projektkonfigurationsdatei an, sondern wird im gewählten Ordner gestartet. Tools ohne Unterstützung für Projekteinstellungen werden als 프로젝트 설정 미지원 (Projekteinstellungen nicht unterstützt) gekennzeichnet und verwenden die globalen Einstellungen des PCs.

Standardwerte für neue Switcher-Chats

Auch Standard-Agent, -Modell und -Reasoning-Aufwand für Switcher-Chats lassen sich pro Ordner festlegen. Klicken Sie im Switcher-Menü des Projekts in der Leiste unter „Einstellungen“ auf 이 폴더에 저장 (In diesem Ordner speichern). Mit 전역 기본값 따르기 (Globalem Standard folgen) werden die Ordnerwerte gelöscht und wieder der globale Standard verwendet. Bereits geöffnete Chats behalten ihre bisherige Engine, ihr Modell und ihren Reasoning-Aufwand.

Schnell über die Taskleiste wechseln

Ein Klick auf das Symbol im Infobereich der Taskleiste (unter macOS in der Menüleiste) öffnet das Schnellwechsel-Panel.

1. Wählen Sie ein Tool und dann API · 게이트웨이 (API · Gateway) oder OAuth · 기본 인증 (OAuth · Standardauthentifizierung).
2. Wenn Sie einen Anbieter wählen, wird die Modellliste über die gespeicherte Verbindung geladen.
3. Wählen Sie ein Modell und klicken Sie auf 이 공급자로 전환 (Zu diesem Anbieter wechseln).

Auch der Schnellwechsel durchläuft dieselbe Sicherung, denselben Verbindungstest und dieselbe Prüfung wie das Hauptfenster.

Schutz der Konfigurationsdateien

• Vor der ersten Änderung wird das Original einmalig gesichert, bei jeder weiteren Änderung bleibt eine Revisionssicherung erhalten.
• Agent Switchboard ändert nur die Einträge, die es selbst verwaltet, und lässt alle übrigen Benutzereinstellungen unverändert.
• Nach dem Anwenden werden die erzeugten Dateien erneut gelesen und geprüft. Schlägt die Prüfung fehl, werden die durch diese Anwendung geänderten Inhalte auf den vorherigen Stand zurückgesetzt.
• 최초 설정 복원 (Ursprüngliche Einstellungen wiederherstellen) setzt die Dateien auf den Stand vor der ersten Änderung durch Agent Switchboard zurück.
• Wenn Sie einen gespeicherten Schlüssel löschen, wird die verwaltete Verbindung zuerst auf die Standardauthentifizierung des Tools umgestellt.

Nächste Schritte

• Wie Sie auf dem Smartphone weiterarbeiten, lesen Sie unter Smartphone verbinden.
• Zur Chatoberfläche und zur Koordination mehrerer Sitzungen siehe Switcher und Orchestrierung.