ccstatusline-config/README.md
이재호_회원서비스개발팀 fb59b17031 네이티브 statusline 스크립트 및 자동 설치/업데이트 도구 추가
Claude Code 네이티브 statusLine 방식의 4줄 상태바 스크립트와
어느 머신에서든 한 줄로 설치·업데이트할 수 있는 스크립트 추가.
크로스플랫폼(Linux/macOS) stat 호환 처리 포함.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-21 00:26:02 +09:00

86 lines
2.5 KiB
Markdown

# 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: 클론 후 설치
```bash
git clone https://git.scrutineer.co.kr/zaksal58/ccstatusline-config.git
cd ccstatusline-config
./install.sh
```
### 방법 2: 원격 설치 (한 줄)
```bash
curl -sSL https://git.scrutineer.co.kr/zaksal58/ccstatusline-config/raw/branch/main/install.sh | bash
```
## 업데이트
```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`에 다음이 추가됩니다:
```json
{
"statusLine": {
"type": "command",
"command": "/home/<user>/.claude/statusline.sh",
"padding": 0
}
}
```
스크립트는 Claude Code에서 JSON을 stdin으로 받아 ANSI 색상이 적용된 4줄 상태바를 출력합니다.