RTK (Rust Token Killer) 安装、使用与卸载指南

4 阅读3分钟

1. 简介

RTK(Rust Token Killer)是一个用于 AI 编程代理的 Token 优化工具。它会在命令输出进入 LLM 上下文之前进行过滤和压缩,从而减少 Token 消耗。

RTK 默认仅在本地运行,不上传数据,不修改文件或 Git 历史。过滤失败时会回退到原始命令执行。

注意:存在另一个同名项目 rtk(Rust Type Kit)。运行 rtk gain 可验证是否安装正确版本。


2. 安装

2.1 Homebrew(macOS / Linux)

brew install rtk

2.2 一键安装脚本(Linux / macOS)

curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/main/install.sh | sh

2.3 Cargo 安装

必须从 Git 源码安装,避免安装到错误的 rtk 包:

cargo install --git https://github.com/rtk-ai/rtk

2.4 预编译二进制

从 GitHub Releases 下载对应平台文件:

  • macOS:rtk-aarch64-apple-darwin.tar.gz 或 rtk-x86_64-apple-darwin.tar.gz
  • Linux:rtk-x86_64-unknown-linux-musl.tar.gz 或 rtk-aarch64-unknown-linux-gnu.tar.gz
  • Windows:rtk-x86_64-pc-windows-msvc.zip

Windows 用户需将 rtk.exe 放入 PATH,并从命令行运行。

2.5 验证安装

rtk --version
rtk gain

如果 rtk gain 报错,说明可能安装了错误的 Rust Type Kit:

cargo uninstall rtk
cargo install --git https://github.com/rtk-ai/rtk

3. 初始化

3.1 通用语法

rtk init [选项] [--工具名]

常用参数:

  • -g / --global:全局安装
  • --codex:集成到 Codex
  • --gemini:集成到 Gemini CLI
  • 不指定工具时默认集成 Claude Code

3.2 各工具初始化命令

工具命令
Claude Codertk init -g
Codexrtk init -g --codex
Gemini CLIrtk init -g --gemini

-g 是 --global 的简写。为 Codex 安装时必须加 --codex。

3.3 Codex 集成

rtk init -g --codex

该命令会在 ~/.codex/ 下创建或更新:

  • RTK.md
  • hooks.json
  • AGENTS.md

验证:

rtk init --show --codex

成功示例:

[ok] Global RTK.md: /Users/xxf/.codex/RTK.md
[ok] Global hook: /Users/xxf/.codex/hooks.json
[ok] Global AGENTS.md: RTK.md reference
[--] Local RTK.md: not found
[ok] Local hook: .codex/hooks.json
[--] Local AGENTS.md: not found

[--] not found 表示当前项目没有本地配置,不影响全局生效。

3.4 Codex Hook 信任

安装后,Codex 不会自动执行 Hook,需要手动信任:

  1. 启动 Codex 时,如出现 Hooks need review,选择 Trust all and continue
  2. 如果错过提示,在 Codex 会话中输入 /hooks
  3. 找到 RTK 相关条目,点击 Trust 或 Enable

更新 RTK 或 Hook 文件变化后,需要重新信任。


4. 使用

4.1 自动模式

完成初始化和 Hook 信任后,Codex 中的已知命令会被自动改写为 RTK 版本,无需手动加 rtk。

4.2 手动模式

如果 Hook 未生效,可手动加 rtk 前缀:

rtk git status
rtk npm test
rtk docker ps

4.3 常用命令

原始命令RTK 命令说明
git statusrtk git status紧凑 Git 状态
git log -n 10rtk git log -n 10单行提交记录
cat <file>rtk read <file>智能读取文件
rg <pattern>rtk grep <pattern>分组搜索结果
find "*.rs" .rtk find "*.rs" .紧凑查找结果
cargo testrtk test cargo test仅显示失败测试
ls -lartk ls优化目录列表

4.4 查看节省统计

rtk gain

常用参数:

rtk gain --reset --yes
rtk gain --weekly --format csv

统计数据库位置:

~/.local/share/rtk/history.db

4.5 遥测设置

遥测默认关闭:

rtk telemetry status
rtk telemetry enable
rtk telemetry disable

遥测开关不影响本地功能。


5. 卸载

5.1 卸载 Codex 集成

rtk init -g --uninstall --codex

预览删除内容:

rtk init -g --uninstall --codex --dry-run

5.2 卸载 Claude Code 集成

rtk init -g --uninstall

5.3 卸载 RTK 二进制

# Homebrew
brew uninstall rtk

# Cargo
cargo uninstall rtk

5.4 清理残留数据

rm -rf ~/.local/share/rtk

6. 常见问题

问题原因解决方案
rtk gain 报 command not found安装了错误的 Rust Type Kit卸载后从正确 Git 仓库重装
Codex Hook 未生效Hook 未信任在 Codex 中输入 /hooks 并信任
Windows 自动过滤失效Codex 桌面端沙箱限制改用 WSL 运行 Codex 和 RTK
卸载提示 nothing to remove未使用全局模式加 -g 参数
遥测是否影响功能不影响只控制匿名数据上报

7. 参考链接