一、创建脚本

随便找个目录，新建一个install-rtk.ps1的文件，打开编辑，然后复制下面全部内容到文件里面，保存

# install-rtk.ps1 — RTK 一键安装脚本 for Windows
# 用法: powershell -ExecutionPolicy Bypass -File .\install-rtk.ps1

$ErrorActionPreference = "Stop"
Set-StrictMode -Version Latest

Write-Host "========================================" -ForegroundColor Cyan
Write-Host " RTK Windows 安装脚本" -ForegroundColor Cyan
Write-Host "========================================" -ForegroundColor Cyan

# === [1/5] 检查依赖 ===
Write-Host "`n=== [1/5] 检查依赖 ===" -ForegroundColor Yellow

$NodeCheck = Get-Command node -ErrorAction SilentlyContinue
if (-not $NodeCheck) {
    Write-Host "未找到 Node.js，RTK 本身不需要 Node，但 Claude Code/Codex CLI 需要。" -ForegroundColor DarkYellow
    Write-Host "如果尚未安装，请访问: https://nodejs.org" -ForegroundColor DarkYellow
}

# === [2/5] 下载 RTK ===
Write-Host "`n=== [2/5] 下载 RTK ===" -ForegroundColor Yellow

$RtkDir = Join-Path $env:USERPROFILE "rtk"
$RtkZip = Join-Path $RtkDir "rtk.zip"
$RtkBinDir = Join-Path $env:USERPROFILE "bin"

# 创建目录
New-Item -ItemType Directory -Path $RtkDir -Force | Out-Null
New-Item -ItemType Directory -Path $RtkBinDir -Force | Out-Null

# 获取最新版本
try {
    Write-Host "正在获取最新版本信息..."
    $Release = Invoke-RestMethod -Uri "https://api.github.com/repos/rtk-ai/rtk/releases/latest" -TimeoutSec 15
    $Tag = $Release.tag_name
    Write-Host "最新版本: $Tag"
    
    $Asset = $Release.assets | Where-Object {
        $_.name -match "x86_64-pc-windows-msvc"
    } | Select-Object -First 1
    if (-not $Asset) {
        Write-Host "未找到 Windows MSVC 二进制，尝试 fallback..." -ForegroundColor DarkYellow
        $Asset = $Release.assets | Where-Object {
            $_.name -match "windows"
        } | Select-Object -First 1
    }
    if (-not $Asset) {
        Write-Error "未找到 Windows 可用下载资源"
        exit 1
    }
    $AssetUrl = $Asset.browser_download_url
} catch {
    Write-Host "GitHub API 请求失败，使用已知版本 v0.39.0" -ForegroundColor DarkYellow
    $Tag = "v0.39.0"
    $AssetUrl = "https://github.com/rtk-ai/rtk/releases/download/v0.39.0/rtk-x86_64-pc-windows-msvc.zip"
}

Write-Host "下载地址: $AssetUrl"
Invoke-WebRequest -Uri $AssetUrl -OutFile $RtkZip

# === [3/5] 解压并安装 ===
Write-Host "`n=== [3/5] 解压并安装 ===" -ForegroundColor Yellow

Expand-Archive -Path $RtkZip -DestinationPath $RtkDir -Force
$ExtractedRtkExe = Get-ChildItem -Path $RtkDir -Filter "rtk.exe" -Recurse | Select-Object -First 1
if (-not $ExtractedRtkExe) {
    Write-Error "解压后未找到 rtk.exe"
    exit 1
}
Copy-Item -Path $ExtractedRtkExe.FullName -Destination (Join-Path $RtkBinDir "rtk.exe") -Force
Remove-Item $RtkZip -Force

Write-Host "rtk.exe 已安装到: $RtkBinDir"

# === [4/5] 添加到 PATH ===
Write-Host "`n=== [4/5] 配置 PATH ===" -ForegroundColor Yellow

