做 AI 编程一段时间之后,很容易进入一种奇怪状态,天天看着终端一直在滚,模型一直在输出,代码一直在生成。但有个问题,不知道它到底在干什么?
比如这些场景:
- 现在到底用的是哪个模型?Sonnet 还是 Opus?
- Claude Code 有没有进入压缩(compaction)?
很多时候只能,打开另一个终端,执行 /usage,切出去看 Git,再回来继续写。
信息也不是拿不到,就是太分散,不知道当前状态。
终端工具这些年一直在进化,编辑器有状态栏,浏览器有开发者工具,监控平台有 Dashboard。
但到了 AI 编程阶段,终端反而退回了黑盒,模型在运行,上下文在增长,费用在累计,但确没有显示出来。
然后,有问题就有人解决,看到一个 ccstatusline 项目,专门给 Claude Code 使用的终端状态栏工具。
ccstatusline 通过读取 Claude Code 的运行信息,在终端底部持续显示状态内容。ccstatusline 基于 Node.js/Bun 开发,通过 npm 发布,提供了一个交互式的 TUI 配置界面,你只需要勾选想显示的内容,调整一下颜色和顺序,就能直接看到效果。开源地址:https://github.com/sirmalloc/ccstatusline
Star 数 10k+,还是很多人在用:
这个是英文版本,配置界面不太友好,然后也有对应的汉化版本:
汉化版地址:https://github.com/huangguang1999/ccstatusline-zh
汉化版本使用的都是中文界面:
ccstatusline 提供了几十种预设的 widget,涵盖几个大类:
模型信息:当前模型名称、thinking effort 级别、上下文窗口使用量
Token 统计:输入/输出 token 数、速度、缓存命中率
用量监控:会话用量、周用量、额外用量、计费块倒计时
Git 状态:分支名、PR/MR 链接、未提交改动数、 ahead/behind
会话信息:会话名称、当前工作目录、会话成本
自定义:纯文本、自定义命令输出、分隔符
渲染模式支持普通的纯文本,也支持 Powerline 风格(带箭头分隔符和渐变颜色),我们可以配置多行状态栏,每行放不同的信息组。
项目技术栈:
1、安装与环境准备
环境要求
最简单安装方式:
npx -y ccstatusline@latest
或者:
bunx -y ccstatusline@latest
直接给 Claude Code 安装上,然后建议选择Pinned global install,这样不会自动跟随最新版升级。
在 TUI 里选择 Pinned global install,它会把你当前运行的版本全局安装好,并把 ccstatusline 命令写入 Claude Code 的配置文件。
安装完成后,会自动写入 Claude Code 的 配置文件中 ~/.claude/settings.json:
中文版通过 npm 全局安装:
npm install -g ccstatusline-zh
或者使用 Bun:
bun install -g ccstatusline-zh
在 Claude Code 设置中添加状态栏配置,编辑 ~/.claude/settings.json:
ccstatusline 配置默认保存在 ~/.config/ccstatusline/settings.json。
2、启动配置界面
启动中文版设置:
打开交互式 TUI 配置界面,我们可以:
我们可以回车进入编辑状态栏:
第一行有 7 个组件,对应信息为:
第一步:添加 widget
按 a 进入添加界面,你会看到分类列表:
用方向键选择分类,回车展开,再选择具体的 widget。
选择总 Token 后就可以看到设置的预览:
第二步:调整顺序
按下 Enter 键可以移动位置:
移动到最后:
然后回车,就可以看到效果:
设置完成后,按 Esc 回退到主界面,然后保存并退出:
配置会自动写入 ~/.config/ccstatusline/settings.json,同时自动安装到 Claude Code 的 settings.json 里,下次启动 Claude Code 时,状态栏就会生效。
其他的配置可以继续使用 ccstatusline-zh setup,进行设置,比如颜色修改等。