Claude Code · 2026년 9월 21일 ★★★

sqz 는 같은 파일 재읽기를 13토큰 참조로 바꿔 주지만 클로드 코드의 Bash 호출만 훅으로 잡고 내장 Read 도구 읽기는 줄이지 못해요

4월에 공개된 러스트 도구 sqz(별 625개, 일래스틱 라이선스 2.0, 최근 릴리스 v1.6.1 은 8월 16일)는 sqz init 으로 클로드 코드에 Bash·PowerShell 만 잡는 PreToolUse 훅을 심어 명령 출력을 sqz compress 로 흘려보내고, 출력의 SHA-256 을 세션 데이터베이스에 남겨 같은 바이트가 다시 오면 본문 대신 13토큰짜리 §ref:해시§ 참조를 돌려줘요. 참조는 30분 안에 본 내용이고 마지막 컨텍스트 압축 뒤에 본 것일 때만 내주며, 저장소가 적은 수치는 같은 파일 5번 읽기 10,000토큰이 826토큰으로, 테스트·수정·테스트 3회가 15,000토큰이 5,186토큰으로, 실제 세션 평균은 24.7% 절감이에요. 다만 sqz 문서 스스로 클로드 코드 내장 Read 도구는 못 잡는다고 적고 CLAUDE.md 에 2KB 넘는 파일은 자체 MCP 도구 sqz_read_file 로 읽으라는 지침을 써 넣는 방식으로 우회하는데, 클로드 코드는 4월 28일 v2.1.121 부터 PostToolUse 훅의 updatedToolOutput 으로 모든 도구의 출력을 바꿀 수 있어서 이 한계는 클로드 코드가 아니라 sqz 구현에 있어요.

용어 풀이
MCP
에이전트가 외부 도구·데이터에 연결되는 표준 규약(Model Context Protocol)
SHA-256
내용이 한 글자만 달라도 값이 바뀌는 고정 길이 요약값을 만드는 해시 함수
PreToolUse
클로드 코드가 도구를 실행하기 직전에 끼어드는 훅 시점. 입력을 바꿀 수 있다
PostToolUse
도구 실행이 끝난 직후 끼어드는 훅 시점. 출력을 바꿀 수 있다
운영자 인사이트

sqz 저장소도 인용하는 7월 논문은 도구 출력 토큰을 38.4% 줄인 설정에서 청구 비용이 오히려 6.8% 올랐고 입력 비용 대부분이 프롬프트 캐시 생성·읽기라고 적었으니, 이 도구의 값어치는 요금보다 컨텍스트 창을 비우는 쪽에서 찾으세요. 붙이기 전에 자기 세션이 파일을 Read 로 읽는지 cat·sed 로 읽는지부터 보고(auto 모드는 cat·sed 를 지시해요), 내장 Read 까지 줄이고 싶으면 v2.1.121 부터 열린 PostToolUse 훅의 updatedToolOutput 으로 직접 만드는 길이 있어요.

여러 관점으로 보기
  • sqz 문서 — 어떤 읽기를 잡고 어떤 읽기를 못 잡는지 sqz 가 직접 쓴 재읽기 문서는 훅이 cat·head·sed 같은 셸 명령과 자체 MCP 도구 sqz_read_file 만 거치고 클라이언트 내장 Read 도구는 못 잡는다고 적었고, 그래서 sqz init 이 CLAUDE.md·AGENTS.md 에 2KB 넘는 파일은 sqz_read_file 로 읽으라는 지침을 써 넣는데 강제는 못 한다고 밝혔어요. 편집 뒤 재읽기는 SimHash 와 줄 단위 비교로 바뀐 줄만 돌려주고, 첫 읽기와 대화 전체 재전송은 줄이지 못한다고도 적었어요. GitHub
  • 클로드 코드 공식 문서 — PostToolUse 훅은 이제 모든 도구 출력을 바꿀 수 있다 훅 문서는 PostToolUse 의 updatedToolOutput 이 모델에 보내기 전에 도구 출력을 통째로 바꾸며 모든 도구에 적용된다고 적었고, 예전 MCP 전용 필드 updatedMCPToolOutput 은 쓰지 말라고 안내해요. 변경 기록은 이 확장을 4월 28일 나온 v2.1.121 에 넣었다고 적어서, sqz 문서가 근거로 든 2025년 이슈는 이미 지난 얘기예요. Claude Code 공식 문서
  • 논문 — 토큰 절감이 비용 절감은 아니다 7월에 올라온 논문 「Token Reduction Is Not Cost Reduction」은 클로드 코드에 압축 방식 세 가지를 붙여 실제 청구액을 쟀는데, 가장 센 설정이 도구 출력 토큰을 38.4% 줄이고도 비용은 6.8% 올랐고 토큰 절감과 비용 절감의 상관계수는 0.15 였어요. 입력 비용은 프롬프트 캐시 생성과 읽기가 대부분이라 도구 출력 압축이 건드릴 수 있는 몫이 작고, 압축이 무엇을 빠뜨리면 조사·테스트 턴이 늘어 절감분을 상쇄한다고 적었어요. sqz 는 이 논문을 인용하며 캐시 요금을 가정한 sqz stats --cost 와 2분 안 재실행 같은 후회 신호를 넣었어요. arXiv

원본 보기 (reddit:claudeai)