用 Claude Code 久了，有一个痛点一直让人不太舒服——很难直观地看到它的运行状态。当前在用哪个模型？上下文占用了多少？这个会话花了多少钱？现在在哪个 Git 分支上？不查命令就是两眼一抹黑，想知道这些信息得一条一条手动去敲。
尤其现在不少 Coding Plan 的用量消耗快，工作时间段还有倍率计算。如果你用的是朋友共享的套餐，大量使用时总得时不时查一下用量，生怕某个时间段超了影响别人正常使用。
GitHub 上有个开源工具叫 ccstatusline，正好解决了这个问题。
01 它是什么？
ccstatusline 是给 Claude Code CLI 做的终端状态栏工具。它把模型名称、Git 分支、Token 用量、上下文占用、费用估算、实时速度这些数据，全部实时显示在终端底部。
GitHub 上已经 9k+ Star，版本迭代到了 v2.2.19，更新频率挺高。
它带一个交互式 TUI 配置界面，70 个组件随你挑、随你排位置，还支持 Powerline 主题，终端颜值直接拉满。仓库 README 里有一个完整的演示动图，配置时不知道从哪下手可以参考那个。
02 核心功能
Token 和费用监控
这项功能对我来说最实用。输入 Token 数、输出 Token 数、总量、当前会话费用（美元），直接挂在状态栏上。如果你是按量付费的模式，这个功能真的能帮你控住成本。
还有个 Token 速度组件（tok/s），支持配置 0 到 120 秒的滑动窗口。设成 0 就是整个会话的平均速度，设成 30 秒就是最近半分钟的实时速度。
上下文可视化
上下文快满时，Claude 会自动执行 compaction（压缩），但不看数据你根本不知道什么时候会触发。它提供了好几个上下文相关组件——长度、百分比、进度条，还有一个 Compaction Counter 显示压缩次数，帮你判断是不是该开新对话了。
Git 信息拉满
不只是分支名。还能加暂存文件数、未暂存文件数、冲突数量、ahead/behind、SHA 哈希、PR 信息（支持 GitHub 和 GitLab）、新增行数、删除行数。
有个小细节我特别喜欢：Git 分支组件可以配成可点击的链接，在终端里直接跳转到浏览器。
Powerline 主题
内置多套主题，箭头分隔符加上渐变配色，终端看起来跟 IDE 似的。支持 16 色、256 色、真彩色三种模式，喜欢折腾美化的话可玩性很高。
交互式 TUI 配置
不用手写 JSON。跑一条命令就弹出一个终端 UI，添加组件、删除组件、排序、设置颜色、切换主题、实时预览，全程可视化操作。还有模糊搜索功能，70 个组件也不怕找不到。
03 安装很简单
方式一：让 Claude Code 帮你装
直接把 GitHub 地址丢给 Claude Code 终端，让它帮忙安装，等一会儿就能装好。不过这种方式有个注意点：装完之后最好还是自己执行 ccstatusline-zh setup 命令去配置，不要让 Claude Code 来帮你配，容易出问题。
方式二：手动安装
全局安装中文版（推荐）：
npm install -g ccstatusline-zh
不想全局安装的话，直接 npx -y ccstatusline@latest 也行，但网络不好的时候每次走 npx 会有延迟。
装完之后编辑 ~/.claude/settings.json（Windows 是 %USERPROFILE%\.claude\settings.json），加上这段配置：
{
"statusLine": {
"type": "command",
"command": "ccstatusline-zh",
"padding": 0,
"refreshInterval": 10
}
}
重启 Claude Code，底部状态栏就出来了。refreshInterval 可以设 1 到 60 秒，Claude Code 2.1.97 以下版本不支持的话就先不写这个字段。
04 自定义配置
运行 ccstatusline-zh setup 打开 TUI 配置界面，想加什么组件就加什么，想放哪个位置就放哪个位置。支持的配置项比较多，可以根据自己的习惯和关注点动态调整。
如果你是个 Claude Code 重度用户，这个既有颜值又有功能的状态栏，非常值得装一个。对这类终端效率工具感兴趣的，也可以去 云栈社区 转一转，那里有不少相关讨论。
项目地址：
发表于 17 小时前
|
查看: 5|
回复: 0
/1 
