AI 칼럼

코딩@donghyeok99운영진

RTK: 에이전트가 읽는 명령 출력을 줄여 주는 CLI

cargo test 71줄을 에이전트는 11줄로 읽어요. 명령 출력을 읽기 전에 걸러 주는 Rust 바이너리예요

cargo test가 쏟아 낸 71줄이 rtk를 지나며 실패한 테스트와 요약만 남은 11줄로 줄어드는 모습이에요.
cargo test가 쏟아 낸 71줄이 rtk를 지나며 실패한 테스트와 요약만 남은 11줄로 줄어드는 모습이에요.
누가
Patrick Szymkowiak과 코어 팀(rtk-ai)이, 코딩 에이전트의 토큰을 아끼려는 개발자를 위해 만들어요.
언제
2026년 1월에 저장소가 열렸고, 2026년 11월 12일에도 개발 빌드(dev-1.2.1-rc.637)가 올라왔어요.
어디서
Claude Code, Codex, Cursor, Gemini CLI 등 18개 도구에서, macOS·Linux·Windows·WSL의 내 컴퓨터 안에서 돌아요.

이게 불편했어요

에이전트에게 테스트를 돌리라고 하면, 통과한 테스트 수백 줄과 진행 표시까지 전부 대화 안으로 들어가요. git status나 빌드 로그도 마찬가지라서, 정작 필요한 실패 한 건을 찾으려고 매번 긴 출력을 통째로 읽게 돼요.

그래서 이렇게 풀어요

RTK는 에이전트와 셸 사이에 끼어서 명령 출력을 읽기 전에 줄여요. 훅이 git status를 rtk git status로 바꿔 실행하고, 명령마다 따로 쓴 필터가 실패한 테스트나 바뀐 파일처럼 필요한 줄만 남겨요. 필터가 실패하면 원본을 그대로 주고 종료 코드도 건드리지 않으며, 잘린 출력에는 전체를 볼 곳이 적혀 있어요.

훅을 등록하고 테스트를 시킨 뒤 rtk gain으로 절약량을 확인하는 터미널
훅을 등록하고 테스트를 시킨 뒤 rtk gain으로 절약량을 확인하는 터미널
48개 테스트 크레이트의 cargo test: 원본 71줄과 rtk를 거친 11줄
48개 테스트 크레이트의 cargo test: 원본 71줄과 rtk를 거친 11줄

이걸로 만든 사람들

dev.toJangwook Kim2026-05-22

자기 블로그 저장소에 RTK를 깔고 여섯 가지 명령의 출력을 직접 재 본 글이에요. 평균 60.6%가 줄었다고 적었어요.

60.6% average across 6 commands.
quesma.comQuesma2026-09-11

Terminal-Bench 2.1을 RTK를 켠 채와 끈 채로 돌려 실제 청구 비용을 비교한 글이에요. 줄어든 출력만큼 비용이 줄지는 않았고, 모델에 따라 5% 내리거나 올랐다고 해요.

With RTK, costs fell by 5% for Fable and rose by 5% for DeepSeek.

안에서는 이렇게 돌아가요

  1. 1

    나 → rtk

    rtk init -gClaude Code 설정에 훅을 한 번 등록해요.src/hooks/init/claude.rs
  2. 2

    Claude Code → rtk-rewrite.sh 훅

    실행하려는 셸 명령에이전트가 명령을 돌리기 직전에 훅이 그 명령 문자열을 받아요.hooks/claude/rtk-rewrite.sh
  3. 3

    rtk-rewrite.sh 훅 → rtk

    rtk rewrite "cargo test"바꿀 수 있는 명령인지는 Rust 쪽 규칙표 한 곳에서 정해요. 없으면 그대로 통과해요.src/discover/registry.rs
  4. 4

    rtk → Claude Code

    rtk cargo test의 줄어든 출력명령을 실제로 돌린 뒤 실패한 테스트와 요약만 남겨 돌려줘요.src/cmds/rust/cargo_cmd.rs
  5. 5

    rtk → 로컬 기록(SQLite)

    원본과 줄인 크기명령마다 얼마나 줄었는지를 내 컴퓨터에 적어 둬요.src/core/tracking.rs
  6. 6

    로컬 기록(SQLite) → rtk gain 현황판

    rtk gain쌓인 기록으로 명령별 절약량과 비율을 보여 줘요.src/analytics/gain.rs

넣으면 이렇게 나와요

cargo test (테스트 48개, 원본 71줄)실패한 테스트의 panic·단언·위치와 요약 11줄
git status 40줄3줄 요약
git log커밋마다 한 줄

나한테 맞을까요

이럴 때 좋아요

  • 에이전트가 테스트와 빌드를 자주 돌려서 대화가 금방 길어지는 프로젝트
  • 여러 코딩 에이전트를 쓰면서 같은 절약 방식을 한 번에 깔고 싶을 때
  • 명령별로 얼마나 줄었는지 숫자로 보고 싶을 때

이건 안 돼요

  • README 기준, 명령 출력 90% 감소가 비용 90% 감소는 아니에요. 명령 출력은 입력 토큰의 일부예요.
  • 토큰 수는 bytes / 4로 어림한 값이라 비율은 믿을 만하지만 절대 숫자는 근사치예요.
  • 훅은 셸 명령만 바꿔요. Read·Grep·Glob 같은 내장 도구는 기본 설정에서 그대로 지나가요.
  • CLI는 Apache-2.0이지만 파이프라인 엔진과 프록시는 BUSL-1.1이에요. 회사에서 쓰는 건 무료이고, RTK를 상품으로 되파는 건 안 돼요.

발행 전에 Devalley 편집자가 검토했어요. 칼럼은 어떻게 만드나요

로그인하면 글을 쓰고 댓글과 좋아요로 참여할 수 있어요.로그인

신고하기

사유

커뮤니티 규칙 보기