첫 멀티 에이전트 세션

st가 실행 중인 장치에서 시작해, Claude Code 하나가 워커 둘에게 일을 맡기고, 끝나기를 지켜보고, 보고를 읽기까지 따라 해 봅니다.

Claude Code 하나가 코디네이터가 됩니다. 일의 두 부분을 워커 둘에게 맡기는데, 워커는 저마다 실제 동작하는 에이전트이고, 각자의 tmux 창에서 실행됩니다. 코디네이터는 워커들을 기다렸다가 한 일을 확인하고 알려 줍니다. 처음에는 10분쯤 걸립니다.

Claude Code에게 프로젝트의 테스트는 한 워커에게, README는 다른 워커에게 맡기라고 한 번 부탁합니다. Claude Code는 st worker로 둘을 각자의 창에 띄우고, 끝나기를 기다렸다가 결과를 확인해 보고합니다. 웹 터미널 화면이고 2배속입니다.

준비할 것

  • st 0.3.67 이상이 실행 중인 장치가 있어야 합니다(설치한 뒤 st를 실행합니다). 버전은 st version으로 봅니다.
  • 그 장치에 Claude Code가 설치돼 있고 로그인돼 있어야 합니다. Codex 워커도 쓰려면 Codex도 필요합니다.
  • 지켜볼 화면이 필요합니다. 데스크탑 앱, 폰 앱, st가 출력한 브라우저 링크 가운데 무엇이든 됩니다.

1. 훅과 스킬 설치

st hooks install      # st가 에이전트의 턴을 봅니다. 워커가 시작했는지도 이것으로 확인합니다
st plugin install     # Claude Code 플러그인과 Codex 스킬

Claude Code에는 /sophonz:orchestrate가, Codex에는 sophonz-orchestrate와 sophonz-worker 스킬이 생깁니다. 설치 뒤에 시작한 세션부터 적용되므로, 이미 실행 중이던 Claude Code는 끄고 다시 엽니다.

2. 공유 중인 세션에서 Claude Code 열기

데스크탑 앱에서 그 장치의 세션을 열거나, 장치의 터미널에서 st attach를 실행합니다. 프로젝트 폴더로 가서 Claude Code를 시작합니다.

cd ~/src/my-project
claude

st가 공유하는 tmux 세션의 pane이어야 합니다. 워커의 창이 그 세션에 열리기 때문입니다. Claude Code가 폴더를 신뢰할지 물으면 지금 답해 둡니다. 워커도 같은 폴더에서 시작하는데, 거기서 신뢰 화면이 뜨면 워커가 멈춥니다.

3. 부탁하기

/sophonz:orchestrate 테스트는 한 워커에게, README 정리는 다른 워커에게 맡기고
둘 다 결과를 확인해서 알려 줘.

어느 에이전트에게 맡길지 정하고 싶으면 "테스트는 Codex에게, README는 다른 Claude에게"처럼 이름을 대면 됩니다. 코디네이터는 워커마다 할 일을 적고 st worker start를 실행합니다. 그러면 창이 열리고, 에이전트가 시작되고, 할 일이 입력됩니다. st worker 명령을 직접 칠 일은 없습니다.

4. 워커가 나타나는 것 보기

워커마다 같은 세션에 창이 하나씩 생기고, 맡은 일에 맞는 이름이 붙습니다. 창을 열면 다른 창과 똑같이 에이전트가 일하는 모습이 보입니다.

  • 데스크탑 앱. 사이드바에서 코디네이터의 창 아래에 워커 · 작업 중 2 머리 줄이 처음부터 펼쳐져 있고, 그 아래에 워커의 창이 나옵니다. 끝난 워커는 끝난 워커 N명 아래로 모입니다. pane 머리의 ◇ Agents(⇧⌘G)를 누르면 에이전트 그래프가 열립니다. 코디네이터에서 워커마다 초록 선이 이어지고, 끝난 카드에는 요약이 붙습니다.
  • 폰 앱. 세션의 창 목록에서 코디네이터의 창에는 코디네이터 배지와 ⑂ 워커 2 알약이 붙고, 그 아래에 워커의 창이 상태 점과 함께 나옵니다. 위쪽의 초록 버튼을 누르면 에이전트 차트가 열립니다. 맨 위에 코디네이터가 있고 워커마다 초록 선이 이어집니다. 코디네이터의 터미널에서는 오른쪽 위 ⑂ 2 카드에 워커가 나오고, 하나를 누르면 그 창으로 갑니다. 워커가 질문에서 멈추면 다른 에이전트처럼 알림이 옵니다. iPhone 앱 0.1.93 이상, Android 앱 0.1.94 이상이 필요합니다.
  • 웹 터미널. 사이드바에 데스크탑 앱과 같은 워커 · 작업 중 2 머리 줄이 나오고, 오른쪽 위 Agents 카드에 코디네이터와 워커가 상태와 함께 나옵니다(st 0.3.85 이상). 하나를 누르면 그 창으로 갑니다.
