AI 编程助手省 80% token 的神器 RTK

RTK(Rust Token Killer)教学文档

❝
一个 CLI 代理工具,给 AI 编程助手(如 Claude Code)用的。它拦截常见开发命令的输出,过滤 + 压缩后再喂给 AI,把 token 消耗降低 60%–90%。
单个 Rust 二进制文件,零依赖。本机实测:rtk ls 比原生 ls 省 89.7% 的 token。

1. 它解决什么问题?

AI 助手是按 token(约等于"词") 计费的。你跑一个 ls、npm test、git log,终端吐出来一大坨文本,这些文本全部进入 AI 的上下文,既花钱又占窗口。

普通命令输出 ──► (一坨原始文本,几百~几万 token) ──► AI 读
rtk 拦截      ──► (过滤掉噪音,精简成核心信息) ──► AI 读

RTK 做的就是中间那一步:同样的命令,更少的 token,信息不丢。

场景	原始输出	rtk 输出	节省
`ls` 一堆文件	带权限位、属主、时间戳	只留文件名+大小	~90%
`npm test`	全部用例 + 通过项	只显示失败项	~80%
`git log`	完整提交信息	紧凑哈希+首行	~70%

2. Windows 安装(本机实际方式)

❝
本机环境:Windows 10,装在 C:\soft\rtk-x86_64-pc-windows-msvc\

步骤

下载去 https://github.com/rtk-ai/rtk/releases ,下载 Windows 版:
```
rtk-x86_64-pc-windows-msvc.zip
```
(x86_64 = 普通 64 位 Intel/AMD 电脑;ARM 机器选 aarch64 那个)

解压解压到任意目录,例如:

C:\soft\rtk-x86_64-pc-windows-msvc\
└── rtk.exe

加入 PATH 环境变量

Win 键搜「环境变量」→「编辑系统环境变量」→「环境变量」按钮
在「用户变量」或「系统变量」里找到 Path → 编辑 → 新建
粘贴路径:C:\soft\rtk-x86_64-pc-windows-msvc
一路确定

验证安装(新开一个终端!)
```
rtk --version
```
看到 rtk 0.42.4 之类的版本号 = 成功。

❝
⚠️ 注意名字撞车:网上还有个完全无关的项目叫 rtk(Rust Type Kit)。如果你 rtk gain 报错但 rtk --version 正常,说明装错了。用 where rtk(Windows)/which rtk(Mac/Linux)确认二进制路径。

3. 三分钟速览:核心命令

RTK 的命令大多是把原生命令前面加 rtk:

rtk ls              # 列目录(精简)
rtk read 文件        # 读文件(智能过滤)
rtk git status      # git 状态(紧凑)
rtk test# 跑测试,只显示失败
rtk diff            # diff,只显示改动行
rtk json file.json  # JSON 压缩显示

三种"特殊"命令(记住这三个)

命令	干什么	什么时候用
`rtk <cmd>`	拦截并过滤命令	默认都用这个
`rtk proxy <cmd>`	原样执行,不过滤,只统计	想看完整输出时
`rtk run <cmd>`	原样执行,不统计也不过滤	rtk 不认识这个命令时

4. 实际跑起来:对比演示

❝
下面是我在这台机器上真实运行的结果,你可以照着敲一遍。

演示 1:`ls` 省了多少

# 原生 ls(每行前面带权限位 755,占 token)
ls -la C:/Windows/Fonts

输出:

755  8514fix.fon  10.7K
755  8514fixe.fon 10.7K
755  8514fixg.fon 11.2K

# rtk ls(去掉权限位噪音)
rtk ls C:/Windows/Fonts

输出:

8514fix.fon  10.7K
8514fixe.fon 10.7K
8514fixg.fon 11.2K

信息没丢(文件名、大小都在),但每一行少了 755 那段。文件越多,省得越多。

演示 2:看节省统计

rtk gain

真实输出(本机跑了一次 rtk ls 后):

RTK Token Savings (Global Scope)
═══════════════════════════════════════
Total commands:    1
Input tokens:      39
Output tokens:     4
Tokens saved:      35 (89.7%)
Efficiency meter: ██████████████████████░░ 89.7%

解读:39 个原始 token 被压成 4 个,省了 35 个,省了 89.7%。在一个真实项目里跑一天,命令成百上千次,这个数字会非常可观。

5. 跟 Claude Code 联动(自动模式)

RTK 真正的威力,是让 AI 助手自动用它。和 Claude Code 配合时:

rtk init

这会在 Claude Code 里装一个 hook(钩子),之后你在 Claude Code 里说"看看目录里有什么",它内部跑的 ls 会被自动改写成 rtk ls,你不用手动加 rtk。

完成后再跑:

rtk session      # 看哪些 Claude Code 会话用上了 rtk
rtk discover     # 分析历史,找出"本该用 rtk 却没用"的命令
rtk learn        # 从历史报错里学习,自动纠正命令

6. 配置文件

rtk config

显示配置文件位置(本机):

C:\Users\lawrence\AppData\Roaming\rtk\config.toml

里面的关键项:

[display]
max_width = 120        # 输出最大宽度,超宽截断

[filters]
ignore_dirs = [".git", "node_modules", "target", ...]   # 列目录时忽略这些
ignore_files = ["*.lock", "*.min.js", ...]              # 忽略这些文件

想自定义?直接编辑这个 .toml 文件即可。

7. 常用命令速查表

想做的事	命令
看总共省了多少 token	`rtk gain`
看历史命令明细	`rtk gain --history`
找出漏掉没用 rtk 的命令	`rtk discover`
列目录(精简)	`rtk ls` / `rtk tree`
读文件(智能过滤)	`rtk read 文件`
git 状态/日志	`rtk git status` / `rtk git log`
跑测试只看失败	`rtk test`
diff 只看改动	`rtk diff`
看完整不过滤的输出	`rtk proxy 命令`
执行 rtk 不认识的命令	`rtk run 命令`
看配置	`rtk config`
看所有命令帮助	`rtk --help`

8. 排错

问题	解决
`rtk: command not found`	PATH 没配对 / 没重开终端。`where rtk` 检查路径
`rtk gain` 报奇怪错误	可能装到了同名的「Rust Type Kit」。重新装对的那个
某命令 rtk 不认识	用 `rtk run <cmd>` 或 `rtk proxy <cmd>`
想看原始完整输出	`rtk proxy <cmd>` ,不过滤

一句话总结:RTK = 给 AI 看的"输出压缩器"。前面加 rtk,token 省一半以上。rtk gain 看效果。