본문으로 건너뛰기
claudemods

Claude Code 상태 표시줄 모드

Claude Code 상태 표시줄 모드는 브랜치, 컨텍스트 사용률, 비용, 카운터 같은 실시간 정보를 상태 표시줄이나 프롬프트 위 밴드에 띄워 따로 물어볼 필요가 없게 합니다.

Claude Code에서 실행 중인 컨텍스트 미터

컨텍스트 미터

컨텍스트 창 사용률, 5시간·7일 요금제 사용량, 세션 비용을 상태 표시줄에 보여 주고 한도에 가까워지면 경고합니다.

  • 상태 표시줄
  • 토스트
  • UI 변경

v2.1.291에서 테스트됨

Claude Code에서 실행 중인 프롬프트 위 Git 브랜치

프롬프트 위 Git 브랜치

Claude Code 프롬프트 위 한 줄 띠에 git 브랜치, 변경된 파일 수, ahead/behind 상태를 표시합니다.

  • 프롬프트 위
  • 명령어 실행
  • 도구 호출 가로채기
  • UI 변경

v2.1.291에서 테스트됨

Claude Code에서 실행 중인 도구 호출 카운터

도구 호출 카운터

Claude의 도구 호출을 턴별·세션별로 세어 스피너 옆에 표시하고, 상세 내역을 보는 /tally 명령을 추가합니다.

  • 스피너
  • 대화 기록
  • 상태 표시줄
  • 도구 호출 가로채기
  • UI 변경
  • 명령어/도구 추가

v2.1.291에서 테스트됨

Claude Code 상태 표시줄 모드는 작업하는 동안 작은 실시간 정보를 보여 줍니다. 현재 git 브랜치, 컨텍스트 창이 얼마나 찼는지, 플랜 사용량이 얼마나 남았는지, 세션 비용, 이번 턴에 Claude가 호출한 도구 수 등입니다. 명령을 입력하고 답을 기다리는 대신 한눈에 읽을 수 있습니다.

Claude Code 상태 표시줄 모드는 텍스트를 어떻게 그리나요?

표시할 수 있는 곳은 두 군데입니다. 첫 번째는 상태 표시줄 자체로, 모드는 $.ui.status('...')로 여기에 씁니다. 일반 문자열을 받으며 숫자를 보여 주는 가장 가벼운 방법입니다. 두 번째는 입력란 위의 한 줄짜리 밴드로, 모드는 AbovePrompt 렌더 사이트에 대한 ui.render 이벤트를 처리하고 $.ui.resolve(e)에서 가져온 Box와 Text 요소를 반환해 그립니다. 밴드는 색상, 굵게, 말줄임을 쓸 수 있으므로 ⎇ main · 3 changed · ↑1 ↓0 같은 더 풍부한 줄에 적합합니다.

새로 고침 시점은 보통 첫 값을 읽는 session.start, Claude가 답한 뒤의 turn.complete, 컴팩션 후의 session.compact, 그리고 느린 대비책인 $.clock.every(ms)입니다. 세부 내역 없이 $.session.usage()를 읽는 모드는 Claude Code가 이미 가진 수치를 읽기 때문에 비용이 들지 않습니다. 이벤트와 렌더 사이트의 전체 목록은 모드 레퍼런스에 있습니다.

설치하기 전에 무엇을 확인해야 하나요?

권한 배지를 살펴보십시오. 순수한 표시기라면 UI 변경 외에는 거의 표시되지 않아야 합니다. git status를 실행해야 하는 git 표시기에는 명령어 실행이 정상이지만, "작동 방식" 섹션을 읽어 정확한 프로그램과 인수를 확인하십시오. 네트워크나 프롬프트 읽기까지 표시되는 상태 표시줄 모드라면 분명한 이유가 있어야 합니다.

다음으로 "사용자 지정" 표에서 새로 고침 간격을 확인하십시오. 큰 저장소에서 타이머가 짧으면 git status가 자주 실행되어 느린 디스크에서는 체감될 수 있습니다. 마지막으로 모드 페이지에서 테스트된 버전을 확인하십시오. 모드를 터미널에서 쓰려면 Claude Code 2.1.287 이상이 필요합니다.

여러 표시기를 함께 쓸 수 있나요?

네. 일반적인 구성은 프롬프트 위의 브랜치 밴드와 상태 표시줄의 컨텍스트 및 비용 미터를 함께 쓰는 것입니다. 쓰지 않는 부분은 /config에서 각 모드의 설정으로 끄고, 줄이 너무 복잡해지면 /plugin의 Installed 탭에서 모드 전체를 비활성화하십시오.

자주 묻는 질문

여러 Claude Code 상태 표시줄 모드가 서로 내용을 덮어쓰나요?
아닙니다. 각 모드의 $.ui.status 텍스트는 해당 플러그인에 속하므로 두 모드가 모두 상태 텍스트를 쓸 수 있습니다. 다만 줄이 금방 복잡해지므로 실제로 보는 숫자 두세 개만 남겨 두십시오.
상태 표시줄 모드 때문에 Claude가 느려지나요?
매초 폴링하는 대신 turn.complete 같은 이벤트에서 새로 고친다면 느려지지 않습니다. git status처럼 타이머로 프로그램을 실행하는 모드는 /config에서 간격을 설정할 수 있습니다.
프롬프트 위의 밴드가 왜 보이지 않나요?
밴드는 Claude Code 자체 콘텐츠에 자리를 양보합니다. 예를 들어 설문이 열려 있는 동안이 그렇습니다. /plugin에서 모드가 활성화되어 있는지, Claude Code 2.1.287 이상을 실행 중인지 확인하고, 셸에서 설치했다면 /reload-plugins를 실행하십시오.