폰 브라우저에서 터미널 위로 사이드바를 연 화면: 세션, coordinator 배지가 붙은 lead, 2 workers 아래 tests와 readme
같은 세션을 폰에서 사이드바를 열고 본 모습

결정이 필요한 워커는 답에 질문을 적고 멈춥니다. 코디네이터가 그걸 읽고 답하거나, 자기 pane에서 나에게 묻습니다. 워커 창에 뜬 권한 질문은 내가 답합니다. 그 창에서든 알림에서든 됩니다.

5. 보고 읽기

둘 다 끝나면 코디네이터가 워커마다 답과 요약을 읽고, 할 일에 적힌 기준대로 확인한 다음(적어 둔 테스트를 실행해 봅니다), 자기 pane에 보고합니다.

웹 터미널: 코디네이터 창에 두 줄 보고가 있고, 오른쪽 위 Agents 카드에 lead, tests, readme가, 사이드바 카드에 코디네이터와 워커 둘이 보입니다
코디네이터의 보고. 워커는 Agents 카드와 사이드바에 보입니다

빠진 것이 있으면 코디네이터에게 말합니다. 처음부터 다시 하지 않고 st worker send로 그 워커에게 일을 더 줍니다.

6. 워커 닫기

보고가 끝나도 워커의 창은 남아 있어서 각자 한 일을 읽어 볼 수 있습니다. 다 봤으면 코디네이터에게 닫으라고 하거나(st worker stop <id> --yes로 닫습니다), 앱에서 그 창을 닫습니다(먼저 묻습니다). 두 워커는 프로젝트 폴더의 파일을 고쳤으니 평소처럼 git으로 살펴봅니다.

이미 띄워 둔 에이전트를 워커로

새 워커를 띄우지 않고, 이미 각자의 창에서 대화하고 있는 에이전트들을 워커로 데려올 수도 있습니다. 데려온 에이전트는 다시 시작하지 않으므로 그동안 읽은 코드와 나눈 대화를 그대로 가지고 일합니다.

창 tests와 readme에서 Claude Code 둘이 이미 split.ts를 읽었습니다. lead의 Claude Code에게 그 둘을 워커로 데려와 테스트와 README를 맡기라고 부탁합니다. st worker adopt로 데려오고, 일을 보내고, 결과를 확인해 보고합니다. 웹 터미널 화면이고 2배속입니다.

  1. 에이전트마다 st가 공유하는 세션에 창을 하나씩 열고 Claude Code나 Codex를 시작해 평소처럼 대화합니다.

  2. 코디네이터가 될 창에서 데려올 에이전트의 id를 넣어 부탁합니다. id는 각 창에서 echo $TMUX_PANE으로 보거나 사이드바에서 확인합니다.

    /sophonz:orchestrate %1과 %2를 네 워커로 데려와. 둘 다 split.ts를 이미 읽었어.
테스트는 %1에게, README는 %2에게 맡기고, 끝나면 확인해서 두 줄로 알려 줘.

  3. 코디네이터가 st worker adopt %1과 st worker adopt %2로 데려오고 st worker send로 일을 보냅니다. 그다음은 위의 4–5단계와 같습니다.

데스크탑 앱에서는 사이드바의 창 행이나 에이전트 그래프의 카드를 코디네이터 위로 끌어다 놓아도 데려옵니다. 데려온 워커는 st worker stop으로 닫히지 않습니다. 일이 끝나면 st worker release <id>로 놓아 주면 원래의 대화로 돌아갑니다. 자세한 것은 오래 대화한 세션을 워커로 데려오기에 있습니다.

다음으로