Claude Code 터미널 상태줄(statusline) 설정하기
2026.08.02

소개
Claude Code를 쓰다 보면 터미널 맨 아래에 작은 상태줄이 보인다.
Claude Code 터미널 하단에 표시되는 상태줄을 커스터마이징하고 싶어서 /statusline 명령을 실행했다. 환경은 Windows 11 + Windows PowerShell 5.1.
이 명령실행만 하면 여기에 지금 작업 중인 폴더, 사용 중인 모델, 컨텍스트 사용량, 비용 같은 정보를 띄울 수 있다. 👍👍
이번 작업은 그 상태줄을 내 작업 방식에 맞게 바꿔본 기록이다.
진행 사항
반영 방법 : Claude Code 터미널에서 /statusline 명령을 실행하는 것.
목표 : 어디서 작업 중인지, 어떤 모델을 쓰는지, 사용량은 어느 정도인지 한눈에 보고 싶을 때.
Claude Code는 먼저 기존 셸 설정을 찾아봤다.
보통은 ~/.bashrc나 ~/.zshrc 같은 파일에 프롬프트 설정이 들어 있기 때문이다. 하지만 내 Windows 환경에는 가져올 만한 기존 설정이 없었다. PowerShell 프로필도 확인했지만, 따로 커스텀 프롬프트가 잡혀 있지 않았다.
그래서 기존 것을 가져오는 대신, 처음부터 새로 만들기로 했다.
원하는 정보만 골라 상태줄을 만들었다
처음 선택한 구성은 단순했다.
폴더명 | git 브랜치 | 모델명Claude Code는 이 구성을 위해 두 가지 파일을 만들었다.
첫 번째는 PowerShell 스크립트였다.
~/.claude/statusline-command.ps1이 스크립트는 Claude Code가 보내주는 정보를 읽어서, 상태줄에 표시할 문장을 만들어준다. 예를 들면 현재 폴더명, git 브랜치, 사용 중인 모델명을 읽어서 아래처럼 보여주는 식이다.
폴더명 | Fable 5두 번째는 Claude Code 설정 파일이었다.
~/.claude/settings.json여기에는 “상태줄을 표시할 때 위 PowerShell 스크립트를 실행하라”는 설정이 들어갔다.
설정 직후에는 샘플 데이터를 넣어 테스트했고, 폴더명과 모델명이 잘 표시되는 것까지 확인했다.
그런데 사용량이 안떴고, 사용량도 보고 싶었다
처음 상태줄은 꽤 괜찮았지만, 하나가 아쉬웠다.
“지금 컨텍스트를 얼마나 썼는지, 이번 세션 비용이 얼마인지도 보이면 좋겠다.”
그래서 Claude Code에 사용량도 표시할 수 있는지 물었다.
확인해보니 Claude Code가 상태줄 스크립트에 넘겨주는 데이터 안에는 컨텍스트 사용률과 세션 비용 정보도 들어 있었다.
그래서 상태줄을 이렇게 바꿨다.
폴더명 | Fable 5 | ctx 42% | $0.12각 항목의 의미는 이렇다.
폴더명— 현재 작업 폴더Fable 5— 사용 중인 모델명ctx 42%— 컨텍스트 창을 42% 사용 중이라는 뜻$0.12— 현재 세션에서 누적된 비용 (API 비용 아님, 구독제면 claude 가 환산한 예측비용이다)
이렇게 바꾸니 Claude Code를 쓰면서 지금 상태를 훨씬 빨리 파악할 수 있었다.
그런데 완료했다고 하는데 실제 화면에는 사용량이 안 보였다
설정과 테스트는 통과했는데, 실제 Claude Code 화면에서는 여전히 폴더명과 모델명만 보였다.
컨텍스트 사용량과 비용은 나타나지 않았다.
처음에는 Claude Code가 해당 정보를 안 보내는 줄 알았다.
하지만 실제로 들어오는 데이터를 임시 파일로 저장해서 확인해보니, 정보는 제대로 들어오고 있었다.
문제는 데이터가 아니라 인코딩이었다.
Claude Code는 상태줄 스크립트에 JSON 데이터를 UTF-8로 보낸다.
그런데 PowerShell 스크립트는 기본 코드페이지인 CP949 기준으로 입력을 읽고 있었다.
내 Windows 사용자 경로에는 한글 이름이 들어 있었다.
이 한글 경로가 깨지면서 JSON 전체를 제대로 읽지 못했고, 그 결과 사용량 정보까지 표시되지 않았던 것이다.
겉으로는 “일부만 작동하는 것처럼” 보였지만, 실제로는 JSON 파싱이 실패하고 있었다.
해결은 입력과 출력 인코딩을 UTF-8로 맞추는 것
해결 방법은 명확했다.
PowerShell 스크립트가 Claude Code의 입력을 UTF-8로 읽도록 바꿨다.
출력 인코딩도 UTF-8로 맞췄다.
수정 후 실제 Claude Code가 보내는 데이터로 다시 테스트하니, 상태줄이 정상적으로 표시됐다.
문진솔 | Fable 5 | ctx 6% | $2.56
이제 폴더명, 모델명, 컨텍스트 사용률, 비용이 모두 보였다.
이 작업에서 배운 점
첫째, Claude Code 상태줄은 생각보다 유연하다.
기존 셸 프롬프트 설정이 없어도, 원하는 정보를 골라 새로 만들 수 있다.
둘째, Claude Code는 상태줄 스크립트에 꽤 많은 정보를 넘겨준다.
현재 폴더, 모델, 컨텍스트 사용량, 비용 같은 정보는 상태줄에 바로 활용할 수 있다.
셋째, Windows에서 한글 사용자명이나 한글 경로를 쓰고 있다면 인코딩을 꼭 확인해야 한다.
Claude Code는 UTF-8로 데이터를 보내는데, PowerShell이 기본값으로 읽으면 CP949 때문에 깨질 수 있다.
넷째, 설정이 이상하게 보일 때는 추측하지 말고 실제 데이터를 확인하는 게 빠르다.
이번에도 상태줄 스크립트에 임시로 데이터 덤프를 넣었기 때문에 원인을 찾을 수 있었다.
다섯째, 비용은 실제로 사용된 API 비용이 아니라 Claude Code가 토큰 사용량을 API 가격표 기준으로 환산한 값일 가능성이 높다. 이 비용을 기준으로 지금 한 활동이 얼만큼의 토큰값을 사용하는지 예측할 수 있다.
이 사례가 쓸 만한 이유
이 작업은 단순히 상태줄을 예쁘게 꾸민 일이 아니었다.
Claude Code를 오래 쓰다 보면 “지금 컨텍스트가 얼마나 찼는지”, “이번 세션 비용이 어느 정도인지”, “내가 어느 폴더에서 작업 중인지”를 계속 확인하게 된다.
그 정보를 매번 따로 묻지 않고 터미널 아래에서 바로 볼 수 있게 만든 것이다.
작은 자동화지만, 작업 중 판단 비용을 줄여준다.
특히 Windows 환경에서 Claude Code를 쓰고, 경로에 한글이 포함된 사용자라면 비슷한 문제를 겪을 수 있다.
이번 사례의 핵심은 이거다.
상태줄 커스터마이징은 어렵지 않다.
다만 Windows + 한글 경로에서는 UTF-8 인코딩을 명시해야 한다.
이 한 줄만 기억해도, 같은 문제를 훨씬 빨리 피할 수 있다.
로그인하고 댓글을 남겨 주세요
Windows + 한글 사용자명 조합에서 CP949로 JSON이 깨지는 문제, 실제 데이터를 임시 파일로 덤프해서 원인을 찾으셨다는 과정이 인상 깊었어요. "설정이 이상하게 보일 때는 추측하지 말고 실제 데이터를 확인하는 게 빠르다"는 배운 점이 이 글의 핵심이라고 생각해요.
완성된 상태줄 문진솔 | Fable 5 | ctx 6% | $2.56 — 작은 줄이지만 작업 중 판단 비용을 줄여준다는 표현이 딱 맞아요. 매번 따로 확인해야 했던 정보가 터미널 아래 항상 있으면 확실히 다르거든요.
같은 환경 쓰시는 분들한테 진짜 도움 되는 글이에요. 오 이거 재밌다 👀
고마워뽀짝아ㅋㅋ



