Session

https://code.claude.com/docs/ko/how-claude-code-works

Claude Code의 작동 방식 - Claude Code Docs

 

🛠️ Claude Code의 세션: AI와 함께하는 '작업 단위' 이해하기

Claude Code를 실행했을 때 우리가 머무는 그 공간, 바로 세션(Session)입니다. 단순히 터미널을 여는 것을 넘어, 개발 환경에서는 어떤 의미를 갖는지 알아볼까요? 🧐

 

1. 세션이란 무엇인가요? 🕒

Claude Code에서 세션은 "터미널에서 claude 명령어를 입력해 대화를 시작한 시점부터 종료할 때까지의 한 주기"를 의미합니다.

이 세션 동안 Claude는 여러분의 프로젝트 상태를 기억하고, 연속적인 피드백을 주고받으며 작업을 수행합니다. 마치 전문 개발자와 함께 페어 프로그래밍을 하기 위해 회의실에 입장해서 퇴장할 때까지의 과정과 같습니다.

 

2. 세션의 핵심 특징 🔑

✅ 단기 기억의 저장소 (Ephemeral Memory)

세션이 유지되는 동안 Claude는 이전에 나눈 대화, 실행했던 명령어의 결과, 수정했던 파일의 이력을 모두 기억합니다. 덕분에 "아까 그 에러 다시 보여줘"나 "그 부분 다시 수정해줘" 같은 연속적인 명령이 가능하죠.

✅ 컨텍스트의 경계 (Context Boundary)

세션은 Claude가 한 번에 집중할 정보의 범위를 결정합니다. 세션을 종료하고 새로 시작하면 이전 세션의 미세한 대화 흐름은 초기화되어, 새로운 마음으로(깨끗한 컨텍스트로) 작업을 시작할 수 있습니다.

✅ 도구 사용의 권한 (Tool Authorization)

세션 내에서 Claude는 파일을 읽고 쓰고 명령어를 실행할 권한을 부여받습니다. 사용자는 이 세션 안에서 Claude가 제안하는 동작을 승인(y)하거나 거절(n)하며 작업을 리드하게 됩니다.

 

3. 세션의 흐름: 생성부터 종료까지 🔄

1. 세션 시작 (claude): 하네스(Harness)가 가동되며 로컬 환경과 Claude 모델(클라우드에 위치)이 연결됩니다. 🔌
2. 컨텍스트 로드: 프로젝트 구조와 주요 파일들을 읽어 들여 '작업 뇌'를 세팅합니다. 🧠
3. 루프(Loop) 수행: * 사용자: "로그인 기능 만들어줘"
   • Claude: 코드 작성 및 터미널 테스트 실행
   • 사용자: "에러 나는데? 다시 봐봐" (연속성 유지)
4. 세션 종료 (/exit): 작업 결과가 로컬에 최종 반영되고 메모리가 정리됩니다. 🏁

4. 세션을 잘 활용하는 꿀팁 💡

• 주제별 세션 분리: 너무 오랫동안 한 세션에서 여러 작업을 하면 컨텍스트가 꼬일 수 있습니다. '버그 수정' 세션과 '기능 구현' 세션을 적절히 끊어서 새로 시작하는 것이 답변의 정확도를 높이는 방법입니다! ✂️
• CLAUDE.md 활용: 세션이 바뀌어도 유지되어야 할 프로젝트 규칙(Style Guide 등)은 CLAUDE.md 파일에 적어두세요. 그러면 새로운 세션이 시작될 때마다 Claude가 이를 가장 먼저 읽고 기억합니다. 📝
• 이력 확인: 세션이 끝나더라도 작업한 코드는 내 로컬 파일에 그대로 남아있으므로 안심하세요!

5. 마무리하며 🎯

Claude Code의 세션은 AI 에이전트가 여러분의 프로젝트를 이해하고 실제 '일'을 하는 몰입의 시간입니다. 이 세션을 어떻게 관리하고 어떤 정보를 주느냐에 따라 여러분의 개발 생산성이 천차만별로 달라질 수 있습니다.

자, 이제 새로운 세션을 열고 코딩을 시작해 볼까요? 💻✨