1. 默认模块
ai.skywalk.cloud
  • 默认模块
    • 生成密钥 快速开始指南
    • Claude Code 安装配置教程
    • 密钥使用说明
    • Gemini CLI 安装配置教程
    • OpenClaw（Clawdbot/Moltbot） 安装 教程
    • Codex安装配置教程
    • Claude长上下文与缓存管理技术指南
    • AI模型接口
    • RTK安装使用
    • 请求api
  • module
    • AI模型接口
  1. 默认模块

RTK安装使用

RTK（Rust Token Killer）最全安装使用说明#

1. RTK 是什么#

RTK，全称 Rust Token Killer，是一个用 Rust 编写的命令行代理工具。
它的作用是：
压缩 AI 编程工具看到的终端输出
删除无用日志、进度条、重复内容、冗余文件列表
保留错误、失败测试、关键变更、摘要信息
减少 GPT、Claude、Codex、Cursor 等 AI 工具的 token 消耗
延长上下文使用时间，降低 API 或订阅消耗成本
它适合用于：
Claude Code
Cursor
Codex CLI
Gemini CLI
GitHub Copilot
OpenCode
Cline / Roo Code
Windsurf
Kilo Code
Google Antigravity
Pi
Hermes
OpenClaw

2. RTK 工作原理#

普通情况下：
AI 助手 -> 执行 shell 命令 -> 原始输出 -> 进入 AI 上下文
使用 RTK 后：
AI 助手 -> RTK hook -> rtk 命令代理 -> 压缩输出 -> 进入 AI 上下文
例如 AI 原本执行：
安装 hook 后会被改写为：
AI 最终看到的是压缩后的输出，例如只看到失败测试，而不是几百行成功测试日志。

3. 安装前检查#

安装前先检查系统里是否已经有 RTK：
判断方式：
rtk gain 能显示 token savings dashboard = 安装的是正确的 Rust Token Killer
rtk gain 提示 not a rtk command = 安装错了，可能是 Rust Type Kit
rtk 命令不存在 = 还没有安装
如果 rtk gain 正常，不需要重复安装，直接进入初始化步骤。

4. Linux / macOS 快速安装#

推荐方式：
如果安装后提示找不到 rtk 命令，把 ~/.local/bin 加入 PATH。
bash 用户：
zsh 用户：
验证：

5. Homebrew 安装#

macOS / Linux 可使用 Homebrew：
验证：

6. Cargo 安装#

注意：不要直接执行：
因为 crates.io 上有同名项目，可能会安装成错误的 Rust Type Kit。
正确安装方式：
如果安装后找不到命令，把 Cargo bin 加入 PATH。
bash / zsh：
写入配置：
zsh 用户：
fish 用户：
set -gx PATH $HOME/.cargo/bin $PATH
验证：

7. Windows 安装说明#

Windows 可以使用预编译二进制文件：
rtk-x86_64-pc-windows-msvc.zip
使用方式：
1.
从 GitHub Releases 下载 Windows zip
2.
解压 rtk.exe
3.
把 rtk.exe 放到 PATH 目录中
4.
打开 PowerShell / CMD / Windows Terminal
5.
执行：
rtk --version
注意：
不要双击 rtk.exe
因为 RTK 是命令行工具，双击后窗口会闪退。
如果希望完整使用自动 hook，Windows 用户推荐使用 WSL。
WSL 中安装：
Native Windows 下可能无法完整启用 shell hook，只能退化为规则提示模式，但仍然可以手动使用：

8. 验证安装是否正确#

执行：
正确情况：
rtk --version 能显示版本号
rtk gain 能显示 token savings dashboard
错误情况：
如果输出类似：
rtk: 'gain' is not a rtk command
说明安装错了，可能装成了 Rust Type Kit。
修复：

9. 初始化 AI 工具集成#

RTK 安装后，还需要对具体 AI 编程工具初始化 hook。

9.1 Claude Code 全局初始化#

适用于所有项目：
简写：
仅当前项目：
初始化后重启 Claude Code。
查看 hook 状态：
预览将要修改的内容，但不真正写入：
显示更详细的预览内容：
卸载 Claude Code hook：
卸载全局 hook：

9.2 Cursor 初始化#

也可以使用：
初始化后重启 Cursor。
查看状态：

9.3 GitHub Copilot 初始化#

