클로드 코드 잔량, 상태줄로 본다

클로드 코드(Claude Code) 화면 아래 상태줄에 지금 작업 중인 워크트리와 브랜치, 남은 컨텍스트, 시간·주간 사용 한도를 함께 띄우는 오픈소스 도구 터미니토(terminito)가 공개됐다. 배시(bash) 파일 하나로 돼 있고 외부 의존성이 없으며, 화면을 그리는 경로에서 별도 프로세스를 띄우지 않는다는 점을 내세웠다.

무슨 일인가

클로드 코드는 상태줄을 사용자가 직접 지정할 수 있게 열어뒀다. 터미니토는 그 자리를 두 줄로 채운다. 첫 줄은 '지금 어디에 있는가'다. 연결된 워크트리인지 주 체크아웃인지, 어느 브랜치인지, 어떤 모델을 쓰고 있는지 표시한다. 둘째 줄은 '무엇이 얼마나 남았는가'다. 컨텍스트 사용률, 5시간 단위 한도, 주간 한도를 막대와 함께 보여준다. 터미널 폭이 넉넉하면 두 줄이 한 줄로 합쳐진다.

설치는 홈브루(Homebrew) 한 줄이거나 저장소를 내려받아 설치 명령을 실행하는 방식이고, 윈도우에서는 깃 배시(Git Bash)를 기준으로 삼는다. 설치 명령은 사용자의 클로드 코드 설정 파일에 상태줄 항목을 써넣고 원본 백업을 옆에 남긴다. 재시작 없이 다음 메시지부터 적용되며, 다시 실행해도 아무 일이 일어나지 않고 이미 다른 상태줄을 쓰고 있으면 덮어쓰지 않고 멈춘 뒤 알려준다. 강제로 교체하는 옵션과, 설정 조각만 출력해 직접 붙여넣게 하는 옵션이 따로 있다.

핵심 짚어보기

이 도구에서 배울 점은 기능보다 '무엇을 보여주지 않을지'를 정한 방식이다.

막대에 색이 칠해지는 부분은 남은 양이 아니라 이미 쓴 양이다. 그래서 갓 시작한 세션은 화면이 조용한 회색이고 한도가 닳을수록 화면이 시끄러워진다. 아무 일도 없을 때 경고처럼 보이지 않게 하려는 설계다. 막대는 열 칸뿐이지만 반 칸짜리 문자를 섞어 해상도를 두 배로 늘렸다. 실제로 판단이 갈리는 95퍼센트와 100퍼센트가 같은 그림으로 보이지 않게 하려는 처리다.

가장 실용적인 부분은 한도 옆에 붙은 초기화 카운트다운이다. 같은 91퍼센트라도 4분 뒤 초기화되면 기다리면 되고, 4시간 51분이 남았으면 지금 모델을 바꿔야 한다. 숫자 하나로는 내릴 수 없던 결정이 카운트다운 덕분에 갈린다. 주 체크아웃은 별도 기호와 호박색 이름으로 강조하는데, 실수로 커밋했을 때 대가가 가장 큰 자리이기 때문이라는 설명이다.

문제 진단용 명령도 갖췄다. 상태줄이 보이지 않을 때 점검을 돌리고, 점검이 전부 통과했는데도 표시되지 않으면 추적 모드를 켜 클로드 코드가 실제로 이 스크립트를 호출하고 있는지 기록으로 확인한다. 세션 목록을 워크트리·브랜치와 함께 나열하고 프로세스 생존 여부까지 확인하는 명령, 색상 표현 방식과 최대 폭, 색상 끄기 등을 조절하는 환경변수도 마련돼 있다.

1인기업 실전 적용 포인트

• 창을 여러 개 띄워 병렬로 일한다면 상태줄에 워크트리와 브랜치를 가장 먼저 올려라. 엉뚱한 창에 명령을 넣는 사고가 실제로 가장 흔한 손실이다.
• 한도는 '몇 퍼센트'가 아니라 '언제 초기화되는가'와 함께 봐야 판단이 된다. 자체 대시보드를 만들 때도 잔량과 회복 시각을 나란히 찍어두자.
• 설정 파일을 자동으로 고치는 도구는 백업을 남기는지, 기존 설정을 덮어쓰지 않는지부터 확인한다. 터미니토가 이 둘을 지키는 방식은 자체 설치 스크립트에도 그대로 옮길 만하다.
• 상태 표시 스크립트는 메시지마다 실행된다. 여기서 프로세스를 새로 띄우거나 네트워크를 호출하면 체감 속도가 즉시 나빠진다.

전망 / 주의점

커밋 열 개짜리 신생 프로젝트이고 라이선스는 MIT다. 상태줄에 뜨는 한도 수치는 클로드 코드가 넘겨주는 값을 해석한 결과이므로 공식 청구 기준과 완전히 같다고 단정하기는 어렵다. 참고용 계기판으로 쓰되 결제와 한도의 최종 확인은 공식 화면에서 하는 편이 안전하다. 설정 파일을 자동으로 수정하는 도구인 만큼 첫 설치 전에 백업 위치를 확인하고, 이미 다른 상태줄을 쓰고 있다면 강제 교체 옵션을 서둘러 쓰지 않는 것이 좋다.

출처: 해커뉴스 (https://github.com/arturlimaaa/terminito)