Vomit - 별도 LLM으로 Claude 5의 토큰 출력을 정리하는 도구

4 hours ago 4
  • Vomit은 Claude가 생성한 난해한 토큰 출력을 로컬 LLM에 전달해 읽을 수 있는 영어로 변환하는 도구임
  • 모든 처리를 로컬 환경에서 수행해 텔레메트리와 외부 의존성이 없으며, 실행 중 원본 메시지는 변경하지 않음
  • Claude 출력 교체용 훅과 함께 쓸 수 있고, list와 tail 명령을 이용해 별도 실행하는 비침습 모드도 지원함
  • OpenAI API 형식의 로컬 LLM을 대상으로 하며 Llama.app, Ollama, GPT-OSS 20B 조합을 사용할 수 있음
  • 로컬 LLM은 Claude의 작업이나 파일에 접근하지 못해 환각하거나 메시지를 누락할 수 있고, 속도가 느리며 Mac에서만 테스트

작동 방식과 특성

  • Claude가 전달하려는 토큰을 로컬 LLM으로 파이핑해 자연스러운 영어로 변환함
  • 텔레메트리와 외부 의존성이 없으며 모든 처리가 로컬에서 이뤄짐
  • 런타임에는 Claude의 원본 메시지를 건드리지 않지만, 기술적으로 TMPDIR에 파일을 기록함

설치와 설정

  • Go 바이너리를 GOPATH에 설치함
go install github.com/zachahn/vomit@latest
  • vomit init으로 로컬 LLM 연결 정보를 설정함
  • vomit scrub -claude로 Claude 출력을 교체하는 훅 설정 방법을 확인함

비침습 모드

  • Claude 출력을 직접 교체하지 않고 Vomit을 별도로 실행할 수 있음
    • vomit list: Claude 세션 식별자 목록을 표시함
    • vomit tail [<session_identifier>]: 지정한 세션의 토큰을 번역하거나 최신 세션을 따라감
    • vomit help: 추가 명령을 확인함

지원 환경

  • Llama.appOllama를 지원 대상으로 제시함
  • OpenAI API를 사용하는 다른 로컬 LLM도 작동할 가능성이 있으나 확정적으로 보장하지 않음
  • 로컬 LLM이 없다면 Llama.app에서 GPT-OSS 20B를 내려받은 뒤 init을 실행하는 구성을 권장함

제약과 라이선스

  • 로컬 LLM은 Claude가 전달하려는 메시지만 볼 수 있고 작업이나 파일에는 접근할 수 없어 일부 내용을 환각함
  • 처리 속도가 느리고, 바이브 코딩으로 제작돼 Mac에서만 테스트
  • Claude 메시지를 완전히 놓칠 수 있으며, 원본 메시지는 AgentsView 같은 도구로 확인할 수 있음
  • 라이선스는 GNU GPLv3
Read Entire Article