RTK+tokscale:一個省 Token、一個看用量¶
整理自 RTK 0.49.0 與 tokscale 4.0.4 的說明,加上我本機的實際統計,2026-10-04。
一句話¶
RTK 把指令輸出壓小,再交給 agent 讀。tokscale 讀本機的對話紀錄,告訴你到底花了多少 token。前者負責省,後者負責看省了有沒有用。
RTK:指令輸出先過濾¶
解決什麼¶
Agent 跑 ls、grep、pytest、git diff,輸出整坨塞進 context。一個資料夾有幾千個檔案,ls 一次就吃掉幾萬 token,裡面多半是 agent 用不到的東西。
RTK(Rust Token Killer,rtk-ai/rtk,Apache-2.0)是一個 CLI 代理。指令照跑,輸出先去掉雜訊、合併重複、截斷,再交出去。
怎麼接進 Claude Code¶
掛在 PreToolUse hook(agent 呼叫工具之前自動執行的指令),只攔 Bash:
{
"matcher": "Bash",
"hooks": [
{ "type": "command", "command": "/home/linuxbrew/.linuxbrew/bin/rtk hook claude" }
]
}
agent 照常下 git status,hook 會把它改寫成 rtk git status。agent 不用記任何新指令。
另外在全域指示檔放了一小段說明,告訴 agent 輸出是壓縮過的,當成完整結果看。只有在結果明顯壞掉時(該有輸出卻是空的、跟 exit code 對不上、亂碼),才用 rtk proxy <指令> 拿原始輸出。
rtk init -g 會把 RTK 的說明寫進全域 agent 設定。
支援的指令¶
ls、tree、find、grep、rg、git、gh、diff、docker、kubectl、psql、aws、pnpm、jest、vitest、pytest 等。rtk test 只顯示失敗的測試,rtk err 只顯示錯誤和警告。
我一個月的數字¶
rtk gain 會記錄每次省了多少。我從 2026-09 開始用:
| 月份 | 指令數 | 原始輸出 | 實際交出 | 省下 | 比例 |
|---|---|---|---|---|---|
| 2026-09 | 4,852 | 5.1M | 1.1M | 4.0M | 78.8% |
| 2026-10(前 3 天) | 904 | 196K | 96K | 100K | 50.9% |
78.8% 看起來很漂亮,拆開來看沒那麼平均:
| 指令 | 次數 | 平均省 |
|---|---|---|
rtk read |
791 | 18.5% |
rtk grep |
1,403 | 26.1% |
rtk find |
81 | 15.0% |
rtk pytest -q |
29 | 87.2% |
rtk ls 大資料夾(單次) |
1 | 99%+ |
日常的 read、grep、find 只省 15–26%。總比例會衝到快八成,靠的是少數幾次超大輸出:對一個放分 K 資料的資料夾跑 ls,一次就省 4 萬多 token。
所以 RTK 真正的價值是擋住意外。平常省一點,偶爾 agent 手滑列了一個巨大目錄,那一次就省下幾萬 token。
放回總用量看¶
只看 78.8%,會以為帳單少了八成。同一個月,tokscale 統計我所有 agent 的非快取 input 大約 3,400 萬 token。RTK 省的 400 萬,大約是一成多。
這個比較會低估 RTK。一段輸出進了 context,之後每一輪都會再被讀一次(多半走快取讀取),RTK 只算它省下的那一次。實際省的比表上多,但我沒有辦法精確算出多多少。
要注意¶
- 壓縮可能剛好剪掉你要的那一行。上面那段「什麼時候用
rtk proxy」的說明就是為這個寫的。 - hook 改寫指令時,會同時回傳
"permissionDecision":"allow"。被改寫的指令不會再跳權限確認。我餵它git status和pytest -q都是這樣。如果你靠權限確認擋危險指令,要知道這件事。 - 本庫的 9Router 文章提到,RTK 對 JSON mode 這類結構化輸出可能誤傷。
tokscale:用量統計¶
解決什麼¶
同時用 Claude Code、Codex、Hermes,每家帳單分開,很難知道總共花了多少、花在哪個模型。
tokscale(junhoyeo/tokscale,MIT)直接讀各 agent 寫在本機的對話紀錄,例如 ~/.claude/projects/*.jsonl 和 ~/.codex/sessions/,不需要任何 API key。
常用指令¶
tokscale usage # 各家訂閱的配額剩多少、什麼時候重置
tokscale monthly # 每月用量與估算成本
tokscale models # 按模型拆
tokscale clients # 掃到哪些 agent、各幾個 session
tokscale monthly --json # 給腳本用
不要跑 tokscale submit。 它會把用量上傳到公開排行榜。
每小時推到 Discord¶
我用 WSL 的 cron 每小時跑一支 Python 腳本:呼叫 tokscale usage --json,整理成一則訊息,用 Discord bot 私訊給自己。
0 * * * * /usr/bin/python3 /home/user/.claude/scripts/push_tokscale_usage.py >> /tmp/tokscale-discord.log 2>&1
有一個坑:cron 的 PATH 很短,找不到裝在 ~/.hermes/node/bin 下的 tokscale 和 node。腳本裡要自己把那個資料夾補進 PATH。
手機上看到配額快用完,就知道該換模型或先停手。
安裝¶
參考來源¶
- rtk-ai/rtk — GitHub、rtk-ai.app
- junhoyeo/tokscale — GitHub
- 本機統計:
rtk gain、rtk gain -m、tokscale monthly --json(2026-10-04 執行)