Claude Code 상세 사용법 51: 세션 이어받기와 브랜치 전략 | DAKER 커뮤니티

Claude Code 상세 사용법 51: 세션 이어받기와 브랜치 전략

긴 AI 코딩 작업에서 가장 큰 손실은 “어디까지 했는지”를 다시 설명하는 시간입니다. Claude Code의 sessions 문서는 이전 대화를 이어가고, 고르고, 이름 붙이고, PR에서 시작하는 흐름을 다룹니다. 오늘은 세션을 작업 단위로 관리하는 방법입니다.

네 가지 선택지

가장 최근 작업을 그대로 이어가면 --continue가 빠릅니다. 여러 작업 중 하나를 골라야 하면 --resume이나 /resume picker가 낫습니다. 같은 문제를 다른 접근으로 풀어야 하면 기존 맥락을 더럽히지 말고 branch/fork로 갈라야 합니다. PR 리뷰나 수정은 --from-pr처럼 PR context를 불러오는 시작점이 더 안전합니다.

세션 이름은 목표로 붙인다

좋은 이름은 도구가 아니라 완료 조건을 말합니다. “vite error”보다 “checkout validation red state fix”가 낫습니다. 나중에 /resume 목록에서 무엇을 골라야 할지 바로 보이기 때문입니다.

Bad: refactor
Good: settings-page-permission-copy-and-tests
Good: pr-184-login-redirect-regression

세션이 길어지면 마지막에 한 줄 handoff를 남깁니다.

Status: patched validation copy, unit tests pass, browser smoke not run.
Next: open /settings in Chrome and verify empty-state copy.
Risk: i18n snapshot may need update.

branch/fork가 필요한 순간

한 세션 안에서 서로 다른 해법을 계속 섞으면 Claude도 사람도 맥락을 잃습니다. “React Query로 갈지 서버 액션으로 갈지”처럼 아키텍처 갈림길이면 branch를 만듭니다. 실험이 실패하면 돌아오고, 성공하면 근거를 남깁니다.

Web과 terminal 사이를 오갈 때

공식 web 문서는 cloud environment와 terminal 사이에서 세션을 이동하는 흐름을 설명합니다. 원칙은 같습니다. 환경이 바뀌면 실행 가능한 명령, 네트워크, 비밀값, 파일 상태가 달라질 수 있습니다. 이어받은 뒤에는 바로 코드를 고치기보다 현재 repo 상태와 검증 명령부터 확인하세요.

git status --short
npm test -- --runInBand

안 보이거나 엉뚱한 세션이 열릴 때

설정이나 memory가 이상하면 /context, /status, /doctor로 실제 로딩 상태를 봅니다. session 문제처럼 보여도 원인은 다른 CLAUDE.md, 다른 working directory, managed settings일 수 있습니다.

/context
/status
/doctor
/resume

시니어 엔지니어의 결론

Claude Code 세션은 채팅 로그가 아니라 작업 단위입니다. 최신 세션은 --continue, 선택은 --resume, PR은 --from-pr, 다른 해법은 fork로 분리하세요. 그리고 매 세션 끝에는 테스트 증거와 다음 행동을 남기세요. 그러면 클로드 코드는 긴 바이브코딩도 다시 설명 없이 이어갈 수 있는 개발 워크플로우가 됩니다.

참고: Anthropic Claude Code sessions, debug configuration, Claude Code on the web 문서를 2026-06-11에 확인했습니다.