RTK卸载指南：3步彻底移除Hook、RTK.md和二进制，不留后患

RTK卸载指南：3步彻底移除Hook、RTK.md和二进制，不留后患

【免费下载链接】rtkCLI proxy that reduces LLM token consumption by 60-90% on common dev commands. Single Rust binary, zero dependencies项目地址: https://gitcode.com/GitHub_Trending/rtk4/rtk

RTK（Rust Token Killer）是一款 Rust 编写的 CLI 代理工具，可将常见开发命令的 LLM token 消耗降低 60%~90%。当你决定停用 RTK 卸载工具时，光删二进制是不够的——它还会在 AI 编程助手里留下 Hook 脚本、RTK.md 上下文文件和 settings.json 注册项。这篇 RTK 卸载教程带你 3 步彻底清除所有痕迹，不留后患 🧹

卸载前必读：RTK 到底装了什么？

在执行任何删除操作前，先了解 RTK 安装时在系统里留下了哪些文件。卸载命令 INSTALL.md 和源码 src/hooks/init.rs 中uninstall()函数的逻辑完全一致：

📌 源码参考：卸载逻辑实现于 src/hooks/init.rs，官方文档见 INSTALL.md 的 "Uninstalling" 章节，Homebrew 配方见 Formula/rtk.rb。

第 1 步：用 dry-run 预览后，一条命令移除 Hook 与 RTK.md

RTK 官方推荐的卸载入口是rtk init的--uninstall参数（定义见 src/main.rs）。注意：全局卸载必须带-g（--global）标志，否则会直接报错。

推荐先用--dry-run预览将移除哪些文件，不写任何磁盘变更：

# 预览：只列出将被删除的内容 rtk init -g --uninstall --dry-run # 确认无误后，正式执行全局卸载 rtk init -g --uninstall

执行成功后，终端会逐条打印已移除项，例如：

RTK uninstalled: - Hook script: ~/.claude/hooks/rtk-rewrite.sh - RTK.md: ~/.claude/RTK.md - CLAUDE.md: removed @RTK.md reference - settings.json: removed RTK hook entry

如果你使用的是其他 AI 代理，加上对应的目标参数即可（详见 docs/guide/getting-started/supported-agents.md）：

💡 卸载过程会为settings.json创建备份（settings.json.bak）。万一改坏了配置，随时可恢复：

cp ~/.claude/settings.json.bak ~/.claude/settings.json

第 2 步：按安装方式移除 RTK 二进制

RTK 有单二进制、零依赖的特点，因此它的安装渠道不同，卸载方式也不同。对照你当初的安装方式二选一（或多选）：

# 方式 A：通过 Cargo 安装 cargo uninstall rtk # 方式 B：通过 Homebrew 安装（对应 Formula/rtk.rb） brew uninstall rtk # 方式 C：通过官方 install.sh 安装（默认装到 ~/.local/bin） # 直接删除二进制文件即可 rm ~/.local/bin/rtk

⚠️ 特别提醒：INSTALL.md 中警告过，crates.io 上可能存在同名的 Rust Type Kit（T 型工具包，非本项目）。如果你装错了，同样执行cargo uninstall rtk清掉即可。

第 3 步：验证卸载干净并重启代理

最后一步验证"不留后患"，依次执行：

# 1. 二进制应提示"command not found" rtk --version # 2. PATH 中不应再找到 rtk which rtk # 3. 关键文件应已不存在 ls ~/.claude/RTK.md ~/.claude/hooks/rtk-rewrite.sh

三条命令都应当"查无此物"才算干净 ✅

完成后再做两件事：

1. 重启你的 AI 代理（Claude Code、Cursor 等），让 Hook 移除生效；
2. 清理本地项目的残留：--uninstall只处理全局安装。如果某个项目里rtk init（不带-g）过，需要手动打开该项目的CLAUDE.md，删掉其中的 RTK 指令块。

另外，如果你在初始化时同意过匿名遥测，建议先用rtk telemetry forget撤回同意并删除本地数据（用法见 docs/TELEMETRY.md），再卸载二进制。

常见 RTK 卸载问题 FAQ

Q1：提示 "Uninstall only works with --global flag" 怎么办？这是 src/hooks/init.rs 中的硬性校验：全局残留只能全局清理。请补上-g参数；纯本地项目则手动编辑CLAUDE.md。

Q2：运行后显示 "RTK was not installed (nothing to remove)"？说明全局目录里本就没有 RTK 残留，命令会打印它检查过的 4 个位置，可对照确认 Hook、RTK.md、CLAUDE.md、settings.json 均已干净。

Q3：settings.json 被改动后想一键回滚？卸载前它会自动备份为settings.json.bak，用上面的cp命令即可还原。

Q4：卸载后 token 节省统计（rtk gain）还在吗？统计数据保存在用户数据目录中，rtk init -g --uninstall不会自动删除。如需彻底抹除，可在移除二进制前执行rtk telemetry forget一并清理本地数据。

总结

RTK 卸载三步走：

1. rtk init -g --uninstall（可加--dry-run预览）——移除 Hook、RTK.md、CLAUDE.md 引用与 settings.json 注册项；
2. 按安装渠道执行cargo uninstall rtk/brew uninstall rtk/ 手动删除~/.local/bin/rtk；
3. 用which rtk等命令验证无残留，重启代理并清理本地项目里的 RTK 指令块。

照做之后，你的系统就恢复了安装 RTK 之前的干净状态，放心告别 👋

【免费下载链接】rtkCLI proxy that reduces LLM token consumption by 60-90% on common dev commands. Single Rust binary, zero dependencies项目地址: https://gitcode.com/GitHub_Trending/rtk4/rtk