Tools #AI Agents #Claude Code #Productivity #Rust

RTK 終端機 Token 殺手安裝與實測:省下 70% 以上 Claude Code 費用

RTK (Rust Token Killer) 是一個基於 Rust 的高效能 CLI 代理工具,能自動過濾與壓縮終端機輸出,為 AI 輔助開發節省 60-90% 的 Token 消耗。

5 min read/ Medium

前言:為什麼我們需要壓縮 Terminal 輸出?

在使用 Claude Code、Cursor 或 Cline 等 AI 工具時,AI 經常需要執行 git statusnpm list 或跑測試等指令。這些指令的原始輸出往往夾帶大量重複的日誌、多餘的空格與提示文字。

這些雜訊會被一字不漏地塞進 LLM 的 Context 中,不僅導致 Token 消耗暴增(費用飆高),還會拖慢 AI 的響應速度,甚至干擾 AI 的判斷。

RTK (Rust Token Killer) 作為終端與 AI 工具之間的代理,在輸出傳給 LLM 之前,先進行極限過濾與壓縮,實測能省下 60% 至 90% 的 Token 消耗


📈 實測效果:Token 直接省下 72%

在我們開發本站時,僅執行最基礎的 lsgit status 指令,RTK 便為我們省下了 72% 的 Token 消耗:

RTK 節省 Token 效果

執行 rtk gain 看到的節省成效

在日常開發的各種常見指令中,RTK 的 Token 減量效果十分顯著:

執行命令原始輸出字元 / Token 數RTK 壓縮後節省比例 (Reduction)
vitest (測試出錯時)102,199 字符377 字符-99.6%
git status529 字符217 字符-59.0%
pnpm list~8,000 tokens~2,400 tokens-70.0%
cargo test / pytest25,000 tokens2,500 tokens-90.0%

長期使用下來,一個 30 分鐘的 AI coding session,Token 總消耗能直接從 15 萬降至 4.5 萬左右,API 費用直接打三折,且能讓 AI 響應速度大幅提升。

常用優化指令速查

即使不靠自動重寫,你也可以在 AI 對話中手動指定使用 rtk 指令:

  • 樹狀目錄結構(自動隱藏 node_modules 等雜訊):
    bash
    rtk ls .
    
  • 智慧讀檔與代碼壓縮
    bash
    rtk read src/App.tsx
    
  • 僅提取簽章 (Signatures)(只顯示類別與函數定義,不顯示實作細節,最省 Token):
    bash
    rtk read src/utils.ts -l aggressive
    
  • 精簡測試輸出(自動攔截 stdout,測試通過僅顯示 ok,失敗則只抽取出錯的 Assertion):
    bash
    rtk test cargo test
    

⚠️ 避坑指南:裝對 RTK 才是關鍵

!WARNINGcrates.io 上存在兩個完全不同的專案都叫 rtk

  1. Rust Token Killer (本專案) - LLM 終端 Token 優化器 (儲存庫:rtk-ai/rtk)
  2. Rust Type Kit (其他專案) - 程式碼結構查詢與類型生成工具 (儲存庫:reachingforthejack/rtk)

在安裝前或使用中,AI 助理應始終驗證是否安裝了正確的版本:

bash
# 檢查版本
rtk --version

# 關鍵:驗證是否能正常執行 token 統計命令
rtk gain
  • 如果 rtk gain 成功顯示統計表,代表正確;如果失敗但有版本號,則是裝到了錯誤的 Rust Type Kit,請先執行 cargo uninstall rtk 卸載。

安裝與全域設定

1. 安裝正確的 Rust Token Killer

在 macOS 或 Linux 上,建議使用 Homebrew 或快速腳本安裝:

bash
# 方法 A:Homebrew 安裝 (推薦)
brew install rtk

# 方法 B:快速腳本安裝
curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh

# 方法 C:透過 Git 源碼編譯 (避免 crates.io 同名衝突)
cargo install --git https://github.com/rtk-ai/rtk

2. 全域自動重寫鉤子 (Auto-Rewrite Hook)

為了讓 AI Agent 執行命令時能自動套用 RTK(例如將 git status 自動轉為 rtk git status 執行),我們可以安裝全域鉤子:

bash
rtk init -g

💡 系統會提示 Patch settings.json? [y/N],請輸入 y。這會將 PreToolUse 攔截器寫入 Claude Code 的設定檔,並在 ~/.claude/settings.json.bak 自動備份。重啟 Claude Code 即可生效!


💻 Windows / WSL 相容性說明

!IMPORTANTWindows 用戶請注意相容性限制:

  • WSL (完整支援):運作與 Linux 相同,支援自動重寫 Hook。
  • Native Windows (部分支援):自動重寫 Hook 無法運作。初始化會降級為 CLAUDE.md 指令引導模式,使用者需要在終端機手動加上 rtk 前綴(如 rtk git status)。(請勿雙擊 rtk.exe,它僅供 CLI 調用)

💡 AI 助理核對清單 (AI Assistant Checklist)

作為 AI 助理,在執行命令前請遵循以下核對步驟:

  • 檢查安裝:用 rtk --version 檢查是否可用,並用 rtk gain 驗證是否為正確的 Token Killer。
  • 專案初始化:若尚未初始化,執行 rtk init
  • 代理執行:遇到會產生冗長輸出的指令(如 git、pnpm、測試執行器等),一律使用 rtk 作為代理。

黃金法則 (Golden Rule):AI 助理應主動善用 rtk 代理所有高冗長終端指令,以確保 Context 視窗清爽、高效!