用途
setup-statusline 用于在 Claude Code 的 CLI 状态栏中安装或卸载 cc-token-saver 的实时用量监控。它通过管理 ~/.claude/settings.json 中的 statusLine 字段来注册状态栏脚本，让用户在 Claude Code 状态栏中实时看到输入/输出/缓存 token 计数及相关用量信息。
主要能力
安装后状态栏可显示以下字段：
[RUN]：当前用户轮次成本 / 自claude启动以来的累计成本。轮次成本会跨后续工具调用累加，因此 $1.43 之类的警告会一直可见，直到开始新的提示。当 60 秒内没有 API 调用时判定为新轮次（可通过CC_TOKEN_SAVER_TURN_IDLE_SEC调整）。退出并重启 claude 时重置。[5H]：Anthropic 5 小时速率限制用量（仅订阅用户）。⏳ 显示窗口重置剩余时间。[W]：7 天每周速率限制，仅在 ≥60% 时显示。⏳ 显示每周窗口重置剩余时间。[CTX]：上下文窗口占用百分比，越高表示每次调用消耗的 token 越多。
订阅用户格式示例：
[RUN🟢] ＄0.10/＄12.23 | [5H🟢] 9% ⏳1h32m | [W🟡] 65% ⏳1d3h | [CTX🟢] 22%
API key 格式示例：
[RUN🟢] ＄0.10/＄12.23 | [CTX🟢] 22%
颜色阈值：
| 指标 | 🟢 正常 | 🟡 警告 | 🔴 严重 |
|---|---|---|---|
| RUN | < ＄0.30 | ≥ ＄0.30 | ≥ ＄1.00 |
| 5H | < 70% | ≥ 70% | ≥ 90% |
| W | （隐藏） | ≥ 60% | ≥ 90% |
| CTX | < 35% | ≥ 35% | ≥ 70% |
当 5H 达到 🔴 时，会出现 → /report-limit 提示。其他警告会显示 → /usage-view current 以进行详细分析。
使用方式
命令参数：
install（无参数时默认）— 注册状态栏脚本uninstall— 移除并在可用时恢复备份help— 显示帮助文本（仅当参数中字面包含 "help" 时显示）
示例：
/setup-statusline install
/setup-statusline uninstall
安装流程
- 读取
~/.claude/settings.json - 检查当前
statusLine字段：- 情况 A：没有 statusLine — 直接安装。
- 情况 B：已是本脚本 — 检查路径是否匹配当前
${CLAUDE_PLUGIN_ROOT}。若版本不同，静默更新路径，然后输出 "Updated to current version." 并停止；若版本相同，输出 "Already installed." 并停止。通过匹配命令路径是否包含cc-token-saver/scripts/statusline-logger.sh来判断。 - 情况 C：存在不同的 statusLine — 警告并询问用户，提供 Replace（将现有配置备份到
_statusLineBackup）或 Cancel 两个选项，等待用户响应。选 "1" 则备份后安装，选 "2" 则停止。
- 安装：将
statusLine设置为：
{
"type": "command",
"command": "${CLAUDE_PLUGIN_ROOT}/scripts/statusline-logger.sh"
}
验证脚本可执行：
chmod +x "${CLAUDE_PLUGIN_ROOT}/scripts/statusline-logger.sh"
安装输出：
✅ Statusline installed.
It will appear after your next interaction with Claude.
卸载流程
- 读取
~/.claude/settings.json - 检查当前 statusLine：
- 不是本脚本 — 输出 "cc-token-saver statusline is not installed." 并停止。
- 是本脚本 — 移除 statusLine 字段。若存在
_statusLineBackup，将其恢复到 statusLine 并删除_statusLineBackup。
卸载输出：
✅ Statusline removed.
若恢复了备份，附加 "Previous statusline restored from backup."；若无备份，附加 "No previous statusline to restore."。
适用场景
适用于使用 Claude Code 并希望实时监控 token 消耗、成本、速率限制用量和上下文窗口占用的用户，尤其是需要控制成本或关注速率限制的订阅用户与 API key 用户。
限制与注意事项
- 始终使用
node -e进行 JSON 操作（安全解析，不依赖 jq）。 - 除
statusLine和_statusLineBackup外，绝不修改其他字段。 - 脚本路径必须使用
${CLAUDE_PLUGIN_ROOT}以保持可移植性。 - 5H 与 W 字段仅对订阅用户显示。
- 帮助文本仅在参数字面包含 "help" 时显示，否则跳过并进入安装流程。