사용기 A-17

클로드 코드 토큰 줄이는 RTK, 제 맥 기록은 88%인데 명령별로 보면 달랐어요

읽는 데 약 6분

아이티플레인

사용 기록

기록 기간2026-09-09 ~ 2026-10-26

써 본 것RTK 0.48.0 (클로드 코드가 읽는 터미널 출력을 줄여 주는 명령 도구)

비용무료 (0.x판은 Apache 2.0 오픈소스, 1.0부터 기본판 라이선스가 바뀜)

설치필요 (홈브루로 설치 + 클로드 코드 설정에 훅 한 줄)

제 맥 기록명령 56,361번, 토큰 3,940만 개 절약(88.0%)

난이도터미널 조금

한 줄 결론이번에 잰 목록·상태·기록 명령은 31~65% 줄었어요. 다만 88%는 절약의 98%가 파일 읽기 한 종류에서 나온 숫자라, 읽기·검색·diff의 명령당 평균은 15~44%였고 그대로인 명령도 있었어요.

클로드 코드는 터미널 명령을 실행하고 그 결과를 읽으면서 일해요. 파일 목록, git 기록, 검색 결과 같은 출력이 전부 클로드가 읽는 글자예요. 이 출력도 모델이 처리하는 내용이에요. RTK는 이 출력을 클로드가 읽기 전에 줄여 주는 도구예요. 이 맥에 남은 RTK 첫 기록이 9월 9일이라, 10월 26일 오전까지 7주 치를 뽑아 봤습니다.

RTK 사용 기록 카드. 2026년 9월 9일부터 10월 26일까지 명령 56,361번, 원래 출력 4,480만 토큰이 540만 토큰으로 줄어 3,940만 토큰 절약(88.0%). 9월 76.7%, 10월 89.4%. 명령별: 파일 읽기 5,871번 3,860만 절약(평균 14.7%), 검색 4,611번 27만 4천 절약(평균 33.4%), diff 18번 1만 7천 절약(평균 44.0%)
rtk gain 명령으로 본 이 맥의 기록이에요

RTK는 뭘 하나요?

클로드 코드가 터미널 명령을 실행하기 직전에 끼어들어서, 명령을 RTK를 거치는 판으로 바꿔요. 예를 들어 클로드가 git status를 치면 실제로는 rtk git status가 실행되고, 결과에서 군더더기를 걷어 낸 짧은 판이 클로드에게 가요.

10월 26일, 제 맥에서 같은 명령을 RTK를 거칠 때와 안 거칠 때로 나눠 출력 크기를 한 번씩 재 봤어요.

같은 명령, RTK를 거치기 전과 후 (맥OS, 2026-10-26, 출력 바이트)

ls -la (글 폴더)             1,721 → 604     65% 줄어듦
git log -15                  5,655 → 3,885   31% 줄어듦
git status                     100 → 49      51% 줄어듦
git diff HEAD~3 --stat       1,605 → 1,604   거의 그대로
grep -rn (글 폴더 검색)       4,459 → 4,459   그대로

ls -la는 소유자, 크기, 날짜 칸을 빼고 권한 숫자와 이름만 보여 줘서 많이 줄었어요.

터미널 출력 비교. rtk proxy ls -la posts(원래 출력)는 total 0과 권한·링크 수·소유자·그룹·크기·날짜·이름이 한 줄씩, rtk ls -la posts는 755와 폴더 이름만 한 줄씩

같은 폴더를 RTK 없이, RTK로 본 출력이에요. 소유자 이름만 가렸어요 git status도 “브랜치가 최신이다”, “고칠 게 없다” 같은 안내 문장을 한 줄로 바꿨고요. 반면 이번에 잰 검색 한 번과 diff 요약은 거의 그대로였어요. 기록상 검색은 평균 33% 줄었으니, 검색어와 결과 모양에 따라 달라지는 것 같아요.

88%는 어디서 나온 숫자인가요?

rtk gain이라는 명령으로 지금까지 아낀 양을 볼 수 있어요. 10월 26일 오전 기준 제 맥은 명령 56,361번, 원래 출력 4,480만 토큰이 540만 토큰으로 줄어서 88.0%를 아꼈다고 나와요. 9월은 76.7%, 10월은 89.4%였어요.

터미널에서 rtk gain 실행 결과. Total commands 56361, Input tokens 44.8M, Output tokens 5.4M, Tokens saved 39.4M (88.0%), 명령별 1위 rtk read 5871번 38.6M 평균 14.7%, 2위 rtk grep 4611번 274.5K 33.4%, 3위 rtk diff 18번 17.5K 44.0%
rtk gain 출력을 그대로 옮긴 그림이에요

그런데 명령별로 나눠 보니 그림이 달랐어요. 아낀 3,940만 토큰 중 3,860만 토큰, 98%가 파일 읽기 한 종류에서 나왔어요. 그런데 파일 읽기의 명령당 평균 절약은 14.7%뿐이에요. 평균은 15%인데 총합은 엄청나니, 아주 큰 출력 몇 번을 크게 잘라 낸 게 전체 숫자를 끌어올렸을 수 있어요. 이 집계만으로는 어느 읽기가 얼마나 보탰는지까지는 알 수 없어요.

