跳轉到

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
brew install rtk
rtk init -g        # 寫入全域 agent 設定

# tokscale
npm i -g tokscale

參考來源