Claude Code의 컨텍스트 잔량을 /statusline으로 간편하게 표시하기

서론

Claude Code를 사용하면서 "지금 컨텍스트(Context)를 얼마나 쓰고 있는 거지?"라고 궁금했던 적이 없으신가요?

세션이 길어지면 /compact를 입력해야 하는 타이밍을 읽지 못해, 갑자기 압축이 진행되면서 문맥이 어긋나는 경우가 있습니다.

스테이터스 라인(Status line)을 설정하면 상시 표시할 수 있지만, 직접 bash를 작성할 필요는 없습니다. /statusline에 한마디만 부탁하면 됩니다.

할 일

/statusline 현재 디렉토리, git 브랜치, 모델명, context 사용량을 표시해줘. 50%를 넘으면 노란색, 80%를 넘으면 빨간색으로.

이것뿐입니다. Claude가 자동으로 쉘 스크립트(Shell script)를 작성하여 ~/.claude/settings.json에 등록해 줍니다.

실행 후에는 프롬프트 아래에 다음과 같이 표시됩니다.

made-for-x [main] Opus 4.7 | ctx:54k/1000k (5% used, 95% left)

커스터마이징도 자연어로

마음에 들지 않는다면 그대로 추가 주문할 수 있습니다.

/statusline 더 간결하게 해줘. ctx의 퍼센트만 있으면 돼.

/statusline 세션의 토큰(Token) 누적량도 병기해줘

생성된 스크립트는 ~/.claude/statusline-command.sh 부근에 일반적인 bash 스크립트로 저장되므로, 나중에 수동으로 편집할 수도 있습니다.

/compact는 언제 입력하는 것이 좋은가

그런데 스테이터스 라인으로 잔량을 볼 수 있게 되면, 다음에 궁금해지는 것이 "그래서, 언제 /compact를 입력해야 하지?"입니다. 커뮤니티의 체감상으로는 다음과 같습니다:

• 60% 전후가 스위트 스팟(Sweet spot). 사후가 아니라 사전에 압축하는 것이 요령입니다.
• 80%를 넘으면 늦습니다. Claude 스스로가 이미 저하된 컨텍스트로 요약하게 되므로, 요약의 질도 떨어집니다.
• 태스크(Task)의 구분점에서 입력하는 것이 베스트입니다. 기능 구현이 일단락된 순간 등, 문맥이 깨끗할 때 압축합니다.

요컨대 "숫자가 노란색이 되면 구분점에서 입력한다" 정도의 감각으로 운용하면, 갑자기 압축되어 문맥이 어긋나는 사고를 상당히 방지할 수 있습니다.

솔직히 말하자면

60%에서 /compact를 하는 것도 어디까지나 커뮤니티의 체감일 뿐이며, 태스크의 종류에 따라 "여기서 입력하면 딱 좋다"라고 느끼는 기준선은 달라집니다. 자신의 작업 스타일에 맞춰 가장 적절한 임계값(Threshold)을 찾는 것이 가장 좋다고 생각합니다.

마치며

"앞으로 몇 턴이나 더 할 수 있지?"를 상시 볼 수 있는 것만으로도, 긴 세션에서의 스트레스가 상당히 줄어듭니다.

참고