sirmalloc/ccstatusline

🚀 Beautiful highly customizable statusline for Claude Code CLI with powerline support, themes, and more.

ccstatusline 는 무엇인가요?

ccstatusline 는 Node.js 패키지 로, Claude Code 명령줄 인터페이스(Anthropic의 Claude 모델 공식 CLI)에 매우 사용자 정의 가능한 상태줄을 추가합니다. Claude Code에서 현재 모델, 토큰 사용량, Git 정보, 사전 환경 상태 등 다양한 데이터를 읽어와, 터미널 하단에 색다르고 설정 가능한 줄로 렌더링합니다.

왜 사용해야 할까요?

실시간 AI 세션 메트릭 – 터미널을 벗어나지 않고도 사용한 토큰 수, 남은 컨텍스트, 주간 사용량을 확인할 수 있습니다.
Git 통합 – 브랜치 이름, PR/MR 링크, 파일 상태 카운트, CI 상태가 AI 정보와 함께 표시됩니다.
높은 조정 가능성 – 표시할 위젯, 순서, 색상, 그라데이션, Powerline 구분자, 심지어 최소 모드의 순수 값까지 선택 가능합니다.
크로스 플랫폼 – macOS, Linux, Windows에서 작동(특수 처리로 보조 창 숨김).
설정 내보내기 가능 – JSON으로 설정을 저장하거나 불러올 수 있어, 여러 기기 간 레이아웃 공유가 쉬워집니다.

핵심 기능 (README에 설명됨)

카테고리	위젯 / 기능
모델 및 사용량	모델 이름, 입력/출력 토큰, 총 토큰 수, 사용 비율, 주간 사용량, 추가 사용(과금제) 위젯, 컨텍스트 창 크기, 압축 카운터, 캐시 히트/읽기/쓰기 비율.
Git 및 CI	브랜치 이름, 루트 디렉터리, PR/MR 링크(GitHub 및 GitLab), 상태(앞서거나 뒤처짐, 충돌, 스테이징/미스테이징/추적되지 않은 파일), CI 체크 요약, 클릭 가능한 링크, 너비 제한 및 생략 표시.
환경	현재 작업 디렉터리(옵션의 기호 포함), 사전 환경 상태, 음성 입력 상태, Claude 계정 이메일, 세션 이름, 메모리 사용량, 터미널 너비 오버라이드.
시각적 요소	Powerline 및 유연한 구분자, 위젯별 또는 전체 줄의 색상 그라데이션, 사용자 정의 기호, 어두운 스타일, 최소 모드 순수 값 모드, 그라데이션 프리셋, 사용자 정의 유니코드 구분자.
제어	위젯 추가/재정렬/복제/삭제 가능한 TUI 에디터, 퍼지 위젯 선택기, 색상 선택기, 설정 내보내기/가져오기, 버전 플래그(`ccstatusline --version`).
성능	디스크 캐시를 사용한 비차단 Git/CI 갱신, 오래된 데이터의 백그라운드 갱신, 캐시된 블록 타이머 메트릭, 설정 가능한 캐시 TTL, 잘못된 `settings.json` 안전 처리.
플랫폼 편의성	Windows UTF-8 처리, 숨겨진 보조 프로세스, 사용량 API용 환경 변수 프록시 지원, 고정된 글로벌 설치 안전 처리.

시작하기 (빠른 시작)

설치 – npm i -g ccstatusline (Bun 사용 가능). 지원되는 플랫폼용 사전 빌드된 바이너리가 포함되어 있습니다.
실행 – 설치 후 Claude Code CLI를 시작하면 상태줄이 자동으로 표시됩니다. ccstatusline을 직접 실행해 설정을 미리 볼 수도 있습니다.
설정 – TUI에서 e를 눌러 에디터를 열고 위젯 추가/제거, 색상 변경, Powerline 모드 전환 등을 할 수 있습니다. 설정은 ~/.config/ccstatusline/settings.json (또는 --config로 커스텀 경로 지정)에 저장됩니다.
내보내기/가져오기 – v2.2.27 이상의 Config import/export 위젯을 사용해 현재 레이아웃을 JSON으로 덤프하고, 편집한 후 다시 가져올 수 있습니다.

누가 유지보수하고 있나요?

리포지토리는 sirmalloc이 소유하며, 빈번한 릴리스, 커밋 활동 그래프, "Maintained? yes" 배지로 활발한 유지보수가 확인됩니다. 또한 Awesome Claude Code 컬렉션에 포함되어 있으며, ClaudeLog 지식 기반에서 참조되고 있습니다.

라이선스

MIT – 코드를 자유롭게 사용, 수정, 재배포할 수 있습니다.

TL;DR

ccstatusline은 Claude Code CLI를 대시보드로 바꾸는 터미널 UI 애드온으로, 모델 사용량, Git 컨텍스트, CI 상태, 기타 여러 메트릭을 JSON 기반 TUI를 통해 매우 유연하게 구성할 수 있습니다. 터미널에서 Claude를 사용하는 개발자를 위한 진정한, 활발히 유지보수되는 오픈소스 도구입니다.