AI 开发者 Token 压缩利器

博主： shpym
发布时间：2026 年 04 月 14 日
8 次浏览
暂无评论
14711字数
分类： AI-RustTokenKiller

RTK 在 Windows 上的安装、使用，以及集成到 Codex 和 Claude Code

这是一篇可直接照着操作的 Windows 教程：从安装 rtk，到日常使用，再到分别集成进 Codex 和 Claude Code。

本文示例基于 Windows AMD64 环境和 rtk 0.35.0。文中的本机路径、用户名和本地目录都已经做了脱敏处理，统一用 %USERPROFILE%、%LOCALAPPDATA%、<用户名> 这类占位符表示。

先说结论

rtk 是一个给 AI 编程助手用的命令行代理层。它不会替代 git、go test、npm、pytest 这些工具，而是把原本很长、很吵、很浪费上下文的终端输出压缩成更适合 LLM 消化的格式。官方把它称为 “A high-performance CLI proxy designed to filter and summarize system outputs before they reach your LLM context”。¹

如果你经常在 Codex、Claude Code、Cursor、Gemini CLI 这类代理式开发工具里工作，rtk 的价值非常直接：

看 git status、git diff、grep、test 结果时，输出会短很多。
失败信息更聚焦，成功信息更安静。
rtk gain 可以统计你到底省了多少 tokens。¹

安装前必须知道的一件事

官方文档特别提醒：有两个完全不同的项目都叫 rtk。如果你装错了，命令名虽然也叫 rtk，但你得到的根本不是这个“Rust Token Killer”。官方给出的最直接识别方式就是：安装后执行 rtk gain，能看到 token savings 统计，才说明你装的是对的版本。²

所以不要只看：

rtk --version

还要看：

rtk gain

如果 rtk --version 能跑，但 rtk gain 不对，那大概率装错包了。²

在 Windows 上安装 `rtk`

如果你只想先看整体顺序，可以先看这张流程图：

flowchart TD
    accTitle: RTK Windows Workflow
    accDescr: 从 Windows 安装 RTK，到验证、再到集成进 Codex 或 Claude Code 的流程图。

    start["🪟 Windows 安装 RTK"]
    verify["✅ 验证安装<br/>rtk --version<br/>rtk gain"]
    choose["🤖 选择集成目标"]
    codex["Codex<br/>rtk init -g --codex"]
    claude["Claude Code<br/>rtk init -g"]
    codex_use["手动或按指令使用<br/>rtk git status<br/>rtk read ..."]
    claude_use["Bash 命令自动改写为 rtk ...<br/>git status -> rtk git status"]
    stats["📊 rtk gain 查看收益"]

    start --> verify
    verify --> choose
    choose --> codex
    choose --> claude
    codex --> codex_use
    claude --> claude_use
    codex_use --> stats
    claude_use --> stats

    classDef install fill:#dbeafe,stroke:#2563eb,stroke-width:2px,color:#1e3a5f
    classDef choice fill:#fef3c7,stroke:#d97706,stroke-width:2px,color:#78350f
    classDef usage fill:#dcfce7,stroke:#16a34a,stroke-width:2px,color:#14532d

    class start,verify install
    class choose choice
    class codex,claude,codex_use,claude_use,stats usage

方式一：直接使用官方预编译二进制

这是更推荐的方式，尤其适合没有 Rust 工具链，或者只是想尽快用起来的人。

官方 README 明确提供了 Windows 预编译包，压缩包是：

rtk-x86_64-pc-windows-msvc.zip

对应下载位置在 GitHub Releases。¹³

1. 下载压缩包

打开官方仓库的 Releases 页面，下载 Windows 对应 zip 包：³

仓库：https://github.com/rtk-ai/rtk
Releases：https://github.com/rtk-ai/rtk/releases
压缩包：rtk-x86_64-pc-windows-msvc.zip

2. 解压并把 `rtk.exe` 放到 PATH 中的目录

在 Windows 上，你需要把 rtk.exe 放进一个已经在 PATH 里的目录，或者自己新建一个目录再加进 PATH。

常见做法有两种：

放进你已经在用的目录，比如 %USERPROFILE%\AppData\Roaming\npm
自建目录，比如 %USERPROFILE%\bin，再把它加入用户级 PATH

3. 验证安装

在 Windows 上建议至少跑这 3 条：

rtk --version
rtk gain
where.exe rtk

预期结果：

rtk --version 能返回版本号
rtk gain 不再是 “command not found”
where.exe rtk 能告诉你 rtk.exe 究竟从哪里被调用

方式二：使用 Cargo

如果你的机器已经装了 Rust，也可以直接走源码安装。

官方建议的方式是：直接从 GitHub 仓库安装。¹²

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

不建议默认使用下面这条：

cargo install rtk

原因和前面一样：同名项目冲突，容易装错。²

Cargo 安装完成之后，同样要执行：

rtk --version
rtk gain
where.exe rtk

安装成功后，RTK 到底怎么用

rtk 的核心用法非常简单：

把原来会产生很多终端输出的命令，改成前面加一个 rtk。

例如：

rtk git status
rtk git diff
rtk read README.md -n -m 80
rtk grep "func main" . -t go
rtk test go test ./...
rtk err npm run build
rtk summary pnpm lint
rtk gain --project

常用命令分类

场景	原始命令	RTK 写法	作用
看 Git 状态	`git status`	`rtk git status`	压缩状态输出
看 diff	`git diff`	`rtk git diff`	更聚焦地展示变更
读大文件	`cat README.md`	`rtk read README.md -n -m 120`	自动截断、保留重点
搜代码	`rg "pattern"`	`rtk grep "pattern" .`	分组展示匹配结果
跑测试	`go test ./...`	`rtk test go test ./...`	优先显示失败信息
只看错误	`npm run build`	`rtk err npm run build`	过滤无关成功日志
看统计	无	`rtk gain`	查看节省的 tokens

最值得先记住的 5 条

rtk git status
rtk read <file> -n -m 120
rtk grep "<pattern>" . -t go
rtk test <你的测试命令>
rtk gain --project

如果你想临时拿回“原始输出”

可以用：

rtk proxy git diff

这个命令会直接透传原始命令，但仍保留 RTK 的 tracking 逻辑。¹

集成到 Codex：推荐全局集成

如果你在用 OpenAI 的 Codex CLI，官方建议的集成命令是：¹

rtk init -g --codex

官方 README 对 Codex 模式的描述非常明确：

会创建 ~/.codex/RTK.md
会创建或更新 ~/.codex/AGENTS.md
AGENTS.md 中会加入 @RTK.md 引用
Codex 会把这些文件当作全局指令读取¹

1. 为什么推荐 `-g --codex`

因为这是全局集成，不会去碰你当前项目里的文档文件。对已经有自己 AGENTS.md 规则的仓库来说，这通常更稳。

执行：

rtk init -g --codex

之后，生成的是：

%USERPROFILE%\.codex\RTK.md
%USERPROFILE%\.codex\AGENTS.md

并且 AGENTS.md 里应该是：

@RTK.md

2. 如何验证 Codex 集成是否生效

用下面这条命令：

rtk init -g --codex --show

rtk Configuration (Codex CLI):

[ok] Global RTK.md: C:\Users\shihao\.codex\RTK.md
[ok] Global AGENTS.md: @RTK.md reference
[ok] Local RTK.md: RTK.md
[ok] Local AGENTS.md: @RTK.md reference

Usage:
  rtk init --codex              # Configure local AGENTS.md + RTK.md
  rtk init -g --codex           # Configure ~/.codex/AGENTS.md + ~/.codex/RTK.md
  rtk init -g --codex --uninstall  # Remove global Codex RTK artifacts

正常情况下，你应该能看到当前 Codex 集成状态，而不是重新进入安装流程。

3. Codex 里集成后到底怎么用

这里有一个关键差异：

Codex 模式不是靠 hook 自动改写命令，而是靠全局指令提醒代理优先使用 rtk。

也就是说，在 Codex 里你最稳妥的使用方式仍然是：

rtk git status
rtk read README.md -n -m 80
rtk grep "handler" . -t go
rtk test go test ./...

4. Codex 模式的一个常见误解

如果你看到：

[warn] No hook installed

不要马上觉得集成失败了。

当前版本里，这个提示更偏向“没有安装 Claude 风格的 hook”。而 Codex 的 --codex 模式本来就不是 hook-first 的集成方式，所以要结合 rtk init -g --codex --show 和实际使用效果一起判断。¹

5. 如果你只想给当前项目单独开启 Codex 集成

可以使用：

rtk init --codex

