Claude Code 토큰 비용을 95% 절감하는 오픈소스 도구 'afd' 공개

실용적 조언

Claude Code 비용이 부담된다면 npx @dotoricode/afd setup을 통해 구조적 압축 기능을 적용해볼 것.
Bun 런타임을 설치하여 afd의 빠른 자가 치유 및 실시간 대시보드 기능을 활용할 수 있음.

섹션별 상세

Claude Code의 비효율적인 파일 처리 방식과 비용 문제를 지적했다. Claude Code가 파일을 읽을 때 불필요한 구현부까지 모두 컨텍스트에 포함시켜 토큰을 낭비하는 현상을 해결하기 위해 백그라운드에서 파일 읽기를 가로채는 데몬 방식을 도입했다.

Hologram 기술을 통한 구조적 압축 방식을 구현했다. Tree-sitter AST 파싱을 사용하여 TypeScript, Python 등 주요 언어의 파일에서 함수 본문을 제외한 타입 시그니처와 구조 정보만 추출한다. 27KB 크기의 파일을 921자로 압축하면서도 모델의 코드 이해도는 유지하는 메커니즘이 핵심이다.

자가 치유(Self-healing) 및 지능형 감지 기능을 갖췄다. Claude가 설정 파일을 삭제하거나 손상시키는 경우 100ms 이내에 감지하여 스냅샷에서 복구하는 면역 시스템을 구축했다. 사용자의 의도적인 파일 삭제와 시스템 오류를 구분하기 위해 30초 이내 재삭제 시 동작을 멈추는 로직을 포함했다.

성능 지표 및 기술적 구현 상세를 공개했다. 실제 사용 사례에서 210K 토큰을 11K로 줄여 95%의 비용 절감 효과를 입증했다. Bun 런타임의 네이티브 SQLite와 빠른 실행 속도를 활용하여 270ms 미만의 복구 사이클을 달성했다.

용어 해설

추상 구문 트리(AST): — 프로그래밍 언어로 작성된 소스 코드의 구조를 트리 형태로 표현한 것이다. afd는 이를 활용해 코드의 세부 구현을 제외하고 함수 시그니처와 클래스 구조만 추출하여 토큰 사용량을 줄인다.
컨텍스트 윈도우(Context Window): — AI 모델이 한 번에 처리할 수 있는 데이터의 최대량이다. Claude Code가 파일 전체를 이 영역에 넣으면 비용이 급증하므로, 핵심 구조만 전달하여 이 공간을 효율적으로 관리하는 것이 중요하다.
트리 시터(Tree-sitter): — 다양한 프로그래밍 언어를 빠르고 점진적으로 파싱할 수 있는 라이브러리이다. afd는 이를 통해 TypeScript, Python, Go, Rust 등의 코드를 실시간으로 분석하여 구조적 뼈대를 생성한다.
토큰 사용량(Token Usage): — LLM API 사용 시 과금의 기준이 되는 텍스트 단위의 양이다. 파일의 불필요한 구현부를 제거함으로써 이 수치를 획기적으로 낮춰 API 비용을 절감할 수 있다.

코드 예제

bash

npx @dotoricode/afd setup

afd 도구를 설치하고 설정을 시작하는 명령어

bash

curl -fsSL https://bun.sh/install | bash

afd 실행에 필요한 고속 런타임 Bun을 설치하는 명령어

언급된 도구

afd추천링크

Claude Code 토큰 최적화 및 비용 절감 데몬

Bun추천링크

고속 JavaScript 런타임 및 패키지 매니저

Tree-sitter중립

다국어 AST 파싱 라이브러리

언급된 리소스

GitHubafd GitHub Repository

문서afd npm Package

튜토리얼Bun Installation Guide