RTK, công cụ nén đầu ra lệnh cho Claude Code: giảm 60–90% token của đầu ra lệnh, không phải của toàn bộ phiên làm việc

Một bài hướng dẫn ngày 27 tháng 10 giới thiệu RTK, một công cụ giúp Claude Code đỡ tốn token khi chạy lệnh. RTK đứng giữa agent lập trình và chương trình dòng lệnh (shell), rồi lọc và nén đầu ra của lệnh trước khi mô hình đọc. Điểm cần sửa ngay trong tiêu đề gốc: con số tới 90% chỉ áp dụng cho đầu ra của các lệnh thường gặp, không phải tổng số token của cả phiên làm việc.

Ở đây, token là đơn vị mà mô hình dùng để đo lượng văn bản nó đọc và viết. Agent lập trình là chương trình AI viết và sửa mã theo yêu cầu của người dùng. Khi agent chạy lệnh, phần lớn token không đến từ yêu cầu của bạn. Phần lớn đến từ đầu ra của lệnh: một nhật ký kiểm thử dài, một danh sách tập tin dài hoặc một cảnh báo lặp lại nhiều lần.

RTK làm gì với đầu ra lệnh

RTK là một chương trình đơn, viết bằng ngôn ngữ Rust, chạy không cần cài thêm thư viện khác. Nó áp dụng bốn cách xử lý tùy theo loại lệnh.

Thứ nhất là lọc bỏ phần thừa, như ghi chú, khoảng trắng và phần mở đầu rườm rà. Thứ hai là gom nhóm các mục giống nhau, ví dụ gom lỗi theo quy tắc và theo tập tin. Thứ ba là cắt phần lặp, chỉ giữ phần liên quan. Thứ tư là gộp các dòng nhật ký trùng nhau thành một dòng kèm số lần lặp.

Ví dụ cụ thể từ tài liệu gốc như sau. Lệnh xem lịch sử mã nguồn chỉ giữ mã băm, tác giả và tiêu đề, thay vì toàn bộ chi tiết. Lệnh chạy kiểm thử chỉ hiện các kiểm thử lỗi, còn các kiểm thử đạt được gộp thành một con số. Lệnh kiểm tra mã nguồn gom lỗi theo quy tắc và theo tập tin, thay vì lặp lại cùng một lỗi nhiều lần.

RTK hỗ trợ hơn 100 lệnh thuộc nhiều nhóm. Các nhóm gồm Git, GitHub CLI, JavaScript, Python, Go, Ruby, .NET, JVM, PHP, Docker, Kubernetes, AWS và Terraform. Tài liệu gốc cũng ghi rõ thời gian xử lý thêm dưới 10 mili giây cho mỗi lệnh.

Cài đặt trong khoảng 10 phút

Các bước dưới đây lấy từ bài hướng dẫn và đối chiếu với tài liệu gốc trên GitHub.

brew install rtk                 # macOS và Linux
winget install rtk-ai.rtk        # Windows

Sau khi cài, cần kiểm tra đã cài đúng gói hay chưa. Lý do là có một dự án khác cũng tên "rtk" trên kho gói của Rust.

rtk --version
rtk gain        # phải hiện bảng tiết kiệm, không phải lỗi không tìm thấy lệnh

Nếu bảng tiết kiệm hiện ra, bạn đã cài đúng gói. Bước tiếp theo là gắn RTK vào Claude Code.

rtk init -g

Lệnh này thêm một hook, tức một điểm chặn tự động, vào Claude Code. Hook này thuộc loại PreToolUse, nghĩa là chạy trước khi công cụ dòng lệnh được dùng. Sau đó, khởi động lại Claude Code và chạy thử một lệnh như xem trạng thái mã nguồn. Phía sau hậu trường, lệnh được viết lại thành dạng qua RTK và agent chỉ nhận bản đã nén. Agent không cần tự gọi RTK.

Cùng một ý tưởng áp dụng cho 18 công cụ khác. Ví dụ, Codex dùng cờ --codex, Gemini CLI dùng cờ --gemini và Cursor dùng cờ --agent cursor.

Bẫy thường gặp: hook chỉ thấy lệnh shell

Đây là điểm khiến nhiều người tưởng công cụ bị hỏng. Hook chỉ kích hoạt với lệnh gọi qua công cụ dòng lệnh Bash. Các công cụ đọc và tìm kiếm có sẵn của Claude Code, như Read, Grep và Glob, không đi qua shell. Vì vậy, RTK không thấy chúng.

