RTK — LLM 토큰을 60~90% 줄이는 CLI 프록시

Claude Code나 Cursor로 개발하다 보면, CLI 명령어 출력이 토큰을 엄청나게 소모한다는 걸 금방 느끼게 됩니다.

git log, npm test, docker build 같은 명령어의 출력은 LLM이 실제로 필요한 정보보다 훨씬 많은 내용을 담고 있습니다. RTK는 이 문제를 해결합니다.

RTK란#

RTK(Rust Token Killer) 는 CLI 명령어 출력을 LLM 컨텍스트에 넘기기 전에 필터링하는 프록시 도구입니다.

Rust로 만들어진 단일 바이너리로, 외부 의존성이 없습니다. Bash hook으로 명령어 실행을 가로채서 LLM에 필요한 고신호(high-signal) 정보만 추출한 뒤 전달합니다.

• GitHub: rtk-ai/rtk
• 공식 사이트: rtk-ai.app

왜 필요한가#

git log --oneline -20 출력 하나만 해도 수십 줄이 나옵니다. npm 테스트 결과, Docker 빌드 로그는 수백 줄에 달하기도 합니다.

LLM 입장에서 이 출력의 대부분은 노이즈입니다. 에러 메시지, 스택 트레이스의 핵심 줄, 테스트 실패 요약만 있으면 충분합니다.

불필요한 출력이 컨텍스트를 채우면 두 가지 문제가 생깁니다.

• 비용 증가 — 입력 토큰이 늘어날수록 API 비용이 올라갑니다
• 품질 저하 — 관련 없는 정보가 많을수록 LLM의 집중도가 떨어집니다

동작 원리#

RTK는 rtk init -g 실행 시 Bash hook을 설치합니다. 이후 명령어를 실행할 때마다 아래 흐름이 자동으로 작동합니다.

명령어 입력
    ↓
RTK가 가로채서 실제 명령어 실행
    ↓
출력을 12가지 필터링 전략으로 처리
    ↓
고신호 정보만 LLM 컨텍스트에 전달

명령어당 추가 지연은 5~15ms 수준이라 체감하기 어렵습니다. 필터링 실패 시에는 원본 출력으로 자동 폴백됩니다.

설치#

# Homebrew (macOS)
brew install rtk-ai/tap/rtk

# 또는 curl
curl -fsSL https://rtk-ai.app/install.sh | sh

설치 후 전역 hook을 설정합니다.

rtk init -g

이 명령어 하나로 모든 터미널 세션에서 RTK가 자동 활성화됩니다.

지원 도구#

AI 코딩 어시스턴트 — Claude Code, Cursor, Aider, Gemini CLI, Codex, Windsurf, Cline

명령어 모듈 — git, cargo, npm/yarn/pnpm, pytest, docker, make 등 40개 이상

• 공식 사이트 Demo 참고: rtk-ai.app

실제 효과#

RTK 공식 사이트에서 공개한 수치입니다.

실 사용자 기준 몇 주 만에 1억 3천만 토큰 이상 절감된 사례도 보고됐습니다.

실제 hands-on 해봤을 때:

주의할 점#

exit code 보존 — RTK는 원본 명령어의 exit code를 그대로 전달합니다. CI/CD 파이프라인에서도 안전하게 사용할 수 있습니다.

필터링 범위 — 모든 명령어가 최적화되는 건 아닙니다. 지원 모듈 목록에 없는 명령어는 원본 출력을 그대로 전달합니다.

컨텍스트 손실 가능성(중요) — 필터링 과정에서 드물게 디버깅에 필요한 정보가 잘릴 수 있습니다. 이때는 RTK를 일시적으로 비활성화해 원본 출력을 확인합니다.

rtk disable   # 비활성화
rtk enable    # 재활성화

정리#