# Headroom — 보내기 전에 압축해서 토큰 절약

모델로 보내기 직전에 파일·명령 출력·로그를 압축하는 로컬 프록시입니다. 같은 작업을 더 적은 토큰으로 돌리려는 사람에게 맞습니다.

- 종류: 오픈소스 · 분류: 비용 절약
- 원본: https://github.com/headroomlabs-ai/headroom
- 라이선스: Apache-2.0

## 설치

```
uv tool install --python 3.13 "headroom-ai[proxy,mcp]"
```

출처: 딸깍코드 https://ddalkkak.ssemgong.com/p/headroom

## 이런 걸 해요

- 도구 출력·로그·RAG 청크 압축
- 로컬 프록시로 동작, headroom wrap claude로 실행
- MCP 옵션 포함 설치 가능

## 주의

Claude Code와 AI 서버 사이에 끼는 프록시라, 프록시가 꺼져 있으면 요청이 실패할 수 있습니다. 쓰지 않을 때는 원래 방식으로 실행하세요.