Claude code 상태표시줄 설정

Claude Code의 Status Line(상태 표시줄) 기능이네요! 터미널 하단에 모델명, context 사용량, git 브랜치, 비용 등을 실시간으로 표시해주는 기능입니다.

설정 방법

방법 1: /statusline 명령어 (가장 쉬움)

Claude Code 세션 안에서 /statusline 명령을 입력하면 Claude가 자동으로 스크립트를 생성하고 설정까지 해줍니다. 원하는 항목을 직접 지시할 수도 있습니다:

/statusline 모델명, context 사용%, git 브랜치, 세션 비용을 표시하는 
글로벌 status line 설정해줘. ~/.claude/statusline.sh 파일로 만들어줘

---

방법 2: 수동 설정

1단계: jq 설치 (JSON 파싱용)

# macOS
brew install jq

# Ubuntu/WSL
sudo apt install jq

2단계: 스크립트 작성

~/.claude/statusline.sh 파일을 생성합니다:

#!/bin/bash
input=$(cat)

# 데이터 추출
MODEL=$(echo "$input" | jq -r '.model.display_name')
DIR=$(echo "$input" | jq -r '.workspace.current_dir' | xargs basename)
COST=$(echo "$input" | jq -r '.cost.total_cost_usd // 0')
CTX_PCT=$(echo "$input" | jq -r '.context_window.used_percentage // 0' | cut -d. -f1)

# Git 브랜치
BRANCH=""
if git rev-parse --git-dir > /dev/null 2>&1; then
  B=$(git branch --show-current 2>/dev/null)
  [ -n "$B" ] && BRANCH="$B"
fi

# ANSI 색상
RST="\033[0m"; BOLD="\033[1m"; DIM="\033[2m"
CYAN="\033[36m"; MAGENTA="\033[35m"; BLUE="\033[34m"
GREEN="\033[32m"; YELLOW="\033[33m"; RED="\033[31m"

# Context bar 색상 (사용량에 따라)
if [ "$CTX_PCT" -ge 90 ]; then BAR_COLOR="$RED"
elif [ "$CTX_PCT" -ge 70 ]; then BAR_COLOR="$YELLOW"
else BAR_COLOR="$GREEN"
fi

# Progress bar 생성
BAR_WIDTH=10
FILLED=$((CTX_PCT * BAR_WIDTH / 100))
EMPTY=$((BAR_WIDTH - FILLED))
BAR=""
[ "$FILLED" -gt 0 ] && printf -v FILL "%${FILLED}s" && BAR="${FILL// /▓}"
[ "$EMPTY" -gt 0 ] && printf -v PAD "%${EMPTY}s" && BAR="${BAR}${PAD// /░}"

# 출력
OUT="${BOLD}${CYAN}${DIR}${RST}"
[ -n "$BRANCH" ] && OUT+=" ${MAGENTA}  ${BRANCH}${RST}"
OUT+=" ${DIM}│${RST} ${BLUE}${MODEL}${RST}"
OUT+=" ${DIM}│${RST} ${DIM}\$${RST}${COST}"
OUT+=" ${DIM}│${RST} ${BAR_COLOR}${BAR}${RST} ${DIM}${CTX_PCT}%${RST}"
echo -e "$OUT"

3단계: 실행 권한 부여

chmod +x ~/.claude/statusline.sh

4단계: ~/.claude/settings.json에 등록

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh"
  }
}

---

방법 3: ccstatusline (고급 – 추천)

ccstatusline은 Powerline 스타일 렌더링, 테마, 다중 라인, 인터랙티브 TUI 설정 인터페이스 등을 지원하는 고도로 커스터마이즈 가능한 서드파티 statusline 도구입니다.

npx ccstatusline init

---

표시 가능한 주요 항목

항목 JSON 필드

모델명	.model.display_name
Context 사용%	.context_window.used_percentage
현재 디렉토리	.workspace.current_dir
세션 비용	.cost.total_cost_usd
Git 브랜치	(별도 git 명령으로 조회)

---

스크립트는 대화가 업데이트될 때마다 JSON 세션 데이터를 stdin으로 받아서 처리하고, stdout에 출력한 내용이 그대로 status bar에 표시됩니다. ANSI 색상 코드도 완전히 지원되므로 원하는 대로 색상 표현이 가능합니다.

가장 빠른 방법은 Claude Code 안에서 /statusline 명령으로 자동 생성하는 것이고, 세밀하게 커스터마이징하려면 위 스크립트를 직접 수정하시면 됩니다!

 

저는 이렇게 나오네요..(기본값)