10월 13일 나온 1.0판 변경 기록에 “rtk gain의 대표 절약률에서 아주 큰 출력은 뺀다”는 항목이 있어요. 제 맥은 그 전 판(0.48.0)이라 큰 출력이 다 들어간 숫자예요. 공식 사이트도 평균 56%, 시끄러운 명령은 최대 90%라고 적고 있고, 사용자 대시보드 예시는 44.4%예요. 제 88%가 곧 “RTK를 쓰면 88% 준다”는 뜻은 아닌 거예요.

그래도 쓸 만한가요?

10월 26일에 잰 범위에서는 목록·상태·기록처럼 길게 나오는 명령이 31~65% 줄었어요. 기록상 많이 거친 명령은 파일 읽기(5,871번)와 검색(4,611번)이에요. 10월 들어 26일까지 거친 명령은 5만 616번, 하루 평균 1,900번쯤이에요.

RTK가 출력을 해석하지 못하면 원래 명령으로 돌려서 실행해요. 제 맥 기록에서 이런 경우가 1,163번이었고, 복구율은 99.8%로 나와요. 목록 앞쪽에 많이 찍힌 건 파일 복사(rsync)와 파일 정보를 보는 명령(stat)이었어요.

줄어서 곤란한 적은 없었나요?

작업이 틀어진 기록은 찾지 못했어요. 다만 ls -la에서 날짜와 크기 칸이 빠지니까, “이 파일 언제 고쳤지?”를 보려면 다른 명령을 한 번 더 쳐야 해요.

원래 출력이 꼭 필요할 때는 RTK를 건너뛰는 명령이 있어요. 0.x판은 rtk proxy, 1.0판부터는 rtk bypass예요(proxy도 별칭으로 남아요). 원래 출력은 이 명령으로 확인할 수 있어요.

설치는 어떻게 하나요?

공식 사이트는 두 가지를 안내해요. 한 줄 설치 스크립트와 홈브루예요. 클로드 코드에 붙이는 건 rtk init –global 한 줄이고, 그러면 클로드 코드 설정 파일(settings.json)에 “터미널 명령을 실행하기 전에 rtk를 거쳐라”라는 훅이 들어가요. 제 맥 설정에도 이 훅이 들어 있어요. 터미널 명령 전체에 걸리는 설정이라, 빼고 싶으면 settings.json에서 rtk hook claude 줄을 지우면 돼요. 그리고 제 맥의 RTK는 아래 공식 탭이 아니라 홈브루 기본 저장소의 rtk(0.48.0)로 깔려 있어요. 지금 아래 명령으로 깔면 버전과 라이선스가 제 것과 다를 수 있어요.

RTK 설치와 클로드 코드 연결 (맥OS, 공식 사이트 안내)

brew install rtk-ai/tap/rtk
rtk init --global
rtk gain

이름이 같은 다른 도구도 있어요. Rust Type Kit이라는 도구도 명령 이름이 rtk라서, 설치한 뒤 rtk gain이 안 되면 그쪽이 깔렸는지 볼 필요가 있어요. RTK 안내 문서도 설치한 뒤 rtk –version과 rtk gain으로 먼저 확인하라고 적고 있어요.

지금 업데이트해야 하나요?

10월 26일 기준 제 맥은 0.48.0이고, 홈브루 기본 저장소의 최신은 1.0.1, 깃허브 최신은 10월 25일 나온 1.1.0이에요. 아직 올리지 않았어요. 1.0에서 바뀐 게 커서요.

  • 명령 이름 일부가 바뀌었어요(proxy → bypass, –ultra-compact 삭제)
  • 기본 실행 파일의 라이선스가 바뀌었어요. Apache 2.0 판은 rtk-oss라는 이름으로 따로 나와요
  • rtk gain의 대표 절약률 계산이 바뀌었어요

기본판의 라이선스 조건이 어떻게 바뀌었는지는 변경 문서(BREAKING_CHANGES.md)에 있다고 해요. 저는 아직 그 문서를 읽지 않아서, 새 기본판의 사용 조건이 어떤지는 여기서 말할 수 없어요.

써 보니 어땠나요?

RTK는 설치하고 나면 클로드 코드가 알아서 거쳐 가는 도구예요. 대신 rtk gain의 큰 숫자 하나만 보고 판단하면 안 된다는 걸 이번에 알았어요. 명령별로 나눠 보니, 이번에 잰 범위에서 크게 줄어든 건 목록·상태·기록 명령이었고 검색은 그대로인 경우도 있었어요. 제 사용 한도를 얼마나 늘려 줬는지는 이 기록만으로는 말할 수 없어요. rtk gain의 토큰 수가 클로드 사용 한도에서 실제로 빠지는 양과 같은지는 확인하지 못했어요.

함께 읽을 글


2026년 10월 26일 기준.

참고한 자료

아이티플레인 · 만들면서 AI 도구를 매일 쓰는 개발자가 적습니다 · 소개 보기