Repolode
sirmalloc

sirmalloc/ccstatusline

모델, git 브랜치, 토큰 사용량과 사용 한도 등을 표시하고 Powerline과 테마를 지원하는 Claude Code CLI용 커스텀 상태 표시줄입니다.

스타
13,335
포크
667
열린 이슈
173
마지막 커밋
10시간 전

어떤 프로젝트인가요?

ccstatusline은 Anthropic의 터미널 코딩 에이전트인 Claude Code용 상태 표시줄 포매터입니다. Claude Code 인터페이스 하단에 설정 가능한 바를 표시해 모델 이름, git 브랜치와 상태, 토큰 수와 속도, 세션 비용과 시간, 컨텍스트 사용량, Claude 사용 한도 등을 보여 줍니다. 각 항목은 위젯으로 구성되며, React와 Ink로 만든 대화형 터미널 UI에서 위젯을 추가하거나 순서를 바꾸고, 색상을 지정하거나 숨길 수 있습니다.

화살표 구분자, 캡, 플렉스 정렬을 사용하는 기본 및 Powerline 스타일 레이아웃을 지원하며, 기본 제공 테마와 위젯별 또는 줄 전체 그라데이션 색상도 사용할 수 있습니다. 여러 개의 독립적인 상태 표시줄을 지원하며, 설정을 JSON으로 내보내고 미리 보기 후 가져올 수 있습니다. 설정은 사용자의 config 디렉터리에 있는 설정 파일에 저장되며, 환경 변수로 Claude Code 설정 경로를 변경할 수 있습니다.

전역 설치 없이 npx 또는 bunx로 실행할 수 있으며, 특정 버전을 고정해 사용할 수도 있습니다. Linux, macOS, Windows에서 작동하며 Node.js와 Bun 모두에서 실행할 수 있습니다.

핵심 기능

  • 01Claude Code 상태 표시줄에 모델, git, 토큰, 비용, 컨텍스트, 사용 한도 위젯을 표시합니다.
  • 02위젯을 추가하고 순서를 바꾸거나 색상을 지정할 수 있는 대화형 터미널 UI를 제공합니다.
  • 03화살표 구분자, 캡, 플렉스 정렬을 사용하는 Powerline 스타일 렌더링을 지원합니다.
  • 04기본 제공 테마와 그라데이션 색상을 적용해 여러 개의 독립적인 상태 표시줄을 사용할 수 있습니다.
  • 05설정을 JSON으로 내보내고 가져올 수 있으며, 교체하거나 병합하기 전에 미리 볼 수 있습니다.
  • 06npx 또는 bunx로 실행하며, 원하는 경우 특정 버전으로 고정해 전역 설치할 수 있습니다.

활용 사례

  • Claude Code로 코딩하는 동안 git 브랜치, PR 상태, 변경된 파일 수를 계속 확인합니다.
  • 긴 에이전트 세션 중 토큰 사용량, 세션 비용, 주간 사용 한도를 추적합니다.
  • 내보낸 JSON을 사용해 여러 머신에서 일관된 상태 표시줄 설정을 공유합니다.

사용 전 알아둘 점

  • Claude Code CLI용으로 제작되어 해당 도구 내의 상태 표시줄로만 작동합니다.
  • Git PR 및 CI 상태와 같은 일부 위젯은 GitHub CLI(gh)에 의존하며, 캐시된 데이터가 없으면 느리게 작동할 수 있습니다.
  • Usage 위젯과 Claude Status 위젯은 외부 서비스에 네트워크 요청을 보냅니다.

토픽

자주 묻는 질문

ccstatusline은(는) 무엇인가요?
모델, git 브랜치, 토큰 사용량과 사용 한도 등을 표시하고 Powerline과 테마를 지원하는 Claude Code CLI용 커스텀 상태 표시줄입니다. ccstatusline은 Anthropic의 터미널 코딩 에이전트인 Claude Code용 상태 표시줄 포매터입니다. Claude Code 인터페이스 하단에 설정 가능한 바를 표시해 모델 이름, git 브랜치와 상태, 토큰 수와 속도, 세션 비용과 시간, 컨텍스트 사용량, Claude 사용 한도 등을 보여 줍니다. 각 항목은 위젯으로 구성되며, React와 Ink로 만든 대화형 터미널 UI에서 위젯을 추가하거나 순서를 바꾸고, 색상을 지정하거나 숨길 수 있습니다.
ccstatusline은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
ccstatusline은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
ccstatusline은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. ccstatusline의 마지막 커밋은 2026년 10월 19일입니다.
ccstatusline은(는) 어디에 사용할 수 있나요?
Claude Code로 코딩하는 동안 git 브랜치, PR 상태, 변경된 파일 수를 계속 확인합니다. 긴 에이전트 세션 중 토큰 사용량, 세션 비용, 주간 사용 한도를 추적합니다. 내보낸 JSON을 사용해 여러 머신에서 일관된 상태 표시줄 설정을 공유합니다.
ccstatusline은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/sirmalloc/ccstatusline

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트