Agent Switchboard
ダウンロード

言語

選んだ言語は Cookie に保存します。

テーマ
ガイド文書

接続・プロジェクト別設定

基本の考え方

Agent Switchboard では、次の 3 つを分けて扱います。

  • 接続: ゲートウェイや provider のアドレスと API キーです。환경 설정 › 연결 · 인증(環境設定 › 接続・認証)に一度登録しておけば、複数のツールで選んで使えます。同じ接続を選んだツール同士はキーを共有します。
  • ツール: Codex、Claude Code、Pi などのコーディングエージェント CLI です。ツールごとに、接続方式(API / 게이트웨이(API / ゲートウェイ)または OAuth / 기본 인증(OAuth / 標準認証))、モデル、推論強度を決めます。
  • 範囲: 전역 기본(グローバル既定)は、登録したすべてのフォルダーが従う値です。フォルダーで個別に保存すると、そのフォルダーにだけ適用される値ができます。

フォルダーに個別の値がなければ、グローバル既定をそのまま使います。フォルダーで初めて保存すると、その時点の値を出発点にして、そのフォルダー専用の設定ができます。フォルダーで決めた provider、認証、モデル、推論の設定は、グローバルより優先されます。

対応している接続

ツール OAuth / 標準認証 API およびゲートウェイ
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 認証、Claude Code・Codex・Kimi Code CLI 認証 OpenAI 互換 Chat, Anthropic Messages, provider カタログ
Qwen Code Qwen Code CLI 認証 OpenAI Chat, Anthropic Messages, provider カタログ
Cline CLI ChatGPT OAuth、Cline 認証 プロトコル別の組み込み provider

Droid、Crush、Kimi Code も接続まで管理します。Antigravity(agy)、Copilot CLI、Cursor CLI、Amp、Goose、Aider、Kilo CLI、Grok Build、Gemini CLI については、インストールの確認と起動だけを受け持ち、設定と認証は各ツールが自分で管理します。

接続を登録する

API キー・ゲートウェイ

  1. サイドバー下部の 환경 설정(環境設定)を開き、연결 · 인증(接続・認証)に進みます。
  2. 연결 추가(接続を追加)を押します。
  3. provider カタログからサービスを選ぶか、ゲートウェイのアドレスを入力します。API キーを入れて保存します。

リモートのアドレスには HTTPS しか使えません。HTTP が使えるのは、同じ PC(loopback)のアドレスだけです。

キーは OS のセキュアストレージ(Windows DPAPI、macOS Keychain、Linux Secret Service)に、接続ごとに暗号化して保管します。一度保存したキーは、画面に再表示しません。Codex、Claude Code、Pi の設定ファイルには、キーの代わりに Agent Switchboard の credential helper コマンドだけを書き込みます。ツールを起動すると、helper がセキュアストレージからキーを取り出して渡します。

接続を登録しただけでは、ツールにはまだ適用されません。下の「ツールに適用する」の手順で適用してください。

サブスクリプションのログイン(OAuth)

ChatGPT や Claude のサブスクリプションのように、ツールに直接ログインして使う場合は API キーは不要です。

  1. ツールの設定画面で OAuth / 標準認証 を選びます。
  2. 기본 인증 적용(標準認証を適用)を押します。
  3. ツールのログイン手順に沿ってログインします。

OAuth トークンは、各 CLI が自分のストレージで保管・更新します。Agent Switchboard がトークンを読み取ったりコピーしたりすることはありません。

複数のアカウントを使い分ける

Codex・Claude Code・Pi・Qwen Code では、標準認証に複数のアカウントを登録できます。ツールのアカウント一覧でアカウントを作ってログインしたあと、グローバルまたはプロジェクトごとに使うアカウントを選びます。Pi は開いたターミナルで /login、Qwen Code は /auth でログインします。API・ゲートウェイの接続には、アカウントの選択は適用されません。

ツールに適用する

