ガイド文書
Switcher とは
Switcher を使うと、ターミナルの代わりに会話画面でコーディングエージェントと作業できます。エージェントの計画やツールの実行、変更されたファイル、承認リクエスト、使用量が会話の中にまとめて表示されるので、いま何が起きているのかを追いやすくなります。
Switcher の会話で使えるエンジンは、Claude Code、Codex、Antigravity(agy)、OpenCode、GitHub Copilot CLI です。このうち Claude Code・Codex・Antigravity には 추천(おすすめ)の表示が付きます。巻き戻し、目標、添付、応答中の入力といった機能は、エンジンによって対応状況が異なります。対応していない機能には、その理由が表示されます。
新しい会話を始める
- 左側のレールで、プロジェクトの行の
⋯メニューを開きます。 - 새 세션(新しいセッション)でツールを選びます。
- Switcher に対応したツールには、CLI セッションと Switcher セッションが別々に用意されています。Switcher を選ぶと、そのツールをエンジンにして、このプロジェクトで新しい会話が開きます。
新しい会話はフォルダーの既定値で始まり、フォルダーに値がなければグローバル既定値を使います。既定値の決め方は、接続・プロジェクト別設定の「Switcher で新しい会話を開くときの既定値」をご覧ください。
会話の中で使える機能
モデルと推論強度を変える
モデルと推論強度(Effort)は、入力欄の上で選びます。モデルは一覧から検索しても、ID を直接入力してもかまいません。変更した値は次のメッセージから適用されます。応答や承認を処理している間は変更できません。
推論強度は、選んだモデルと実行ツールが対応していると確認できた範囲でのみ選べます。対応しているか確認できなかった場合は、ツールの既定値で送信し、その旨をお知らせします。
実行ツールを変える
会話を続けたまま、実行ツールだけを別のツールに変えられます。セッションと関係はそのまま残り、必要に応じて元のツールの圧縮と作業の要約でコンテキストを引き継ぎます。切り替えに失敗した場合や、コンテキストを引き継ぐ余裕が足りない場合は、既存のセッションには手を付けません。
スマートフォンでは、대화 모델 바꾸기(会話のモデルを変更)で、プロバイダー → ツール → モデルの順に選びます。選んだプロバイダーはこの会話にだけ適用され、プロジェクト設定は変わりません。
コマンドメニュー
会話中に Ctrl+/ を押すと、コマンドメニューが開きます。/help、/new、/stop、/model、/status、/search、/copy、/export、/retry、/clear が使え、いま実行できないコマンドにはその理由も表示されます。
会話情報
ヘッダーの 대화 정보(会話情報)を開くと、環境、コンテキストの使用量、ブランチ、ToDo、変更されたファイルと diff、サブエージェント、バックグラウンドタスクを 1 か所で確認できます。
会話を続ける
アプリを開き直すと、Switcher の会話一覧と画面の配置が元どおりになります。続けたい会話で 재연결(再接続)を押せば、会話の続きから再開できます。一覧を読み込むだけなら、CLI は起動しません。
AI コードレビュー
コミットする前に、Switcher の ⋯ その他 → AI 코드리뷰(AI コードレビュー)で変更内容をレビューしてもらえます。API キーを保存した接続とモデルを選び、리뷰 실행(レビューを実行)を押したときに初めて、変更内容がその接続に送られます。画面を開いたり更新したりするだけでは、モデルは呼び出しません。
音声会話
환경 설정 › 음성 대화(環境設定 › 音声会話)をオンにして OpenAI API の接続を選ぶと、Switcher のヘッダーの 음성 대화(音声会話)から、いまのセッションと声でやり取りできます。この機能は最初はオフです。音声はユーザーの OpenAI API キーで OpenAI に直接送られ、料金もそのキーに請求されます。作業の停止と承認は、画面でもう一度確認してから実行されます。
オーケストレーション
オーケストレーションを使うと、ひとつの Switcher の会話が指揮セッション(coordinator)になり、ほかのセッションを作業セッション(worker)として作って仕事を任せます。大きな作業を複数のセッションに分けて任せ、1 か所でまとめて見届けられます。作業セッションは結果を報告したり、指揮セッションに質問したりできます。
指揮セッションを指定する
- 指揮を任せたい Switcher の会話を開きます。
- 오케스트레이션 세션으로 지정(オーケストレーションセッションに指定)を押します。
- 오케스트레이션 권한 선택(オーケストレーション権限の選択)で方式を選びます。
- 사용자 승인 후 위임(ユーザーの承認後に委任): 作業セッションを作ったり指示を送ったりする前に、ユーザーが確認します。
- 전체 자율 위임 승인(完全自律委任を承認): 明示的に委任した入力は、個別の承認なしで渡します。
権限の選択や承認・取り消しは、ユーザーの画面からしか行えません。エンジン本来の承認ルールと作業フォルダーの制限はそのまま適用され、ポリシーはこの PC に暗号化して保存します。
作業セッションと業務
- 指揮セッションは、登録済みのプロジェクトに作業セッションを新しく作るか、過去のセッションを作業セッションとして開き直します。作るときに、モデルと推論強度も決められます。
- 新しい作業セッションはレールのプロジェクトの下に 1 行で表示され、いま見ている画面をさえぎらないよう、バックグラウンドの Switcher タブで開きます。
- 作業セッションが処理中に送った指示や回答はキューに入れておき、順番に渡します。
- 指揮セッションはユーザーの依頼を 지휘 할 일(指揮の ToDo)として記録し、作業セッションの業務と結び付けます。作業セッションが報告した進捗率と、指揮セッションが結果を確認した完了は、分けて表示されます。
ダッシュボードと関係図
指揮セッションで 오케스트레이션 대시보드(オーケストレーションダッシュボード)を開くと、指揮・チームリーダー・作業セッションの関係図、業務と依頼の状態、決定の記録が表示されます。依頼の状態は「승인 대기」(承認待ち)、「전달 중」(依頼中)、「입력 접수 · 완료 미확인」(入力受付・完了未確認)、「실행 여부 불명」(実行状況不明)、「완료」(完了)のように、実際に確認できた段階までしか表示しません。実行されたかどうかわからない依頼を、自動で送り直すことはありません。
オーケストレーションダッシュボードと ToDo は、PWA・Android アプリからも確認・操作できます。
チームリーダー権限
指揮セッションは、直下の作業セッションにチームリーダー権限を与えられます。チームリーダーは、指定されたプロジェクトと同時実行数の上限の範囲で、自分の配下の作業セッションを管理します。権限を取り消しても、配下のセッションの会話と実行はそのまま残ります。
ほかの PC に任せる
レールの 내 컴퓨터(マイコンピューター)でつないでおいた同じアカウントのほかの PC にも、作業セッションを作れます。その場合は、受け取る側の PC でもオーケストレーション権限を決めておく必要があります。
- 受け取る側の PC が 위임마다 승인(委任ごとに承認)なら、その PC で承認されてから実行されます。期限内に応答がなければ拒否されます。
- 受け取る側の PC が 자율 위임(自律委任)なら、すぐに実行されます。
同じ依頼は 1 回しか実行しません。途中で応答を受け取り損ねても、その PC の記録と照らし合わせて、届いたかどうかを確かめます。ほかの PC も、同じかそれ以降のバージョンである必要があります。
整理のルール
- 종료(終了)で止まるのは、Switchboard が起動したプロセスだけです。会話・再開情報・関係は残ります。
- 待機中の作業セッションは、既定では 15 分たつとプロセスを終了します。結果を報告して自動終了した作業セッションは、既定では 60 分後にアーカイブへ移します。
- 承認・質問・確認を待っている業務は、自動では整理しません。
- 탭 닫기(タブを閉じる)では、セッションは終了しません。アーカイブに移したセッションも、復元すれば続きから再開できます。
監督方式(ユーザーの承認後に委任)では、こうした整理にもユーザーの承認が必要です。