Windows也能跑RTK：Token压缩神器原生二进制Hook、PowerShell与WSL全平台部署指南

Windows也能跑RTK：Token压缩神器原生二进制Hook、PowerShell与WSL全平台部署指南

【免费下载链接】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 代理工具，能在常见开发命令上削减 60%~90% 的 LLM token 消耗，零依赖、开销低于 10ms。过去 Windows 用户想用上它的自动 Hook 改写功能，还得依赖 bash 或 WSL；从v0.37.2起，自动改写 Hook 已升级为原生二进制命令（rtk hook claude），不再需要 Unix shell、bash 或 jq——Command Prompt、PowerShell、Windows Terminal 下均可透明改写命令。本文将带你完成 Windows 原生、PowerShell 与 WSL 三种方式的全平台部署。

为什么 Windows 部署 RTK 值得关注？

RTK 拦截 Shell 命令，在输出进入 AI Agent（如 Claude Code、Copilot）之前先做压缩，Agent 拿到的是精简结果而不是原始噪音：

原始命令	RTK 压缩后
git push输出 15 行	ok main1 行
ls -la45 行	12 行目录树
cargo test失败 200+ 行	~20 行（只保留失败项）

在 Windows 上部署的核心价值：Hook 机制原生可用，Agent 执行git status时会被透明改写为rtk git status，全程无感、按命令零上下文开销。相关机制可参考 hooks/README.md，Hook 处理逻辑位于 src/hooks/hook_cmd.rs。

原生 Windows 部署：3 步装好二进制 Hook

第一步：下载并放置 rtk.exe

从 Release 页面下载rtk-x86_64-pc-windows-msvc.zip，解压后将rtk.exe放入 PATH 中的目录，例如C:\Users\<you>\.local\bin。

⚠️重要：不要双击rtk.exe——它是 CLI 工具，双击只会闪退。请始终在 Command Prompt、PowerShell 或 Windows Terminal 中运行。

第二步：初始化安装

在 PowerShell 中执行一条命令，即完成原生二进制 Hook 的安装：

rtk init -g

该命令会安装原生二进制 Hook 并写入 Agent 配置（对旧版本用户，重新执行此命令即可从 legacyrtk-rewrite.sh壳脚本 Hook 迁移到原生二进制 Hook）。

第三步：验证安装

rtk --version # 应显示版本号 rtk gain # 应显示 token 节省仪表盘 rtk init --show # 确认 Hook 已安装且为最新版本

📌名称冲突提醒：crates.io 上存在另一个同名项目 "Rust Type Kit"。判断装对没装对只需一条命令——rtk gain能打开节省仪表盘即为正确的 RTK（Token Killer），详见 INSTALL.md 与 docs/guide/getting-started/installation.md。

PowerShell 场景下的两个实用细节

• 依赖 ripgrep：部分过滤器（如搜索类命令）会调用rg。建议提前安装并保持其在 PATH 中（例如winget install BurntSushi.ripgrep.MSVC），避免看到Binary 'rg' not found on PATH警告。
• BOM 兼容已内置：Windows 宿主有时会在 Hook 的 stdin 前附加 UTF-8 BOM（Cursor 等场景已实测），RTK 二进制内部会自动剥离，无需手动处理。实现见 src/hooks/hook_cmd.rs 中的strip_leading_bom调用。

WSL 部署：最快获得完整 Linux 体验

如果偏好 Linux 工具链，WSL 是另一条成熟路径，行为与 Linux 完全一致：

# 进入 WSL 后 curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh rtk init -g

安装脚本为 install.sh。WSL 方案与原生方案能力完全对齐：

功能	原生 Windows	WSL
过滤器（cargo、git 等 100+ 命令）	✅ 完整	✅ 完整
自动改写 Hook	✅ 原生二进制	✅
rtk gain节省分析	✅ 完整	✅ 完整
依赖	仅 ripgrep（可选）	无额外依赖

常见问题速查

问题	解决方法
rtk gain提示 command not found	装错包（Rust Type Kit），卸载后重新安装正确版本
老版本 Hook 不生效	重新执行rtk init -g迁移到原生二进制 Hook
搜索类命令报 rg 缺失	安装 ripgrep 并确保在 PATH 中
需要彻底卸载	rtk init -g --uninstall移除 Hook 与配置项

RTK 同时支持 16 种 AI 编码工具（Claude Code、Copilot、Cursor、Gemini CLI、Codex 等），各工具的 Hook 安装参数见 README.md 中的 "Supported AI Tools" 章节，架构设计详见 docs/contributing/ARCHITECTURE.md。

需要源码构建时，可克隆仓库git clone https://gitcode.com/GitHub_Trending/rtk4/rtk后用cargo build --release自行编译。

小结

• 原生 Windows：下载 zip → 放入 PATH →rtk init -g，全程无需 bash；
• PowerShell / Windows Terminal：与原生 Hook 无缝兼容，注意提前装好 ripgrep；
• WSL：一行 curl 安装脚本即完整 Linux 体验。

无论选择哪条路径，部署完成后rtk gain就是你的"节省账本"，直观看到 Agent 少读了多少 token 输出 📉

【免费下载链接】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