选择安装方式

根据操作系统选择Homebrew（macOS/Linux）、Cargo或预编译二进制文件安装rtk。

推荐使用Homebrew（`brew install rtk-ai/rtk/rtk`）或快速安装脚本（`curl -fsSL https://rtk-ai.app/install.sh | sh`），最简单快捷。

验证安装

运行`rtk --version`确认安装成功，并检查是否与crates.io上的另一个同名项目混淆（如果`rtk gain`失败，说明安装错误）。

如果`rtk gain`报错，请使用`cargo install --git https://github.com/rtk-ai/rtk`重新安装。

Windows用户特殊设置

如果使用Windows，推荐安装WSL以获得完整支持。在原生Windows上，只能使用过滤功能，无法自动重写命令。

不要双击rtk.exe，它会在终端中运行并立即退出。

运行基本过滤命令

尝试`rtk ls -la`、`rtk git status`、`rtk cargo test`等命令，观察输出与原始命令的区别。

rtk会自动过滤注释、空白行和冗余信息，输出更紧凑。

查看令牌节省分析

运行`rtk gain`查看令牌节省统计，了解rtk为你节省了多少。

这个命令会显示节省百分比和具体数值，是衡量rtk效果的关键指标。

使用全局标志

尝试`rtk --verbose git status`查看详细输出，或`rtk --dry-run git status`预览过滤效果而不实际执行。

`--dry-run`非常适合调试，可以看到rtk会如何修改输出。

为Claude Code设置自动重写钩子

运行`rtk init -g`，这将安装一个钩子，自动将Claude Code中的Bash命令重写为rtk版本。

重启Claude Code后生效。注意：钩子只影响Bash工具调用，内置的Read、Grep等工具不会自动重写。

为其他AI工具设置集成

根据使用的AI工具（如GitHub Copilot、Cursor等），运行相应的初始化命令，例如`rtk init -g --copilot`。

查看README中的表格，选择对应工具的安装命令。

测试集成是否生效

在AI编码助手内执行一个命令（如`git status`），检查输出是否被rtk过滤（更紧凑）。

如果输出没有变化，检查钩子是否正确安装，或查看故障排除指南。

编辑配置文件

找到配置文件位置（Linux: `~/.config/rtk/config.toml`，macOS: `~/Library/Application Support/rtk/config.toml`），查看默认设置。

配置文件使用TOML格式，可以调整过滤策略、排除某些命令等。

配置失败命令的回退

在配置文件中设置`[passthrough]`部分，当命令失败时，rtk会保存完整输出供LLM读取。

这确保AI助手不会因为过滤而丢失重要错误信息。

调整过滤策略

根据需要启用或禁用智能过滤、分组、截断和去重策略。

不同项目类型可能需要不同的策略组合，建议先使用默认设置，再根据`rtk gain`结果微调。