Claude Code 병렬 세션: 작업 격리와 핸드오프

먼저 작업 경계를 정합니다

버그 수정, 테스트, 마이그레이션, 문서 또는 조사의 결과가 독립적일 때 새 세션을 만듭니다. 기대 결과, 수정 가능한 파일, 검증 방법을 기록하세요. 두 작업이 같은 파일이나 스키마를 바꾸면 편집 전에 한 명의 소유자를 정합니다.

세션, worktree, 백그라운드 프로세스의 차이

Claude Code 세션은 대화 맥락을 분리합니다. Git worktree는 디렉터리와 브랜치를 분리합니다. 백그라운드 프로세스는 긴 build나 test를 실행할 뿐입니다. 어느 것도 올바른 merge나 테스트 통과를 보장하지 않습니다.

git status --short
git worktree add ../project-fix-parser -b fix/parser-boundary
git diff --check

짧은 handoff 카드를 전달합니다

작업: <결과와 범위>
디렉터리 / 브랜치: <경로와 브랜치>
변경 파일: <목록 또는 없음>
완료: <구체적 결과>
검증: <명령 → 결과>
차단 요인 / 위험: <불확실성>
다음 단계: <검증 가능한 한 가지 작업>

API key, token, cookie, .env 내용, 민감한 로그를 전달하지 마세요. merge나 전달 전에는 status와 diff를 확인하고 가장 작은 관련 검증을 실행하며, 실행하지 못했다면 이유를 기록합니다.

도구 동작은 Claude Code 문서, 브랜치 격리는 Git worktree 문서를 확인하세요. 별도 API workflow에는 BetterToken Claude Code 문서를 사용할 수 있습니다. BetterToken은 자신의 account와 key를 사용하는 API 서비스이며 Claude 구독이 아닙니다.