커스텀 statusLine 세그먼트를 통해 Claude Code의 컨텍스트 윈도우 (Context Window), Pro/Max 속도 제한 (Rate-limits), 그리고 모델을 모니터링하려면 cc-context-telemetry를 설치하세요.

변경 사항 — 상태 표시줄의 실시간 텔레메트리 (Telemetry)

Claude Code의 상태 표시줄 (status bar)은 작지만 강력한 UI 요소입니다. 현재 브랜치와 디렉토리를 보여주지만, 컨텍스트 윈도우 (Context Window)가 얼마나 사용되었는지, Pro 또는 Max 속도 제한 (Rate limits) 하에서 요청이 얼마나 남았는지, 그리고 어떤 모델이 활성화되어 있는지와 같은 중요한 정보는 숨겨져 있습니다.

cc-context-telemetry는 이를 변화시킵니다. 기존 상태 표시줄 (status line) 앞에 다음과 같은 세그먼트를 추가합니다:

ctx 48% | 5h 14% ~3h20m | 7d 50% ~4d | opus-4.8 ~/code/myapp main

각 항목은 실행 가능한 정보를 제공합니다:

• ctx 48% — 컨텍스트 윈도우 (Context Window)가 절반 정도 찼습니다. 토큰 제한 (Token limits)에 도달하고 있다면 새로운 세션을 시작할 때입니다.
• 5h 14% ~3h20m — 5시간 속도 제한 (Rate limit) 중 14%를 사용했으며, 초기화까지 약 3시간 20분이 남았습니다.
• 7d 50% ~4d — 7일 속도 제한 (Rate limit) 중 50%를 사용했으며, 초기화까지 약 4일이 남았습니다.
• opus-4.8 — 현재 모델 (짧은 토큰 명칭).

이 도구는 adtention(Git 정보, 시간 등을 표시)과 같은 인기 있는 플러그인을 포함하여 어떠한 기존 상태 표시줄 (status line) 설정과도 함께 작동합니다. 현재의 바 (bar)를 교체하는 것이 아니라, 확장하는 방식입니다.

사용자에게 주는 의미 — 추측을 멈추고 최적화를 시작하세요

Claude Code를 집중적으로 사용한다면, 작업 도중 컨텍스트 윈도우 (Context window) 제한에 걸리거나 요청 속도가 갑자기 느려지는 이유를 궁금해한 적이 있을 것입니다. 그것이 바로 속도 제한 (Rate-limit)이 적용된 상황입니다.

cc-context-telemetry를 사용하면 다음과 같은 작업이 가능합니다:

• 실시간 컨텍스트 압박 (Context Pressure) 확인 — ctx가 70%를 초과하면, 새로운 세션을 시작하거나 /compact를 사용하여 토큰을 확보하는 것을 고려하세요.
• 속도 제한 (Rate-limit) 초기화에 맞춘 계획 수립 — 카운트다운을 통해 언제 더 많은 용량을 사용할 수 있는지 정확히 알 수 있습니다. 더 이상 Anthropic 대시보드를 새로고침할 필요가 없습니다.
• 활성화된 모델 확인 — 세션 중간에 모델을 전환하더라도 (예: /model을 통해), 상태 표시줄이 즉시 업데이트됩니다. 혼란을 방지할 수 있습니다.

이는 Pro 또는 Max 플랜을 공유하는 팀에게 특히 유용합니다. 만약 5h 80%가 보인다면, 초기화될 때까지 사용량을 조절하거나 더 저렴한 모델로 전환해야 함을 알 수 있습니다.

지금 바로 사용해 보세요 — 2분 만에 설정하기

1. 설치

npm i -g cc-context-telemetry

사용 중인 머신에 Node.js가 없나요? npm은 건너뛰세요. 저장소(repo)를 Git clone한 후, 아래 명령에서 bin/cct-statusline의 절대 경로를 사용하면 됩니다.

2. 설정

~/.claude/settings.json에 다음을 추가하세요:

{
  "statusLine": {
    "type": "command",
...

Claude Code를 재시작하세요. 텔레메트리(telemetry) 세그먼트가 표시될 것입니다.

3. 기존 상태 표시줄 감싸기 (Wrap)

이미 커스텀 상태 표시줄을 사용 중인가요? CCT_WRAP을 설정하세요:

{
  "statusLine": {
    "type": "command",
...

Claude Code 버전이 설정에서 env를 지원하지 않는 경우, 대신 셸 프로필(shell profile)에 CCT_WRAP을 export 하세요.

4. 세그먼트 커스텀

CCT_SEGMENTS를 사용하여 어떤 데이터를 어떤 순서로 표시할지 선택할 수 있습니다. 옵션:

• ctx — 컨텍스트 윈도우 (Context window) %
• 5h — 카운트다운이 포함된 5시간 속도 제한 (Rate-limit) %
• 7d — 카운트다운이 포함된 7일 속도 제한 (Rate-limit) %
• model — 현재 모델의 짧은 토큰

예시 — 속도 제한만 표시:

{
  "statusLine": {
    "type": "command",
...

또는 모델을 맨 앞으로 오도록 순서 변경:

{
  "statusLine": {
    "type": "command",
...

변경 사항은 새로운 세션에서만 적용됩니다.

5. 호스트 소유 상태 표시줄 (Host-Owned Status Lines)

다른 도구(예: 플러그인)가 상태 표시줄을 관리하는 경우, 해당 도구가 cct를 가리키도록 설정할 수 있습니다. 자세한 내용은 저장소의 examples/host-owned-statusline.md를 참조하세요.

Forward Signal

Claude Code가 (Claude Agent를 통한) 멀티 에이전트 워크플로(multi-agent workflows)와 함께 더 큰 프로젝트로 확장됨에 따라, 이러한 실시간 텔레메트리(telemetry)는 오케스트레이션(orchestration)을 위해 필수적이 됩니다. 컨텍스트(context)가 80%에 도달했을 때 세션을 자동으로 압축하거나, 속도 제한(rate limits)이 엄격할 때 작업을 다른 모델로 라우팅하는 에이전트를 상상해 보세요. 이 도구는 그러한 미래를 향한 첫 번째 단계이며, 무료이며, 오픈 소스(open-source)이고, 바로 오늘 사용할 수 있습니다.

출처: github.com

원문 게시지: gentic.news