这会在当前项目里写本地 AGENTS.md 和 RTK.md。¹

如果你的仓库本来就已经有自己的 AGENTS.md 规则，建议先谨慎一点。对大多数人来说，全局 -g --codex 更合适。

6. 集成到 Codex 之后，日常该怎么提问

你可以把下面这些当作比较“顺手”的写法：

方式一：直接把命令写全

请运行 rtk git status
请用 rtk read 看一下 README.md
请用 rtk grep 搜索 "CreateShortURL"
请用 rtk test 跑 go test ./...

方式二：让代理默认偏向 RTK

如果全局 RTK.md 已经生效，很多时候你也可以直接说：

帮我看一下当前 git 状态
帮我读一下 README
帮我搜一下哪个文件里有这个函数

但从可预期性来说，把 rtk 明写出来更稳。特别是当你希望代理一定使用压缩后的 shell 输出时。

方式三：问题排查时配合 `gain`

rtk gain --project
rtk gain --project --history

RTK Token Savings (Global Scope)
════════════════════════════════════════════════════════════

Total commands:    28
Input tokens:      43.2K
Output tokens:     33.9K
Tokens saved:      12.4K (28.8%)
Total exec time:   2.5s (avg 87ms)
Efficiency meter: ███████░░░░░░░░░░░░░░░░░ 28.8%

[warn] No hook installed — run `rtk init -g` for automatic token savings

By Command
───────────────────────────────────────────────────────────────────────
  #  Command                   Count  Saved    Avg%    Time  Impact    
───────────────────────────────────────────────────────────────────────
 1.  rtk read                     10   9.0K   29.3%     0ms  ██████████
 2.  rtk git diff                  1   3.1K   41.7%   187ms  ███░░░░░░░
 3.  rtk git status                3    278   60.9%   254ms  ░░░░░░░░░░
 4.  rtk git log                   3     84   25.2%   150ms  ░░░░░░░░░░
 5.  rtk git branch                1      6   75.0%   104ms  ░░░░░░░░░░
 6.  rtk git diff docs/blo...      2      2  100.0%   289ms  ░░░░░░░░░░
 7.  rtk grep                      8      0    0.0%    46ms  ░░░░░░░░░░
───────────────────────────────────────────────────────────────────────

这两条很适合用来回头看看：最近哪些命令最省 tokens，哪些命令其实没省多少。

集成到 Claude Code：这是 RTK 最强的场景之一

对 Claude Code，官方给出的默认推荐命令是：¹

rtk init -g

如果你不想手动确认 patch，可以用：

rtk init -g --auto-patch

官方 README 和 INSTALL 都说明了 Claude Code 集成的大体行为：¹²

安装 hook
创建 ~/.claude/RTK.md
在 ~/.claude/CLAUDE.md 中加入 @RTK.md
patch settings.json

1. Claude Code 集成后为什么体验更“自动”

因为 Claude Code 默认是通过 PreToolUse hook 来拦截 Bash 工具调用的。官方 README 的原话是：

Claude Code：PreToolUse hook (bash)
Hook transparently rewrites Bash commands
例如 git status -> rtk git status¹

这意味着：

你在 Claude Code 里让它执行：

git status

最终真正落到 shell 的，很可能是：

rtk git status

也就是说，Claude Code 这边的 RTK 集成是“自动改写”路线。

2. 一个必须知道的限制

官方 README 同时也强调了一件事：¹

Hook 只会作用在 Bash tool calls 上。

像 Claude Code 内建的 Read、Grep、Glob 这类工具，并不会自动经过这个 Bash hook，所以不会被透明改写。¹

这一点很重要，因为很多人装完之后会以为“所有操作都会自动变成 RTK”。实际上不是：

Bash 命令：会自动改写
内建读取类工具：不会自动改写

3. Claude Code 的验证方式

安装后可以这样检查：

rtk init --show

你应该能看到类似：

Hook: ok
RTK.md: ok
Global ~/.claude/CLAUDE.md: 已配置
settings.json: 已配置 hook

然后重启 Claude Code，再试一次普通命令：

git status

如果 hook 已经正常工作，Claude Code 实际拿到的会是被 RTK 压缩过的输出。¹²

4. Claude Code 里推荐怎么用

虽然自动改写已经很好用，但更稳妥的建议是：

日常随手操作，可以让 Claude 直接执行原始 Bash 命令
对你特别在意的场景，仍然可以显式写 rtk

例如：

git status
git diff
go test ./...

以及更可控的：

rtk git status
rtk git diff
rtk test go test ./...

两者都能用，只是第二种更明确。

Codex 和 Claude Code 的差异，最好一次搞清楚

维度	Codex	Claude Code
推荐安装命令	`rtk init -g --codex`	`rtk init -g`
主要机制	`AGENTS.md + RTK.md` 指令注入	PreToolUse hook + `RTK.md`
是否自动改写 Bash 命令	通常不是自动 hook 改写	是
是否需要你显式写 `rtk`	建议写	可以不写，但显式写更稳
配置检查	`rtk init -g --codex --show`	`rtk init --show`
更适合的使用心智	“让代理优先用 RTK”	“让 Bash 命令自动走 RTK”

如果一句话概括：

Codex 更像“通过全局规则教会代理使用 RTK”
Claude Code 更像“通过 hook 自动把命令改写成 RTK”

`rtk gain` 怎么看、怎么清空

安装完之后，最值得养成的习惯就是定期跑：

rtk gain
rtk gain --history
rtk gain --project
rtk gain --project --history

这 4 条命令分别对应：

rtk gain：看全局累计统计
rtk gain --history：看全局最近命令历史
rtk gain --project：只看当前项目
rtk gain --project --history：看当前项目的最近命令历史

在当前 Windows 版本里，rtk gain 至少会给你这些信息：

总命令数
输入 token 数
输出 token 数
节省比例
各命令的节省效果排行

通常最值得交给 RTK 的，是这些输出特别吵的命令：

git status
git diff
read / cat
grep / rg
test
lint
docker
kubectl

一个当前版本里很容易踩的参数坑

正确写法是：

rtk gain --history

不是：

rtk gain history

后者在当前版本会直接报参数错误，因为 history 在这里是一个 flag，不是子命令。

Windows 上怎么清空 `rtk gain` 的累计统计

很多人看见 Total commands 一直上涨，会下意识问一句：怎么清零？

先说结论：

当前版本没有内置的 clear 或 reset 子命令
rtk gain 默认显示的是全局累计统计
如果你只是想缩小观察范围，优先用 rtk gain --project

如果你确实想把全局统计清空，在当前 Windows 实测环境里，可以重置这个文件：

%LOCALAPPDATA%\rtk\history.db

更稳妥的做法是先备份再清空：

Rename-Item "$env:LOCALAPPDATA\rtk\history.db" "history.db.bak"

如果你确认不需要备份，也可以直接删除：

Remove-Item "$env:LOCALAPPDATA\rtk\history.db"

建议先关闭正在使用 rtk 的终端或代理会话，避免文件被占用。通常下次再运行 rtk 时，这个统计库会自动重建。

Windows 上最常见的排错点

1. `rtk` 命令找不到

先看：

where.exe rtk

如果没结果，说明：

rtk.exe 没有放到 PATH 目录里
或者你修改了 PATH，但终端还没重开

这时你需要：

确认 rtk.exe 真实存放路径
确认这个目录在用户 PATH 里
关闭并重新打开 PowerShell / 终端 / AI 工具

2. `rtk --version` 能跑，但 `rtk gain` 不对

优先怀疑你装错了同名项目。

最稳的修复方式：

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

如果你走的是二进制方式，就重新从 rtk-ai/rtk 官方 Releases 下载。²³

3. `rtk gain history` 报错

正确写法是：

rtk gain --history

如果你写成 rtk gain history，当前版本会直接报参数错误。

4. `Total commands` 一直上涨

这是默认行为，因为 rtk gain 看的是全局累计。你有三个选择：

只看当前项目：rtk gain --project
看最近历史：rtk gain --history
直接重置统计库：处理 %LOCALAPPDATA%\rtk\history.db

5. 总看到 `No hook installed`

如果你还没有集成 Claude Code，这个提示本身并不奇怪。

如果你已经在用 Codex 的 --codex 模式，也不要只凭这一句就判断失败。先用 rtk init -g --codex --show 看真实状态，再结合实际命令使用效果判断。

6. Claude Code 安装后没自动改写

优先检查：

rtk init --show

重点看两个地方：

Hook 是否存在
settings.json 是否已经 patch 成功

如果你当时安装时选择了不 patch，那么可以重新执行：

