ガイド文書
基本の考え方
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 キー・ゲートウェイ
- サイドバー下部の 환경 설정(環境設定)を開き、연결 · 인증(接続・認証)に進みます。
- 연결 추가(接続を追加)を押します。
- 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 キーは不要です。
- ツールの設定画面で
OAuth / 標準認証を選びます。 - 기본 인증 적용(標準認証を適用)を押します。
- ツールのログイン手順に沿ってログインします。
OAuth トークンは、各 CLI が自分のストレージで保管・更新します。Agent Switchboard がトークンを読み取ったりコピーしたりすることはありません。
複数のアカウントを使い分ける
Codex・Claude Code・Pi・Qwen Code では、標準認証に複数のアカウントを登録できます。ツールのアカウント一覧でアカウントを作ってログインしたあと、グローバルまたはプロジェクトごとに使うアカウントを選びます。Pi は開いたターミナルで /login、Qwen Code は /auth でログインします。API・ゲートウェイの接続には、アカウントの選択は適用されません。
ツールに適用する
グローバル既定
- 左側のレールの グローバル既定 を押します。プロジェクトホームの 전역 기본과 비교(グローバル既定と比較)からも開けます。
- ツールのカードを押して、設定画面を開きます。
API / ゲートウェイまたはOAuth / 標準認証を選びます。- API 接続なら、登録しておいた接続を選び、検索できる一覧からモデルを選びます。モデルを変えると、そのモデルが対応する推論強度(Effort)とトークン上限も一緒に切り替わります。
- 연결 테스트(接続テスト)で、アドレスと認証を確認します。
- 저장 후 적용(保存して適用)を押します。OpenCode では 설정 적용(設定を適用)を押します。
接続テストと適用の段階で、選んだモデルが実際に使えるかを確認します。使えないモデルの場合は適用を止めてお知らせします。そのときは、一覧から使えるモデルを選び直してください。
プロジェクトフォルダーごとに変える
Agent Switchboard でいちばん大事な機能です。同じ PC でも、フォルダーごとにエージェント、モデル、provider、キーを変えられます。
- 左側のレールでプロジェクトを選ぶと、プロジェクトホームが開きます。
- 도구 설정(ツール設定)でツールのカードを押します。一覧にないツールは、도구(ツール)ボタン(このフォルダーに表示するツールを追加)で加えます。
- グローバル既定と同じ手順で、接続方式・接続・モデル・推論強度を選びます。
- 適用すると、このフォルダーだけの設定になります。
プロジェクトホームには、上から 지금(いま。実行中・入力待ち・エラーのセッション)、ツール設定、최근 세션(最近のセッション)が並びます。ツールのカードを見れば、そのフォルダーのツール・接続・モデル・推論強度がひと目でわかります。グローバル既定と比較 を押すと、グローバルの値と並べて見られます。
フォルダー専用の設定は、ツールごとに次のファイルに書き込まれます。
| ツール | フォルダー設定の場所 |
|---|---|
| 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 ではメニューバー)のアイコンを押すと、クイック切り替えパネルが開きます。メインウィンドウを開かずに接続を切り替えられます。
- ツールを選び、
API · 게이트웨이(API・ゲートウェイ)またはOAuth · 기본 인증(OAuth・標準認証)を選びます。 - プロバイダーを選ぶと、保存済みの接続でモデル一覧を読み込みます。
- モデルを選び、이 공급자로 전환(このプロバイダーに切り替え)を押します。
クイック切り替えでも、メインウィンドウと同じようにバックアップ、接続テスト、結果の検証を行います。
設定ファイルの保護
- 最初に設定を変えるときに元のファイルをバックアップし、その後も変更のたびに revision のバックアップを残します。
- Agent Switchboard が管理する項目だけを変え、それ以外のユーザー設定には手を付けません。
- 適用後は、書き込んだファイルを読み直して確認します。確認に失敗した場合は、今回の変更を元の状態に戻します。
- 최초 설정 복원(初期設定を復元)を押すと、Agent Switchboard が最初に手を加える前のファイルに戻ります。
- 保存したキーを削除するときは、そのキーを使っていた管理対象の接続を、先にツールの標準認証に戻します。
次のステップ
- スマートフォンで続けるには、スマートフォン連携をご覧ください。
- 会話画面で作業したり、複数のセッションに仕事を割り振ったりするには、Switcher とオーケストレーションをご覧ください。