高性能 CLI 代理，可将 LLM 的 token 消耗降低 60-90%

官网 • 安装 • 故障排除 • 架构 • Discord

English • Francais • 中文 • 日本語 • 한국어 • Espanol

---

rtk 在命令输出到达您的 LLM 上下文之前对其进行过滤和压缩。单个 Rust 二进制文件，支持 100 多种命令，开销不到 10 毫秒。

Token 节省（30 分钟 Claude Code 会话）

操作	频率	标准	rtk	节省
ls / tree	10x	2,000	400	-80%
cat / read	20x	40,000	12,000	-70%
grep / rg	8x	16,000	3,200	-80%
git status	10x	3,000	600	-80%
git diff	5x	10,000	2,500	-75%
git log	5x	2,500	500	-80%
git add/commit/push	8x	1,600	120	-92%
cargo test / npm test	5x	25,000	2,500	-90%
ruff check	3x	3,000	600	-80%
pytest	4x	8,000	800	-90%
go test	3x	6,000	600	-90%
docker ps	3x	900	180	-80%
总计		~118,000	~23,900	-80%

估算基于中型 TypeScript/Rust 项目。实际节省量因项目规模而异。

安装

Homebrew（推荐）

brew install rtk

快速安装（Linux/macOS）

curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh

安装到 ~/.local/bin。如果需要，请将其添加到 PATH：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc  # 或 ~/.zshrc

Cargo

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

预编译二进制文件

从 releases 下载：

• macOS：rtk-x86_64-apple-darwin.tar.gz / rtk-aarch64-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

验证安装

rtk --version   # 应显示 "rtk 0.28.2"
rtk gain        # 应显示 token 节省统计信息

命名冲突警告：crates.io 上存在另一个名为“rtk”（Rust Type Kit）的项目。如果 rtk gain 失败，则说明您安装了错误的包。请改用上述 cargo install --git 命令。

快速入门

# 1. 为您的 AI 工具安装
rtk init -g                     # Claude Code / Copilot（默认）
rtk init -g --gemini            # Gemini CLI
rtk init -g --codex             # Codex（OpenAI）
rtk init -g --agent cursor      # Cursor
rtk init --agent windsurf       # Windsurf
rtk init --agent cline          # Cline / Roo Code

# 2. 重启您的 AI 工具，然后测试
git status  # 自动重写为 rtk git status

该钩子会在执行前透明地重写 Bash 命令（例如 git status -> rtk git status）。Claude 根本看不到这种重写，它只会收到压缩后的输出。

重要提示：该钩子仅在 Bash 工具调用时运行。Claude Code 内置工具如 Read、Grep 和 Glob 不会经过 Bash 钩子，因此不会自动重写。要获得这些工作流的 RTK 紧凑输出，请使用 shell 命令（cat/head/tail、rg/grep、find）或直接调用 rtk read、rtk grep 或 rtk find。

工作原理

  无 rtk：                                    有 rtk：

  Claude  --git status-->  shell  -->  git         Claude  --git status-->  RTK  -->  git
    ^                                   |            ^                      |          |
    |        ~2,000 tokens（原始）        |            |   ~200 tokens        | 过滤   |
    +-----------------------------------+            +-------（过滤后） ---+----------+

针对每种命令类型采用四种策略：

1. 智能过滤 - 去除噪声（注释、空格、样板代码）
2. 分组 - 将相似项聚合（按目录分类文件、按类型分类错误）
3. 截断 - 保留相关上下文，去除冗余
4. 去重 - 将重复的日志行合并并计数

命令

文件

rtk ls .                        # 优化 token 的目录树
rtk read file.rs                # 智能文件读取
rtk read file.rs -l aggressive  # 仅显示签名（去除函数体）
rtk smart file.rs               # 两行启发式代码摘要
rtk find "*.rs" .               # 紧凑的查找结果
rtk grep "pattern" .            # 分组后的搜索结果
rtk diff file1 file2            # 精简的差异

Git

