Context Gauge

Context Gauge는 Claude Code 타일 제목 표시줄에 있는 얇은 채움 막대입니다. 한눈에 하나의 질문에 답합니다: 이 에이전트는 컨텍스트가 얼마나 남았는가? 이 신호가 없다면 에이전트가 작업 중간에 갑자기 compaction이나 truncation을 할 때야 사후적으로 알 수 있습니다.

에이전트가 긴 작업을 실행 중일 때 게이지를 지켜보세요. 녹색에서 주황색, 빨간색으로 올라가면 턴을 마무리하거나, 새 세션을 시작하거나, 컨텍스트 압력이 결과 품질을 떨어뜨리기 전에 새 에이전트로 넘길 때입니다.

할 수 있는 일

• 컨텍스트 윈도우 채움 정도를 한눈에 보기 — 타일 제목 표시줄의 채움 막대와 퍼센트 라벨.
• 문제를 조기에 발견 — 막대가 70%에서 주황색, 90%에서 빨간색으로 바뀌어 에이전트가 한계에 부딪히기 전에 알 수 있습니다.
• 호버 시 정확한 숫자 확인 — 툴팁에 토큰 수와 모델의 컨텍스트 윈도우 크기가 표시됩니다. 예: Context ~42% · 84k of 200k tokens (claude-opus-4-7).
• Dynamic Workflows를 별도로 추적 — 타일이 Claude Code Dynamic Workflow를 실행 중일 때 툴팁에 합산된 workflow … tokens 수치(서브에이전트가 실행 중인 동안에는 (active) 표시)가 추가되며, 메인 세션의 채움 정도를 왜곡하지 않도록 메인 퍼센트와 분리해 추적합니다.

사용 방법

1. Claude Code 에이전트 타일을 생성하거나 엽니다. 게이지는 제목 표시줄에 자동으로 나타납니다 — 아무것도 활성화할 필요가 없습니다.
2. 에이전트가 작업하는 동안 색상을 확인합니다:

   구간	색상
   < 70%	녹색
   70–89%	주황색
   ≥ 90%	빨간색

3. 정확한 토큰 수와 모델을 보려면 게이지에 호버하세요.
4. 게이지가 주황색이나 빨간색으로 올라가면 현재 턴을 마무리할지, 새 세션을 시작할지, 작업을 새 에이전트로 옮길지 결정합니다.

게이지는 감지된 에이전트가 Claude Code이고 실제로 에이전트가 감지된 타일에만 렌더링됩니다. Codex, Amp, OpenCode, 일반 셸에는 나타나지 않습니다 — 이 CLI들은 Claude Code처럼 로컬 구조화된 사용량 블록을 노출하지 않습니다.

일반적인 사용 사례

• "이 긴 리팩터가 compaction 직전인가?" — 게이지를 지켜보고, 빨간색이면 컨텍스트 압력이 결과를 떨어뜨리기 전에 턴을 마무리하거나 새 세션을 시작하세요.
• "다음 지시를 위해 에이전트에 여유가 얼마나 남았나?" — 정확한 퍼센트와 토큰 수를 보려면 호버하세요.
• "워크플로의 서브에이전트 소모가 표시되나?" — Dynamic Workflow를 실행 중인 타일에서 게이지를 호버하세요. 워크플로 토큰 수치가 메인 퍼센트와 분리되어 나타납니다.

팁과 모범 사례

• 주황색은 "곧 마무리", 빨간색은 "지금 결정"으로 취급하세요. 에이전트는 빨간색 이후에도 계속 작업하지만, 컨텍스트 압력이 커질수록 품질이 떨어질 수 있습니다.
• 게이지는 MadoHub 창이 백그라운드로 간 동안 일시정지되며, 다시 돌아오면 즉시 갱신됩니다. 그래서 볼 때의 수치는 항상 최신입니다.
• 폴이 일시적으로 실패하면(가장 흔한 원인은 아직 세션 파일이 없는 경우) 게이지는 비워두지 않고 마지막 수치를 계속 보여줍니다 — 잠깐 빈 값이 나타난다고 당황하지 마세요.
• 워크플로 서브에이전트는 메인 세션 윈도우가 아닌 자신만의 컨텍스트에서 실행되므로 토큰 사용량이 별도로 추적되며, 의도적으로 메인 퍼센트에 합산되지 않습니다.

관련 기능

• Fleet — 행별로 상태와 함께 워크플로 진행(workflow · 3/5 agents)을 볼 수 있습니다.
• Dynamic Workflows — 툴팁이 서브에이전트 토큰 사용량을 보여주는 Claude Code 기능입니다.
• MadoAgent — 한 타일의 컨텍스트가 부족해질 때 새 에이전트를 시작합니다.

제한 사항

• Claude Code 전용입니다. 다른 에이전트 유형이나 일반 셸에는 게이지가 렌더링되지 않습니다.
• 퍼센트는 실시간 OS 수준의 카운트가 아니라 가장 최근 assistant 메시지의 사용량 블록을 기반으로 한 근사치입니다.
• 인식되지 않은 모델 문자열은 보수적 기본값인 200,000 토큰 컨텍스트 윈도우로 처리됩니다. 그래서 새로 출시된 모델의 퍼센트는 MadoHub의 표가 갱신되기 전까지 약간 빗나갈 수 있습니다.