Agent Switchboard
Herunterladen

Sprache

Ihre Sprachwahl merken wir uns in einem Cookie.

Design
Anleitungsdokumente

Verbindungen und Projekteinstellungen

Die Desktop-App gibt es derzeit nur mit koreanischer Oberfläche. Bezeichnungen aus der App stehen beim ersten Vorkommen auf Koreanisch mit deutscher Übersetzung in Klammern, danach nur auf Deutsch.

Die Grundbegriffe

Agent Switchboard unterscheidet drei Dinge:

  • Verbindung: Adresse und API-Schlüssel eines Gateways oder Providers. Sie legen eine Verbindung einmal unter 환경 설정 › 연결 · 인증 (Einstellungen › Verbindung · Authentifizierung) an, danach können beliebig viele Tools sie verwenden. Tools mit derselben Verbindung teilen sich den Schlüssel.
  • Tool: eine Coding-Agent-CLI wie Codex, Claude Code oder Pi. Für jedes Tool wählen Sie die Verbindungsart (API / 게이트웨이 (API / Gateway) oder OAuth / 기본 인증 (OAuth / Standardauthentifizierung)), das Modell und den Reasoning-Aufwand.
  • Geltungsbereich: Der 전역 기본 (globale Standard) gilt für alle registrierten Ordner. Speichern Sie in einem Ordner eigene Werte, gelten diese nur dort.

Solange ein Ordner keine eigenen Werte hat, gilt der globale Standard. Speichern Sie in einem Ordner zum ersten Mal, dienen die aktuellen Werte als Ausgangspunkt für die Ordnereinstellungen. Was Sie im Ordner für Provider, Authentifizierung, Modell und Reasoning festlegen, hat Vorrang vor dem globalen Standard.

Unterstützte Verbindungen

Tool OAuth / Standardauthentifizierung API und Gateway
Codex ChatGPT OAuth OpenAI Responses, LiteLLM Responses, GLM via LiteLLM
Claude Code Claude OAuth Anthropic API, LiteLLM, GLM, OpenRouter, DeepSeek Anthropic Messages
Pi ChatGPT OAuth, Claude OAuth OpenAI, Anthropic, LiteLLM, Z.ai, OpenRouter, Gemini, xAI, DeepSeek, Groq, Together, Mistral, Cerebras
OpenCode Authentifizierung über OpenCode-Provider sowie Claude Code, Codex und Kimi Code CLI OpenAI-kompatibler Chat, Anthropic Messages, Provider-Katalog
Qwen Code Authentifizierung der Qwen Code CLI OpenAI Chat, Anthropic Messages, Provider-Katalog
Cline CLI ChatGPT OAuth, Cline-Authentifizierung Eingebaute Provider je Protokoll

Auch bei Droid, Crush und Kimi Code verwaltet die App die Verbindung. Antigravity (agy), Copilot CLI, Cursor CLI, Amp, Goose, Aider, Kilo CLI, Grok Build und Gemini CLI erkennt und startet sie nur; Einstellungen und Anmeldung verwalten diese Tools selbst.

Verbindung anlegen

API-Schlüssel und Gateways

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

Entfernte Adressen müssen HTTPS verwenden. HTTP ist nur für Adressen auf demselben PC (Loopback) erlaubt.

Schlüssel werden pro Verbindung verschlüsselt im sicheren Speicher des Betriebssystems abgelegt (Windows DPAPI, macOS Keychain, Linux Secret Service) und nach dem Speichern nie wieder angezeigt. In die Konfigurationsdateien von Codex, Claude Code und Pi schreibt die App statt des Schlüssels nur den Befehl ihres credential helper. Startet ein Tool, holt der helper den Schlüssel aus dem sicheren Speicher und reicht ihn weiter.

Eine angelegte Verbindung gilt noch für kein Tool. Wie Sie sie zuweisen, steht weiter unten unter „Verbindung einem Tool zuweisen“.

Abo-Anmeldung (OAuth)

Melden Sie sich direkt im Tool an, etwa mit einem 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 so an, wie es das Tool vorsieht.

OAuth-Tokens speichert und erneuert jede CLI selbst. Agent Switchboard liest diese Tokens nicht und kopiert sie nicht.

Mehrere Konten

Codex, Claude Code, Pi und Qwen Code können bei der Standardauthentifizierung mehrere Konten verwalten. Legen Sie in der Kontenliste des Tools ein Konto an, melden Sie sich an und wählen Sie dann global oder pro Projekt, welches Konto gilt. Bei Pi melden Sie sich im geöffneten Terminal mit /login an, bei Qwen Code mit /auth. Für API- und Gateway-Verbindungen gibt es keine Kontoauswahl.

Verbindung einem Tool zuweisen

