Switcher와 오케스트레이션 — 가이드

Switcher란

Switcher는 코딩 에이전트와 터미널 대신 대화 화면으로 일하는 방식입니다. 계획, 도구 실행, 변경 파일, 승인 요청, 사용량을 대화 안에서 함께 봅니다.

Switcher 대화를 열 수 있는 엔진은 Claude Code, Codex, Antigravity(agy), OpenCode, GitHub Copilot CLI입니다. Claude Code·Codex·Antigravity에는 추천 표시가 붙습니다. 엔진마다 지원하는 기능(되돌리기, 목표, 첨부, 응답 중 입력 등)이 다르며, 지원하지 않는 기능은 이유를 표시합니다.

새 대화 시작하기

왼쪽 레일에서 프로젝트 줄의 ⋯ 메뉴를 엽니다.
새 세션에서 도구를 고릅니다.
지원하는 도구에는 CLI 세션과 Switcher 세션이 따로 있습니다. Switcher를 고르면 그 도구 엔진으로 이 프로젝트에 새 대화를 만듭니다.

새 대화는 폴더의 기본값으로 시작합니다. 폴더 값이 없으면 전역 기본값을 씁니다. 기본값은 연결·프로젝트별 설정의 「Switcher 새 대화 기본값」에서 정합니다.

대화 안에서 쓰는 기능

모델과 추론 강도 바꾸기

입력창 위에서 모델과 추론 강도(effort)를 고릅니다. 모델 목록은 검색하거나 ID를 직접 입력할 수 있습니다. 바꾼 값은 다음 메시지부터 적용됩니다. 응답이나 승인을 처리하는 동안에는 바꿀 수 없습니다.

추론 강도는 고른 모델과 실행 도구가 지원한다고 확인한 범위에서만 고를 수 있습니다. 지원이 확인되지 않으면 도구 기본값으로 보내고 안내를 남깁니다.

실행 도구 바꾸기

같은 대화의 실행 도구를 다른 도구로 바꿀 수 있습니다. 세션과 관계는 유지하며, 필요하면 원래 도구의 압축과 작업 요약으로 문맥을 넘깁니다. 전환에 실패하거나 넘길 공간이 부족하면 기존 세션을 그대로 둡니다.

휴대폰의 대화 모델 바꾸기에서는 프로바이더 → 도구 → 모델 순서로 고릅니다. 고른 프로바이더는 이 대화에만 적용되고 프로젝트 설정은 바뀌지 않습니다.

명령 메뉴

대화에서 Ctrl+/로 명령 메뉴를 엽니다. /help, /new, /stop, /model, /status, /search, /copy, /export, /retry, /clear를 실행할 수 있습니다. 지금 실행할 수 없는 명령은 이유를 함께 보여 줍니다.

대화 정보

머리줄의 대화 정보를 열면 환경, 컨텍스트 사용량, 브랜치, 할 일, 변경 파일과 diff, 서브 에이전트, 백그라운드 작업을 한곳에서 봅니다.

대화 이어 가기

앱을 다시 열면 Switcher 대화 목록과 작업 배치가 복원됩니다. 이어 갈 대화에서 재연결을 누르면 같은 대화를 계속합니다. 목록을 읽는 것만으로는 CLI를 실행하지 않습니다.

AI 코드리뷰

Switcher의 ⋯ 더보기 → AI 코드리뷰에서 커밋 전 변경을 검토합니다. API 키가 저장된 연결과 모델을 고르고 리뷰 실행을 눌러야 변경 내용이 그 연결로 전송됩니다. 화면을 열거나 새로 고치는 것만으로는 모델을 호출하지 않습니다.

음성 대화

환경 설정 › 음성 대화를 켜고 OpenAI API 연결을 고르면, Switcher 머리줄의 음성 대화로 지금 세션과 말로 주고받습니다. 기본으로 꺼져 있습니다. 음성은 사용자의 OpenAI API 키로 OpenAI에 직접 전송되고 그 키로 과금됩니다. 작업 멈추기와 승인은 화면에서 확인해야 실행됩니다.

