Cmd. /fork
현재 대화를 분기하거나 별도 백그라운드 세션으로 복사하고, inherited-context 하위 작업을 위임하는 세 명령의 차이
핵심 요약
- 현재 대화를 새 background session으로 복사
- 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
현재 대화를 새 background session으로 복사
/fork [prompt]
/branch [name]
/subtask <task>사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 내장 명령 |
| 상태 | 현재 공식 표 |
| 별칭 | — |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Claude Code 2.1.278 |
여기서는 v2.1.212+의 Agent View 동작을 설명합니다. Agent View를 끄면 /subtask가 없고 /fork가 inherited-context 하위 작업으로 동작합니다.
사용 예
/fork Investigate the flaky integration test in isolation실행 결과와 유지 범위
/branch는 새 대화 분기로 전환하고, /fork는 별도 백그라운드 세션을 만들며, /subtask는 결과를 현재 대화로 돌려줍니다.
어떤 명령을 고를까
| 명령 | 실행 후 현재 화면 | 결과 위치 | 맞는 작업 |
|---|---|---|---|
/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주의사항
- branch·fork·subtask는 생성 시점의 대화 맥락을 복사하거나 상속합니다. 이후 원본 대화의 새 메시지가 자동 동기화되지는 않습니다.
/branch의 “이 세션에 한해 허용” 권한은 새 branch로 이어지지 않습니다./fork세션에는 찾기 쉬운 이름을 붙이고 Agent View에서 상태와 write scope를 확인하세요./subtask도 서브에이전트 동시 실행 한도에 포함됩니다. v2.1.237 기본값은 동시 20개이며, 세션 누적 200개 제한은 v2.1.224에서 제거됐습니다.- v2.1.232부터 inherited-context fork mode는 interactive 세션에서 기본 활성화되고
-p/SDK에서는 기본 비활성화됩니다.CLAUDE_CODE_FORK_SUBAGENT=1로 비대화형에서도 켜거나0으로 모든 표면에서 끌 수 있습니다.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록