rtk git status                  # 精简的状态
rtk git log -n 10               # 单行提交记录
rtk git diff                    # 精简的差异
rtk git add                     # -> "ok"
rtk git commit -m "msg"         # -> "ok abc1234"
rtk git push                    # -> "ok main"
rtk git pull                    # -> "ok 3 files +10 -2"

GitHub CLI

rtk gh pr list                  # 精简的 PR 列表
rtk gh pr view 42               # PR 详情 + 检查
rtk gh issue list               # 精简的问题列表
rtk gh run list                 # 工作流运行状态

测试运行器

rtk test cargo test             # 仅显示失败（-90%）
rtk err npm run build           # 仅显示错误/警告
rtk vitest run                  # Vitest 精简版（仅显示失败）
rtk playwright test             # E2E 结果（仅显示失败）
rtk pytest                      # Python 测试（-90%）
rtk go test                     # Go 测试（NDJSON，-90%）
rtk cargo test                  # Cargo 测试（-90%）
rtk rake test                   # Ruby minitest（-90%）
rtk rspec                       # RSpec 测试（JSON，-60%以上）。

构建与 lint

rtk lint                        # ESLint 按规则/文件分组
rtk lint biome                  # 支持其他 linter
rtk tsc                         # TypeScript 错误按文件分组
rtk next build                  # Next.js 构建简洁版
rtk prettier --check .          # 需要格式化的文件
rtk cargo build                 # Cargo 构建（减少 80%）
rtk cargo clippy                # Cargo clippy（减少 80%）
rtk ruff check                  # Python lint（JSON 格式，减少 80%）
rtk golangci-lint run           # Go lint（JSON 格式，减少 85%）
rtk rubocop                     # Ruby lint（JSON 格式，减少 60%以上）

包管理器

rtk pnpm list                   # 简洁的依赖树
rtk pip list                    # Python 包（自动检测 uv）
rtk pip outdated                # 过时的包
rtk bundle install              # Ruby gems（去除 Using 行）
rtk prisma generate             # Schema 生成（无 ASCII 艺术）

AWS

rtk aws sts get-caller-identity # 一行显示身份信息
rtk aws ec2 describe-instances  # 简洁的实例列表
rtk aws lambda list-functions   # 名称/运行时/内存（去除敏感信息）
rtk aws logs get-log-events     # 仅显示带时间戳的消息
rtk aws cloudformation describe-stack-events  # 失败事件优先
rtk aws dynamodb scan           # 展开类型注解
rtk aws iam list-roles          # 去除策略文档
rtk aws s3 ls                   # 截断输出并支持 tee 恢复

容器

rtk docker ps                   # 简洁的容器列表
rtk docker images               # 简洁的镜像列表
rtk docker logs <container>     # 去重后的日志
rtk docker compose ps           # Compose 服务
rtk kubectl pods                # 简洁的 Pod 列表
rtk kubectl logs <pod>          # 去重后的日志
rtk kubectl services            # 简洁的服务列表

数据与分析

rtk json config.json            # 结构化数据，不含值
rtk deps                        # 依赖总结
rtk env -f AWS                  # 过滤后的环境变量
rtk log app.log                 # 去重后的日志
rtk curl <url>                  # 自动检测 JSON + schema
rtk wget <url>                  # 下载并去除进度条
rtk summary <long command>      # 启发式摘要
rtk proxy <command>             # 原始透传 + 跟踪

Token 节省分析

rtk gain                        # 总结统计
rtk gain --graph                # ASCII 图表（最近 30 天）
rtk gain --history              # 最近的命令历史
rtk gain --daily                # 按天细分
rtk gain --all --format json    # 导出 JSON 格式用于仪表板

rtk discover                    # 发现遗漏的节省机会
rtk discover --all --since 7    # 所有项目，过去 7 天

rtk session                     # 显示近期会话中的 RTK 使用情况

全局标志

-u, --ultra-compact    # 使用 ASCII 图标，内联格式（额外节省 token）
-v, --verbose          # 提高详细程度（-v、-vv、-vvv）

示例

目录列表：