Có hai cách xử lý. Cách thứ nhất là dặn agent ưu tiên dùng lệnh shell như cat, rg và find để đọc và tìm kiếm. Một dòng trong tập tin CLAUDE.md, ví dụ "use rg and cat through Bash for search and reading", là đủ cho nhiều dự án. Cách thứ hai là để agent gọi trực tiếp rtk read, rtk grep và rtk find.

Sau vài phiên làm việc, bạn có thể kiểm tra tiết kiệm thật bằng các lệnh sau.

rtk gain              # bảng tóm tắt
rtk gain --graph      # biểu đồ 30 ngày gần nhất
rtk gain --daily      # tiết kiệm theo từng ngày
rtk discover          # lệnh đã chạy mà RTK có thể nén nhưng chưa nén

Trong bốn lệnh trên, rtk discover hữu ích nhất. Lệnh này chỉ ra chỗ bạn vẫn đang rò rỉ token.

Con số 90% cần hiểu đúng

Tài liệu gốc trên GitHub ghi rõ phạm vi của con số. RTK giảm lượng token tiêu thụ từ 60% đến 90% trên các lệnh thường gặp. Đây là mức giảm của đầu ra lệnh, không phải của toàn bộ hóa đơn.

Lý do là chuỗi pha loãng gồm ba nấc. Đầu ra lệnh chỉ là một phần đóng góp vào token đầu vào. Token đầu vào gồm cả yêu cầu của bạn, yêu cầu hệ thống và lịch sử trò chuyện. Token đầu vào lại chỉ là một phần của hóa đơn, vì hóa đơn còn tính token đầu ra mà mô hình viết ra.

Một lưu ý khác liên quan đến cách đo. RTK ước tính số token bằng cách lấy số byte chia cho 4. RTK không kèm bộ tách token thật. Vì vậy, tỷ lệ phần trăm được coi là đáng tin, nhưng số token tuyệt đối chỉ là ước tính.

Cách nói đúng về RTK là như sau. RTK giảm mạnh phần token đến từ đầu ra lệnh thường gặp. Mức giảm tổng hóa đơn sẽ thấp hơn, tùy theo tỷ trọng đầu ra lệnh trong phiên làm việc của bạn. Đừng dùng con số 90% để hứa hẹn giảm 90% hóa đơn.

Chọn bản nào: bản đầy đủ hay bản mã nguồn mở

Bản rtk mặc định trộn hai giấy phép: Apache-2.0 và BUSL-1.1. Giấy phép là điều khoản pháp lý cho phép dùng, sửa và phân phối phần mềm. Dùng trong sản xuất được miễn phí. Giới hạn của giấy phép BUSL là không được cung cấp RTK hoặc sản phẩm phái sinh cho bên thứ ba dưới dạng sản phẩm hay dịch vụ thương mại.

Nếu nhóm của bạn cần bản chỉ dùng Apache-2.0, hãy cài rtk-oss thay thế. Lệnh trên macOS là brew install rtk-ai/tap/rtk-oss. Hai bản cài cùng một chương trình tên rtk, nên không thể cài chung. Cần gỡ bản này trước khi cài bản kia.

Ngoài ra còn có rtk-proxy, một chương trình riêng nén cả lưu lượng gọi API. Chương trình này cũng dùng giấy phép BUSL-1.1. Tài liệu gốc khuyên thử hook cơ bản trước, rồi mới tính đến proxy.

Trước khi bật RTK, kiểm tra ba điều

• Chạy rtk gain và chắc chắn bảng tiết kiệm hiện ra, để biết bạn đã cài đúng gói.
• Thử trên một kho mã nhỏ trước, và dùng rtk bypass <lệnh> khi agent bắt đầu thiếu chi tiết ở một lệnh cụ thể. Lệnh bypass chạy lệnh gốc không lọc, nhưng vẫn ghi nhận để đo.
• Đo bằng rtk gain và rtk discover trước khi kết luận về tiết kiệm. Đừng báo cáo con số 90% khi chưa đo trên chính phiên làm việc của mình.

RTK không thay đổi cách bạn ra lệnh cho agent. Giá trị của nó nằm ở chỗ dọn dẹp phần đầu ra mà agent phải đọc mỗi lần. Hiểu đúng phạm vi con số sẽ giúp bạn đặt kỳ vọng đúng và đo được lợi ích thật.

Nguồn tham khảo

• DEV Community, dedupedai, "How to cut Claude Code token use by up to 90% with RTK (setup in 10 minutes)", bài hướng dẫn gốc ngày 27 tháng 10 năm 2026.
• GitHub, rtk-ai/rtk, tài liệu gốc của dự án, gồm phạm vi tiết kiệm, danh sách lệnh hỗ trợ, giấy phép và cách đo.