클로드 코드 출력에 색을 입히는 411KB 래퍼

클로드 코드(Claude Code)가 화면에 뿌리는 셸 명령어를 색으로 구분해 주는 작은 도구 '클로드에이치엘(claude-hl)'이 공개됐다. 러스트로 작성된 411KB짜리 실행 파일 하나로, 클로드 코드와 터미널 사이에 끼어 앉아 명령어는 파랑, 플래그는 분홍, 문자열은 금색으로 칠한다.

무슨 일인가 / 배경

클로드 코드는 실행할 셸 명령을 화면에 보여 주지만, 지금까지는 그 전체가 하나의 단색 문자열로 표시됐다. git commit -m "fix" --no-verify 같은 줄에서 어디까지가 명령이고 어디부터가 옵션이며 무엇이 인자인지 눈으로 구분하기 어려웠다는 뜻이다. 승인 여부를 몇 초 안에 판단해야 하는 상황에서는 이 한 겹의 시각 정보가 생각보다 크게 작용한다.

제작자는 같은 문제를 다르게 푼 선례들도 소개했다. 에이전트 에스디케이 위에 별도 터미널 화면을 올린 클로드 코드 러스트(claude-code-rust), 에디터 안에서 출력을 렌더링하는 코드컴패니언(CodeCompanion)이나 사이드킥(Sidekick) 같은 통합 도구들이다. 다만 이들은 하나같이 클로드 코드 명령줄 도구 자체를 대체한다는 공통점이 있다.

핵심 짚어보기

이 도구가 택한 방향은 정반대다. 클로드 코드를 그대로 실행하고 그 출력만 가로채 다시 칠한다. 그래서 훅, 스킬, MCP 서버, 권한 승인 창처럼 명령줄 도구에 붙어 있는 기능이 전부 그대로 동작한다. 새 기능이 언제나 공식 명령줄 도구에 먼저 도착한다는 점을 감안하면, '대체하지 않는다'는 선택 자체가 이 도구의 핵심 설계다.

설치는 러스트 툴체인이 있는 환경에서 cargo install --git 한 줄이면 끝난다. 의존성은 libc 하나뿐이다. 사용법도 평소 쓰던 명령 대신 claude-hl을 치면 되고, 뒤에 붙인 인자는 그대로 넘어간다.

설정은 전부 환경 변수로 한다. CLAUDE_HL_THEME으로 코덱스(기본값)·로즈·카푸친·도쿄나이트·드라큘라·그루브박스·노드 일곱 가지 팔레트 중 하나를 고르고, CLAUDE_HL_COLORS로 명령·플래그·경로·숫자 등 개별 슬롯 색만 덮어쓸 수 있다. CLAUDE_HL_COMMANDS로는 다시 빌드하지 않고도 인식할 명령어 어휘를 늘리거나 뺄 수 있으며, CLAUDE_HL_CMD를 바꾸면 클로드 코드가 아닌 다른 프로그램을 감쌀 수도 있다. --selftest와 --themes는 실제로 세션을 열지 않고도 색을 미리 확인하는 용도다.

한 가지 한계는 명확히 밝혀져 있다. 제작·검증은 맥오에스에서만 이뤄졌고 리눅스는 동작할 것으로 보이나 시험되지 않았다. 저장소는 커밋 30건, 별 5개 규모의 초기 프로젝트다.

1인기업 실전 적용 포인트

• 에이전트에게 셸 실행 권한을 주고 일하는 사람이라면, 승인 판단 속도가 곧 사고 예방이다. 명령·플래그·경로가 색으로 갈리면 --force나 -rf 같은 위험 옵션이 문장 속에 묻히지 않는다.
• 러스트 툴체인 설치가 부담이면 도입을 미뤄도 된다. 이 도구는 생산성을 바꾸는 종류가 아니라 오독 확률을 낮추는 종류다. 하루 수십 번 명령을 승인하는 사람에게만 값이 있다.
• 맥이 아닌 환경에서 쓸 계획이라면 실서비스 작업 세션 말고 별도 프로젝트 폴더에서 며칠 돌려 보고 판단한다. 검증되지 않은 플랫폼이라고 제작자가 직접 밝힌 상태다.
• CLAUDE_HL_CMD로 다른 명령줄 프로그램도 감쌀 수 있으므로, 자체 제작한 자동화 스크립트의 로그 가독성을 올리는 데 전용할 수도 있다.

전망 / 주의점

에이전트 도구 주변에는 이런 식의 '얇은 껍데기' 도구가 계속 늘어날 전망이다. 본체를 대체하지 않고 한 가지 불편만 걷어 내는 방식은 유지보수 부담이 작고 본체 업데이트에 잘 깨지지 않는다. 다만 터미널 출력 스트림을 통째로 거쳐 가는 구조인 만큼, 원치 않는 기록이 남지 않도록 디버그용 덤프 옵션은 꼭 필요할 때만 켜는 편이 좋다.

출처: Hacker News (https://github.com/rashedInt32/claude-hl)