ccstatusline-config

Claude Code 커스텀 statusline 중앙 관리 저장소.

여러 머신에서 동일한 statusline을 사용하기 위한 설정과 설치 스크립트.

상태바 레이아웃

🎨 Explanatory │ 🖥️ odroidhc4 │ 🧠 [░░░░░░░░░░░░] 0% │ 💰 $0.00        0 tokens
🤖 ◆ Opus 4.6 │ 🔑 e6271b19 │ 📟 v2.1.49
📁 /home/user │ 🌿 main │ 📊 ▲+0 ▼-0 │ ⏱️ 9s
⏵⏵ Explanatory

표시 항목

라인	항목
1	Output Style, 호스트명, 컨텍스트 사용률 (색상 변화), 비용, 토큰 수
2	모델 (티어별 심볼: ◆Opus/◇Sonnet/○Haiku), 세션 ID, 버전
3	작업 디렉토리, Git 브랜치, 추가/삭제 라인 수, 경과 시간
4	현재 모드, Vim 모드 (사용 시), 에이전트 이름 (팀 모드 시)

설치

방법 1: 클론 후 설치

git clone https://git.scrutineer.co.kr/zaksal58/ccstatusline-config.git
cd ccstatusline-config
./install.sh

방법 2: 원격 설치 (한 줄)

curl -sSL https://git.scrutineer.co.kr/zaksal58/ccstatusline-config/raw/branch/main/install.sh | bash

업데이트

# 방법 1: 클론된 디렉토리에서
cd ccstatusline-config && git pull && ./install.sh

# 방법 2: 원격 업데이트 (한 줄)
curl -sSL https://git.scrutineer.co.kr/zaksal58/ccstatusline-config/raw/branch/main/update.sh | bash

구조

statusline.sh          -- 메인 statusline 스크립트 (Claude Code 네이티브)
install.sh             -- 자동 설치 스크립트
update.sh              -- 원격 업데이트 스크립트
ccstatusline/          -- (레거시) ccstatusline npm 패키지용 설정
  settings.json        -- 위젯 배치/색상 설정
scripts/               -- (레거시) ccstatusline 커스텀 커맨드 스크립트
  ctx-bar.sh           -- 컨텍스트 사용량 progress bar
  ctx-debug.sh         -- 디버그용 raw 데이터 출력

요구사항

• jq (JSON 파싱에 필요)
• git (설치/업데이트에 필요)
• Claude Code v1.0+

동작 방식

Claude Code의 네이티브 statusLine 설정을 사용합니다. ~/.claude/settings.json에 다음이 추가됩니다:

{
  "statusLine": {
    "type": "command",
    "command": "/home/<user>/.claude/statusline.sh",
    "padding": 0
  }
}

스크립트는 Claude Code에서 JSON을 stdin으로 받아 ANSI 색상이 적용된 4줄 상태바를 출력합니다.