# ls -la (45 行，约 800 token)        # rtk ls (12 行，约 150 token)
drwxr-xr-x  15 user staff 480 ...       my-project/
-rw-r--r--   1 user staff 1234 ...       +-- src/ (8 个文件)
...                                      |   +-- main.rs
                                         +-- Cargo.toml

Git 操作：

# git push (15 行，约 200 token)       # rtk git push (1 行，约 10 token)
Enumerating objects: 5, done.             ok main
Counting objects: 100% (5/5), done.
Delta compression using up to 8 threads
...

测试输出：

# cargo test (失败时超过 200 行)     # rtk test cargo test (~20 行)
running 15 tests                          FAILED: 2/15 测试
test utils::test_parse ... ok               test_edge_case: 断言失败
test utils::test_format ... ok              test_overflow: panic 在 utils.rs:18
...

自动重写钩子

使用 rtk 的最有效方式。该钩子会在执行前透明地拦截 Bash 命令，并将其重写为 rtk 等效命令。

结果：所有对话和子代理中 100% 采用 rtk，且无额外 token 开销。

范围说明：此功能仅适用于 Bash 工具调用。Claude Code 内置工具如 Read、Grep 和 Glob 会绕过钩子，因此在需要 RTK 过滤时，请使用 shell 命令或显式 rtk 命令。

设置

rtk init -g                 # 安装钩子 + RTK.md（推荐）
rtk init -g --opencode      # OpenCode 插件（替代 Claude Code）
rtk init -g --auto-patch    # 非交互式（CI/CD）
rtk init -g --hook-only     # 仅安装钩子，不创建 RTK.md
rtk init --show             # 验证安装

安装后，请重启 Claude Code。

支持的 AI 工具

RTK 支持 10 种 AI 编程工具。每种集成都会透明地将 shell 命令重写为 rtk 等效命令，从而节省 60%-90% 的 token。

工具	安装	方法
Claude Code	rtk init -g	PreToolUse 钩子（Bash）
GitHub Copilot (VS Code)	rtk init -g --copilot	PreToolUse 钩子（rtk hook copilot）— 透明重写
GitHub Copilot CLI	rtk init -g --copilot	PreToolUse 拒绝并提供建议（CLI 限制）
Cursor	rtk init -g --agent cursor	preToolUse 钩子（hooks.json）
Gemini CLI	rtk init -g --gemini	BeforeTool 钩子（rtk hook gemini）
Codex	rtk init -g --codex	AGENTS.md + RTK.md 指导
Windsurf	rtk init --agent windsurf	.windsurfrules（项目范围）
Cline / Roo Code	rtk init --agent cline	.clinerules（项目范围）
OpenCode	rtk init -g --opencode	TS 插件（tool.execute.before）
OpenClaw	openclaw plugins install ./openclaw	TS 插件（before_tool_call）
Mistral Vibe	计划中（#800）	受限于上游 BeforeToolCallback

Claude Code（默认）

rtk init -g                 # 安装钩子 + RTK.md
rtk init -g --auto-patch    # 非交互式（CI/CD）
rtk init --show             # 验证安装
rtk init -g --uninstall     # 卸载

GitHub Copilot（VS Code + CLI）

rtk init -g --copilot         # 安装钩子 + 指南

会创建 .github/hooks/rtk-rewrite.json（PreToolUse 钩子）和 .github/copilot-instructions.md（提示级别意识）。钩子（rtk hook copilot）会自动检测格式：

• VS Code Copilot Chat：通过 updatedInput 透明重写（与 Claude Code 相同）
• Copilot CLI：拒绝并提供建议（CLI 尚不支持 updatedInput — 参见 copilot-cli#2013）

Cursor

rtk init -g --agent cursor

会创建 ~/.cursor/hooks/rtk-rewrite.sh 并修改 ~/.cursor/hooks.json 中的 preToolUse 匹配器。适用于 Cursor 编辑器和 cursor-agent CLI。

Gemini CLI

rtk init -g --gemini
rtk init -g --gemini --uninstall

创建 ~/.gemini/hooks/rtk-hook-gemini.sh 并通过 BeforeTool 钩子修补 ~/.gemini/settings.json。

