claude-dash

claude-dash

Claude Code 的模型感知状态栏插件——实时追踪模型调用次数、token 用量与配额进度。

---

功能特性

• 逐轮模型追踪 — 上轮 / 本轮 / 对话累计的 Opus·Sonnet·Haiku 调用次数与 token
• Sonnet 专项配额 — 独立显示 Sonnet-only 周用量进度条（Max 5× 订阅适用）
• 项目名显示 — 第一行末尾以蓝色方括号显示当前工作目录名
• Sub-agent 归因 — 自动将 sub-agent 的 token 消耗归入对应主轮次
• 配额进度条 — 5h / 7d 用量 + 刷新时间（绝对/相对/双显）
• 上下文指示器 — 五级圆弧 ○ ◔ ◑ ◕ ●，颜色随用量渐变
• 10 款内置方案 — default / compact / minimal / dashboard / neon / zen / powerline / retro / pro / stealth
• 完全可配置 — 每个显示元素独立开关，支持自定义布局、进度条风格、配色方案
• 零 token 消耗 — 纯本地渲染，不调用 AI API

---

快速上手（3 步）

第 1 步：安装插件

推荐：Claude Code 插件管理器

/plugin install https://github.com/ya3924143/claude-dash

或手动克隆：

git clone https://github.com/ya3924143/claude-dash.git ~/.claude/plugins/claude-dash

---

第 2 步：配置 statusLine

编辑 ~/.claude/settings.json，在顶层添加 statusLine 字段：

使用 bun（推荐，原生 TypeScript，无需编译）：

{
  "statusLine": {
    "type": "command",
    "command": "bun ~/.claude/plugins/claude-dash/src/index.ts"
  }
}

使用 node（需要 dist/ 目录）：

{
  "statusLine": {
    "type": "command",
    "command": "node ~/.claude/plugins/claude-dash/dist/index.js"
  }
}

如果通过插件管理器安装，路径为 ~/.claude/plugins/cache/claude-dash/claude-dash/<version>/， 运行 /claude-dash:setup 可自动检测并写入正确路径。

---

第 3 步：选择方案

交互式向导（推荐）：

/claude-dash:setup

或直接写入配置文件：

echo '{"preset":"default"}' > ~/.claude/plugins/claude-dash/config.json

重启 Claude Code 后状态栏即可显示。

---

方案预览

以下为纯文本模拟效果；实际运行时各部分带有 ANSI 颜色。 运行 bun src/preview.ts 可在终端中查看带颜色的真实效果。

极简类

minimal — 一行极简，只看本轮，无 Plan 名

[Sonnet]  ◑ 45%  5h ●●●●░░ 42%  │  7d ●●░░░░ 19%
本轮 S:×2  10.2k

stealth — 隐身模式，仅配额 + 上下文

[Sonnet]  ◑ 45%  5h ████░░░░ 42%  │  7d ██░░░░░░ 19%

zen — 禅意色点，无进度条数字，只看本轮

[Sonnet | Max]  ◑ 45%  对话 S:×5 O:×2  42.1k  [my-project]
5h ● 42%  │  7d ● 19%
本轮 S:×2  10.2k

---

标准类

default — 经典三行，全部信息

[Sonnet | Max]  ◑ 45%  对话 S:×5 O:×2  42.1k  [my-project]
5h ████░░░░░░ 42% (刷新时间: 14:30)  │  7d ██░░░░░░░░ 19% (刷新时间: 明天 09:00)
上轮 O:×1 S:×3  25.6k  │  本轮 S:×2  10.2k  │  Sonnet Only ████░░ 27%

compact — 双行紧凑，同等信息量

[Sonnet | Max]  ◑ 45%  对话 S:×5 O:×2  42.1k  [my-project]  5h ████░░░░░░ 42%  │  7d ██░░░░░░░░ 19%
上轮 O:×1 S:×3  25.6k  │  本轮 S:×2  10.2k  │  Sonnet Only ████░░ 27%

