Claude Code status line과 effort: 긴 세션 비용·문맥을 보며 조절하는 법 | DAKER 커뮤니티

Claude Code status line이란, 세션 하단에 모델, 문맥 사용량, 비용, git 상태 같은 작업 지표를 표시하는 사용자 정의 상태줄입니다. 2026년 7월 2일 기준 공식 문서에서 /statusline, statusLine, /effort 흐름을 확인했고, 장기 리팩터링이나 백그라운드 작업이 많은 팀은 먼저 보이는 지표를 정해야 합니다.

한 줄 요약: 긴 Claude Code 세션은 "더 생각해"보다 "무엇을 보고 언제 effort를 올릴지"가 먼저입니다.

이미지: Claude Code status line으로 context, 비용, 모델, effort를 함께 보는 대표 카드.

문제 상황: 왜 긴 Claude Code 세션은 중간에 흐려질까?

처음에는 작은 수정처럼 보였던 작업도 테스트, 리팩터링, 리뷰 반영을 거치면 세션이 길어집니다. 이때 context window, 비용, 현재 모델, git 상태를 보지 않으면 "아직 여유가 있다"는 느낌으로만 판단하게 됩니다. 특히 여러 세션을 동시에 열면 어느 세션이 어떤 branch에서 얼마만큼 진행됐는지 헷갈리기 쉽습니다.

관련 운영 글로는 DAKER의 Claude Code 알림 설정과 Claude Code 계획 모드를 함께 보면 좋습니다. 알림은 기다림을 줄이고, 계획 모드는 작업 범위를 줄이며, status line은 진행 중 지표를 보이게 합니다.

핵심 개념: status line과 effort는 각각 무엇을 맡을까?

Status line은 Claude Code가 JSON session data를 stdin으로 전달하고, 사용자가 지정한 shell command가 출력한 문자열을 하단에 보여주는 기능입니다. Effort는 모델이 작업 난이도에 맞게 추론 강도를 조절하는 설정입니다. 둘은 별개지만, 실무에서는 status line으로 현재 상태를 보고 /effort로 다음 턴의 균형을 조절하는 짝으로 쓰기 좋습니다.

운영 질문	확인 지표	Claude Code 기능
문맥이 얼마나 찼나?	context window percentage	status line
비용이 커지고 있나?	total cost, duration	status line
단순 작업인가 복잡한 판단인가?	작업 난이도	`/effort`
모델 장애 때 멈추나?	fallback notice	fallback model chain

단계별 사용법: status line을 먼저 어떻게 붙일까?

팀에서 보고 싶은 지표를 3개 이하로 고릅니다.
/statusline show model name and context percentage with cost처럼 자연어로 생성합니다.
생성된 statusLine 설정이 ~/.claude/settings.json 또는 프로젝트 설정에 들어갔는지 확인합니다.
shell script가 JSON stdin을 읽고 너무 오래 걸리지 않는지 확인합니다.
시간 기반 지표가 필요하면 refreshInterval을 검토합니다.
팀 문서에는 "status line은 관찰용이며 API 토큰을 쓰지 않는다"는 점을 남깁니다.

이미지: 관찰 지표 선택, /statusline 생성, settings 확인, /effort 조절로 이어지는 팀 운영 워크플로.

짧은 예시: effort는 언제 올리고 내릴까?

단순 오타 수정, 파일 위치 찾기, 짧은 로그 요약은 낮은 effort 후보입니다. 반대로 실패 원인 분석, 보안 경계 판단, 대규모 리팩터링 계획은 높은 effort가 더 적합합니다. 공식 문서 기준 low, medium, high, xhigh, max는 비용과 지연 시간, 추론 깊이의 균형이 다르므로 팀 기본값을 하나로 고정하기보다 작업 종류별 기준을 두는 편이 안전합니다.

팀 적용 체크리스트: 비용과 문맥을 줄이려면 무엇을 정할까?

status line에는 모델, context %, git branch처럼 바로 행동으로 이어지는 지표만 넣었습니다.
비용 표시가 실제 청구액과 다를 수 있다는 한계를 팀에 알렸습니다.
/effort 변경은 세션·모델에 따라 지속 범위가 다를 수 있음을 확인했습니다.
max나 ultracode는 모든 작업의 기본값이 아니라 고난도 작업의 예외로 둡니다.
fallback model chain을 쓰면 인증, 결제, rate limit 오류는 자동 전환 대상이 아니라는 점을 런북에 남깁니다.

공식 출처: 어떤 문서를 확인했나?

이 글은 2026년 7월 2일 기준 Claude Code Customize your status line, Model configuration, CLI reference 공식 문서와 Claude Sonnet 5 공개 공지를 확인해 작성했습니다. DAKER/DACON 공개 링크 정책에 따라 본문에는 외부 공식 URL을 직접 노출하지 않았습니다.

FAQ

Status line은 API 토큰을 추가로 쓰나요?

공식 문서 기준 status line은 로컬 스크립트를 실행해 표시하므로 API 토큰을 쓰지 않습니다. 다만 스크립트가 외부 명령을 느리게 실행하면 터미널 경험은 나빠질 수 있습니다.

`/effort high`를 항상 켜두면 좋은가요?

항상 좋은 선택은 아닙니다. 단순 작업은 낮은 effort가 빠르고 비용 효율적일 수 있고, 복잡한 설계·디버깅에서만 높은 effort가 필요할 수 있습니다.

Status line에는 어떤 필드를 넣는 게 좋나요?

처음에는 model, context percentage, git branch 세 가지가 무난합니다. 비용이나 duration은 팀 운영에서 실제 의사결정에 쓰일 때만 추가합니다.

Fallback model chain은 모든 오류를 해결하나요?

아닙니다. 공식 문서 기준 인증, 결제, rate limit, request size, transport 오류는 fallback 전환 대상이 아닙니다.

다음 긴 Claude Code 작업을 시작하기 전에 status line에 보일 세 가지 지표와 effort 기준을 먼저 정해 보세요.