Codex (OpenAI)

rtk init -g --codex

创建包含 @RTK.md 引用的 ~/.codex/RTK.md 和 ~/.codex/AGENTS.md。Codex 会将这些文件作为全局指令读取。

Windsurf

rtk init --agent windsurf

在当前项目中创建 .windsurfrules 文件。Cascade 会读取这些规则，并在命令前加上 rtk 前缀。

Cline / Roo Code

rtk init --agent cline

在当前项目中创建 .clinerules 文件。Cline 会读取这些规则，并在命令前加上 rtk 前缀。

OpenCode

rtk init -g --opencode

创建 ~/.config/opencode/plugins/rtk.ts。使用 tool.execute.before 钩子。

OpenClaw

openclaw plugins install ./openclaw

安装 openclaw/ 目录中的插件。该插件使用 before_tool_call 钩子，并委托给 rtk rewrite。

Mistral Vibe（计划中）

受上游 BeforeToolCallback 支持的阻碍（mistral-vibe#531，PR #533）。已在 #800 中跟踪。

已重写命令

原始命令	重写后命令
git status/diff/log/add/commit/push/pull	rtk git ...
gh pr/issue/run	rtk gh ...
cargo test/build/clippy	rtk cargo ...
cat/head/tail <file>	rtk read <file>
rg/grep <pattern>	rtk grep <pattern>
ls	rtk ls
vitest/jest	rtk vitest run
tsc	rtk tsc
eslint/biome	rtk lint
prettier	rtk prettier
playwright	rtk playwright
prisma	rtk prisma
ruff check/format	rtk ruff ...
pytest	rtk pytest
pip list/install	rtk pip ...
go test/build/vet	rtk go ...
golangci-lint	rtk golangci-lint
rake test / rails test	rtk rake test
rspec / bundle exec rspec	rtk rspec
rubocop / bundle exec rubocop	rtk rubocop
bundle install/update	rtk bundle ...
aws sts/ec2/lambda/...	rtk aws ...
docker ps/images/logs	rtk docker ...
kubectl get/logs	rtk kubectl ...
curl	rtk curl
pnpm list/outdated	rtk pnpm ...

已经使用 rtk 的命令、heredoc（<<）以及无法识别的命令将保持不变。

配置

配置文件

~/.config/rtk/config.toml（macOS：~/Library/Application Support/rtk/config.toml）：

[tracking]
database_path = "/path/to/custom.db"  # 默认：~/.local/share/rtk/history.db

[hooks]
exclude_commands = ["curl", "playwright"]  # 跳过对这些命令的重写

[tee]
enabled = true          # 失败时保存原始输出（默认：是）
mode = "failures"       # "failures"、"always" 或 "never"
max_files = 20          # 循环限制

Tee：完整输出恢复

当命令失败时，RTK 会保存完整的未过滤输出，以便 LLM 可以在无需重新执行的情况下读取：

FAILED: 2/15 tests
[完整输出：~/.local/share/rtk/tee/1707753600_cargo_test.log]

卸载

rtk init -g --uninstall     # 移除钩子、RTK.md 和 settings.json 条目
cargo uninstall rtk          # 移除二进制文件
brew uninstall rtk           # 如果通过 Homebrew 安装

文档

• TROUBLESHOOTING.md - 解决常见问题
• INSTALL.md - 详细安装指南
• ARCHITECTURE.md - 技术架构
• SECURITY.md - 安全策略和 PR 审核流程
• AUDIT_GUIDE.md - 令牌节省分析指南

隐私与遥测

RTK 每天收集一次匿名的汇总使用指标，默认启用。这有助于优先安排开发工作。有关退出选项，请参见下文。

收集的内容：

• 设备哈希值（加盐的 SHA-256 — 每个用户本地存储的随机盐，不可逆）
• RTK 版本、操作系统、架构
• 命令数量（过去 24 小时）及常用命令名称（如“git”、“cargo”——不包含参数或文件路径）
• 令牌节省百分比

不会收集的内容： 源代码、文件路径、命令参数、密钥、环境变量或任何个人身份信息。

