[Claude Code] 클로드 코드 상태 표시줄(스테이터스 라인)이란? +설정방법

클로드 코드로 작업을 하다 보면 지금 어떤 모델을 쓰고 있는지, 컨텍스트가 얼마나 찼는지, 비용은 얼마나 나가고 있는지 궁금해질 때가 많습니다. 매번 별도로 확인하기는 번거롭고, 그렇다고 신경 쓰지 않으면 예상치 못한 지점에서 컨텍스트가 가득 차거나 비용이 예상보다 많이 나가는 상황을 마주하게 됩니다.

 

이럴 때 유용한 기능이 바로 스테이터스 라인입니다 스테이터스 라인은 프롬프트 하단에 표시되는 상태 표시줄로써 이 기능을 설정하면 현재 사용 중인 모델명, 작업 중인 디렉터리, 컨텍스트 사용량 등 원하는 정보를 프롬프트 하단에서 실시간으로 확인할 수 있습니다. 설정 방법도 어렵지 않아서 명령어 한 줄이면 충분합니다. 이번 포스팅에서는 스테이터스 라인을 설정하고 활용하는 방법을 정리해 보겠습니다.

 

스테이터스 라인 설정 방법

사용법은 매우 간단합니다. /statusline 명령어를 입력하고 엔터를 누르면 됩니다. 그러면 "스테이터스 라인 셋업"이라는 표시가 활성화되면서 설치가 진행되는 것을 확인할 수 있습니다. 이 표시는 서브 에이전트가 백그라운드에서 작업을 진행하고 있다는 의미입니다.

 

여기서 많은 분들이 오해하는 부분이 있습니다. 스테이터스 라인을 설정하면 모델명, 디렉터리, 컨텍스트 사용량 같은 항목이 항상 정해진 형태로 나온다고 생각하기 쉽지만 그런건 아닙니다. 서브 에이전트가 수행하는 작업 역시 결국 하나의 프롬프트 실행이기 때문에, 동일한 명령어를 입력하더라도 매번 똑같은 결과로 설정되지는 않습니다. 때로는 설정에 실패하여 몇 차례 재시도가 필요한 경우도 있습니다.

 

스테이터스 라인 커스터마이징

기본적으로 /statusline 명령어만 입력해도 스테이터스 라인이 설정되지만, 원하는 형태로 꾸미고 싶다면 명령어 뒤에 자연어로 원하는 디자인을 구체적으로 설명해 주면 됩니다.

/statusline 모델명을 대괄호로 표시하고, 폴더 아이콘과 현재 디렉터리 이름, 
git 브랜치를 잎사귀 아이콘과 함께 보여줘. 그 아래 줄에는 컨텍스트 사용량을 
초록색 막대그래프로, 남은 부분은 점무늬로 표시하고, 퍼센트, 세션 비용(노란색), 
경과 시간을 순서대로 보여줘

이처럼 클로드에게 자연어로 원하는 디자인을 자세히 설명하면 statusline-setup 서브 에이전트가 이를 반영한 스크립트를 생성해 줍니다. 표시 순서, 색상, 아이콘 등을 구체적으로 적을수록 원하는 결과에 더 가까운 스테이터스 라인을 얻을 수 있습니다.

 

설정 후 재실행 확인

설정이 완료된 후 클로드 코드를 종료하고 다시 실행하면 현재 디렉터리가 상태 표시줄에 표시되는 것을 확인할 수 있습니다. 이후 스테이터스 라인 명령을 다시 실행하여 모델명, 컨텍스트 사용량, 비용까지 화면에 표시해 달라고 요청하면 해당 정보들이 상태 표시줄에 정상적으로 출력됩니다.

 

표시 가능한 항목 확인하기

https://code.claude.com/docs/en/statusline

Customize your status line - Claude Code Docs

