- Vomit은 Claude가 생성한 난해한 토큰 출력을 로컬 LLM에 전달해 읽을 수 있는 영어로 변환하는 도구임
- 모든 처리를 로컬 환경에서 수행해 텔레메트리와 외부 의존성이 없으며, 실행 중 원본 메시지는 변경하지 않음
- Claude 출력 교체용 훅과 함께 쓸 수 있고, list와 tail 명령을 이용해 별도 실행하는 비침습 모드도 지원함
- OpenAI API 형식의 로컬 LLM을 대상으로 하며 Llama.app, Ollama, GPT-OSS 20B 조합을 사용할 수 있음
- 로컬 LLM은 Claude의 작업이나 파일에 접근하지 못해 환각하거나 메시지를 누락할 수 있고, 속도가 느리며 Mac에서만 테스트됨
작동 방식과 특성
- Claude가 전달하려는 토큰을 로컬 LLM으로 파이핑해 자연스러운 영어로 변환함
- 텔레메트리와 외부 의존성이 없으며 모든 처리가 로컬에서 이뤄짐
- 런타임에는 Claude의 원본 메시지를 건드리지 않지만, 기술적으로 TMPDIR에 파일을 기록함
설치와 설정
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.app과 Ollama를 지원 대상으로 제시함
- OpenAI API를 사용하는 다른 로컬 LLM도 작동할 가능성이 있으나 확정적으로 보장하지 않음
- 로컬 LLM이 없다면 Llama.app에서 GPT-OSS 20B를 내려받은 뒤 init을 실행하는 구성을 권장함
제약과 라이선스
- 로컬 LLM은 Claude가 전달하려는 메시지만 볼 수 있고 작업이나 파일에는 접근할 수 없어 일부 내용을 환각함
- 처리 속도가 느리고, 바이브 코딩으로 제작돼 Mac에서만 테스트됨
- Claude 메시지를 완전히 놓칠 수 있으며, 원본 메시지는 AgentsView 같은 도구로 확인할 수 있음
- 라이선스는 GNU GPLv3임