🚀 【實戰教學】用 RTK 幫 AI 程式碼助理瘦身！大幅節省 60%~90% Token 消耗
在日常使用 Claude Code、Cursor、Trae 或 Gemini CLI 等 AI 輔助開發時，終端機（CLI）輸出的落落長訊息（例如：
git status 列出一大堆變更、npm test / pytest 噴出幾百行測試日誌）往往是吃掉上下文 Token 的元兇。RTK (rtk-ai/rtk) 是一款用 Rust 撰寫的超輕量 CLI 代理工具，能自動攔截並智慧過濾這些冗長輸出，在不損失重要錯誤訊息的前提下，將 Token 消耗直接砍半甚至減少 90%！📋 目錄
一、環境需求與前置觀念
- 作業系統：Windows 11
- 開發環境：VS Code 內建 Terminal（建議切換至 Git Bash）
- 運作原理： RTK 扮演輕量級代理。當 AI 或你手動執行指令時，RTK 會在本地端進行去重複、壓縮樣板文字（Boilerplate）、群組化檔名，最後僅將高濃度的資訊傳給 AI 讀取。
第一步：Windows 11 下的手動安裝與 PATH 設定
由於 Windows 上的 Git Bash 環境無法直接執行 Linux 的 Shell 安裝腳本，手動下載單一
.exe 執行檔是最快且最穩定的方式。第二步：專案與全域初始化設定
安裝完成後，需要讓 RTK 知道要在哪些專案中介入運作。
1. 單一專案初始化（專案目錄下執行）
切換到你當前開發的專案根目錄，執行：
Bash
rtk init
- 運作結果：
- 會自動建立/更新專案中的
CLAUDE.md（或 IDE 指示檔），提示 AI 開發助理主動套用rtk。 - 會生成
.rtk/filters.toml，供你針對該專案自訂過濾規則。
2. 全域 Hook 與代理初始化（推薦）
如果你希望這台電腦上的所有專案、以及 AI 代理執行的 Bash 命令預設都經過 RTK 過濾，請執行：
Bash
rtk init -g
- 運作結果：
- 將 Hooks 與 Proxy 設定寫入全域設定（如
~/.rtk/），讓 CLI 工具在背後發起的命令自動被攔截與瘦身。
第三步：日常使用技巧與語法實戰
1. 自動化模式（最常用）
在
rtk init 後，像 Claude Code 或 Trae / Cursor 內的 Agent 在 Terminal 幫你跑 git status、git diff 或 npm test 時，AI 自動就會讀到被 RTK 壓縮後的版本，你不需要改變任何操作習慣！2. 手動前綴測試
如果你自己在寫 Prompt，或者想看看某個指令被壓縮成什麼樣子，直接在指令最前面加上
rtk：Bash
# 測試 Git 狀態過濾
rtk git status
# 測試大型測試套件過濾
rtk npm test
# 或
rtk pytest
# 測試目錄樹過濾
rtk ls -la
3. 查看累積省下了多少錢 (Token)
想知道 RTK 實際上幫你省了多少資源？隨時輸入：
Bash
rtk gain
系統會印出漂亮的統計儀表板，顯示：
- 處理過的指令總數
- 原始輸出的位元組 / Token 數
- 壓縮後節省的 Token 數與百分比
第四步：自訂過濾規則 (.rtk/filters.toml)
執行
rtk init 後產生的 .rtk/filters.toml 是你控管壓縮邏輯的核心。你可以針對專案特有的 Log 或輸出格式進行微調：Ini, TOML
# .rtk/filters.toml 範例
[general]
# 是否啟用過濾器
enabled = true
# 針對特定指令的過濾樣式
[filters.git]
# 自動隱藏未追蹤檔中的雜項編譯檔
ignore_patterns = [
"*.log",
"node_modules/",
"vendor/"
]
[filters.test]
# 只保留失敗的測試案例 details，通過的測試自動收摺為計數
show_only_failures = true
小技巧：如果發現某個第三方套件輸出的 Warning 訊息太洗版，可以在ignore_patterns加入關鍵字，直接在送給 AI 之前將其過濾。
五、常見問題與維護指令
| 問題 / 需求 | 解決方案 / 命令 |
| 想要停用或啟用匿名遙測 (Telemetry) | 停用： rtk telemetry disable啟用： rtk telemetry enable |
下指令後出現 command not found: rtk | 代表環境變數未載入，請確認 C:\tools 已加入 PATH，並重新開啟 VS Code / Terminal。 |
| 不想讓某個指令被 RTK 過濾 | 直接執行原指令即可（不要加 rtk 前綴），或是暫時停用 .rtk/filters.toml 中的對應選項。 |
| 想更新 RTK 到最新版本 | 至 Releases 頁面下載最新 rtk.exe 覆蓋 C:\tools\rtk.exe 即可。 |
💡 總結
設定好
rtk.exe 並完成 rtk init -g 後，你不需要改變任何開發習慣，系統就會在背景默默壓縮每一次 terminal 輸出。對於長度動輒幾千 Token 的大型專案而言，能顯著降低 API 成本並提升 AI 助理的回應速度！