rtk init -g --auto-patch

然后重启 Claude Code。¹²

卸载与回滚

Codex

rtk init -g --codex --uninstall

如果你是本地项目集成：

rtk init --codex --uninstall

Claude Code

rtk init -g --uninstall

官方文档说明，这会移除 hook、RTK.md、CLAUDE.md 中的引用，以及相关的 settings.json 配置。¹²

二进制本体

如果你是手动复制 rtk.exe：

删除对应目录里的 rtk.exe
重新打开终端
再用 where.exe rtk 确认它已经消失

如果你是 Cargo 安装：

cargo uninstall rtk

一套最实用的推荐方案

如果你是 Windows 用户，建议这样做：

方案 A：你主要用 Codex

从官方 Releases 下载 Windows zip
把 rtk.exe 放到已经在 PATH 的目录
验证 rtk --version 和 rtk gain
执行 rtk init -g --codex
在 Codex 里尽量显式使用 rtk ...

最小命令集：

rtk git status
rtk read README.md -n -m 120
rtk grep "pattern" . -t go
rtk test go test ./...
rtk gain --project

方案 B：你主要用 Claude Code

安装 rtk
执行 rtk init -g --auto-patch
用 rtk init --show 确认 hook 已启用
重启 Claude Code
平时让 Claude 正常跑 Bash 命令，需要时再显式指定 rtk

最后的理解

rtk 真正解决的问题，不是“让命令变酷”，而是：

让 AI 编程助手在有限上下文里，优先看到真正重要的终端信息。

在 Windows 上，它完全可以用，而且不复杂：

安装本体并不难
Codex 集成偏“指令式”
Claude Code 集成偏“hook 式”
一旦你开始用 rtk gain 回看统计，就会很快知道它有没有帮你省上下文

如果你经常让 AI 帮你做代码阅读、测试、构建、查错，那么 rtk 非常值得进入你的默认工具箱。

参考资料

RTK 官方 README（安装、命令、各类 AI 工具集成方式）: https://github.com/rtk-ai/rtk ↩ ↩ ↩ ↩ ↩ ↩ ↩ ↩ ↩ ↩ ↩ ↩ ↩ ↩ ↩ ↩ ↩
RTK 官方 INSTALL.md（同名包冲突、Claude Code 初始化与验证）: https://github.com/rtk-ai/rtk/blob/master/INSTALL.md ↩ ↩ ↩ ↩ ↩ ↩ ↩ ↩ ↩
RTK 官方 Releases（Windows 预编译二进制下载）: https://github.com/rtk-ai/rtk/releases ↩ ↩ ↩

最后修改：2026 年 04 月 14 日

如果觉得我的文章对你有用，请随意赞赏

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

评论 *

私密评论

名称 *

🎲

邮箱 *

地址

AI 开发者 Token 压缩利器

shpym • 2026 年 04 月 14 日

<h1><a id="content-rtk-在-windows-上的安装使用以及集成到-codex-和-claude-code" href="#content-rtk-在-windows-上的安装使用以及集成到-codex-和-claude-code" class="heading-permalink" aria-hidden="true" title="Permalink"></a>RTK 在 Windows 上的安装、使用，以及集成到 Codex 和 Claude Code</h1>
<blockquote>
<p>这是一篇可直接照着操作的 Windows 教程：从安装 <code>rtk</code>，到日常使用，再到分别集成进 Codex 和 Claude Code。</p>
<p>本文示例基于 Windows AMD64 环境和 <code>rtk 0.35.0</code>。文中的本机路径、用户名和本地目录都已经做了脱敏处理，统一用 <code>%USERPROFILE%</code>、<code>%LOCALAPPDATA%</code>、<code>&lt;用户名&gt;</code> 这类占位符表示。</p>
</blockquote>
<hr />
<h2><a id="content-先说结论" href="#content-先说结论" class="heading-permalink" aria-hidden="true" title="Permalink"></a>先说结论</h2>
<p><code>rtk</code> 是一个给 AI 编程助手用的命令行代理层。它不会替代 <code>git</code>、<code>go test</code>、<code>npm</code>、<code>pytest</code> 这些工具，而是把原本很长、很吵、很浪费上下文的终端输出压缩成更适合 LLM 消化的格式。官方把它称为 “A high-performance CLI proxy designed to filter and summarize system outputs before they reach your LLM context”。<sup id="fnref:1"><a class="footnote-ref" href="#fn:1" role="doc-noteref">1</a></sup></p>
<p>如果你经常在 Codex、Claude Code、Cursor、Gemini CLI 这类代理式开发工具里工作，<code>rtk</code> 的价值非常直接：</p>
<ul>
<li>看 <code>git status</code>、<code>git diff</code>、<code>grep</code>、<code>test</code> 结果时，输出会短很多。</li>
<li>失败信息更聚焦，成功信息更安静。</li>
<li><code>rtk gain</code> 可以统计你到底省了多少 tokens。<sup id="fnref:1__2"><a class="footnote-ref" href="#fn:1" role="doc-noteref">1</a></sup></li>
</ul>
<hr />
<h2><a id="content-目录" href="#content-目录" class="heading-permalink" aria-hidden="true" title="Permalink"></a>目录</h2>
<ol>
<li>安装前必须知道的一件事</li>
<li>在 Windows 上安装 <code>rtk</code></li>
<li>安装成功后，RTK 到底怎么用</li>
<li>集成到 Codex</li>
<li>集成到 Claude Code</li>
<li>Codex 和 Claude Code 的差异</li>
<li><code>rtk gain</code> 怎么看、怎么清空</li>
<li>Windows 上最常见的排错点</li>
<li>卸载与回滚</li>
<li>一套最实用的推荐方案</li>
</ol>
<hr />
<h2><a id="content-安装前必须知道的一件事" href="#content-安装前必须知道的一件事" class="heading-permalink" aria-hidden="true" title="Permalink"></a>安装前必须知道的一件事</h2>
<p>官方文档特别提醒：<strong>有两个完全不同的项目都叫 <code>rtk</code></strong>。如果你装错了，命令名虽然也叫 <code>rtk</code>，但你得到的根本不是这个“Rust Token Killer”。官方给出的最直接识别方式就是：安装后执行 <code>rtk gain</code>，能看到 token savings 统计，才说明你装的是对的版本。<sup id="fnref:2"><a class="footnote-ref" href="#fn:2" role="doc-noteref">2</a></sup></p>
<p>所以不要只看：</p>
<pre><code class="language-powershell">rtk --version
</code></pre>
<p>还要看：</p>
<pre><code class="language-powershell">rtk gain
</code></pre>
<p>如果 <code>rtk --version</code> 能跑，但 <code>rtk gain</code> 不对，那大概率装错包了。<sup id="fnref:2__2"><a class="footnote-ref" href="#fn:2" role="doc-noteref">2</a></sup></p>
<hr />
<h2><a id="content-在-windows-上安装-rtk" href="#content-在-windows-上安装-rtk" class="heading-permalink" aria-hidden="true" title="Permalink"></a>在 Windows 上安装 <code>rtk</code></h2>
<p>如果你只想先看整体顺序，可以先看这张流程图：</p>
<pre><code class="mermaid">flowchart TD
    accTitle: RTK Windows Workflow
    accDescr: 从 Windows 安装 RTK，到验证、再到集成进 Codex 或 Claude Code 的流程图。

start[&quot;🪟 Windows 安装 RTK&quot;]
    verify[&quot;✅ 验证安装&lt;br/&gt;rtk --version&lt;br/&gt;rtk gain&quot;]
    choose[&quot;🤖 选择集成目标&quot;]
    codex[&quot;Codex&lt;br/&gt;rtk init -g --codex&quot;]
    claude[&quot;Claude Code&lt;br/&gt;rtk init -g&quot;]
    codex_use[&quot;手动或按指令使用&lt;br/&gt;rtk git status&lt;br/&gt;rtk read ...&quot;]
    claude_use[&quot;Bash 命令自动改写为 rtk ...&lt;br/&gt;git status -&gt; rtk git status&quot;]
    stats[&quot;📊 rtk gain 查看收益&quot;]

start --&gt; verify
    verify --&gt; choose
    choose --&gt; codex
    choose --&gt; claude
    codex --&gt; codex_use
    claude --&gt; claude_use
    codex_use --&gt; stats
    claude_use --&gt; stats

classDef install fill:#dbeafe,stroke:#2563eb,stroke-width:2px,color:#1e3a5f
    classDef choice fill:#fef3c7,stroke:#d97706,stroke-width:2px,color:#78350f
    classDef usage fill:#dcfce7,stroke:#16a34a,stroke-width:2px,color:#14532d

