숏컷 코드

claude --continue
claude --resume
claude --resume auth-refactor
claude --continue --fork-session
claude --worktree feature-auth

세션 구조

Claude Code session은 특정 프로젝트 디렉터리에 연결된 대화 기록입니다. 작업 중 대화가 로컬 transcript로 저장되므로, 중간에 종료해도 나중에 이어갈 수 있습니다.

--continue
  -> 현재 디렉터리의 가장 최근 session 재개

--resume
  -> picker에서 session 선택

--resume <name>
  -> 이름이 정확히 맞는 session 재개

여러 작업을 동시에 진행한다면 session 이름을 붙이는 것이 중요합니다. 시작할 때 -n auth-refactor를 쓰거나, 진행 중 /rename auth-refactor로 이름을 정하면 재개할 때 혼동이 줄어듭니다.

분기 실험이 필요하면 기존 session을 그대로 이어가기보다 /branch나 --fork-session을 사용합니다. 원래 대화는 남겨 두고 새 session에서 다른 접근을 시험할 수 있습니다.

worktree 기준

Worktree는 같은 Git 저장소 기록을 공유하지만 별도 작업 디렉터리와 branch를 갖습니다. Claude Code 병렬 세션을 worktree에 나누면 한 세션의 파일 수정이 다른 세션의 작업 파일을 직접 건드리지 않습니다.

claude --worktree feature-auth
claude --worktree bugfix-123

새 worktree는 fresh checkout에 가까우므로 gitignored 파일이 자동으로 따라오지 않을 수 있습니다. .env, .env.local 같은 로컬 파일이 필요하면 .worktreeinclude로 복사 대상을 명시하는 흐름을 검토합니다.

주의할 점