Owloops/claude-powerline

Claude Powerline – Claude Code용 상태줄

무엇인가요

• Node 기반 플러그인으로, Anthropic의 Claude 모델용 데스크톱 UI인 Claude Code에 Vim 스타일의 "powerline" 상태줄을 추가합니다.
• 상태줄은 에디터 하단에 위치하며 현재 Claude 세션, Git 리포지토리, 파일 시스템, 사용 관련 메트릭(토큰, 비용, 레이트 제한 창 등)에 대한 실시간 정보를 표시합니다.

왜 중요한가요

• Claude Code는 이미 모델 이름, 컨텍스트 창, 레이트 제한 데이터 등 많은 텔레메트리 정보를 제공합니다. Powerline은 이러한 데이터를 컴팩트하고 항상 보이는 요약으로 전환하여, 개발자가 별도 패널을 열지 않고도 토큰 소비, 일일/월간 예산, Git 상태를 파악할 수 있도록 도와줍니다.
• 이 도구는 완전히 사용자 정의 가능합니다. 표시할 세그먼트를 선택하고, 시각 스타일(클래식 powerline, 캡슐, 미니멀, 또는 전체 화면 TUI), 테마를 전환할 수 있으며, 사용자 정의 JSON 설정도 정의할 수 있습니다.

주요 기능 (README에 기술됨)

기능	제공되는 기능
실시간 사용 추적	사용된 토큰 수, 추정 비용, 일일/월간 합계, 시각적 "예산" 인디케이터 표시.
Git 통합	브랜치 이름, SHA, ahead/behind 화살표, 스태시 수, 워크트리 마커.
모델 및 세션 정보	현재 Claude 모델, 세션 ID, 선택적 확장 사고 상태.
컨텍스트 창 시각화기	모델의 컨텍스트 창 사용률(백분율), 여러 바 스타일(텍스트, 블록, 점 등).
레이트 제한 창	Claude의 5시간 "블록" 및 7일 "주간" 활용도를 표시하며, 선택적으로 페이스 비교도 가능.
메트릭	API 응답 시간, 전체 세션 기간, 메시지 수, 추가/삭제된 줄 수.
Tmux 인식	Claude Code를 tmux 내에서 실행할 경우 tmux 세션 이름을 표시.
테마 및 스타일	6개의 내장 테마(다크, 라이트, nord, tokyo-night, rose-pine, gruvbox)와 4가지 시각 스타일; 사용자 정의 테마도 생성 가능.
런타임 의존성 없음	npm 패키지는 단일 스크립트로 배포되며, npx를 통해 자동으로 업데이트를 가져옵니다.
설정	변경 시 리로드되는 JSON 설정 파일(프로젝트 로컬, 사용자 수준, XDG); CLI 플래그와 환경 변수로 오버라이드 가능.
Powerline Studio	드래그 앤 드롭으로 세그먼트를 배치하고 스타일을 미리 보며, 생성된 JSON 설정을 내보낼 수 있는 웹 UI (powerline.owloops.com).

설치 방법

1. 사전 요구 사항 – Node 18+, Claude Code, Git 2.0+, 최상의 유니코드 기호를 위해 Nerd Font.
2. 설치 – Claude Code 내부의 마켓플레이스 위저드(/plugin marketplace add Owloops/claude-powerline … /powerline)를 실행하거나, settings.json에 npx @owloops/claude-powerline를 호출하는 명령어 항목을 추가.
3. 설정 – 다시 /powerline을 실행하여 위저드를 재오픈하거나, 생성된 ~/.claude/claude-powerline.json을 수동으로 편집. 온라인 Powerline Studio를 사용하여 설정을 만들고 복사해도 됩니다.

일반적인 사용 사례 Claude Code를 사용하는 개발자가 프로젝트에서 소비하는 토큰 수를 파악하고 싶을 때, Session 및 Today 세그먼트를 활성화하면 상태줄에 § 4.4M tokens $12.34 (79%)와 같은 표시가 나타나며 각 턴마다 업데이트됩니다. 동시에 Git 세그먼트는 현재 브랜치와 ahead/behind 상태를 항상 표시하므로, 코드와 AI 보조 작업을 반복할 때도 맥락을 잃지 않습니다.

누구에게 유용할까

• 코드 생성, 디버깅, 문서화에 Claude Code를 사용하면서 토큰 사용량을 모니터링하고 예산 내에서 작업해야 하는 사람.
• 팀원 간에 Git 상태와 AI 보조 작업에 대한 일관된 시각적 신호를 원하는 팀.
• Vim/Neovim의 powerline 플러그인처럼 고도로 사용자 정의 가능한 상태줄을 GUI 에디터에서 원하는 파워 유저.

---

위의 모든 세부 정보는 프로젝트의 README에서 직접 인용되었으며, 추가 기능은 추측되지 않았습니다.