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,而不是獨立的包裝器或 daemon。
  • 提供即時的消耗下探視圖,讓使用者在工作階段中看到預算餘裕。
  • 將整個工作階段套用同一個預算,包括分派出去的子代理。
  • 提供多種安裝方式,之後也可以解除安裝。

Cons

  • 對牆上時鐘時間的強制執行屬於盡力而為,並不精確;架構說明指出,在工具嘗試或回合邊界之間時間仍可能流逝。
  • README 表示 Redline 目前可與 Claude Code 搭配使用,而 Codex 與其他代理仍在路線圖上。
  • 此專案依賴 Claude Code 隨附的 Node runtime,因此設定與該環境綁定。

FAQ

Redline 可搭配什麼使用?

Redline 是為 Claude Code 打造,使用其原生 hooks 與 statusline,而不是獨立的程序包裝器或 daemon。

要如何安裝?

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 runtime
來源網域
github.com
授權
MIT