$UserPath = [Environment]::GetEnvironmentVariable("Path", "User")
if ($UserPath -notlike "*$RtkBinDir*") {
    $NewPath = if ($UserPath) { "$UserPath;$RtkBinDir" } else { $RtkBinDir }
    [Environment]::SetEnvironmentVariable("Path", $NewPath, "User")
    $env:Path = "$env:Path;$RtkBinDir"
    Write-Host "已将 $RtkBinDir 添加到用户 PATH"
} else {
    Write-Host "$RtkBinDir 已在 PATH 中"
}

# 刷新当前会话
$env:Path = [Environment]::GetEnvironmentVariable("Path", "User") + ";" + [Environment]::GetEnvironmentVariable("Path", "Machine")

# === [5/5] 配置 AI 工具 ===
Write-Host "`n=== [5/5] 配置 AI 工具 Hook ===" -ForegroundColor Yellow

$RtkExe = Join-Path $RtkBinDir "rtk.exe"

# 验证 rtk 可用
try {
    & $RtkExe --version 2>&1 | Out-Null
    Write-Host "rtk 已验证: $( & $RtkExe --version )" -ForegroundColor Green
} catch {
    Write-Error "rtk 执行失败，请检查安装"
    exit 1
}

# Claude Code: 添加 PreToolUse Hook
$ClaudeSettings = Join-Path $env:USERPROFILE ".claude\settings.json"
if (Test-Path $ClaudeSettings) {
    Write-Host "`n检测到 Claude Code 配置，正在添加 RTK Hook..." -ForegroundColor Cyan
    
    $Settings = Get-Content $ClaudeSettings -Raw | ConvertFrom-Json
    
    # 检查是否已有 hooks
    if (-not $Settings.PSObject.Properties.Name.Contains("hooks")) {
        $Settings | Add-Member -MemberType NoteProperty -Name "hooks" -Value ([pscustomobject]@{}) -Force
    }
    if (-not $Settings.hooks.PSObject.Properties.Name.Contains("PreToolUse")) {
        $Settings.hooks | Add-Member -MemberType NoteProperty -Name "PreToolUse" -Value @() -Force
    }
    
    # 检查是否已有 rtk hook
    $HasRtkHook = $false
    foreach ($hook in $Settings.hooks.PreToolUse) {
        if ($hook.matcher -eq "Bash") {
            foreach ($h in $hook.hooks) {
                if ($h.command -match "rtk hook claude") {
                    $HasRtkHook = $true
                    break
                }
            }
        }
    }
    
    if (-not $HasRtkHook) {
        $RtkHook = @{
            matcher = "Bash"
            hooks = @(
                @{
                    type = "command"
                    command = "rtk hook claude"
                }
            )
        }
        $Settings.hooks.PreToolUse += $RtkHook
        $Settings | ConvertTo-Json -Depth 10 | Set-Content $ClaudeSettings -Encoding UTF8
        Write-Host "  Claude Code RTK Hook 已添加" -ForegroundColor Green
    } else {
        Write-Host "  Claude Code RTK Hook 已存在，跳过" -ForegroundColor DarkYellow
    }
} else {
    Write-Host "`n未检测到 Claude Code 配置文件，跳过。（如果已安装，请手动配置）" -ForegroundColor DarkYellow
}