오케스트레이션

오케스트레이션은 한 Switcher 대화(지휘 세션)가 다른 세션(worker)을 만들고 일을 맡기는 기능입니다. worker는 결과를 보고하거나 지휘 세션에 질문할 수 있습니다.

지휘 세션 지정하기

지휘를 맡길 Switcher 대화를 엽니다.
오케스트레이션 세션으로 지정을 누릅니다.
오케스트레이션 권한 선택에서 방식을 고릅니다.
- 사용자 승인 후 위임: worker 생성·지시 같은 위임을 실행 전에 사용자가 확인합니다.
- 전체 자율 위임 승인: 명시적으로 위임한 입력을 추가 승인 없이 전달합니다.

권한 선택·승인·철회는 사용자 화면에서만 할 수 있습니다. 기존 엔진의 승인 규칙과 작업 폴더 제한은 그대로 유지됩니다. 정책은 이 PC에 암호화해 저장합니다.

worker와 업무

지휘 세션은 등록된 프로젝트에 worker를 만들거나 지난 세션을 worker로 재개합니다. 만들 때 모델과 추론 강도를 정할 수 있습니다.
만든 worker는 레일의 프로젝트 아래에 한 줄로 나타나고, 포커스를 빼앗지 않는 백그라운드 Switcher 탭으로 열립니다.
worker가 바쁘면 보낸 지시와 답변은 대기열에 보관했다가 순서대로 전달합니다.
지휘 세션은 사용자 요청을 지휘 할 일로 기록하고 worker 업무와 연결합니다. worker가 보고한 진행률과, 지휘가 결과를 확인한 완료는 따로 표시합니다.

대시보드와 관계도

지휘 세션에서 오케스트레이션 대시보드를 열면 지휘·팀장·worker 관계도, 업무와 전달 상태, 결정 기록을 봅니다. 전달 상태는 「승인 대기」, 「전달 중」, 「입력 접수 · 완료 미확인」, 「실행 여부 불명」, 「완료」처럼 실제로 확인한 단계까지만 표시합니다. 실행 여부를 모르는 요청은 자동으로 다시 보내지 않습니다.

PWA·Android 앱에서도 오케스트레이션 대시보드와 할 일을 확인하고 조작할 수 있습니다.

팀장 권한

지휘 세션은 직속 worker에게 팀장 권한을 줄 수 있습니다. 팀장은 지정된 프로젝트와 동시 실행 상한 안에서 자기 하위 worker를 관리합니다. 권한을 회수해도 하위 대화와 실행은 유지됩니다.

다른 PC에 맡기기

레일 내 컴퓨터로 연결해 둔 같은 계정의 다른 PC에도 worker를 만들 수 있습니다. 받는 PC도 오케스트레이션 권한을 정해야 합니다.

받는 PC가 위임마다 승인이면 그 PC에서 승인해야 실행합니다. 기한까지 응답하지 않으면 거절됩니다.
받는 PC가 자율 위임이면 바로 실행합니다.

같은 요청은 한 번만 실행합니다. 응답을 잃어도 그 PC의 기록으로 도착 여부를 맞춥니다. 다른 PC도 같은 버전 이상이어야 합니다.

정리 규칙

종료는 Switchboard가 띄운 프로세스만 멈추고 대화·재개 정보·관계는 남깁니다.
유휴 worker는 기본 15분 뒤 프로세스를 종료합니다. 결과를 보고하고 자동 종료된 worker는 기본 60분 뒤 보관함으로 옮깁니다.
승인·질문·확인을 기다리는 업무는 자동 정리에서 제외합니다.
탭 닫기는 세션을 끝내지 않습니다. 보관함에서 복원하면 다시 재개할 수 있습니다.

감독 방식(사용자 승인 후 위임)에서는 이런 정리도 사용자 승인을 거칩니다.