SuperAPI AI 工具集

statusline

编程与开发

查看项目

更新于 10-16 06:37

技能介绍

用途

statusline 用于为 Claude Code 安装一条状态栏,实时展示当前使用的模型、上下文窗口用量、当前工作目录以及 git 分支。适合希望在编码过程中随时掌握模型与上下文消耗情况的用户。

主要能力

  • 显示当前模型名称,例如 Opus 5.5。
  • 显示上下文窗口用量,格式为已用 token / 总容量及百分比,例如 42k/200k (21%)。
  • 以进度条形式呈现用量,进度条按已用 token 填充,与上下文窗口大小无关。
  • 文本颜色随用量增长从绿色经琥珀色渐变到红色。
  • 显示当前目录名与 git 分支,例如 data-fabric-dwh (dwh)。
  • 阈值以脚本顶部的命名变量定义,README 中有相关说明。

使用方式

该技能按以下工作流安装:

  1. 检查前置条件:运行 command -v jq。若缺少 jq,需先安装并停止后续步骤。macOS 上使用 brew install jq,Linux 上使用发行版对应的包管理器。同时解析本技能 scripts/statusline.sh 的绝对路径。
  2. 复制脚本:将脚本复制到 ~/.claude/statusline.sh 并赋予可执行权限(chmod +x)。建议复制而非直接指向技能目录,因为插件和 npx skills 的更新可能移动该目录。若 ~/.claude/statusline.sh 已存在且内容不同,会先显示差异并询问是否覆盖。
  3. 在设置中注册:默认使用 ~/.claude/settings.json,使其对所有项目生效;仅当用户要求项目级状态栏时,才使用项目的 .claude/settings.json。若文件不存在,则创建并仅包含 statusLine 键;否则先读取文件。若已存在 statusLine 键且未指向 ~/.claude/statusline.sh,会先显示并询问是否替换。设置内容为:
"statusLine": { "type": "command", "command": "~/.claude/statusline.sh" }

只修改该键,保留其他所有设置。运行 jq empty <file> 确认文件仍是合法 JSON。

  1. 验证:在 git 仓库内通过管道向已安装脚本传入示例输入:
echo '{"model":{"display_name":"Opus 5.5"},"context_window":{"total_input_tokens":42000,"context_window_size":200000,"used_percentage":21.4},"workspace":{"current_dir":"'"$PWD"'"}}' | ~/.claude/statusline.sh

当输出显示模型、▰▰▱▱▱▱▱▱▱▱ 42k/200k (21%)、目录名和分支时即完成。

适用场景

  • 在 Claude Code 中工作时希望直观看到模型与上下文用量。
  • 需要快速确认当前目录与 git 分支。
  • 希望状态栏对所有项目统一生效,或按项目单独配置。

限制

  • 需要预先安装 jq。
  • 渐变颜色需要支持 24 位色彩的终端,例如 iTerm2、Ghostty、Warp 或 VS Code 终端;旧版 macOS Terminal.app 不显示渐变。
  • 状态栏从下一条消息开始出现;若未出现,需重启 Claude Code。
  • 会话第一条消息之前,由于 Claude Code 尚无用量可报告,状态栏显示 0/0 (0%)。
  • 关于收费、价格、平台支持范围等信息,资料中暂未提供。