グローバル既定

  1. 左側のレールの グローバル既定 を押します。プロジェクトホームの 전역 기본과 비교(グローバル既定と比較)からも開けます。
  2. ツールのカードを押して、設定画面を開きます。
  3. API / ゲートウェイ または OAuth / 標準認証 を選びます。
  4. API 接続なら、登録しておいた接続を選び、検索できる一覧からモデルを選びます。モデルを変えると、そのモデルが対応する推論強度(Effort)とトークン上限も一緒に切り替わります。
  5. 연결 테스트(接続テスト)で、アドレスと認証を確認します。
  6. 저장 후 적용(保存して適用)を押します。OpenCode では 설정 적용(設定を適用)を押します。

接続テストと適用の段階で、選んだモデルが実際に使えるかを確認します。使えないモデルの場合は適用を止めてお知らせします。そのときは、一覧から使えるモデルを選び直してください。

プロジェクトフォルダーごとに変える

Agent Switchboard でいちばん大事な機能です。同じ PC でも、フォルダーごとにエージェント、モデル、provider、キーを変えられます。

  1. 左側のレールでプロジェクトを選ぶと、プロジェクトホームが開きます。
  2. 도구 설정(ツール設定)でツールのカードを押します。一覧にないツールは、도구(ツール)ボタン(このフォルダーに表示するツールを追加)で加えます。
  3. グローバル既定と同じ手順で、接続方式・接続・モデル・推論強度を選びます。
  4. 適用すると、このフォルダーだけの設定になります。

プロジェクトホームには、上から 지금(いま。実行中・入力待ち・エラーのセッション)、ツール設定、최근 세션(最近のセッション)が並びます。ツールのカードを見れば、そのフォルダーのツール・接続・モデル・推論強度がひと目でわかります。グローバル既定と比較 を押すと、グローバルの値と並べて見られます。

フォルダー専用の設定は、ツールごとに次のファイルに書き込まれます。

ツール フォルダー設定の場所
Codex $CODEX_HOME のフォルダー専用プロファイル(起動時に自動で選択)
Claude Code .claude/settings.local.json
Pi .pi/settings.json
OpenCode opencode.json
Qwen Code .qwen/settings.json

Cline CLI はプロジェクトの設定ファイルを作らず、選んだフォルダーで起動するだけです。プロジェクト設定がないツールには 프로젝트 설정 미지원(プロジェクト設定非対応)と表示され、PC のグローバル設定が使われます。

Switcher で新しい会話を開くときの既定値

Switcher で新しい会話を開くときのエージェント・モデル・推論強度も、フォルダーごとに決めておけます。レールのプロジェクトの Switcher メニュー › 設定で、이 폴더에 저장(このフォルダーに保存)を押してください。전역 기본값 따르기(グローバル既定値に従う)を押すと、フォルダーの値が消えて、ふたたびグローバル既定に従います。すでに開いている会話は、元のエンジン・モデル・推論強度のまま使われます。

トレイからすばやく切り替える

トレイ(macOS ではメニューバー)のアイコンを押すと、クイック切り替えパネルが開きます。メインウィンドウを開かずに接続を切り替えられます。

  1. ツールを選び、API · 게이트웨이(API・ゲートウェイ)または OAuth · 기본 인증(OAuth・標準認証)を選びます。
  2. プロバイダーを選ぶと、保存済みの接続でモデル一覧を読み込みます。
  3. モデルを選び、이 공급자로 전환(このプロバイダーに切り替え)を押します。

クイック切り替えでも、メインウィンドウと同じようにバックアップ、接続テスト、結果の検証を行います。

設定ファイルの保護

  • 最初に設定を変えるときに元のファイルをバックアップし、その後も変更のたびに revision のバックアップを残します。
  • Agent Switchboard が管理する項目だけを変え、それ以外のユーザー設定には手を付けません。
  • 適用後は、書き込んだファイルを読み直して確認します。確認に失敗した場合は、今回の変更を元の状態に戻します。
  • 최초 설정 복원(初期設定を復元)を押すと、Agent Switchboard が最初に手を加える前のファイルに戻ります。
  • 保存したキーを削除するときは、そのキーを使っていた管理対象の接続を、先にツールの標準認証に戻します。

次のステップ