왜 상태바를 바꾸는가
Claude Code의 기본 상태바는 필수 정보만 표시합니다. 장시간 작업에서는 토큰 사용량, 현재 모델, Git 브랜치 같은 정보를 한눈에 파악할 수 있어야 컨텍스트 전환 비용이 줄어듭니다.
ccstatusline은 이런 위젯을 인터랙티브하게 구성할 수 있는 독립 CLI 도구입니다.
설치 및 첫 설정
npx -y ccstatusline@latest실행하면 인터랙티브 TUI가 열립니다. 화살표 키로 항목을 이동하고 Enter로 선택, ESC로 빠져나옵니다.
설정을 저장하면 ccstatusline이 ~/.claude/settings.json의 statusLine 필드를 자동으로 갱신합니다. Claude Code 다음 세션부터 적용됩니다.
위젯 선택
상태바에 표시할 위젯을 선택할 수 있습니다.
- 모델 정보 — 현재 사용 중인 Claude 모델 (Opus 4.7, Sonnet 4.6 등)
- 토큰 사용량 — 5시간 사용 블록 소진 상태 실시간 표시
- Git 브랜치 — 현재 작업 중인 브랜치 이름
- 세션 타이머 — 현재 세션 경과 시간
- 메모리 사용량 — 시스템 메모리 상태
- 컨텍스트 사용량 — 현재 컨텍스트 윈도우 점유율
작업 성격에 맞는 위젯만 켜는 것을 권장합니다. 너무 많이 켜면 상태바가 좁은 터미널에서 잘릴 수 있습니다.
테마와 색상
내장된 Powerline 스타일 테마를 화살표 키로 미리보기하며 선택합니다. 각 위젯의 색상은 TUI 색상 설정에서 개별 조정할 수 있어, 사용 중인 터미널 테마와 조화시킬 수 있습니다.
설정 변경 시점
언제든 npx -y ccstatusline@latest를 다시 실행하면 기존 설정을 불러와 수정할 수 있습니다. 별도의 설정 파일을 직접 편집할 필요는 없습니다.
함께 쓰면 좋은 도구
- ccusage — 일/월 단위 토큰 사용량과 비용을 상세 분석. ccstatusline의 실시간 표시와 보완 관계.
자주 묻는 질문
ccstatusline은 무엇을 해주나요?
Claude Code의 터미널 상태바를 Powerline 스타일로 꾸미고, 사용 중인 모델·토큰 사용량·Git 브랜치 등 작업에 필요한 정보를 한 줄에 표시하는 독립 CLI 도구입니다.
어떻게 적용하나요?
`npx -y ccstatusline@latest`로 인터랙티브 TUI를 실행하여 테마와 위젯을 선택하고 저장하면, Claude Code의 statusLine에 자동으로 적용됩니다.
Claude Code 설정 파일을 직접 수정해야 하나요?
아니요. ccstatusline TUI가 `~/.claude/settings.json`의 `statusLine` 필드를 자동으로 갱신합니다.
토큰 사용량 위젯은 정확한가요?
Claude Code가 노출하는 정보를 그대로 표시하므로, 5시간 사용 블록 단위 표시는 정확합니다. 다만 정확한 일/월 단위 비용 분석은 ccusage 같은 별도 도구를 함께 쓰는 것을 권장합니다.
테마와 색상은 어떻게 조정하나요?
ccstatusline은 내장된 Powerline 테마를 제공하며, TUI의 색상 설정에서 위젯별로 색을 개별 조정할 수 있습니다.