Agent Switchboard
Download

Language

We remember your language choice in a cookie.

Theme
Guides

Connections and per-project settings

Key concepts

Agent Switchboard keeps three things apart.

  • Connection: A gateway or provider address plus its API key. Add it once under 환경 설정 › 연결 · 인증 (Settings › Connections · Authentication) and any tool can use it. Tools that pick the same connection share its key.
  • Tool: A coding agent CLI such as Codex, Claude Code, or Pi. Each tool gets its own connection method (API / 게이트웨이 (API / Gateway) or OAuth / 기본 인증 (OAuth / Default sign-in)), model, and reasoning effort.
  • Scope: The 전역 기본 (Global default) applies to every folder you've added. Save settings in a folder and you get values that apply to that folder only.

A folder with no settings of its own uses the global default. The first time you save in a folder, the current values become the starting point for that folder's settings. From then on, the folder's provider, authentication, model, and reasoning settings win over the global ones.

Supported connections

Tool OAuth / Default sign-in API and gateways
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 OpenCode provider auth; Claude Code, Codex, and Kimi Code CLI auth OpenAI-compatible Chat, Anthropic Messages, provider catalog
Qwen Code Qwen Code CLI auth OpenAI Chat, Anthropic Messages, provider catalog
Cline CLI ChatGPT OAuth, Cline auth Built-in providers for each protocol

Droid, Crush, and Kimi Code get connection management too. For Antigravity (agy), Copilot CLI, Cursor CLI, Amp, Goose, Aider, Kilo CLI, Grok Build, and Gemini CLI, the app only checks that they're installed and launches them. Those tools handle their own settings and sign-in.

Adding a connection

API keys and gateways

  1. Open 환경 설정 (Settings) at the bottom of the sidebar and go to 연결 · 인증 (Connections · Authentication).
  2. Click 연결 추가 (Add connection).
  3. Pick a service from the provider catalog or enter a gateway address, paste in the API key, and save.

Remote addresses must use HTTPS. Plain HTTP is allowed only for addresses on the same PC (loopback).

Each connection's key is encrypted in your OS's secure storage (Windows DPAPI, macOS Keychain, Linux Secret Service), and once saved it's never shown on screen again. Codex, Claude Code, and Pi settings files get Agent Switchboard's credential helper command instead of the key. When a tool runs, the helper fetches the key from secure storage and hands it over.

Adding a connection doesn't apply it to any tool yet. Follow the steps under "Applying settings to tools" below.

Subscription login (OAuth)

If you sign in to a tool directly, for example with a ChatGPT or Claude subscription, you don't need an API key.

  1. On the tool settings screen, choose OAuth / 기본 인증 (OAuth / Default sign-in).
  2. Click 기본 인증 적용 (Apply default sign-in).
  3. Sign in through the tool's own login flow.

Each CLI stores and refreshes its OAuth tokens itself. Agent Switchboard never reads or copies them.

Using multiple accounts

Codex, Claude Code, Pi, and Qwen Code support several accounts for default sign-in. Create an account in the tool's account list, sign in, then choose which account to use globally or per project. For Pi, sign in with /login in an open terminal; for Qwen Code, use /auth. Account selection doesn't apply to API and gateway connections.

Applying settings to tools

Global default

  1. Click 전역 기본 (Global default) in the left rail. You can also get there with 전역 기본과 비교 (Compare with global default) on a project home.
  2. Click a tool card to open its settings.
  3. Choose API / 게이트웨이 (API / Gateway) or OAuth / 기본 인증 (OAuth / Default sign-in).
  4. For an API connection, pick one of your saved connections, then pick a model from the searchable list. Changing the model also updates the reasoning effort levels and token limits to match what that model supports.
  5. Click 연결 테스트 (Test connection) to check the address and authentication.
  6. Click 저장 후 적용 (Save and apply). For OpenCode, click 설정 적용 (Apply settings).

Both the connection test and the apply step check that the model you picked actually works. If it doesn't, the app stops and tells you. Pick a model that's available from the list and try again.

Different settings for each project folder

This is what Agent Switchboard is built around. On the same PC, each folder can use a different agent, model, provider, and key.

  1. Pick a project in the left rail to open its project home.
  2. In 도구 설정 (Tool settings), click a tool card. To add a tool that isn't listed, use the 도구 (Tools) button, which adds a tool to show for this folder.
  3. Choose the connection method, connection, model, and reasoning effort the same way you would for the global default.
  4. Apply, and those settings now belong to this folder only.

The project home shows, from top to bottom, 지금 (Now: sessions that are running, waiting for input, or failed), Tool settings, and 최근 세션 (Recent sessions). The tool cards tell you the folder's tool, connection, model, and reasoning effort at a glance. Click Compare with global default to see them next to the global values.

Folder settings are written to these files for each tool.

Tool Where folder settings go
Codex A folder-specific profile in $CODEX_HOME (picked automatically at launch)
Claude Code .claude/settings.local.json
Pi .pi/settings.json
OpenCode opencode.json
Qwen Code .qwen/settings.json

Cline CLI doesn't create a project settings file; it just runs in the folder you pick. Tools without project settings are labeled 프로젝트 설정 미지원 (Project settings not supported) and use the PC-wide settings.

Defaults for new Switcher chats

You can also set, per folder, which agent, model, and reasoning effort a new Switcher chat starts with. In the rail, open the project's Switcher menu › settings and click 이 폴더에 저장 (Save to this folder). Click 전역 기본값 따르기 (Follow global default) to clear the folder value and go back to the global default. Chats that are already open keep their original engine, model, and reasoning effort.

Quick switching from the tray

Click the tray icon (the menu bar icon on macOS) to open the quick switch panel. You can change connections without opening the main window.

  1. Pick a tool, then choose API · 게이트웨이 (API · Gateway) or OAuth · 기본 인증 (OAuth · Default sign-in).
  2. Pick a provider, and the model list loads using your saved connection.
  3. Pick a model and click 이 공급자로 전환 (Switch to this provider).

Quick switching backs up, tests the connection, and verifies the result exactly like the main window does.

How your settings files are protected

  • The original file is backed up before the first change, and every change after that leaves a revision backup.
  • Agent Switchboard changes only the fields it manages and leaves the rest of your settings alone.
  • After applying, the app reads the written files back to verify them. If verification fails, that change is rolled back.
  • 최초 설정 복원 (Restore original settings) puts files back the way they were before Agent Switchboard first touched them.
  • Before a saved key is deleted, any managed connection using it is switched back to the tool's default sign-in.

Next steps