退出方式（任选其一）：

# 环境变量
export RTK_TELEMETRY_DISABLED=1

# 或在配置文件中（~/.config/rtk/config.toml）
[telemetry]
enabled = false

贡献

欢迎贡献！请在 GitHub 上提交问题或拉取请求。

加入我们的社区，访问 Discord。

许可证

MIT 许可证——详情请参阅 LICENSE。

免责声明

请参阅 DISCLAIMER.md。

RTK 快速上手指南

RTK (Rust Token Killer) 是一款高性能 CLI 代理工具，专为 AI 编程助手（如 Claude Code、Copilot 等）设计。它能在命令执行前自动过滤和压缩输出内容，将 LLM 的 Token 消耗降低 60-90%，同时保持上下文的相关性。

环境准备

• 操作系统：macOS, Linux, Windows
• 前置依赖：
  • 无特殊依赖，RTK 为单文件二进制程序。
  • 若使用 cargo 安装，需预先安装 Rust 工具链。
  • 目标用户：主要配合 Claude Code、GitHub Copilot、Cursor 等 AI 终端工具使用。

安装步骤

推荐优先使用国内可访问的安装方式。如果官方源连接缓慢，建议使用 cargo 源码安装或手动下载二进制文件。

方式一：Homebrew (macOS/Linux 推荐)

brew install rtk

方式二：一键脚本安装 (Linux/macOS)

curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh

安装后若提示命令未找到，请将 ~/.local/bin 加入环境变量：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc  # 或 ~/.zshrc
source ~/.bashrc

方式三：Cargo 源码安装 (通用/网络不佳时推荐)

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

注意：Crates.io 上存在同名项目 "Rust Type Kit"。务必使用 --git 参数安装本项目，否则 rtk gain 等命令将无法运行。

方式四：手动下载二进制

访问 Releases 页面 下载对应系统的压缩包，解压后将二进制文件移至 $PATH 目录即可。

验证安装

rtk --version   # 应显示版本号，如 "rtk 0.28.2"
rtk gain        # 应显示 Token 节省统计信息

基本使用

RTK 的核心功能是自动重写钩子 (Auto-Rewrite Hook)。启用后，你在终端输入的标准命令（如 git status）会被透明地转换为优化后的 rtk git status，AI 模型看到的是经过压缩的精简输出，而你无需改变操作习惯。

1. 初始化配置

根据你的 AI 工具运行初始化命令（默认支持 Claude Code）：

# 全局安装钩子 (推荐，适用于 Claude Code / Copilot)
rtk init -g

# 针对特定工具
rtk init -g --gemini            # Gemini CLI
rtk init -g --codex             # Codex (OpenAI)
rtk init --agent cursor         # Cursor
rtk init --agent windsurf       # Windsurf
rtk init --agent cline          # Cline / Roo Code

2. 重启 AI 工具

配置完成后，必须重启你的 AI 编程工具（如退出并重新进入 Claude Code 会话），钩子才会生效。

3. 测试效果

在 AI 对话中直接执行常规命令，观察输出变化：

git status

• 未经优化：输出完整的文件列表和状态详情（约 2,000 Tokens）。
• RTK 优化后：输出精简的状态摘要（约 200 Tokens），AI 仍能准确理解文件变更情况。

4. 常用优化命令示例

除了自动钩子，你也可以直接在终端调用 rtk 命令来获取压缩输出：

# 文件操作
rtk ls .                        # 优化的目录树
rtk read file.rs                # 智能读取代码（去除冗余）
rtk grep "pattern" .            # 分组显示的搜索结果

# Git 操作
rtk git log -n 10               # 单行提交记录
rtk git diff                    # 浓缩的差异对比

# 测试与构建 (仅显示错误/失败信息)
rtk test cargo test             # 仅展示失败的测试用例 (-90% Token)
rtk err npm run build           # 仅展示构建错误和警告

5. 查看节省统计

随时运行以下命令查看 Token 节省情况和历史数据：

rtk gain                        # 查看总体节省统计
rtk gain --graph                # 查看近 30 天的节省趋势图