CC-statusline
무엇인가
Claude Code의 statusLine 훅에 등록되어 터미널 하단 한 줄을 그리는 셸 스크립트다. 코딩 에이전트 세션의 상태를 별도 명령 없이 상시 노출하는 자리에 들어간다. Node 런타임이나 Nerd Font 없이 동작하는 것을 전제로 설계됐다.
어떻게 동작하나
Claude Code는 갱신마다 세션 정보를 JSON으로 만들어 statusline 명령의 표준 입력으로 넘긴다. 스크립트는 그 JSON을 jq로 파싱해 모델명, 컨텍스트 사용량, 비용, 추론 effort(`/effort`의 high·xhigh·max)와 확장 사고 여부를 뽑고, 공식 rate-limit API에서 5시간·7일 한도 막대를 가져온다. 렌더링 결과는 표준 출력으로 나가고 Claude Code가 그대로 화면에 붙인다. 설치기는 `~/.claude/awesome-statusline.sh`(macOS/Linux) 또는 `~/.claude/awesome-statusline.ps1`(Windows)을 쓰고, `~/.claude/settings.json`의 `statusLine` 항목이 그 경로를 가리키게 고친다. 수정 전 settings.json은 타임스탬프가 붙은 백업으로 남는다.
무엇과 다른가
같은 자리를 차지하는 다른 statusline 구현과 달리 Node를 요구하지 않고, Windows에서 Git Bash·jq·`.sh` 파일 연결에 의존하지 않는다. Windows 설치기는 네이티브 PowerShell 스크립트를 만들고 `powershell -NoProfile`로 실행하도록 등록한다. 아이콘도 Nerd Font 글리프 대신 표준 이모지와 유니코드 블록만 써서 폰트 설치 없이 터미널에 그대로 나온다. 색은 Catppuccin 팔레트를 따른다.
어떻게 쓰나
설치 스크립트를 실행하면 끝이고, 크기는 인자 하나로 정한다. `xs`/`xsmall`부터 `xl`/`xlarge`까지 다섯 단계가 있고 약어와 전체 이름을 모두 받는다. 크기를 바꾸려면 같은 설치기를 새 크기로 다시 돌린다. Claude Code 플러그인 마켓플레이스로도 배포되어 `/statusline-setup`(예: `/statusline-setup xl`)으로 적용할 수 있다. 제거는 `~/.claude/settings.json`에서 `statusLine` 항목을 지우고 스크립트 파일을 삭제하는 것이다.
전제와 한계
macOS와 Linux에서는 jq가 필요하며 없으면 설치기가 자동으로 깐다. Windows는 내장 PowerShell만 쓴다. `⚡effort` 필드는 현재 모델이 effort 파라미터를 노출할 때만 나타나고, 지원하지 않는 모델에서는 의도적으로 숨겨진다(Opus 4.x 등이 지원). tmux 안에서 문자가 세로로 쌓이면 `~/.tmux.conf`에 트루컬러를 켜야 한다. 스크립트는 갱신마다 도는 작은 로컬 프로세스다.