클로드 코드에서 대화를 이어받는 포크 서브에이전트 띄우고 끄는 법

클로드 코드(Claude Code)의 포크(fork)는 지금까지 나눈 대화를 통째로 물려받는 서브에이전트다. 배경을 다시 설명할 필요가 없고, 포크가 부른 도구 호출은 본 대화에 쌓이지 않고 마지막 결과만 돌아온다. 10월 16일 나온 2.1.302부터는 터미널 말고도 claude -p, Agent SDK, 데스크톱 앱, VS Code에서 포크 모드가 기본으로 켜진다.

1. /subtask 뒤에 할 일을 적으면 직접 띄울 수 있다. 포크는 프롬프트 아래 패널에서 백그라운드로 돌다가, 끝나면 결과를 본 대화에 메시지로 남긴다.

/subtask 지금까지 바꾼 파서에 맞춰 단위 테스트 초안 써 줘

1. 패널에서 ↑·↓로 줄을 고르고 Enter를 누르면 그 포크의 기록이 열려 이어서 지시할 수 있다. x는 돌고 있는 포크를 멈추고, Esc를 누르면 입력창으로 돌아간다.

2. 포크는 시스템 프롬프트와 도구, 모델이 본 세션과 같아서 첫 요청부터 본 세션의 프롬프트 캐시를 그대로 쓴다. 같은 맥락이 필요한 일은 새 서브에이전트보다 싸게 든다.

3. 포크 모드를 끄려면 환경변수를 0으로 준다. 모든 세션에서 꺼지고, 꺼 둔 상태에서도 /subtask로는 직접 띄울 수 있다.

{
  "env": {
    "CLAUDE_CODE_FORK_SUBAGENT": "0"
  }
}

1. 포크 모드는 켜 두고 Claude가 알아서 포크를 띄우는 것만 막으려면 deny 규칙에 Agent(fork)를 넣는다.

{
  "permissions": {
    "deny": [
      "Agent(fork)"
    ]
  }
}

/subtask는 2.1.212부터 쓸 수 있고, 2.1.161~2.1.211에서는 /fork가 같은 일을 한다. claude mcp serve에서는 포크가 나오지 않는다. 설명 문서에는 아직 -p와 Agent SDK에서 기본으로 꺼져 있다고 나오는데, 2.1.302 체인지로그에서 바뀐 내용이다.