Cmd. /branch · /fork · /subtask
현재 대화를 분기하거나 별도 백그라운드 세션으로 복사하고, inherited-context 하위 작업을 위임하는 세 명령의 차이
핵심 요약
/branch [name]은 현재 대화를 새 branch로 복사하고 그 branch로 전환합니다./fork [지시문]은 현재 대화 전체를 별도 백그라운드 세션으로 복사하고 원래 대화는 계속합니다./subtask <지시문>은 현재 맥락을 상속한 서브에이전트에 작업을 맡기고 결과를 이 대화로 반환합니다.- v2.1.212에서
/fork의 역할이 바뀌고 기존 inherited-context 동작은/subtask로 이름이 바뀌었습니다. 오래된 “/fork는/branch별칭” 설명을 현재 버전에 적용하지 마세요.
명령어 원본 선언
/branch [name]
/fork [instruction]
/subtask <instruction>어떤 명령을 고를까
| 명령 | 실행 후 현재 화면 | 결과 위치 | 맞는 작업 |
|---|---|---|---|
/branch | 새 branch로 전환 | branch 대화에 계속 축적 | 같은 맥락에서 접근 A/B를 직접 비교 |
/fork | 원래 대화를 계속 | 별도 background session | 독립적으로 이어가고 나중에 resume할 곁가지 |
/subtask | 원래 대화를 계속 | 하위 작업 결과가 현재 대화로 반환 | 한정된 조사·검토·구현 위임 |
현재 동작 (v2.1.212+)
/branch [name]
현재 시점까지의 대화를 복사해 새 branch를 만들고 즉시 그 branch로 전환합니다. 원본은 보존되며
/resume 또는 세션 피커로 돌아갈 수 있습니다. “이 설계를 다른 접근으로 직접 이어서 실험”할 때 씁니다.
/branch streaming-alternative명령줄에서는 --continue 또는 --resume에 --fork-session을 결합할 수 있습니다.
claude --continue --fork-session/fork [지시문]
현재 대화 전체를 복사한 새 백그라운드 세션을 만들고, 원래 대화는 전환 없이 계속합니다. 새 세션은 Agent View에서 모니터링하거나 나중에 다시 열 수 있으므로, 현재 작업을 막지 않으면서 독립된 장기 흐름을 시작할 때 적합합니다.
/fork investigate the flaky integration test and keep the work isolated/subtask <지시문>
현재 대화 맥락을 받은 서브에이전트에 작업을 위임하고 결과를 이 대화로 돌려받습니다. v2.1.212 이전의
inherited-context /fork 동작이 이 이름으로 이동했습니다. 별도 세션을 관리할 필요가 없는 짧은 조사나
경계가 분명한 구현에 적합합니다.
/subtask inspect the parser tests and report missing edge cases버전 이력
v2.1.71: 대화 fork/branch의 plan 파일 공유 문제 수정v2.1.77: 당시/fork를/branch로 이름 변경v2.1.116: 50MB 초과 transcript의/branch제한 수정v2.1.117: inherited-context fork 서브에이전트 실험 도입v2.1.212:/fork를 별도 백그라운드 세션 명령으로 재정의하고, inherited-context 서브에이전트 명령을/subtask로 변경
운영 주의사항
- branch·fork·subtask는 생성 시점의 대화 맥락을 복사하거나 상속합니다. 이후 원본 대화의 새 메시지가 자동 동기화되지는 않습니다.
/branch의 “이 세션에 한해 허용” 권한은 새 branch로 이어지지 않습니다./fork세션에는 찾기 쉬운 이름을 붙이고 Agent View에서 상태와 write scope를 확인하세요./subtask도 서브에이전트 동시·세션 누적 한도에 포함됩니다. v2.1.220 기본값은 동시 20개, 세션 누적 200개입니다.
출처
- Commands: https://code.claude.com/docs/en/commands
- Subagents: https://code.claude.com/docs/en/sub-agents
- Agent View: https://code.claude.com/docs/en/agent-view
- Changelog: https://code.claude.com/docs/en/changelog