Claude Code 상태 표시줄이 너무 멋져요: CC statusline으로 터미널을 즉시 아름답고 효율적으로

모델, Git, 컨텍스트, 비용을 실시간으로 표시하는 Claude Code 상태 표시줄, 제로 설정 TUI 사용 가이드.

기본 Claude Code 상태 표시줄은 잊어버리세요. CCstatusline이 터미널을 아름답고 유능하게 만들어주는 신비로운 도구입니다. 이 도구는 모델 정보, Git 브랜치, 토큰 사용량, 세션 비용, 타이머, Powerline 화살표를 모두 사용자 정의 상태 표시줄에 넣을 수 있으며, 전 과정이 그래픽으로 구성되어 있어 파일을 수정하지 않고도 가능합니다.

CCstatusline이란?

이것은 Claude Code를 위한 오픈 소스 npm 패키지로, 실시간 지표를 제공하는 구성 가능한 상태 표시줄을 지원하며, Powerline, 내장 TUI 구성, 여러 테마를 지원합니다.

시작 후 Live 미리보기를 볼 수 있습니다: Ctx: 18.6k | ⎇ main | (+42,-10) . 구성 후에는 더 화려하게 만들 수 있습니다.

무엇을 표시할 수 있나요

위젯(Widgets)을 자유롭게 조합할 수 있습니다: 모델 이름, 컨텍스트 길이, Git 브랜치/변경, 세션 시간, 5시간 블록 타이머, 세션 비용, 작업 디렉토리, 임의의 사용자 정의 텍스트 또는 명령 출력... 여러 개의 상태 표시줄을 각각 배치할 수도 있습니다.

전 과정 TUI 구성, 구성 파일 수정 불필요

npx ccstatusline@latest를 실행하면 인터랙티브 인터페이스로 들어갑니다. 일곱 개의 메뉴: 라인 편집, 색상 변경, Powerline 설정, 터미널 옵션, 전역 스타일, Claude Code에 설치, 저장 후 종료. 상단에서 변경 사항을 즉시 확인할 수 있습니다.

Powerline 활성화, 미적 가치가 즉시 상승

먼저 Powerline 메뉴에서 i를 눌러 Nerd Font를 설치한 후, t를 눌러 화살표 구분을 활성화합니다. Windows 사용자가 사각형을 보게 되면, Nerd Font를 설치하고 터미널 글꼴로 설정하면 됩니다.

빠른 설치 단계

• 터미널에서 실행:

npx ccstatusline@latest

또는 bunx ccstatusline@latest

• TUI에 들어가서 먼저 Powerline을 열고, 필요에 따라 위젯, 색상, 전역 스타일을 조정합니다.
• 「Install to Claude Code」를 선택하여 설정을 작성하고 저장 후 종료합니다.

구성 위젯 팁

• 「Edit Lines → Line 1」에 들어가서 ↑↓로 위젯을 선택하고, a로 추가, d로 삭제, ←→로 유형 전환, r로 원래 값 표시, m으로 병합합니다.
• 3개의 독립 상태 표시줄을 만들 수 있으며, 실시간 미리보기를 제공합니다.

추천하는 위젯: 모델, 블록 타이머, 세션 비용, Git 브랜치, 컨텍스트 길이.

색상 및 터미널 옵션

「Edit Colors」에서 ←→로 색상을 선택하고, f로 전경/배경, b로 굵게, a로 256색 전환, r로 초기화합니다. 「Terminal Options」에서 16색/256색/Truecolor를 선택할 수 있습니다.

Claude Code에 설치 및 실행 예제

저장 후 Claude Code를 열면 상태 표시줄이 즉시 적용되며, 테마는 Powerline 테마에서 전환할 수 있습니다.

TUI로 돌아가서 다시 수정

언제든지 npx ccstatusline@latest를 실행하여 계속 조정할 수 있습니다.

내가 좋아하는 위젯 조합

Git 브랜치 + 변경, 블록 타이머, 세션 비용, 컨텍스트 길이, 작업 디렉토리, 현재 모델.

블록 타이머

Claude Code는 5시간마다 세션 블록을 생성하며, 이 타이머는 남은 시간을 항상 알 수 있도록 도와줍니다; p를 눌러 진행률 표시줄 모드로 전환할 수 있습니다.

세션 비용

실시간으로 비용을 표시하며, r을 눌러 태그를 닫고 숫자만 볼 수 있습니다. Claude Code 1.0.85+가 필요합니다.

Git 브랜치 및 변경

브랜치는 항상 표시되며, 변경된 행 수가 명확하게 보이며, git worktree 위젯도 선택할 수 있습니다.

컨텍스트 길이

실시간 토큰 수를 계산하여 긴 세션에서 초과를 방지합니다.

사용자 정의 명령

모든 shell 명령을 실행하고 출력을 상태 표시줄에 넣을 수 있으며, 네트워크 명령은 5000ms 이상의 타임아웃을 설정해야 합니다. 예시:

date +%H:%M node -v git rev-parse --short HEAD curl -s wttr.in?format="%t" npx -y ccusage@latest statusline

요약 및 주의 사항

• Powerline 화살표는 Nerd Font가 필요합니다.
• 세션 비용은 Claude Code 1.0.85+가 필요하며, /resume 시 업데이트되지 않을 수 있습니다.
• 구성을 변경하고 싶다면 언제든지 npx ccstatusline@latest를 실행하세요.