Globaler Standard

  1. Klicken Sie in der linken Seitenleiste auf 전역 기본 (Globaler Standard). Alternativ erreichen Sie ihn auf der Projektstartseite über 전역 기본과 비교 (Mit globalem Standard vergleichen).
  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 angelegte Verbindung und suchen dann das Modell in der Liste aus. Mit dem Modell ändern sich auch der verfügbare Reasoning-Aufwand (Effort) und das Token-Limit.
  5. Prüfen Sie Adresse und Authentifizierung mit 연결 테스트 (Verbindungstest).
  6. Klicken Sie auf 저장 후 적용 (Speichern und anwenden), bei OpenCode auf 설정 적용 (Einstellungen anwenden).

Beim Verbindungstest und beim Anwenden prüft die App, ob sich das gewählte Modell tatsächlich nutzen lässt. Wenn nicht, bricht sie ab und sagt Ihnen Bescheid. Wählen Sie dann ein verfügbares Modell aus der Liste.

Jeder Projektordner für sich

Das ist der Kern von Agent Switchboard: Auf demselben PC kann jeder Ordner mit eigenem Agent, eigenem Modell, eigenem Provider und eigenem Schlüssel arbeiten.

  1. Wählen Sie in der linken Seitenleiste ein Projekt. Die Projektstartseite öffnet sich.
  2. Klicken Sie unter 도구 설정 (Tool-Einstellungen) auf eine Tool-Karte. Fehlt ein Tool, fügen Sie es über die Schaltfläche 도구 (Tools) hinzu – damit legen Sie fest, welche Tools in diesem Ordner angezeigt werden.
  3. Wählen Sie wie beim globalen Standard Verbindungsart, Verbindung, Modell und Reasoning-Aufwand.
  4. Nach dem Anwenden gelten diese Einstellungen nur für diesen Ordner.

Auf der Projektstartseite sehen Sie von oben nach unten 지금 (Jetzt: laufende, auf Eingabe wartende und fehlerhafte Sitzungen), die Tool-Einstellungen und 최근 세션 (Letzte Sitzungen). Die Tool-Karten zeigen Tool, Verbindung, Modell und Reasoning-Aufwand des Ordners auf einen Blick. Über „Mit globalem Standard vergleichen“ sehen Sie die globalen Werte direkt daneben.

Die Ordnereinstellungen schreibt die App je nach Tool in diese Dateien:

Tool Ort der Ordnereinstellungen
Codex Ordnereigenes Profil in $CODEX_HOME (wird beim Start automatisch gewählt)
Claude Code .claude/settings.local.json
Pi .pi/settings.json
OpenCode opencode.json
Qwen Code .qwen/settings.json

Cline CLI legt keine Projektkonfiguration an, sondern wird lediglich im gewählten Ordner gestartet. Tools ohne Projekteinstellungen tragen den Hinweis 프로젝트 설정 미지원 (Keine Projekteinstellungen) und verwenden die globalen Einstellungen des PCs.

Standardwerte für neue Switcher-Chats

Auch mit welchem Agent, Modell und Reasoning-Aufwand ein neuer Chat in Switcher startet, können Sie pro Ordner festlegen. Öffnen Sie dazu im Switcher-Menü des Projekts in der Seitenleiste die Einstellungen und klicken Sie auf 이 폴더에 저장 (In diesem Ordner speichern). Mit 전역 기본값 따르기 (Globalen Standard verwenden) löschen Sie die Ordnerwerte wieder. Bereits geöffnete Chats behalten ihre Engine, ihr Modell und ihren Reasoning-Aufwand.

Schnell über das Tray-Symbol wechseln

Ein Klick auf das Symbol im Infobereich der Taskleiste (unter macOS in der Menüleiste) öffnet das Schnellwechsel-Panel. So wechseln Sie die Verbindung, ohne das Hauptfenster zu öffnen.

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

Auch beim Schnellwechsel sichert, testet und prüft die App genau wie im Hauptfenster.

So schützt die App Ihre Konfigurationsdateien

  • Vor der ersten Änderung sichert die App das Original, danach legt sie bei jeder Änderung eine weitere Sicherung (Revision) an.
  • Sie ändert nur die Einträge, die Agent Switchboard verwaltet. Alle übrigen Einstellungen bleiben unangetastet.
  • Nach dem Anwenden liest die App die geschriebenen Dateien erneut ein. Schlägt diese Prüfung fehl, macht sie die eben vorgenommenen Änderungen rückgängig.
  • Mit 최초 설정 복원 (Ursprüngliche Einstellungen wiederherstellen) kehren die Dateien zu dem Stand zurück, bevor Agent Switchboard sie zum ersten Mal geändert hat.
  • Bevor ein gespeicherter Schlüssel gelöscht wird, stellt die App alle verwalteten Verbindungen, die ihn nutzen, auf die Standardauthentifizierung des Tools um.

Wie geht es weiter?