Claude 출력을 로컬 LLM으로 읽기 쉽게 바꾸는 Vomit

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

TL;DR

Vomit은 Claude의 읽기 어려운 토큰 출력을 별도의 로컬 LLM에 전달해 영어 문장으로 변환하는 Go 도구입니다. `vomit scrub -claude`로 Claude 출력 교체용 hook을 구성하거나 `vomit list`와 `vomit tail`로 원래 실행을 건드리지 않고 변환 결과를 확인할 수 있습니다. Llama.app, Ollama, OpenAI API 기반 구성을 지원하고 GPT-OSS 20B가 권장되지만, 속도가 느리고 Mac에서만 테스트됐으며 로컬 LLM의 환각으로 원문이 누락될 수 있습니다.

섹션별 상세

Vomit은 Claude가 사람이 읽기 어려운 형태로 내보내는 토큰 출력을 별도의 로컬 LLM에 통과시켜 영어 문장으로 바꾸는 Go 기반 도구입니다. 처리 과정은 Claude가 전달하려는 출력만 읽고, 사용자가 설정한 LLM에 이를 입력한 뒤 변환 결과를 돌려주는 방식이며 Claude의 파일이나 실행 동작에는 접근하지 않습니다. 모든 처리를 로컬에서 수행하고 telemetry와 외부 의존성이 없다는 점이 핵심이지만, 변환 모델이 원문을 완전히 복원한다고 보장하지는 않습니다.

bash

# Install the binary to your GOPATH
go install github.com/zachahn/vomit@latest
# Setup connection details to your LLM
vomit init
# Instructions on how to replace Claude's output via hooks
vomit scrub -claude

Vomit을 설치하고 LLM 연결 정보를 설정한 뒤 Claude 출력 교체용 hook을 구성합니다.

text

vomit list. List Claude session identifiers
vomit tail [<session_identifier>]. Translate Claude's tokens for the specified session, or follow the latest one
vomit help. See for more commands

Claude 세션 식별자를 조회하고 특정 세션 또는 최신 세션의 토큰 출력을 따라갑니다.

Vomit은 `go install github.com/zachahn/vomit@latest`로 설치한 뒤 `vomit init`에서 LLM 연결 정보를 설정하는 흐름을 제공합니다. Claude 출력 자체를 교체하려면 `vomit scrub -claude`를 실행해 hook 기반 구성을 적용하고, 원본 흐름을 건드리지 않으려면 `vomit list`와 `vomit tail [<session_identifier>]`로 별도 변환을 수행할 수 있습니다. 후자의 비침습 모드는 Claude 세션 식별자를 확인한 다음 특정 세션이나 최신 세션을 따라가며 결과를 읽는 구조입니다.

저장소는 Llama.app, Ollama, OpenAI API를 사용하는 구성을 지원 대상으로 제시하며, 이미 로컬 LLM이 없다면 Llama.app에서 GPT-OSS 20B를 내려받는 선택지를 권합니다. 사용자는 LLM을 준비한 뒤 `vomit init`을 다시 실행해 연결 세부 정보를 등록해야 하며, 도구는 그 설정을 이용해 Claude의 출력을 변환합니다. 실행 속도가 느리고 Mac에서만 테스트됐다는 제한 때문에 모델 선택과 운영 환경에 따라 실사용성이 달라집니다.

Vomit의 가장 큰 주의점은 로컬 LLM이 Claude가 전달하려 한 내용만 볼 뿐 실제 동작이나 파일에 접근하지 못한다는 점입니다. 그래서 변환 과정에서 환각이 생기거나 Claude의 메시지를 완전히 놓칠 수 있으며, 원본 확인에는 AgentsView 같은 별도 도구를 사용하라는 안내가 붙어 있습니다. Vomit은 실행 중 TMPDIR에 파일을 쓰는 것을 제외하면 Claude의 동작을 변경하지 않는다고 밝히므로, 자동 교체 방식보다 원문 보존을 우선할 때 비침습 모드가 더 적합합니다.

용어 해설

로컬 LLM(Local LLM): — 인터넷의 원격 API가 아니라 사용자의 컴퓨터에서 직접 실행하는 언어 모델입니다. Vomit은 Claude가 생성한 토큰을 임시 파일에서 읽고 로컬 LLM에 전달해 사람이 읽을 수 있는 영어로 바꿉니다. 데이터 외부 전송과 telemetry를 피할 수 있지만, 로컬 모델의 성능과 속도에 결과가 좌우됩니다.
토큰 출력 난해화(Token Vomit): — Claude가 내부 처리 과정에서 내놓는 읽기 어려운 토큰이나 문장을 가리키는 표현입니다. Vomit은 이 출력을 별도 LLM에 입력해 더 자연스러운 영어 문장으로 재구성합니다. 원래 메시지의 일부가 사라지거나 모델이 내용을 지어낼 가능성이 있어 원문 확인이 필요합니다.
Claude Hook(Claude Hooks): — Claude의 출력이나 실행 흐름에 외부 명령을 연결하는 자동화 방식입니다. Vomit은 `vomit scrub -claude` 명령으로 Claude의 출력 교체에 필요한 hook 설정을 지원합니다. 다만 원문 메시지를 보존하거나 복구하는 도구는 아니므로 별도의 세션 확인 수단이 필요합니다.
OpenAI API: — OpenAI 호환 형식의 요청을 통해 언어 모델을 호출하는 API 방식입니다. Vomit은 Llama.app이나 Ollama뿐 아니라 OpenAI API를 사용하는 구성도 작동할 수 있다고 안내합니다. 따라서 특정 로컬 실행기 하나에만 묶이지 않고 사용자가 설정한 LLM 연결 정보를 활용합니다.

기술

Go
Claude
Claude Code
Llama.app
Ollama
OpenAI API
GPT-OSS 20B

활용 사례

Claude의 읽기 어려운 토큰 출력을 로컬 LLM으로 변환하는 작업
Claude 세션의 최신 출력이나 특정 세션을 비침습적으로 따라가는 작업
Claude 출력에 hook을 연결해 변환 결과로 교체하는 작업

언급된 리소스

GitHubzachahn/vomit