세션 관리 — 시작·종료·재개

세션은 Claude Code와 나눈 일련의 대화를 하나로 묶은 단위입니다. 세션 안의 대화 이력은 컨텍스트로 유지되기 때문에 "아까 얘기한 내용을 기억하고 있는" 상태로 작업을 이어갈 수 있습니다. 세션을 언제 새로 열고 언제 이어갈지 가려 쓰는 것만으로 작업 효율이 크게 달라집니다.

핵심 요약

• claude 를 실행할 때마다 새 세션이 시작되고, 이전 세션 정보는 자동으로 이어지지 않습니다.
• 종료는 /exit, Ctrl+D(확인 표시 후 한 번 더), Ctrl+C(입력란이 빈 상태에서 2번) 중 하나입니다.
• claude -c 로 직전 세션을, /resume 으로 과거 세션 목록에서 골라 재개합니다.
• /rename 으로 세션에 이름을 붙여 두면 나중에 찾기 쉽습니다.
• 전혀 다른 작업으로 넘어갈 때는 /clear 로 컨텍스트를 비웁니다.

세션이 기억하는 것은 무엇인가

세션 안에서 오간 대화, 읽은 파일, 실행한 명령의 결과가 모두 컨텍스트로 남습니다.

예를 들어 "이 파일을 수정해줘"라고 부탁한 뒤 방금 수정에 실수가 있었다는 걸 깨달았다고 합시다. 이때 "아까 수정을 취소해줘"라고만 말해도 Claude Code는 직전 변경 내용을 이해한 채로 대응합니다. 세션 안의 문맥이 유지되기에 가능한 일입니다.

또 각 세션에는 고유한 세션 ID가 할당됩니다. 그래서 나중에 특정 세션만 골라 재개할 수 있습니다.

처음 Claude Code를 실행하는 분은 첫 세션 실전에서 기본 흐름을 먼저 확인하세요.

새 세션은 어떻게 시작하고 끝내나

claude 커맨드를 실행할 때마다 새 세션이 시작됩니다. 과거 세션 정보는 자동으로 이어지지 않으므로, "아까 작업의 연속을 하고 싶다"면 뒤에서 설명하는 --continue 옵션을 씁니다.

# 현재 디렉터리에서 새 세션 시작
claude

종료 방법은 세 가지입니다.

직전 세션을 이어가려면 — claude -c

PC를 닫았다가 "어제 하던 걸 이어서 하고 싶다"는 장면에서는 --continue(단축형 -c) 옵션을 씁니다.

# 직전 세션 이어가기
claude --continue

# 단축형도 같음
claude -c

현재 디렉터리에서 마지막으로 진행한 세션이 읽혀 들어오고, 대화 이력이 그대로 복원됩니다. "어제 어디까지 했더라?" 하고 되짚어 볼 필요가 없어집니다.

다만 --continue 는 직전 세션 하나만 대상으로 삼습니다. "어제도 작업했지만 이번엔 3일 전 세션을 재개하고 싶다"는 경우엔 /resume 을 쓰세요.

과거 세션 목록에서 고르려면 — /resume

Claude Code를 실행한 뒤 /resume 을 입력하면 과거 세션 목록이 표시됩니다. 화살표 키로 원하는 세션을 고르고 Enter 를 누르면 그 세션이 재개됩니다.

> /resume
──────────────────────────────────────────────
Resume
❯ README를 써 주세요
  2 seconds ago · main · 12.4KB · -
  Create main.js with Hello and helloWorld function
  23 seconds ago · main · 45.1KB · -
  Ctrl+A to show all projects · Ctrl+B to only show current branch · Type to search · Esc to cancel

각 항목에는 마지막 활동으로부터의 경과 시간, 브랜치, 대화의 첫머리가 표시됩니다. 화면 아래 안내처럼 글자를 입력해 검색하거나, Ctrl+A 로 모든 프로젝트를, Ctrl+B 로 현재 브랜치의 세션만 볼 수 있습니다. "지난주에 한 인증 기능 구현을 재개하고 싶다" 같은 장면에 잘 맞습니다.

세션에 이름 붙이기 — /rename

목록에는 대화의 첫머리만 표시되기 때문에 세션이 많아지면 알아보기 어렵습니다. 이럴 때 /rename 으로 세션 이름을 바꿔 둡니다.

> /rename README를 쓰던 세션
  ⎿  Session renamed to: README를 쓰던 세션

이후 /resume 목록에는 바꾼 이름이 표시됩니다.

Resume
❯ README를 쓰던 세션
  18 seconds ago · main · 15.2KB · -
  Create main.js with Hello and helloWorld function
  2 minutes ago · main · 45.1KB · -

실무에서는 기능 단위나 이슈 번호로 이름을 붙여 두는 편이 나중에 찾기 좋습니다.

세션 ID를 알고 있다면 — claude --resume

세션 ID를 알고 있는 경우엔 --resume 옵션으로 직접 지정할 수 있습니다.

claude --resume abc123def456

세션 ID는 /resume 목록 화면에는 표시되지 않습니다. 스크립트나 자동화 흐름 안에서 세션을 실행하고 그 출력에서 ID를 메모해 둔 경우처럼, 미리 ID를 아는 상황에서 쓰는 조금 고급 사용법입니다. 비대화 모드에서 JSON 출력으로 세션 ID를 받는 방법은 비대화 모드(-p)를 참고하세요.

팀에서 세션 ID를 공유해 쓰는 용도는 아닙니다. 자주 돌아가는 세션이 있다면 개인용 메모로 ID를 적어 두는 정도가 알맞습니다.

새 작업으로 넘어갈 때는 — /clear

세션이 길어지면 컨텍스트가 커지고 토큰 소비량도 늘어납니다. 그래서 기본적으로는 되도록 세션을 나누면서 작업하는 편이 좋습니다.

전혀 다른 작업으로 옮길 때는 /clear 를 실행합니다.

> /clear

사람으로 치면 지금까지의 대화를 한번 잊고 새 작업에 집중하는 것과 같습니다. 화제를 바꾸기 전에 /clear 를 해 두면 Claude Code가 과거 대화에 끌려가지 않습니다.

/clear 와 /compact 의 차이, 언제 무엇을 쓸지는 컨텍스트 윈도우 관리에서 자세히 다룹니다.

상황별로 무엇을 쓰면 되나

정리

• 세션은 대화 한 묶음이며, 세션 안에서는 앞의 문맥이 유지됩니다.
• claude -c 는 직전 세션 하나, /resume 은 과거 세션 목록에서 선택, --resume <id> 는 ID 직접 지정입니다.
• /rename 으로 이름을 붙여 두면 /resume 목록에서 바로 찾을 수 있습니다.
• 주제가 바뀌면 /clear 나 새 세션으로 컨텍스트를 비우는 편이 품질과 비용 양쪽에 유리합니다.
• 세션 안에서 특정 지점으로 되돌아가고 싶다면 /rewind 로 되감기를, 그 밖의 일상 커맨드는 기본 조작과 명령어를 참고하세요.