rtk

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

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

开源 unknown 编程开发
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 81438
维护状态 活跃
是否开源
定价模式 unknown

项目数据

分类编程开发
开发团队rtk-ai
所属国家
定价模式unknown
价格说明定价信息待确认
访问状态
是否开源
开源协议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 星标★ 81438
30天Star增速
HF 下载量
上线时间2026-01-22 00:00:00
最近更新2026-09-22 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数7

使用教程

难度:入门 约 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. 1一键安装 rtk

    在 Linux/macOS 终端执行官方安装脚本,二进制会被装到 ~/.local/bin 目录。

    curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh
  2. 2把安装目录加入 PATH

    如果终端提示找不到 rtk,把 ~/.local/bin 写入 shell 配置文件(bash 用 .bashrc,zsh 用 .zshrc)。

    echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
  3. 3验证是否装对版本

    执行版本命令,应显示 rtk 0.28.2;crates.io 上有同名包,装错时该命令会异常。

    rtk --version
  4. 4查看节省面板

    rtk gain 会显示节省统计面板,是确认安装正确的第二个标志。

    rtk gain
  5. 5初始化到你的 AI 工具

    默认装 Claude Code / Copilot 的 hook 与 RTK.md;换其他工具需加对应参数。

    rtk init -g
  6. 6对其他工具初始化

    按你实际使用的 AI 工具选择一条,把 rtk 接入其中(示例为 Gemini CLI 与 Cursor)。

    rtk init -g --gemini
    rtk init -g --agent cursor
  7. 7检查安装结果

    用 --show 确认 hook、RTK.md 与 settings.json 是否写入成功。

    rtk init --show
  8. 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 的方式按提示召回。

核心亮点

  • 通过缓存和压缩技术将常见开发命令的LLM token消耗降低60-90%,显著节省成本
  • 单一Rust二进制文件,零依赖,安装部署简单且运行高效
  • 专为Claude Code等AI编码工具设计,无缝集成到现有agentic coding工作流

不足之处

  • 仅针对特定开发命令优化,对非标准或复杂命令的token节省效果可能有限
  • 文档/社区待观察

适用场景

  • 在CI/CD流水线中减少AI辅助编码工具的API调用成本
  • 高频使用Claude Code等AI编程助手的个人开发者或团队日常开发
  • 需要轻量级、无依赖代理工具的企业内部开发环境

替代项目

claude-code-proxy、llm-cache、tokencost

项目介绍

rtk 是编程开发领域的开源项目,由 rtk-ai 开发,是 2026 年新上线的项目。

在全站 13,014 个收录项目中,它的 GitHub 星标数(81,438)位列前 1%,在编程开发分类的 490 个项目里位列前 1%。

近 44 天,它的 GitHub 星标从 75,348 增加到 81,438,净增 6,090。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-22。从国内网络环境看,可直接访问。

它主要面向的使用场景是:在CI/CD流水线中减少AI辅助编码工具的API调用成本。同类可对比的替代方案包括 claude-code-proxy、llm-cache、tokencost。

上一篇:bolt.new

下一篇:code-review-graph

同类项目推荐

bolt.new 开源

想到啥说啥,网页应用当场生成直接能用

Prompt, run, edit, and deploy full-stack web applications. -- bolt.new -- Help Cente···

★ 16557 2026-08-09
fuzz4all 开源

用大模型自动生成测试输入,发现各种软件漏洞

️Fuzz4All: Universal Fuzzing with Large Language Models

★ 338 2026-08-09
superpowers-zh 开源

全套 AI 编程神技汉化好了,照着用就行。

AI 编程超能力 · 中文增强版 — superpowers(250k+ ⭐)完整汉化 + 4 个中国原创 skills···

★ 8188 2026-08-09
Gitea 代码托管 开源

轻量 Git 代码托管平台

Git with a cup of tea! Painless self-hosted all-in-one software development service,···

★ 58115 2026-08-22