# Codex CLI: 添加 RTK.md 引用
$CodexAgents = Join-Path $env:USERPROFILE ".codex\AGENTS.md"
if (Test-Path (Split-Path $CodexAgents -Parent)) {
    Write-Host "`n检测到 Codex CLI，正在添加 RTK 配置..." -ForegroundColor Cyan
    
    $RtkMdPath = Join-Path $env:USERPROFILE ".codex\RTK.md"
    
    # 创建 RTK.md
    $RtkMdContent = @"
# RTK - Rust Token Killer (Codex CLI)

**Usage**: Token-optimized CLI proxy for shell commands.

## Rule

Always prefix shell commands with `rtk`.

Examples:
rtk git status
rtk cargo test
rtk npm  run build
rtk pytest  -q

## Meta Commands
rtk gain # Token savings analytics
rtk gain --history # Recent command savings history
rtk proxy # Run raw command without filtering
"@
    Set-Content -Path $RtkMdPath -Value $RtkMdContent -Encoding UTF8
    
    # 确保 AGENTS.md 引用 RTK.md
    $AgentsContent = "@C:\Users\$env:USERNAME\.codex\RTK.md"
    if (Test-Path $CodexAgents) {
        $Existing = Get-Content $CodexAgents -Raw
        if ($Existing -notmatch "RTK.md") {
            $AgentsContent = "$Existing`n$AgentsContent"
        } else {
            $AgentsContent = $Existing
            Write-Host "  Codex CLI AGENTS.md 已包含 RTK 引用" -ForegroundColor DarkYellow
            $AgentsContent = $null
        }
    }
    if ($AgentsContent) {
        Set-Content -Path $CodexAgents -Value $AgentsContent -Encoding UTF8
        Write-Host "  Codex CLI RTK 配置已添加" -ForegroundColor Green
    }
} else {
    Write-Host "`n未检测到 Codex CLI 目录，跳过。" -ForegroundColor DarkYellow
}

# === 完成 ===
Write-Host "`n========================================" -ForegroundColor Green
Write-Host " RTK 安装完成!" -ForegroundColor Green
Write-Host "========================================" -ForegroundColor Green
Write-Host ""

# 验证
Write-Host "验证安装:" -ForegroundColor Cyan
& $RtkExe --version
Write-Host ""
Write-Host "查看 token 节省数据:" -ForegroundColor Cyan
Write-Host "  rtk gain"
Write-Host ""
Write-Host "查看历史记录:" -ForegroundColor Cyan
Write-Host "  rtk gain --history"
Write-Host ""
Write-Host "重启 Claude Code / Codex CLI 后生效。" -ForegroundColor Yellow

二、安装脚本（powershell）：

cd 刚才创建脚本的目录
powershell -ExecutionPolicy Bypass -File .\install-rtk.ps1

安装完之后，测试rtk是无效的，可以这样：

重新加载系统 PATH 和用户 PATH

$env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")

再执行rtk就可以了

三、验证效果

重启 AI 工具后跑几个命令，然后查看节省数据：

rtk gain

输出示例：

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

Total commands:    70
Input tokens:      31.7K
Output tokens:     30.7K
Tokens saved:      1.0K (3.3%)

By Command
───────────────────────────────────────────────────────
  git status             每次节省 ~90%
  ls -la                 每次节省 ~90%
  pytest                 每次节省 ~80%
  npm run build          每次节省 ~80%

如果想看详细的命令历史：

rtk gain --history
powershell1

四、常用命令速查

五、支持的命令（部分）

RTK 内置了 100+ 个命令的过滤器：

版本控制: git, gh, glab, gt
包管理: npm, npx, pnpm, cargo, pip
构建工具: tsc, next, lint, prettier, ruff
测试框架: pytest, jest, vitest, playwright, rspec
数据库: psql, prisma
容器: docker, kubectl
云: aws
日志: log（通用日志去重）

完整列表见 RTK GitHub。

六、常见问题

Q: RTK 会影响命令执行结果吗？

不会。RTK 只在输出层面过滤，不修改命令行为也不修改源文件。如果 RTK 判断失败（比如命令 exit code 非 0），会自动退回完整输出。

Q: 怎么禁用某个命令的过滤？

rtk proxy git log --all    # 以原始模式运行，不做过滤

Q: Codex CLI 上似乎没用？

Codex CLI 没有 Hook 机制，RTK 靠 AGENTS .md 中的规则让 AI 主动加 rtk 前缀。如果 AI 没遵守，可以用 codexu wrapper（见下一篇博客）。

Q: 和 GitHub Copilot 能一起用吗？

已支持。用 rtk init --copilot -g 配置。

七、总结

RTK 是那种"装上就忘了"的工具——你不需要学任何东西，它静默地帮你省 Token。

• 单二进制，零依赖，3MB
• 支持 100+ 个常用开发命令
• Claude Code / Codex / Copilot / Cursor 全兼容
• 开源 MIT 协议

GitHub: https://github.com/rtk-ai/rtk

‍