class start,verify install
    class choose choice
    class codex,claude,codex_use,claude_use,stats usage
</code></pre>
<hr />
<h3><a id="content-方式一直接使用官方预编译二进制" href="#content-方式一直接使用官方预编译二进制" class="heading-permalink" aria-hidden="true" title="Permalink"></a>方式一：直接使用官方预编译二进制</h3>
<p>这是更推荐的方式，尤其适合没有 Rust 工具链，或者只是想尽快用起来的人。</p>
<p>官方 README 明确提供了 Windows 预编译包，压缩包是：</p>
<pre><code class="language-text">rtk-x86_64-pc-windows-msvc.zip
</code></pre>
<p>对应下载位置在 GitHub Releases。<sup id="fnref:1__3"><a class="footnote-ref" href="#fn:1" role="doc-noteref">1</a></sup><sup id="fnref:3"><a class="footnote-ref" href="#fn:3" role="doc-noteref">3</a></sup></p>
<h4><a id="content-1-下载压缩包" href="#content-1-下载压缩包" class="heading-permalink" aria-hidden="true" title="Permalink"></a>1. 下载压缩包</h4>
<p>打开官方仓库的 Releases 页面，下载 Windows 对应 zip 包：<sup id="fnref:3__2"><a class="footnote-ref" href="#fn:3" role="doc-noteref">3</a></sup></p>
<ul>
<li>仓库：<code>https://github.com/rtk-ai/rtk</code></li>
<li>Releases：<code>https://github.com/rtk-ai/rtk/releases</code></li>
<li>压缩包：<code>rtk-x86_64-pc-windows-msvc.zip</code></li>
</ul>
<h4><a id="content-2-解压并把-rtkexe-放到-path-中的目录" href="#content-2-解压并把-rtkexe-放到-path-中的目录" class="heading-permalink" aria-hidden="true" title="Permalink"></a>2. 解压并把 <code>rtk.exe</code> 放到 PATH 中的目录</h4>
<p>在 Windows 上，你需要把 <code>rtk.exe</code> 放进一个已经在 <code>PATH</code> 里的目录，或者自己新建一个目录再加进 <code>PATH</code>。</p>
<p>常见做法有两种：</p>
<ul>
<li>放进你已经在用的目录，比如 <code>%USERPROFILE%\AppData\Roaming\npm</code></li>
<li>自建目录，比如 <code>%USERPROFILE%\bin</code>，再把它加入用户级 <code>PATH</code></li>
</ul>
<h4><a id="content-3-验证安装" href="#content-3-验证安装" class="heading-permalink" aria-hidden="true" title="Permalink"></a>3. 验证安装</h4>
<p>在 Windows 上建议至少跑这 3 条：</p>
<pre><code class="language-powershell">rtk --version
rtk gain
where.exe rtk
</code></pre>
<p>预期结果：</p>
<ul>
<li><code>rtk --version</code> 能返回版本号</li>
<li><code>rtk gain</code> 不再是 “command not found”</li>
<li><code>where.exe rtk</code> 能告诉你 <code>rtk.exe</code> 究竟从哪里被调用</li>
</ul>
<hr />
<h3><a id="content-方式二使用-cargo" href="#content-方式二使用-cargo" class="heading-permalink" aria-hidden="true" title="Permalink"></a>方式二：使用 Cargo</h3>
<p>如果你的机器已经装了 Rust，也可以直接走源码安装。</p>
<p>官方建议的方式是：<strong>直接从 GitHub 仓库安装</strong>。<sup id="fnref:1__4"><a class="footnote-ref" href="#fn:1" role="doc-noteref">1</a></sup><sup id="fnref:2__3"><a class="footnote-ref" href="#fn:2" role="doc-noteref">2</a></sup></p>
<pre><code class="language-powershell">cargo install --git https://github.com/rtk-ai/rtk
</code></pre>
<p>不建议默认使用下面这条：</p>
<pre><code class="language-powershell">cargo install rtk
</code></pre>
<p>原因和前面一样：同名项目冲突，容易装错。<sup id="fnref:2__4"><a class="footnote-ref" href="#fn:2" role="doc-noteref">2</a></sup></p>
<p>Cargo 安装完成之后，同样要执行：</p>
<pre><code class="language-powershell">rtk --version
rtk gain
where.exe rtk
</code></pre>
<hr />
<h2><a id="content-安装成功后rtk-到底怎么用" href="#content-安装成功后rtk-到底怎么用" class="heading-permalink" aria-hidden="true" title="Permalink"></a>安装成功后，RTK 到底怎么用</h2>
<p><code>rtk</code> 的核心用法非常简单：</p>
<blockquote>
<p><strong>把原来会产生很多终端输出的命令，改成前面加一个 <code>rtk</code>。</strong></p>
</blockquote>
<p>例如：</p>
<pre><code class="language-powershell">rtk git status
rtk git diff
rtk read README.md -n -m 80
rtk grep &quot;func main&quot; . -t go
rtk test go test ./...
rtk err npm run build
rtk summary pnpm lint
rtk gain --project
</code></pre>
<h3><a id="content-常用命令分类" href="#content-常用命令分类" class="heading-permalink" aria-hidden="true" title="Permalink"></a>常用命令分类</h3>
<table>
<thead>
<tr>
<th>场景</th>
<th>原始命令</th>
<th>RTK 写法</th>
<th>作用</th>
</tr>
</thead>
<tbody>
<tr>
<td>看 Git 状态</td>
<td><code>git status</code></td>
<td><code>rtk git status</code></td>
<td>压缩状态输出</td>
</tr>
<tr>
<td>看 diff</td>
<td><code>git diff</code></td>
<td><code>rtk git diff</code></td>
<td>更聚焦地展示变更</td>
</tr>
<tr>
<td>读大文件</td>
<td><code>cat README.md</code></td>
<td><code>rtk read README.md -n -m 120</code></td>
<td>自动截断、保留重点</td>
</tr>
<tr>
<td>搜代码</td>
<td><code>rg &quot;pattern&quot;</code></td>
<td><code>rtk grep &quot;pattern&quot; .</code></td>
<td>分组展示匹配结果</td>
</tr>
<tr>
<td>跑测试</td>
<td><code>go test ./...</code></td>
<td><code>rtk test go test ./...</code></td>
<td>优先显示失败信息</td>
</tr>
<tr>
<td>只看错误</td>
<td><code>npm run build</code></td>
<td><code>rtk err npm run build</code></td>
<td>过滤无关成功日志</td>
</tr>
<tr>
<td>看统计</td>
<td>无</td>
<td><code>rtk gain</code></td>
<td>查看节省的 tokens</td>
</tr>
</tbody>
</table>
<h3><a id="content-最值得先记住的-5-条" href="#content-最值得先记住的-5-条" class="heading-permalink" aria-hidden="true" title="Permalink"></a>最值得先记住的 5 条</h3>
<pre><code class="language-powershell">rtk git status
rtk read &lt;file&gt; -n -m 120
rtk grep &quot;&lt;pattern&gt;&quot; . -t go
rtk test &lt;你的测试命令&gt;
rtk gain --project
</code></pre>
<h3><a id="content-如果你想临时拿回原始输出" href="#content-如果你想临时拿回原始输出" class="heading-permalink" aria-hidden="true" title="Permalink"></a>如果你想临时拿回“原始输出”</h3>
<p>可以用：</p>
<pre><code class="language-powershell">rtk proxy git diff
</code></pre>
<p>这个命令会直接透传原始命令，但仍保留 RTK 的 tracking 逻辑。<sup id="fnref:1__5"><a class="footnote-ref" href="#fn:1" role="doc-noteref">1</a></sup></p>
<hr />
<h2><a id="content-集成到-codex推荐全局集成" href="#content-集成到-codex推荐全局集成" class="heading-permalink" aria-hidden="true" title="Permalink"></a>集成到 Codex：推荐全局集成</h2>
<p>如果你在用 OpenAI 的 Codex CLI，官方建议的集成命令是：<sup id="fnref:1__6"><a class="footnote-ref" href="#fn:1" role="doc-noteref">1</a></sup></p>
<pre><code class="language-powershell">rtk init -g --codex
</code></pre>
<p>官方 README 对 Codex 模式的描述非常明确：</p>
<ul>
<li>会创建 <code>~/.codex/RTK.md</code></li>
<li>会创建或更新 <code>~/.codex/AGENTS.md</code></li>
<li><code>AGENTS.md</code> 中会加入 <code>@RTK.md</code> 引用</li>
<li>Codex 会把这些文件当作全局指令读取<sup id="fnref:1__7"><a class="footnote-ref" href="#fn:1" role="doc-noteref">1</a></sup></li>
</ul>
<h3><a id="content-1-为什么推荐--g---codex" href="#content-1-为什么推荐--g---codex" class="heading-permalink" aria-hidden="true" title="Permalink"></a>1. 为什么推荐 <code>-g --codex</code></h3>
<p>因为这是<strong>全局集成</strong>，不会去碰你当前项目里的文档文件。对已经有自己 <code>AGENTS.md</code> 规则的仓库来说，这通常更稳。</p>
<p>执行：</p>
<pre><code class="language-powershell">rtk init -g --codex
</code></pre>
<p>之后，生成的是：</p>
<ul>
<li><code>%USERPROFILE%\.codex\RTK.md</code></li>
<li><code>%USERPROFILE%\.codex\AGENTS.md</code></li>
</ul>
<p>并且 <code>AGENTS.md</code> 里应该是：</p>
<pre><code class="language-text">@RTK.md
</code></pre>
<h3><a id="content-2-如何验证-codex-集成是否生效" href="#content-2-如何验证-codex-集成是否生效" class="heading-permalink" aria-hidden="true" title="Permalink"></a>2. 如何验证 Codex 集成是否生效</h3>
<p>用下面这条命令：</p>
<pre><code class="language-powershell">rtk init -g --codex --show
</code></pre>
<pre><code>rtk Configuration (Codex CLI):

