본문으로 건너뛰기

상태줄 커스터마이즈

중급

상태줄은 Claude Code가 세션에 관해 보여주는 지속적인 띠입니다. 이것을 커스터마이즈하면 신경 쓰는 사실들 — 어떤 모델인지, 어디에 있는지, 컨텍스트가 얼마나 남았는지, git 브랜치는 무엇인지 — 을 항상 시야에 둘 수 있습니다.

무엇을 드러낼 수 있는가​

  • 사용 중인 모델 (사소한 작업에 비싼 모델을 실수로 돌리지 않도록).
  • 현재 디렉터리 / 프로젝트.
  • 컨텍스트 예산 — 윈도우가 얼마나 찼는지, /compact 신호.
  • git 상태 — 브랜치, dirty/clean, 그리고 어느 워크트리에 있는지.

작동 방식​

상태줄을 스크립트(설정에서 구성, 설정 참고)로 가리키면, 그 스크립트가 세션 데이터를 받아 한 줄을 출력합니다. 그저 스크립트일 뿐이므로 계산할 수 있는 것은 무엇이든 보여줄 수 있습니다.

#!/usr/bin/env bash
# reads session JSON on stdin; prints a status line
input=$(cat)
model=$(echo "$input" | jq -r '.model.display_name // "claude"')
branch=$(git branch --show-current 2>/dev/null)
printf "%s · %s · %s" "$model" "$(basename "$PWD")" "${branch:-no-git}"

(정확한 입력 필드는 문서화되어 있습니다 — 특정 키에 의존하기 전에 확인하세요.)

스크립트를 짜고 싶지 않나요?​

커뮤니티 도구(예: ccstatusline)는 직접 작성하는 대신 그대로 넣을 수 있는, 구성 가능한 기성 상태줄을 제공합니다. 어떤 서드파티 스크립트든 신뢰하기 전에 검토할 코드로 취급하세요.

:::tip 가장 유용한 필드 대부분의 사람에게는 컨텍스트 예산 + 모델이 자리값을 합니다: 가장 흔한 두 가지 의외의 상황 — 작업 도중 컨텍스트가 바닥나는 것, 그리고 잘못된(더 비싼) 모델을 소모하는 것 — 을 막아줍니다. :::

다음​