Claude Code 세션 가치 극대화

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

TL;DR

Claude Code 세션에서는 이전 작업의 문맥과 명령 출력이 계속 누적되면서 토큰 사용량과 비용이 커질 수 있습니다. 작업 사이에 `/clear`를 사용하고, 모델과 effort level을 시작 전에 고정하며, 파일은 `@`로 직접 첨부하면 불필요한 Read와 검색을 줄일 수 있습니다. 새 세션의 `/context`로 로드된 `CLAUDE.md`와 MCP tool definitions를 확인하고, 긴 명령은 quiet 플래그나 subagent로 분리하는 방식도 문맥 관리에 쓰입니다. 한 시간 뒤 prompt cache가 만료되기 전에 `/compact`를 실행하면 장시간 대화를 더 적은 비용으로 요약할 수 있습니다.

섹션별 상세

Claude Code에서 여러 작업을 한 대화에 계속 이어 붙이면 이전 작업의 관련 없는 문맥이 다음 요청에도 전송되어 토큰 사용량이 커질 수 있습니다. 작업 사이에 `/clear`를 실행하면 기존 대화 문맥을 제거하고 새 작업을 별도 문맥에서 시작할 수 있습니다. 이 방식은 서로 무관한 작업을 연속 처리할 때 입력 비용을 낮추는 데 초점을 둡니다.

세션을 시작한 뒤 모델과 effort level을 먼저 정하면 이후 요청이 같은 설정과 캐시 경로를 유지할 수 있습니다. 대화 중간에 모델이나 effort level을 변경하면 prompt cache가 무효화될 수 있어 같은 프롬프트를 다시 처리하는 비용이 발생합니다. 따라서 작업에 필요한 설정을 초기에 고정하는 편이 토큰 비용 관리에 유리합니다.

파일 이름을 메시지에 글자로 적고 Claude Code가 다시 찾게 하기보다 `@`로 파일을 직접 첨부할 수 있습니다. 파일 첨부는 별도의 Read 호출을 줄이고, 파일을 찾기 위한 검색 과정도 생략하게 합니다. 파일 내용을 작업 문맥에 바로 넣어야 하는 요청에서 호출 수와 처리 단계를 줄이는 방법입니다.

명령어가 많은 출력을 내놓으면 그 결과가 파일과 마찬가지로 대화 문맥에 추가되고 세션이 끝날 때까지 남습니다. 조용한 플래그를 지원하는 명령에는 quiet 옵션을 사용하고, 그렇지 않으면 해당 명령을 subagent에서 실행해 주 대화로 들어오는 출력을 제한할 수 있습니다. 출력이 긴 테스트나 검색 명령을 반복하는 작업일수록 문맥 누적을 관리하는 효과가 커집니다.

새 세션을 시작한 직후 `/context`를 한 번 실행하면 현재 로드된 `CLAUDE.md`와 MCP tool definitions를 확인할 수 있습니다. 이 목록에서 현재 작업에 필요하지 않은 설정이나 도구를 식별하면 세션에 불필요하게 포함된 정보를 줄일 수 있습니다. 초기 문맥의 구성을 확인하는 절차가 이후 요청의 입력량을 관리하는 출발점이 됩니다.

키보드에서 잠시 손을 뗄 때 `/compact`를 실행하면 기존 대화를 요약된 형태로 압축할 수 있습니다. prompt cache는 한 시간 뒤 만료되므로 캐시가 살아 있을 때 요약하면 대화 전체를 나중에 다시 처리하는 것보다 비용이 적습니다. 장시간 세션을 중단했다가 재개할 때 문맥을 유지하면서 입력량을 줄이는 방법입니다.

용어 해설

프롬프트 캐시(Prompt Cache): — 이전 요청에서 반복되는 프롬프트 내용을 저장해 다시 계산하지 않도록 하는 기능입니다. Claude Code에서는 모델이나 effort level을 중간에 바꾸면 캐시가 무효화되어 토큰 비용이 늘어날 수 있습니다.
토큰 사용량(Token Usage): — 모델이 입력과 출력을 처리할 때 소비하는 텍스트 단위의 양입니다. 불필요한 대화 기록과 명령 출력이 계속 누적되면 사용량과 비용이 함께 증가합니다.
서브에이전트(Subagent): — 주요 대화와 분리된 작업 단위에서 특정 명령이나 문제를 처리하는 보조 실행 주체입니다. 시끄러운 명령의 출력을 별도 작업으로 보내면 주 대화의 문맥 누적을 줄일 수 있습니다.
MCP 도구 정의(MCP Tool Definitions): — MCP 서버가 제공하는 도구의 이름과 사용 방법을 담은 정보입니다. 새 Claude Code 세션에서 어떤 도구 정의가 로드됐는지 확인하면 불필요한 문맥을 줄이는 데 도움이 됩니다.

기술

Claude Code
CLAUDE.md
MCP tool definitions

활용 사례

서로 다른 개발 작업을 한 세션에서 연속 처리하는 작업
긴 명령 출력이 발생하는 테스트와 검색 작업
장시간 중단 후 대화를 재개하는 개발 세션