[ok] Global RTK.md: C:\Users\shihao\.codex\RTK.md
[ok] Global AGENTS.md: @RTK.md reference
[ok] Local RTK.md: RTK.md
[ok] Local AGENTS.md: @RTK.md reference

Usage:
  rtk init --codex              # Configure local AGENTS.md + RTK.md
  rtk init -g --codex           # Configure ~/.codex/AGENTS.md + ~/.codex/RTK.md
  rtk init -g --codex --uninstall  # Remove global Codex RTK artifacts
</code></pre>
<p>正常情况下，你应该能看到当前 Codex 集成状态，而不是重新进入安装流程。</p>
<h3><a id="content-3-codex-里集成后到底怎么用" href="#content-3-codex-里集成后到底怎么用" class="heading-permalink" aria-hidden="true" title="Permalink"></a>3. Codex 里集成后到底怎么用</h3>
<p>这里有一个关键差异：</p>
<blockquote>
<p><strong>Codex 模式不是靠 hook 自动改写命令，而是靠全局指令提醒代理优先使用 <code>rtk</code>。</strong></p>
</blockquote>
<p>也就是说，在 Codex 里你最稳妥的使用方式仍然是：</p>
<pre><code class="language-powershell">rtk git status
rtk read README.md -n -m 80
rtk grep &quot;handler&quot; . -t go
rtk test go test ./...
</code></pre>
<h3><a id="content-4-codex-模式的一个常见误解" href="#content-4-codex-模式的一个常见误解" class="heading-permalink" aria-hidden="true" title="Permalink"></a>4. Codex 模式的一个常见误解</h3>
<p>如果你看到：</p>
<pre><code class="language-text">[warn] No hook installed
</code></pre>
<p>不要马上觉得集成失败了。</p>
<p>当前版本里，这个提示更偏向“没有安装 Claude 风格的 hook”。而 Codex 的 <code>--codex</code> 模式本来就不是 hook-first 的集成方式，所以要结合 <code>rtk init -g --codex --show</code> 和实际使用效果一起判断。<sup id="fnref:1__8"><a class="footnote-ref" href="#fn:1" role="doc-noteref">1</a></sup></p>
<h3><a id="content-5-如果你只想给当前项目单独开启-codex-集成" href="#content-5-如果你只想给当前项目单独开启-codex-集成" class="heading-permalink" aria-hidden="true" title="Permalink"></a>5. 如果你只想给当前项目单独开启 Codex 集成</h3>
<p>可以使用：</p>
<pre><code class="language-powershell">rtk init --codex
</code></pre>
<p>这会在当前项目里写本地 <code>AGENTS.md</code> 和 <code>RTK.md</code>。<sup id="fnref:1__9"><a class="footnote-ref" href="#fn:1" role="doc-noteref">1</a></sup></p>
<p>如果你的仓库本来就已经有自己的 <code>AGENTS.md</code> 规则，建议先谨慎一点。对大多数人来说，全局 <code>-g --codex</code> 更合适。</p>
<hr />
<h3><a id="content-6-集成到-codex-之后日常该怎么提问" href="#content-6-集成到-codex-之后日常该怎么提问" class="heading-permalink" aria-hidden="true" title="Permalink"></a>6. 集成到 Codex 之后，日常该怎么提问</h3>
<p>你可以把下面这些当作比较“顺手”的写法：</p>
<h4><a id="content-方式一直接把命令写全" href="#content-方式一直接把命令写全" class="heading-permalink" aria-hidden="true" title="Permalink"></a>方式一：直接把命令写全</h4>
<pre><code class="language-text">请运行 rtk git status
请用 rtk read 看一下 README.md
请用 rtk grep 搜索 &quot;CreateShortURL&quot;
请用 rtk test 跑 go test ./...
</code></pre>
<h4><a id="content-方式二让代理默认偏向-rtk" href="#content-方式二让代理默认偏向-rtk" class="heading-permalink" aria-hidden="true" title="Permalink"></a>方式二：让代理默认偏向 RTK</h4>
<p>如果全局 <code>RTK.md</code> 已经生效，很多时候你也可以直接说：</p>
<pre><code class="language-text">帮我看一下当前 git 状态
帮我读一下 README
帮我搜一下哪个文件里有这个函数
</code></pre>
<p>但从可预期性来说，<strong>把 <code>rtk</code> 明写出来更稳</strong>。特别是当你希望代理一定使用压缩后的 shell 输出时。</p>
<h4><a id="content-方式三问题排查时配合-gain" href="#content-方式三问题排查时配合-gain" class="heading-permalink" aria-hidden="true" title="Permalink"></a>方式三：问题排查时配合 <code>gain</code></h4>
<pre><code class="language-powershell">rtk gain --project
rtk gain --project --history
</code></pre>
<pre><code>RTK Token Savings (Global Scope)
════════════════════════════════════════════════════════════

Total commands:    28
Input tokens:      43.2K
Output tokens:     33.9K
Tokens saved:      12.4K (28.8%)
Total exec time:   2.5s (avg 87ms)
Efficiency meter: ███████░░░░░░░░░░░░░░░░░ 28.8%

[warn] No hook installed — run `rtk init -g` for automatic token savings

By Command
───────────────────────────────────────────────────────────────────────
  #  Command                   Count  Saved    Avg%    Time  Impact    
───────────────────────────────────────────────────────────────────────
 1.  rtk read                     10   9.0K   29.3%     0ms  ██████████
 2.  rtk git diff                  1   3.1K   41.7%   187ms  ███░░░░░░░
 3.  rtk git status                3    278   60.9%   254ms  ░░░░░░░░░░
 4.  rtk git log                   3     84   25.2%   150ms  ░░░░░░░░░░
 5.  rtk git branch                1      6   75.0%   104ms  ░░░░░░░░░░
 6.  rtk git diff docs/blo...      2      2  100.0%   289ms  ░░░░░░░░░░
 7.  rtk grep                      8      0    0.0%    46ms  ░░░░░░░░░░