项目级别：
全局级别：
项目级别会写入：
.github/hooks/rtk-rewrite.json
.github/copilot-instructions.md
全局级别会写入：
~/.copilot/hooks/rtk-rewrite.json
~/.copilot/copilot-instructions.md
卸载项目级别：
卸载全局级别：

9.4 Gemini CLI 初始化#

初始化后重启 Gemini CLI。

9.5 Codex CLI / OpenAI 初始化#

或者：
初始化后重启 Codex CLI。

9.6 OpenCode 初始化#

会创建：
~/.config/opencode/plugins/rtk.ts
初始化后重启 OpenCode。
查看状态：

9.7 Pi 初始化#

当前项目：
全局：
卸载：

9.8 Hermes 初始化#

9.9 Cline / Roo Code 初始化#

这类工具通常是规则文件或提示词级别集成，不一定能自动改写所有命令。

9.10 Windsurf 初始化#

或者项目级别：

9.11 Kilo Code 初始化#

9.12 Google Antigravity 初始化#

9.13 OpenClaw 初始化#

OpenClaw 使用插件方式：

10. 初始化后的测试流程#

推荐按下面流程测试：
如果 AI 工具自动把 git status 改写为 rtk git status，说明 hook 生效。
也可以查看 hook 状态：

11. 手动使用 RTK#

即使 hook 没有生效，也可以手动使用 RTK。
Git：
文件读取：
搜索：
测试：
构建：
Docker / Kubernetes：
HTTP / 数据库 / 云命令：

12. RTK 支持优化的命令类型#

Git#

优化效果：
git status：压缩为紧凑状态
git log：保留 hash、作者、标题
git diff：减少上下文，去掉冗余 header
git show：类似 diff 压缩
git stash list：每条 stash 一行展示

GitHub CLI#

优化效果：
删除 ASCII 装饰
精简 metadata
高亮失败检查
保留关键信息

Rust / Cargo#

优化效果：
测试只保留失败
构建只保留错误和警告
clippy 按文件分组 lint 问题

JavaScript / TypeScript#

优化效果：
测试只保留失败
TypeScript 错误按文件分组
eslint 按规则分组
依赖树压缩展示
Next.js 构建保留路由摘要和错误

Python#

优化效果：
pytest 保留失败信息
ruff 按文件分组
mypy 按文件分组
pip install 去掉进度条，只保留安装结果

Go#

Ruby#

.NET#

Docker / Kubernetes#

文件和搜索#

示例：
rtk smart 会生成更短的代码摘要，适合让 AI 快速理解文件结构。

13. 全局参数#

13.1 超紧凑模式#

作用：
输出更短
使用 ASCII 图标
进一步减少 token

13.2 详细调试模式#

作用：
查看 RTK 过滤细节
排查命令是否经过 RTK
调试 hook 和 rewrite 行为

14. 统计 token 节省#

查看总节省：
查看每日节省：
查看每周节省：

15. 查找漏掉的节省机会#

RTK 提供 discover 命令，用于分析 Claude Code 命令历史，找出哪些命令没有经过 RTK。
当前项目：
所有项目：
最近 7 天：
如果发现很多命令没有经过 RTK，通常说明对应 AI 工具的 hook 没有正确启用。

16. 查看 RTK 采用率#

它会显示最近 Claude Code 会话中：
总 shell 命令数
经过 RTK 的命令数
覆盖率
如果覆盖率较低，建议检查 hook 状态。

17. 配置文件#

查看当前配置：
创建默认配置文件：
配置文件位置：
Linux：
~/.config/rtk/config.toml
macOS：
~/Library/Application Support/rtk/config.toml

18. 配置文件示例#

[tracking]
enabled = true
history_days = 90
database_path = "/custom/path/history.db"

[display]
colors = true
emoji = true
max_width = 120

[filters]
ignore_dirs = [".git", "node_modules", "target", "__pycache__", ".venv", "vendor"]
ignore_files = ["*.lock", "*.min.js", "*.min.css"]

[tee]
enabled = true
mode = "failures"
max_files = 20

[telemetry]
enabled = true

[hooks]
exclude_commands = []

19. 排除某些命令，不让 RTK 自动改写#

如果某些命令不希望被 RTK hook 自动改写，可以在配置文件中添加：
[hooks]
exclude_commands = ["git rebase", "git cherry-pick", "docker exec"]
例如：
[hooks]
exclude_commands = ["psql", "docker exec", "git rebase"]
这样即使 AI 执行这些命令，也不会自动变成 rtk xxx。