powerline — Powerline 风格，只看本轮

[Sonnet | Max]  ◑ 45%  对话 S:×5 O:×2  42.1k  [my-project]  5h ▓▓▓▓░░░░░░ 42%  │  7d ▓▓░░░░░░░░ 19%
本轮 S:×2  10.2k  │  Sonnet Only ████░░ 27%

---

全功能类

dashboard — 仪表盘，每项独占行，标签对齐

  model  Sonnet | Max  tokens 42.1k
    ctx  ████░░░░░░ 45%
     5h  ████░░░░░░ 42%  (刷新时间: 14:30)
     7d  ██░░░░░░░░ 19%  (刷新时间: 明天 09:00)
上轮 O:×1 S:×3  25.6k  │  本轮 S:×2  10.2k  │  Sonnet Only ████░░ 27%

neon — 霓虹渐变进度条，全部信息

[Sonnet | Max]  ◑ 45%  对话 S:×5 O:×2  42.1k  [my-project]
5h ▏▎▍▌▋▊▉█░░░░ 42% (刷新时间: 14:30)  │  7d ▏▎▍▌░░░░░░░░ 19%
上轮 O:×1 S:×3  25.6k  │  本轮 S:×2  10.2k  │  Sonnet Only ▏▎▍▌▋▊ 27%

pro — 双时间显示（绝对 + 相对），全部信息

[Sonnet | Max]  ◑ 45%  对话 S:×5 O:×2  42.1k  [my-project]
5h ████░░░░░░ 42% (刷新时间: 14:30 / 3h 42m)  │  7d ██░░░░░░░░ 19% (刷新时间: 明天 09:00 / 4d 11h)
上轮 O:×1 S:×3  25.6k  │  本轮 S:×2  10.2k  │  Sonnet Only ████░░ 27%

retro — 复古 ASCII 进度条，单色绿

[Sonnet]  ◑ 45%  对话 S:×5 O:×2  42.1k  [my-project]
5h [====------] 42% (刷新时间: 14:30)  │  7d [==--------] 19%
上轮 O:×1 S:×3  25.6k  │  本轮 S:×2  10.2k  │  Sonnet Only [===---] 27%

---

配置示例：从简到繁

最简配置（只看 quota）

{
  "preset": "stealth"
}

推荐日常配置

{
  "preset": "default"
}

省空间配置（终端较窄时）

{
  "preset": "compact",
  "barWidth": 8,
  "showLastTurn": false
}

深色终端 · 霓虹风格

{
  "preset": "neon",
  "colorScheme": "vibrant",
  "barWidth": 14,
  "timeFormat": "both"
}

极简禅意（无进度条，只看颜色变化）

{
  "preset": "zen",
  "showLastTurn": false,
  "showResetTime": false
}

Max 5× 用户（关注 Sonnet 专项配额）

{
  "preset": "default",
  "showSessionStats": true,
  "timeFormat": "both",
  "barWidth": 12
}

Sonnet Only 进度条会在第三行自动显示，追踪 seven_day_sonnet 独立周配额。

单色绿 · 复古终端

{
  "preset": "retro",
  "colorScheme": "mono-green",
  "barStyle": "ascii",
  "barWidth": 12
}

全功能仪表盘

{
  "preset": "dashboard",
  "layout": "dashboard",
  "barStyle": "gradient",
  "colorScheme": "vibrant",
  "timeFormat": "both",
  "showLastTurn": true,
  "showCurrentTurn": true,
  "showSessionStats": true,
  "showPlanName": true,
  "showResetTime": true,
  "barWidth": 14
}

自定义混搭（powerline 布局 + 渐变条 + muted 配色）

{
  "preset": "powerline",
  "barStyle": "gradient",
  "colorScheme": "muted",
  "timeFormat": "relative",
  "barWidth": 10,
  "showLastTurn": true
}

---