───────────────────────────────────────────────────────────────────────
</code></pre>
<p>这两条很适合用来回头看看：最近哪些命令最省 tokens，哪些命令其实没省多少。</p>
<hr />
<h2><a id="content-集成到-claude-code这是-rtk-最强的场景之一" href="#content-集成到-claude-code这是-rtk-最强的场景之一" class="heading-permalink" aria-hidden="true" title="Permalink"></a>集成到 Claude Code：这是 RTK 最强的场景之一</h2>
<p>对 Claude Code，官方给出的默认推荐命令是：<sup id="fnref:1__10"><a class="footnote-ref" href="#fn:1" role="doc-noteref">1</a></sup></p>
<pre><code class="language-powershell">rtk init -g
</code></pre>
<p>如果你不想手动确认 patch，可以用：</p>
<pre><code class="language-powershell">rtk init -g --auto-patch
</code></pre>
<p>官方 README 和 INSTALL 都说明了 Claude Code 集成的大体行为：<sup id="fnref:1__11"><a class="footnote-ref" href="#fn:1" role="doc-noteref">1</a></sup><sup id="fnref:2__5"><a class="footnote-ref" href="#fn:2" role="doc-noteref">2</a></sup></p>
<ul>
<li>安装 hook</li>
<li>创建 <code>~/.claude/RTK.md</code></li>
<li>在 <code>~/.claude/CLAUDE.md</code> 中加入 <code>@RTK.md</code></li>
<li>patch <code>settings.json</code></li>
</ul>
<h3><a id="content-1-claude-code-集成后为什么体验更自动" href="#content-1-claude-code-集成后为什么体验更自动" class="heading-permalink" aria-hidden="true" title="Permalink"></a>1. Claude Code 集成后为什么体验更“自动”</h3>
<p>因为 Claude Code 默认是通过 <strong>PreToolUse hook</strong> 来拦截 Bash 工具调用的。官方 README 的原话是：</p>
<ul>
<li>Claude Code：<code>PreToolUse hook (bash)</code></li>
<li>Hook transparently rewrites Bash commands</li>
<li>例如 <code>git status -&gt; rtk git status</code><sup id="fnref:1__12"><a class="footnote-ref" href="#fn:1" role="doc-noteref">1</a></sup></li>
</ul>
<p>这意味着：</p>
<p>你在 Claude Code 里让它执行：</p>
<pre><code class="language-bash">git status
</code></pre>
<p>最终真正落到 shell 的，很可能是：</p>
<pre><code class="language-bash">rtk git status
</code></pre>
<p>也就是说，<strong>Claude Code 这边的 RTK 集成是“自动改写”路线</strong>。</p>
<h3><a id="content-2-一个必须知道的限制" href="#content-2-一个必须知道的限制" class="heading-permalink" aria-hidden="true" title="Permalink"></a>2. 一个必须知道的限制</h3>
<p>官方 README 同时也强调了一件事：<sup id="fnref:1__13"><a class="footnote-ref" href="#fn:1" role="doc-noteref">1</a></sup></p>
<blockquote>
<p>Hook 只会作用在 Bash tool calls 上。</p>
</blockquote>
<p>像 Claude Code 内建的 <code>Read</code>、<code>Grep</code>、<code>Glob</code> 这类工具，并不会自动经过这个 Bash hook，所以不会被透明改写。<sup id="fnref:1__14"><a class="footnote-ref" href="#fn:1" role="doc-noteref">1</a></sup></p>
<p>这一点很重要，因为很多人装完之后会以为“所有操作都会自动变成 RTK”。实际上不是：</p>
<ul>
<li>Bash 命令：会自动改写</li>
<li>内建读取类工具：不会自动改写</li>
</ul>
<h3><a id="content-3-claude-code-的验证方式" href="#content-3-claude-code-的验证方式" class="heading-permalink" aria-hidden="true" title="Permalink"></a>3. Claude Code 的验证方式</h3>
<p>安装后可以这样检查：</p>
<pre><code class="language-powershell">rtk init --show
</code></pre>
<p>你应该能看到类似：</p>
<ul>
<li>Hook: ok</li>
<li>RTK.md: ok</li>
<li>Global <code>~/.claude/CLAUDE.md</code>: 已配置</li>
<li>settings.json: 已配置 hook</li>
</ul>
<p>然后重启 Claude Code，再试一次普通命令：</p>
<pre><code class="language-bash">git status
</code></pre>
<p>如果 hook 已经正常工作，Claude Code 实际拿到的会是被 RTK 压缩过的输出。<sup id="fnref:1__15"><a class="footnote-ref" href="#fn:1" role="doc-noteref">1</a></sup><sup id="fnref:2__6"><a class="footnote-ref" href="#fn:2" role="doc-noteref">2</a></sup></p>
<h3><a id="content-4-claude-code-里推荐怎么用" href="#content-4-claude-code-里推荐怎么用" class="heading-permalink" aria-hidden="true" title="Permalink"></a>4. Claude Code 里推荐怎么用</h3>
<p>虽然自动改写已经很好用，但更稳妥的建议是：</p>
<ul>
<li>日常随手操作，可以让 Claude 直接执行原始 Bash 命令</li>
<li>对你特别在意的场景，仍然可以显式写 <code>rtk</code></li>
</ul>
<p>例如：</p>
<pre><code class="language-bash">git status
git diff
go test ./...
</code></pre>
<p>以及更可控的：</p>
<pre><code class="language-bash">rtk git status
rtk git diff
rtk test go test ./...
</code></pre>
<p>两者都能用，只是第二种更明确。</p>
<hr />
<h2><a id="content-codex-和-claude-code-的差异最好一次搞清楚" href="#content-codex-和-claude-code-的差异最好一次搞清楚" class="heading-permalink" aria-hidden="true" title="Permalink"></a>Codex 和 Claude Code 的差异，最好一次搞清楚</h2>
<table>
<thead>
<tr>
<th>维度</th>
<th>Codex</th>
<th>Claude Code</th>
</tr>
</thead>
<tbody>
<tr>
<td>推荐安装命令</td>
<td><code>rtk init -g --codex</code></td>
<td><code>rtk init -g</code></td>
</tr>
<tr>
<td>主要机制</td>
<td><code>AGENTS.md + RTK.md</code> 指令注入</td>
<td>PreToolUse hook + <code>RTK.md</code></td>
</tr>
<tr>
<td>是否自动改写 Bash 命令</td>
<td>通常不是自动 hook 改写</td>
<td>是</td>
</tr>
<tr>
<td>是否需要你显式写 <code>rtk</code></td>
<td>建议写</td>
<td>可以不写，但显式写更稳</td>
</tr>
<tr>
<td>配置检查</td>
<td><code>rtk init -g --codex --show</code></td>
<td><code>rtk init --show</code></td>
</tr>
<tr>
<td>更适合的使用心智</td>
<td>“让代理优先用 RTK”</td>
<td>“让 Bash 命令自动走 RTK”</td>
</tr>
</tbody>
</table>
<p>如果一句话概括：</p>
<ul>
<li><strong>Codex</strong> 更像“通过全局规则教会代理使用 RTK”</li>
<li><strong>Claude Code</strong> 更像“通过 hook 自动把命令改写成 RTK”</li>
</ul>
<hr />
<h2><a id="content-rtk-gain-怎么看怎么清空" href="#content-rtk-gain-怎么看怎么清空" class="heading-permalink" aria-hidden="true" title="Permalink"></a><code>rtk gain</code> 怎么看、怎么清空</h2>
<p>安装完之后，最值得养成的习惯就是定期跑：</p>
<pre><code class="language-powershell">rtk gain
rtk gain --history
rtk gain --project
rtk gain --project --history
</code></pre>
<p>这 4 条命令分别对应：</p>
<ul>
<li><code>rtk gain</code>：看全局累计统计</li>
<li><code>rtk gain --history</code>：看全局最近命令历史</li>
<li><code>rtk gain --project</code>：只看当前项目</li>
<li><code>rtk gain --project --history</code>：看当前项目的最近命令历史</li>
</ul>
<p>在当前 Windows 版本里，<code>rtk gain</code> 至少会给你这些信息：</p>
<ul>
<li>总命令数</li>
<li>输入 token 数</li>
<li>输出 token 数</li>
<li>节省比例</li>
<li>各命令的节省效果排行</li>
</ul>
<p>通常最值得交给 RTK 的，是这些输出特别吵的命令：</p>
<ul>
<li><code>git status</code></li>
<li><code>git diff</code></li>
<li><code>read</code> / <code>cat</code></li>
<li><code>grep</code> / <code>rg</code></li>
<li><code>test</code></li>
<li><code>lint</code></li>
<li><code>docker</code></li>
<li><code>kubectl</code></li>
</ul>
<hr />
<h3><a id="content-一个当前版本里很容易踩的参数坑" href="#content-一个当前版本里很容易踩的参数坑" class="heading-permalink" aria-hidden="true" title="Permalink"></a>一个当前版本里很容易踩的参数坑</h3>
<p>正确写法是：</p>
<pre><code class="language-powershell">rtk gain --history
</code></pre>
<p>不是：</p>
<pre><code class="language-powershell">rtk gain history
</code></pre>
<p>后者在当前版本会直接报参数错误，因为 <code>history</code> 在这里是一个 flag，不是子命令。</p>
<hr />
<h3><a id="content-windows-上怎么清空-rtk-gain-的累计统计" href="#content-windows-上怎么清空-rtk-gain-的累计统计" class="heading-permalink" aria-hidden="true" title="Permalink"></a>Windows 上怎么清空 <code>rtk gain</code> 的累计统计</h3>
<p>很多人看见 <code>Total commands</code> 一直上涨，会下意识问一句：怎么清零？</p>
<p>先说结论：</p>
<ul>
<li>当前版本没有内置的 <code>clear</code> 或 <code>reset</code> 子命令</li>
<li><code>rtk gain</code> 默认显示的是全局累计统计</li>
<li>如果你只是想缩小观察范围，优先用 <code>rtk gain --project</code></li>
</ul>
<p>如果你确实想把全局统计清空，在当前 Windows 实测环境里，可以重置这个文件：</p>
<pre><code class="language-text">%LOCALAPPDATA%\rtk\history.db
</code></pre>
<p>更稳妥的做法是先备份再清空：</p>
<pre><code class="language-powershell">Rename-Item &quot;$env:LOCALAPPDATA\rtk\history.db&quot; &quot;history.db.bak&quot;
</code></pre>
<p>如果你确认不需要备份，也可以直接删除：</p>
<pre><code class="language-powershell">Remove-Item &quot;$env:LOCALAPPDATA\rtk\history.db&quot;
</code></pre>
<p>建议先关闭正在使用 <code>rtk</code> 的终端或代理会话，避免文件被占用。通常下次再运行 <code>rtk</code> 时，这个统计库会自动重建。</p>
<hr />
<h2><a id="content-windows-上最常见的排错点" href="#content-windows-上最常见的排错点" class="heading-permalink" aria-hidden="true" title="Permalink"></a>Windows 上最常见的排错点</h2>
<h3><a id="content-1-rtk-命令找不到" href="#content-1-rtk-命令找不到" class="heading-permalink" aria-hidden="true" title="Permalink"></a>1. <code>rtk</code> 命令找不到</h3>
<p>先看：</p>
<pre><code class="language-powershell">where.exe rtk
</code></pre>
<p>如果没结果，说明：</p>
<ul>
<li><code>rtk.exe</code> 没有放到 PATH 目录里</li>
<li>或者你修改了 PATH，但终端还没重开</li>
</ul>
<p>这时你需要：</p>
<ol>
<li>确认 <code>rtk.exe</code> 真实存放路径</li>
<li>确认这个目录在用户 PATH 里</li>
<li>关闭并重新打开 PowerShell / 终端 / AI 工具</li>
</ol>
<h3><a id="content-2-rtk---version-能跑但-rtk-gain-不对" href="#content-2-rtk---version-能跑但-rtk-gain-不对" class="heading-permalink" aria-hidden="true" title="Permalink"></a>2. <code>rtk --version</code> 能跑，但 <code>rtk gain</code> 不对</h3>
<p>优先怀疑你装错了同名项目。</p>
<p>最稳的修复方式：</p>
<pre><code class="language-powershell">cargo uninstall rtk
cargo install --git https://github.com/rtk-ai/rtk
rtk gain
</code></pre>
<p>如果你走的是二进制方式，就重新从 <code>rtk-ai/rtk</code> 官方 Releases 下载。<sup id="fnref:2__7"><a class="footnote-ref" href="#fn:2" role="doc-noteref">2</a></sup><sup id="fnref:3__3"><a class="footnote-ref" href="#fn:3" role="doc-noteref">3</a></sup></p>
<h3><a id="content-3-rtk-gain-history-报错" href="#content-3-rtk-gain-history-报错" class="heading-permalink" aria-hidden="true" title="Permalink"></a>3. <code>rtk gain history</code> 报错</h3>
<p>正确写法是：</p>
<pre><code class="language-powershell">rtk gain --history
</code></pre>
<p>如果你写成 <code>rtk gain history</code>，当前版本会直接报参数错误。</p>
<h3><a id="content-4-total-commands-一直上涨" href="#content-4-total-commands-一直上涨" class="heading-permalink" aria-hidden="true" title="Permalink"></a>4. <code>Total commands</code> 一直上涨</h3>
<p>这是默认行为，因为 <code>rtk gain</code> 看的是全局累计。你有三个选择：</p>
<ul>
<li>只看当前项目：<code>rtk gain --project</code></li>
<li>看最近历史：<code>rtk gain --history</code></li>
<li>直接重置统计库：处理 <code>%LOCALAPPDATA%\rtk\history.db</code></li>
</ul>
<h3><a id="content-5-总看到-no-hook-installed" href="#content-5-总看到-no-hook-installed" class="heading-permalink" aria-hidden="true" title="Permalink"></a>5. 总看到 <code>No hook installed</code></h3>
<p>如果你还没有集成 Claude Code，这个提示本身并不奇怪。</p>
<p>如果你已经在用 Codex 的 <code>--codex</code> 模式，也不要只凭这一句就判断失败。先用 <code>rtk init -g --codex --show</code> 看真实状态，再结合实际命令使用效果判断。</p>
<h3><a id="content-6-claude-code-安装后没自动改写" href="#content-6-claude-code-安装后没自动改写" class="heading-permalink" aria-hidden="true" title="Permalink"></a>6. Claude Code 安装后没自动改写</h3>
<p>优先检查：</p>
<pre><code class="language-powershell">rtk init --show
</code></pre>
<p>重点看两个地方：</p>
<ul>
<li>Hook 是否存在</li>
<li><code>settings.json</code> 是否已经 patch 成功</li>
</ul>
<p>如果你当时安装时选择了不 patch，那么可以重新执行：</p>
<pre><code class="language-powershell">rtk init -g --auto-patch
</code></pre>
<p>然后重启 Claude Code。<sup id="fnref:1__16"><a class="footnote-ref" href="#fn:1" role="doc-noteref">1</a></sup><sup id="fnref:2__8"><a class="footnote-ref" href="#fn:2" role="doc-noteref">2</a></sup></p>
<hr />
<h2><a id="content-卸载与回滚" href="#content-卸载与回滚" class="heading-permalink" aria-hidden="true" title="Permalink"></a>卸载与回滚</h2>
<h3><a id="content-codex" href="#content-codex" class="heading-permalink" aria-hidden="true" title="Permalink"></a>Codex</h3>
<pre><code class="language-powershell">rtk init -g --codex --uninstall
</code></pre>
<p>如果你是本地项目集成：</p>
<pre><code class="language-powershell">rtk init --codex --uninstall
</code></pre>
<h3><a id="content-claude-code" href="#content-claude-code" class="heading-permalink" aria-hidden="true" title="Permalink"></a>Claude Code</h3>
<pre><code class="language-powershell">rtk init -g --uninstall
</code></pre>
<p>官方文档说明，这会移除 hook、<code>RTK.md</code>、<code>CLAUDE.md</code> 中的引用，以及相关的 <code>settings.json</code> 配置。<sup id="fnref:1__17"><a class="footnote-ref" href="#fn:1" role="doc-noteref">1</a></sup><sup id="fnref:2__9"><a class="footnote-ref" href="#fn:2" role="doc-noteref">2</a></sup></p>
<h3><a id="content-二进制本体" href="#content-二进制本体" class="heading-permalink" aria-hidden="true" title="Permalink"></a>二进制本体</h3>
<p>如果你是手动复制 <code>rtk.exe</code>：</p>
<ul>
<li>删除对应目录里的 <code>rtk.exe</code></li>
<li>重新打开终端</li>
<li>再用 <code>where.exe rtk</code> 确认它已经消失</li>
</ul>
<p>如果你是 Cargo 安装：</p>
<pre><code class="language-powershell">cargo uninstall rtk
</code></pre>
<hr />
<h2><a id="content-一套最实用的推荐方案" href="#content-一套最实用的推荐方案" class="heading-permalink" aria-hidden="true" title="Permalink"></a>一套最实用的推荐方案</h2>
<p>如果你是 Windows 用户，建议这样做：</p>
<h3><a id="content-方案-a你主要用-codex" href="#content-方案-a你主要用-codex" class="heading-permalink" aria-hidden="true" title="Permalink"></a>方案 A：你主要用 Codex</h3>
<ol>
<li>从官方 Releases 下载 Windows zip</li>
<li>把 <code>rtk.exe</code> 放到已经在 PATH 的目录</li>
<li>验证 <code>rtk --version</code> 和 <code>rtk gain</code></li>
<li>执行 <code>rtk init -g --codex</code></li>
<li>在 Codex 里尽量显式使用 <code>rtk ...</code></li>
</ol>
<p>最小命令集：</p>
<pre><code class="language-powershell">rtk git status
rtk read README.md -n -m 120
rtk grep &quot;pattern&quot; . -t go
rtk test go test ./...
rtk gain --project
</code></pre>
<h3><a id="content-方案-b你主要用-claude-code" href="#content-方案-b你主要用-claude-code" class="heading-permalink" aria-hidden="true" title="Permalink"></a>方案 B：你主要用 Claude Code</h3>
<ol>
<li>安装 <code>rtk</code></li>
<li>执行 <code>rtk init -g --auto-patch</code></li>
<li>用 <code>rtk init --show</code> 确认 hook 已启用</li>
<li>重启 Claude Code</li>
<li>平时让 Claude 正常跑 Bash 命令，需要时再显式指定 <code>rtk</code></li>
</ol>
<hr />
<h2><a id="content-最后的理解" href="#content-最后的理解" class="heading-permalink" aria-hidden="true" title="Permalink"></a>最后的理解</h2>
<p><code>rtk</code> 真正解决的问题，不是“让命令变酷”，而是：</p>
<blockquote>
<p><strong>让 AI 编程助手在有限上下文里，优先看到真正重要的终端信息。</strong></p>
</blockquote>
<p>在 Windows 上，它完全可以用，而且不复杂：</p>
<ul>
<li>安装本体并不难</li>
<li>Codex 集成偏“指令式”</li>
<li>Claude Code 集成偏“hook 式”</li>
<li>一旦你开始用 <code>rtk gain</code> 回看统计，就会很快知道它有没有帮你省上下文</li>
</ul>
<p>如果你经常让 AI 帮你做代码阅读、测试、构建、查错，那么 <code>rtk</code> 非常值得进入你的默认工具箱。</p>
<hr />
<h2><a id="content-参考资料" href="#content-参考资料" class="heading-permalink" aria-hidden="true" title="Permalink"></a>参考资料</h2>
<div class="footnotes" role="doc-endnotes"><hr /><ol><li class="footnote" id="fn:1" role="doc-endnote"><p>RTK 官方 README（安装、命令、各类 AI 工具集成方式）: <a rel="noopener noreferrer" href="https://github.com/rtk-ai/rtk">https://github.com/rtk-ai/rtk</a>&nbsp;<a class="footnote-backref" rev="footnote" href="#fnref:1" role="doc-backlink">↩</a>&nbsp;<a class="footnote-backref" rev="footnote" href="#fnref:1__2" role="doc-backlink">↩</a>&nbsp;<a class="footnote-backref" rev="footnote" href="#fnref:1__3" role="doc-backlink">↩</a>&nbsp;<a class="footnote-backref" rev="footnote" href="#fnref:1__4" role="doc-backlink">↩</a>&nbsp;<a class="footnote-backref" rev="footnote" href="#fnref:1__5" role="doc-backlink">↩</a>&nbsp;<a class="footnote-backref" rev="footnote" href="#fnref:1__6" role="doc-backlink">↩</a>&nbsp;<a class="footnote-backref" rev="footnote" href="#fnref:1__7" role="doc-backlink">↩</a>&nbsp;<a class="footnote-backref" rev="footnote" href="#fnref:1__8" role="doc-backlink">↩</a>&nbsp;<a class="footnote-backref" rev="footnote" href="#fnref:1__9" role="doc-backlink">↩</a>&nbsp;<a class="footnote-backref" rev="footnote" href="#fnref:1__10" role="doc-backlink">↩</a>&nbsp;<a class="footnote-backref" rev="footnote" href="#fnref:1__11" role="doc-backlink">↩</a>&nbsp;<a class="footnote-backref" rev="footnote" href="#fnref:1__12" role="doc-backlink">↩</a>&nbsp;<a class="footnote-backref" rev="footnote" href="#fnref:1__13" role="doc-backlink">↩</a>&nbsp;<a class="footnote-backref" rev="footnote" href="#fnref:1__14" role="doc-backlink">↩</a>&nbsp;<a class="footnote-backref" rev="footnote" href="#fnref:1__15" role="doc-backlink">↩</a>&nbsp;<a class="footnote-backref" rev="footnote" href="#fnref:1__16" role="doc-backlink">↩</a>&nbsp;<a class="footnote-backref" rev="footnote" href="#fnref:1__17" role="doc-backlink">↩</a></p></li>
<li class="footnote" id="fn:2" role="doc-endnote"><p>RTK 官方 INSTALL.md（同名包冲突、Claude Code 初始化与验证）: <a rel="noopener noreferrer" href="https://github.com/rtk-ai/rtk/blob/master/INSTALL.md">https://github.com/rtk-ai/rtk/blob/master/INSTALL.md</a>&nbsp;<a class="footnote-backref" rev="footnote" href="#fnref:2" role="doc-backlink">↩</a>&nbsp;<a class="footnote-backref" rev="footnote" href="#fnref:2__2" role="doc-backlink">↩</a>&nbsp;<a class="footnote-backref" rev="footnote" href="#fnref:2__3" role="doc-backlink">↩</a>&nbsp;<a class="footnote-backref" rev="footnote" href="#fnref:2__4" role="doc-backlink">↩</a>&nbsp;<a class="footnote-backref" rev="footnote" href="#fnref:2__5" role="doc-backlink">↩</a>&nbsp;<a class="footnote-backref" rev="footnote" href="#fnref:2__6" role="doc-backlink">↩</a>&nbsp;<a class="footnote-backref" rev="footnote" href="#fnref:2__7" role="doc-backlink">↩</a>&nbsp;<a class="footnote-backref" rev="footnote" href="#fnref:2__8" role="doc-backlink">↩</a>&nbsp;<a class="footnote-backref" rev="footnote" href="#fnref:2__9" role="doc-backlink">↩</a></p></li>
<li class="footnote" id="fn:3" role="doc-endnote"><p>RTK 官方 Releases（Windows 预编译二进制下载）: <a rel="noopener noreferrer" href="https://github.com/rtk-ai/rtk/releases">https://github.com/rtk-ai/rtk/releases</a>&nbsp;<a class="footnote-backref" rev="footnote" href="#fnref:3" role="doc-backlink">↩</a>&nbsp;<a class="footnote-backref" rev="footnote" href="#fnref:3__2" role="doc-backlink">↩</a>&nbsp;<a class="footnote-backref" rev="footnote" href="#fnref:3__3" role="doc-backlink">↩</a></p></li></ol></div>

