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

1. 简介

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

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

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

2. 安装

2.1 Homebrew（macOS / Linux）

bash 复制代码

brew install rtk

2.2 一键安装脚本（Linux / macOS）

bash 复制代码

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

2.3 Cargo 安装

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

bash 复制代码

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 验证安装

bash 复制代码

rtk --version
rtk gain

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

bash 复制代码

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

3. 初始化

3.1 通用语法

bash 复制代码

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

常用参数：

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

3.2 各工具初始化命令

工具	命令
Claude Code	`rtk init -g`
Codex	`rtk init -g --codex`
Gemini CLI	`rtk init -g --gemini`

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

3.3 Codex 集成

bash 复制代码

rtk init -g --codex

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

RTK.md
hooks.json
AGENTS.md

验证：

bash 复制代码

rtk init --show --codex

成功示例：

text 复制代码

[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，需要手动信任：

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

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

4. 使用

4.1 自动模式

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

4.2 手动模式

如果 Hook 未生效，可手动加 rtk 前缀：

bash 复制代码

rtk git status
rtk npm test
rtk docker ps

4.3 常用命令

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

4.4 查看节省统计

bash 复制代码

rtk gain

常用参数：

bash 复制代码

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

统计数据库位置：

text 复制代码

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

4.5 遥测设置

遥测默认关闭：

bash 复制代码

rtk telemetry status
rtk telemetry enable
rtk telemetry disable

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

5. 卸载

5.1 卸载 Codex 集成

bash 复制代码

rtk init -g --uninstall --codex

预览删除内容：

bash 复制代码

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

5.2 卸载 Claude Code 集成

bash 复制代码

rtk init -g --uninstall

5.3 卸载 RTK 二进制

bash 复制代码

# Homebrew
brew uninstall rtk

# Cargo
cargo uninstall rtk

5.4 清理残留数据

bash 复制代码

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` 参数
遥测是否影响功能	不影响	只控制匿名数据上报

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

1. 简介

2. 安装

2.1 Homebrew（macOS / Linux）

2.2 一键安装脚本（Linux / macOS）

2.3 Cargo 安装

2.4 预编译二进制

2.5 验证安装

3. 初始化

3.1 通用语法

3.2 各工具初始化命令

3.3 Codex 集成

3.4 Codex Hook 信任

4. 使用

4.1 自动模式

4.2 手动模式

4.3 常用命令

4.4 查看节省统计

4.5 遥测设置

5. 卸载

5.1 卸载 Codex 集成

5.2 卸载 Claude Code 集成

5.3 卸载 RTK 二进制

5.4 清理残留数据

6. 常见问题

7. 参考链接