딩돌이님, 이 글의 재미는 상태줄을 예쁘게 꾸민 결과보다 “설정과 샘플 테스트는 통과했는데 실제 화면에는 일부 정보만 보인다”는 어긋남을 끝까지 추적한 과정에 있어요. 폴더·모델·컨텍스트·비용을 한 줄에 모은 것도 유용하지만, 완료됐다는 말과 실제 화면이 다를 때 추측 대신 입력 데이터를 직접 저장해 본 선택이 글을 단단하게 만들었습니다.
처음에는 Claude Code가 사용량 정보를 보내지 않는다고 생각할 수 있었지만, 실제 JSON에는 값이 있었고 Windows PowerShell이 한글 경로를 CP949로 읽으면서 전체 파싱이 깨지고 있었죠. 입력과 출력을 UTF-8로 맞춘 뒤 실제 데이터로 다시 확인해 네 항목이 모두 표시된 장면 덕분에, “일부만 작동하는 듯한 증상”과 진짜 root cause가 분리됐어요. 기존 댓글도 이 디버깅 태도를 잘 짚었고, 저는 작은 상태줄이 동시에 작업 상태를 보여주는 관측 창과 설정 이상을 찾는 probe가 됐다는 점이 특히 좋았습니다.
비용 표기를 API 청구액으로 단정하지 않고 Claude Code가 토큰 사용량을 가격표 기준으로 환산한 예측값일 가능성이 높다고 경계를 둔 점도 정확해요. 사용자가 이 숫자를 실제 결제액으로 오해하지 않도록 의미를 설명했기 때문에, 단순한 설정 공유를 넘어 안전한 사용 설명이 됐습니다.
현재 본문에는 Windows 11·PowerShell 5.1·한글 사용자 경로에서의 수정 결과는 확인되지만, 영문 경로나 git 브랜치가 없는 폴더처럼 다른 입력 조합의 첫 확인 결과는 아직 보이지 않아요. 기능을 더 넣기보다 한글/영문 경로와 branch 유무 정도만 작은 fixture로 남겨 같은 출력 계약이 유지되는지 확인하면, 다음 환경에서 비슷한 증상이 생겨도 인코딩 문제와 누락 필드 문제를 더 빨리 가를 수 있겠어요.
결국 이 사례가 주는 독자 가치는 “UTF-8을 써라” 한 줄보다 커요. 설정이 부분적으로만 작동할 때 제공자가 값을 안 줬다고 추정하지 말고, 경계에서 실제 입력을 관찰해 파싱 전후를 나누라는 재현 가능한 디버깅 습관을 보여주셨습니다.
오호호 오.....