rtk(Rust Token Killer)는 클로드코드(Claude Code)가 실행한 명령의 터미널 출력을 AI에게 필요한 부분만 남기고 압축해주는 오픈소스 도구예요. 명령 앞에 rtk 세 글자만 붙이면 되고, 테스트 출력은 최대 99%, 빌드 로그는 70~87%, git 명령은 59~80% 절감돼요. 동작 원리, 카테고리별 절감률, CLAUDE.md에 등록해서 AI가 알아서 쓰게 만드는 세팅법을 정리했어요.
이 글은 클로드코드 비용 정리에서 예고한 사용량 절약 스킬 시리즈 1편이에요. 스킬 개념이 낯설다면 스킬 개념편을 먼저 보고 오시면 좋아요.
클로드코드 한도를 갉아먹는 건 무엇인가요?
클로드코드의 사용량 한도는 토큰으로 계산돼요. 그런데 토큰을 제일 많이 먹는 건 내가 치는 말이 아니라 AI가 실행한 명령의 출력이에요.
테스트 한 번 돌리면 통과 로그 수백 줄, git 상태 한 번 보면 파일 목록 수십 줄이 나와요. 이게 전부 AI의 입력으로 들어가면서 한도를 갉아먹어요.
rtk란 무엇이고 어떻게 동작하나요?
rtk(Rust Token Killer)는 명령 출력을 AI에게 필요한 것만 남기고 압축해주는 오픈소스 도구예요. 쓰는 법은 딱 하나, 명령 앞에 rtk를 붙이는 거예요.
공식 저장소는 github.com/rtk-ai/rtk이고, Apache-2.0 라이선스의 무료 오픈소스예요. Rust로 만든 단일 실행 파일이라 가볍고(오버헤드 10ms 미만), 100개 이상의 명령을 지원해요.
공식 문서에 나온 동작 방식이에요. 명령마다 “출력에서 뭘 남길지”가 정교하게 정의돼 있어요. 테스트는 실패만, git log는 해시·작성자·제목만 남기는 식이에요.
테스트 500줄 중에 AI가 정말 필요한 건 “뭐가 실패했는지” 몇 줄이에요. rtk는 그것만 남겨요. 결과는 같은데 토큰만 줄어요.
rtk 절감률은 카테고리별로 얼마나 되나요?
rtk 공식 문서 기준, 명령 카테고리별 출력 토큰 절감률은 아래와 같아요.
| 작업 | 명령 예시 | 절감률 |
|---|---|---|
| 테스트 | rtk npm test, rtk vitest run | 90~99% |
| 빌드·컴파일 | rtk next build, rtk tsc | 70~87% |
| git | rtk git status, rtk git diff | 59~80% |
| 파일 탐색 | rtk ls, rtk grep, rtk find | 60~75% |
| 패키지 관리 | rtk npm install, rtk pnpm list | 70~90% |
| 인프라 | rtk docker ps, rtk kubectl | 약 85% |
| 네트워크 | rtk curl | 65~70% |
평균적으로 60~90% 절감이에요.
정직하게 짚고 갈 것 하나. 이 수치는 “AI가 읽는 명령 출력”의 절감률이에요. 출력은 전체 사용량의 일부라서 구독 한도 전체가 90% 늘어나는 건 아니고, 공식 문서도 이 점을 명확히 밝히고 있어요. 그래도 명령을 많이 실행하는 개발 작업일수록 출력 비중이 커서 체감 효과는 확실해요.
rtk 설치와 세팅 방법은?
핵심은 사람이 기억해서 붙이는 게 아니라 AI가 알아서 쓰게 만드는 거예요.
- 설치 : 공식 저장소(github.com/rtk-ai/rtk)에서 받아 설치해요. “github.com/rtk-ai/rtk 설치해 줘”라고 클로드코드에게 시키는 게 제일 편해요.
- 규칙 등록 : CLAUDE.md에 “모든 명령은 rtk를 붙여 실행”이라고 적어두는 게 핵심이에요. 그러면 AI가 명령을 실행할 때마다 알아서 rtk를 붙여요.
- 확인 : rtk gain을 실행하면 지금까지 아낀 토큰 통계를 보여줘요. 절약이 눈에 보여서 재미있어요.
포인트는 2번이에요. 규칙 파일에 박아서 AI가 항상 쓰게 만드는 것. 저는 모든 프로젝트 공통 규칙으로 넣어두고 몇 달째 쓰고 있어요.
자주 묻는 질문 (FAQ)
Q. 압축하면 정보가 손실돼서 AI가 실수하지 않나요?
rtk는 에러, 실패, 변경사항 같은 “판단에 필요한 정보”는 남기고 통과 로그 같은 노이즈만 걷어내요. 몇 달 써본 경험상 판단 품질이 떨어진 적은 없었고, 오히려 출력이 깔끔해져서 AI가 핵심에 집중해요.
Q. rtk가 모르는 명령을 만나면 어떻게 되나요?
전용 필터가 없는 명령은 그대로 통과시켜요. 그래서 아무 명령에나 붙여도 안전해요.
Q. 원본 출력이 필요할 땐 어떻게 하나요?
rtk proxy를 쓰면 압축 없이 원본 그대로 볼 수 있어요. 디버깅할 때 가끔 써요.
Q. 얼마나 아껴지는지 확인할 수 있나요?
네, rtk gain 명령이 누적 절감 통계를 보여줘요. 커맨드별 히스토리도 볼 수 있어요.
다음 글: 스킬 2편 QA
다음 스킬은 QA 스킬(gstack)이에요. 만든 웹 앱을 AI가 체계적으로 테스트하고, 발견한 버그를 스스로 고치게 만드는 매뉴얼이에요. “만들기”만큼 중요한 “검증”을 자동화하는 이야기예요.
Leave a Reply