Redline icon

Redline

Redline 是一款面向 Claude Code 的预算管理工具,可按时间、token、成本或计划百分比限制会话进度,并借助原生 hooks 和 statusline 让任务平稳完成,不会突然中断。

Redline

概述

Redline 是一款面向 Claude Code 的预算管理工具,可在活动会话中设置时间、token 用量、成本或计划百分比限制。它使用 Claude Code 自身的 hooks 和 statusline,使会话能够朝着限制平稳推进,而不是在上限处突然结束。

该项目旨在让预算结束时的工作仍然可用:它会尽量产出完整结果,使用预留区在达到硬性上限前阻止新的工具调用,并将子代理活动计入同一会话预算。仓库说明 Redline 目前适用于 Claude Code,而 Codex 和其他代理仍列在路线图中。

核心功能

会话内预算设置

在 Claude Code 内部使用 /redline 10m $5、/redline 1h 200k 或 /redline 45m 10% 等命令设置会话预算。

实时 statusline 反馈

在 statusline 中显示实时消耗情况,让你在会话运行时看到剩余时间、成本或计划余量。

基于预留区的节奏控制和执行

通过预留区间将代理引导至预算上限,而不是等到硬性停止,在达到上限前阻止新的工具调用。

覆盖整个会话的预算

将整个 Claude Code 会话视为一个预算,包括生成的子代理,这样用户无需为每个子任务单独设置限额。

本地控制命令

提供本地命令,用于查看当前预算、检查 landed-rate、查看版本信息或移除集成。

多种安装与移除路径

支持通过 Homebrew、curl 脚本或 git clone 流程安装,之后可使用 redline uninstall 卸载。

常见用例

  • 为活动编码会话设置预算

    当你希望模型将工作节奏控制在固定的时间、支出或 token 数量内时,为 Claude Code 会话设置限制。

  • 为可用的收尾保留空间

    预留足够的预算用于收尾和最终回复,避免较长任务突然中断。

  • 用一个预算覆盖多个子代理

    管理会生成子代理的会话,而无需为每个子任务单独分配预算。

  • 本地检查预算表现

    使用本地 pulse 命令监控多个活动会话,并检查它们是否在预算内完成。

  • 添加并移除集成

    将该工具安装到 Claude Code 环境中,如果之后不再需要 statusline 和 hooks 集成,可将其移除。

Pros and Cons

Pros

  • 支持多种预算类型,包括时间、美元成本、token 数量和计划百分比。
  • 使用 Claude Code 的原生 hooks 和 statusline,而不是单独的包装器或守护进程。
  • 提供实时消耗视图,让用户在会话期间看到预算余量。
  • 对整个会话应用同一个预算,包括分流出的子代理。
  • 提供多种安装路径,之后也可以卸载。

Cons

  • 墙钟时间的限制执行是尽力而为,而非精确;架构说明指出,在工具尝试或轮次边界之间,时间可能继续流逝。
  • README 说明 Redline 目前适用于 Claude Code,而 Codex 和其他代理仍在路线图中。
  • 该项目依赖随 Claude Code 一同提供的 Node 运行时,因此安装与该环境绑定。

FAQ

Redline 支持什么?

Redline 是为 Claude Code 打造的,它使用其原生 hooks 和 statusline,而不是单独的进程包装器或守护进程。

如何安装它?

README 提供了通过 Homebrew、基于 curl 的安装脚本安装,或者克隆仓库后运行 install.sh 的方式。

如何设置或清除预算?

你可以使用 /redline 10m $5、/redline 1h 200k、/redline 45m 10% 这样的命令来设置预算,或使用 /redline off 清除预算。

所有预算维度的执行方式都一样吗?

架构文档说明,token、成本和计划百分比限制会被精确测量,而墙钟时间则是尽力而为,因为它是在工具尝试或轮次边界处执行的。

Quick Facts

类别
开发者工具
主要用途
用于 Claude Code 的 token 和时间预算管理
平台
Claude Code
运行时
随 Claude Code 一同提供的 Node 运行时
源域名
github.com
许可证
MIT