20. 环境变量#

20.1 单次禁用 RTK#

20.2 禁用遥测#

临时使用：
永久写入 bash：
永久写入 zsh：

20.3 设置 tee 输出目录#

20.4 启用 hook 审计日志#

20.5 Next.js 环境校验问题#

21. Tee 系统：保留失败命令完整日志#

RTK 默认会在命令失败时保存完整原始输出。
例如测试失败时，RTK 可能输出：
FAILED: 2/15 tests

[full output: ~/.local/share/rtk/tee/1707753600_cargo_test.log]
这样 AI 可以先看压缩摘要，需要时再读取完整日志文件，不必重新执行命令。
Tee 配置：
[tee]
enabled = true
mode = "failures"
max_files = 20
可选模式：
failures = 只保存失败命令
always   = 总是保存
never    = 不保存

22. 遥测与隐私#

查看遥测状态：
启用遥测：
禁用遥测：
禁用遥测并删除本地数据，同时请求服务端删除：
强制禁用遥测：
如果对隐私敏感，建议直接禁用：
或者永久写入环境变量：

23. AI 工具规则建议#

为了让 AI 更稳定地使用 RTK，可以把下面内容加入项目规则、CLAUDE.md、AGENTS.md、Cursor Rules 或 Copilot Instructions。
为了减少 token 消耗，执行 shell 命令时请优先使用 RTK。

常见命令请优先使用：
- rtk git status
- rtk git diff
- rtk git log
- rtk read
- rtk grep
- rtk find
- rtk cargo test
- rtk npm test
- rtk pnpm test
- rtk pytest
- rtk go test
- rtk docker ps
- rtk kubectl get pods

除非我明确要求完整原始输出，否则不要直接输出大量日志、目录树、测试结果或构建日志。

如果 RTK 返回了完整日志文件路径，先阅读摘要；只有摘要不足以定位问题时，再读取完整日志。

24. 常见问题排查#

24.1 rtk gain 提示不是 RTK 命令#

现象：
rtk: 'gain' is not a rtk command
原因：
安装成了 Rust Type Kit，而不是 Rust Token Killer
解决：

24.2 AI 工具没有自动使用 RTK#

现象：
AI 仍然直接执行 cargo test，而不是 rtk cargo test
检查：
重新初始化：
Claude Code：
Cursor：
OpenCode：
然后重启 AI 工具。
Claude Code 可检查：

24.3 rtk 命令找不到#

如果是脚本安装：
如果是 Cargo 安装：
zsh 用户把 .bashrc 换成 .zshrc。

24.4 Windows 双击 rtk.exe 没反应#

不要双击。
请打开：
CMD / PowerShell / Windows Terminal
然后执行：
rtk --version

24.5 Windows hook 不生效#

Native Windows 下 Unix shell hook 可能不可用。
推荐使用 WSL：
如果不用 WSL，就手动运行：

24.6 Node.js 工具找不到#

例如：
报错：
program not found
建议升级 RTK：

24.7 编译安装失败#

更新 Rust：
清理并重新构建：
最低 Rust 版本建议：
Rust 1.70+

25. 卸载 RTK#

25.1 脚本安装卸载#

常见安装路径：
删除：

25.2 Homebrew 卸载#

25.3 Cargo 卸载#

25.4 卸载 AI 工具 hook#

Claude Code：
Copilot：
Pi：
Cursor / OpenCode 等工具可先查看：
再根据对应 agent 重新执行 uninstall。

26. 推荐最佳实践#

26.1 日常 AI 编程推荐#

优先让 AI 使用：

26.2 构建失败排查#

先执行：
或：
如果摘要不足，再读取 RTK 保存的完整日志文件。

26.3 测试失败排查#

推荐：
RTK 会尽量只保留失败测试和关键错误。

26.4 代码搜索#

不要让 AI 直接扫描整个项目。
推荐：
例如：

26.5 大文件读取#

不要直接：
推荐：

26.6 定期检查节省效果#

检查是否有漏掉的命令：
查看 AI 会话覆盖率：

27. 一键安装和初始化脚本#

适合 Linux / macOS / WSL。
保存为：
执行：

28. 快速命令汇总#

修改于 2026-06-16 10:47:00
上一页
AI模型接口
下一页
AI模型接口
Built with