RTK 在 Windows 上的安装、使用，以及集成到 Codex 和 Claude Code

先说结论

目录

安装前必须知道的一件事

在 Windows 上安装 rtk

方式一：直接使用官方预编译二进制

1. 下载压缩包

2. 解压并把 rtk.exe 放到 PATH 中的目录

3. 验证安装

方式二：使用 Cargo

安装成功后，RTK 到底怎么用

常用命令分类

最值得先记住的 5 条

如果你想临时拿回“原始输出”

集成到 Codex：推荐全局集成

1. 为什么推荐 -g --codex

2. 如何验证 Codex 集成是否生效

3. Codex 里集成后到底怎么用

4. Codex 模式的一个常见误解

5. 如果你只想给当前项目单独开启 Codex 集成

6. 集成到 Codex 之后，日常该怎么提问

方式一：直接把命令写全

方式二：让代理默认偏向 RTK

方式三：问题排查时配合 gain

集成到 Claude Code：这是 RTK 最强的场景之一

1. Claude Code 集成后为什么体验更“自动”

2. 一个必须知道的限制

3. Claude Code 的验证方式

4. Claude Code 里推荐怎么用

Codex 和 Claude Code 的差异，最好一次搞清楚

rtk gain 怎么看、怎么清空

一个当前版本里很容易踩的参数坑

Windows 上怎么清空 rtk gain 的累计统计

Windows 上最常见的排错点

1. rtk 命令找不到

2. rtk --version 能跑，但 rtk gain 不对

3. rtk gain history 报错

4. Total commands 一直上涨

5. 总看到 No hook installed

6. Claude Code 安装后没自动改写

卸载与回滚

Codex

Claude Code

二进制本体

一套最实用的推荐方案

方案 A：你主要用 Codex

方案 B：你主要用 Claude Code

最后的理解

参考资料

发表评论 取消回复 使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

AI 开发者 Token 压缩利器

在 Windows 上安装 `rtk`

2. 解压并把 `rtk.exe` 放到 PATH 中的目录

1. 为什么推荐 `-g --codex`

方式三：问题排查时配合 `gain`

`rtk gain` 怎么看、怎么清空

Windows 上怎么清空 `rtk gain` 的累计统计

1. `rtk` 命令找不到

2. `rtk --version` 能跑，但 `rtk gain` 不对

3. `rtk gain history` 报错

4. `Total commands` 一直上涨

5. 总看到 `No hook installed`

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款