위의 공식 문서(영문) 링크에서는 스테이터스 라인에 표시할 수 있는 항목들을 표로 상세히 정리해 두었습니다. 클로드 코드의 스펙이 업데이트되면서 표시 가능한 필드도 계속 늘어나고 있으므로, 강의를 수강하는 시점에 맞춰 어떤 항목을 표시할 수 있는지 직접 확인해 보는 것이 좋을 것 같습니다. 해당 내용은 영문 공식 문서에서만 확인할 수 있습니다.

 

윈도우 환경에서 설치가 안 될 때

윈도우 환경에서는 스테이터스 라인 설치가 원활하지 않은 이슈가 종종 발생합니다. 이럴 때 단순히 "설치가 안 되니까 해결해 줘"라는 요청만 반복하면 효과가 없을 수 있습니다. 이런 경우에는 자신의 환경 정보를 정확하게 전달하는 것이 중요합니다.

 

예를 들어 스테이터스 라인 설정 중이라는 점과 윈도우 환경이라는 점을 함께 알려주어야 합니다. 또한 스테이터스 라인이 데이터를 올바르게 읽기 위해서는 JQ라는 데이터 처리 도구가 있으면 매우 유용합니다. 이처럼 운영체제 정보부터 JQ 도구의 설치 여부까지 다양한 환경 정보를 함께 제공하면 문제를 훨씬 효과적으로 해결할 수 있습니다.

 

실제 설정 파일 확인하기

스테이터스 라인을 설정하면 기본적으로 사용자 홈 디렉터리 아래의 .claude 디렉터리에 관련 설정이 저장됩니다. 해당 디렉터리로 이동하여 ls 명령으로 확인해 보면 settings.json 파일이 존재하는 것을 알 수 있습니다.

 

이 파일을 에디터로 열어 아래로 내려보면 스테이터스 라인 옵션이 설정되어 있는 것을 확인할 수 있습니다. 이는 스테이터스 라인 명령어를 통해 내부적으로 설치된 결과입니다.

 

사람에 따라 외부 파일로 깔끔하게 설정될 수도 있고, 다소 긴 코드 형태로 설정될 수도 있습니다. 정해진 형식이 없기 때문입니다. 이는 LLM에게 설정을 요청한 결과로, 그때그때 상황에 맞게 다르게 구성됩니다. 만약 생성된 코드가 지저분하다고 느껴진다면 조금 더 깔끔하게 정리해 달라고 추가로 요청하면 됩니다.

 

실제 스테이터스 라인 스크립트 파일을 열어보면, 앞서 공식 문서에서 확인했던 필드 값을 읽어와 모델 네임 등의 변수에 저장한 뒤 print 형태로 출력하는 구조를 확인할 수 있습니다.

 

JQ 도구에 대하여

JQ는 터미널에서 JSON 데이터를 다루는 도구입니다. JQ가 설치되어 있다면 터미널에 jq --version을 입력했을 때 버전 정보가 정상적으로 출력됩니다. 다만 JQ는 필수 도구가 아닙니다. JQ가 없어도 코드가 다소 길어질 뿐, 클로드 코드는 해당 방식으로 상태 표시줄을 구성할 수 있습니다.

 

단, PC에 JQ가 설치되어 있지 않은 상태에서 클로드 코드가 이를 이미 사용할 수 있다고 착각하고 진행하는 경우도 있습니다. 이러한 이유로 환경 정보를 정확히 전달하는 것이 중요합니다. 실제로 계속 설정에 어려움을 겪던 수강생이 이러한 명령어 한 번으로 바로 문제를 해결한 사례도 있었습니다.

 

정리하며

스테이터스 라인은 단순히 현재 상태를 화면에 표시해 주는 기능일 뿐, 클로드 코드를 사용하는 데 필수적인 요소는 아닙니다. 한 번에 설치가 되지 않는다면 "모델, 비용, 컨텍스트 사용량을 표시해 줘"와 같이 구체적으로 요청해 보는 것이 좋습니다. 그래도 설정이 되지 않는다면 자신이 사용하는 운영체제와 환경, 사용 중인 터미널 정보까지 함께 전달해야 합니다. 이러한 맥락 정보를 충분히 제공할수록 문제 해결 속도가 훨씬 빨라집니다.