rtk

给开发命令加个省钱的中间人，AI 开销砍掉六到九成

开源 🏷️定价信息待确认 ✅ 目前可打开编程开发 🍴 复刻 5493 🐛 待处理 1699 👀 关注 216

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 85820

维护状态活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类编程开发

开发团队rtk-ai

官网地址https://www.rtk-ai.app

GitHubhttps://github.com/rtk-ai/rtk

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态✅ 目前可打开

是否开源是

开源协议Apache-2.0

主要语言Rust

技术栈/模型agentic-coding,ai-coding,anthropic,claude-code,cli,command-line-tool,cost-reduction,developer-tools,llm,open-source,productivity,rust,token-optimization

GitHub 星标★ 85820

上线时间2026-01-22 00:00:00

代码更新2026-11-07

仓库体积15.5 MB

本站数据更新2026-11-08

维护状态活跃

收录时间2026-08-09

浏览次数10

项目介绍

用单一 Rust 二进制实现的 CLI 代理，零依赖即可将常见开发命令的 LLM Token 消耗降低 60-90%，是追求极致性能与轻量化的开发者利器。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 85820

技术标签

agentic-coding ai-coding anthropic claude-code cli

使用教程

难度：入门约 10 分钟部署方式：命令行工具 8 步

环境要求

Linux 或 macOS 终端（使用官方 install.sh 一键脚本）
原生 Windows 需在命令提示符 / PowerShell / Windows Terminal 中手动安装，推荐用 winget
部分过滤器会调用 ripgrep（rg），需安装并放在 PATH 中
已安装至少一个受支持的 AI 编程工具（Claude Code、Copilot、Gemini CLI、Codex、Cursor、Windsurf、Cline 等

安装与启动步骤

1一键安装 rtk

在 Linux/macOS 终端执行官方安装脚本，二进制会被装到 ~/.local/bin 目录。
```
curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh
```
2把安装目录加入 PATH

如果终端提示找不到 rtk，把 ~/.local/bin 写入 shell 配置文件（bash 用 .bashrc，zsh 用 .zshrc）。
```
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
```
3验证是否装对版本

执行版本命令，应显示 rtk 0.28.2；crates.io 上有同名包，装错时该命令会异常。
```
rtk --version
```
4查看节省面板

rtk gain 会显示节省统计面板，是确认安装正确的第二个标志。
```
rtk gain
```
5初始化到你的 AI 工具

默认装 Claude Code / Copilot 的 hook 与 RTK.md；换其他工具需加对应参数。
```
rtk init -g
```
6对其他工具初始化

按你实际使用的 AI 工具选择一条，把 rtk 接入其中（示例为 Gemini CLI 与 Cursor）。
```
rtk init -g --gemini
rtk init -g --agent cursor
```
7检查安装结果

用 --show 确认 hook、RTK.md 与 settings.json 是否写入成功。
```
rtk init --show
```
8重启 AI 工具

安装完成后必须重启 Claude Code（或其他对应工具）才能加载新的 hook 生效。

关键配置

配置项	必填	说明	示例
`hooks.exclude_commands`	否	跳过这些命令的重写过滤，避免误处理输出	`["curl", "playwright"]`
`retriever.mode`	否	失败输出保存方式：sqlite（默认）、tee（旧文件模式）或 disabled	`"sqlite"`
`awareness`	否	写入 RTK.md 的提示等级，high 告知 rtk gain/proxy，full 让 agent 自行加前缀	`level = "high"`

如何确认成功

执行 rtk --version 应输出 rtk 0.28.2，执行 rtk gain 应显示节省统计面板；再跑 rtk init --show 确认 hook 已装好。

常见问题

Q：rtk gain 执行失败或行为异常怎么办？

A：说明装了错误的包。crates.io 上另有一个叫 rtk 的项目（Rust Type Kit），请卸载后改用 cargo install --git 方式从官方仓库安装。

Q：Windows 上双击 rtk.exe 没反应？

A：这是正常现象。rtk 是 CLI 工具，双击只会打印用法后立刻退出，必须在命令提示符、PowerShell 或 Windows Terminal 里运行。

Q：出现 Binary 'rg' not found on PATH 警告？

A：说明缺少 ripgrep。安装并保证它在 PATH 中即可，例如 winget install BurntSushi.ripgrep.MSVC。

Q：从旧版本升级需要注意什么？

A：若你在 v0.37.2 之前安装过，可能还残留旧版 rtk-rewrite.sh 外壳 hook，重新执行 rtk init -g 即可迁移到原生二进制 hook。

Q：怎么卸载？

A：rtk init -g --uninstall 移除 hook、RTK.md 和 settings.json 条目；再按安装方式用 cargo uninstall rtk 或 brew uninstall rtk 删除二进制。

注意事项

安装后必须重启 Claude Code（或对应 AI 工具）才会加载 hook。
默认 RTK.md 不介绍 rtk 自身，可在 config.toml 中设置 [awareness] level = "high" 或 "full" 让 agent 感知。
配置文件位于 ~/.config/rtk/config.toml，macOS 为 ~/Library/Application Support/rtk/config.toml。
命令失败时 rtk 会保存完整未过滤输出，可用类似 rtk recall 3f9c2a81d4e7 的方式按提示召回。