sirmalloc/ccstatusline

🚀 Beautiful highly customizable statusline for Claude Code CLI with powerline support, themes, and more.

什么是 ccstatusline？

ccstatusline 是一个 Node.js 包，为 Claude Code 命令行界面（Anthropic 的 Claude 模型官方 CLI）添加了一个高度可定制的状态行。它从 Claude Code 读取数据，如当前模型、令牌使用情况、Git 信息、沙箱状态等，并将其渲染为终端底部的一条色彩丰富、可配置的行。

为什么你需要它

实时 AI 会话指标 – 无需离开终端即可查看已使用的令牌数、剩余上下文、每周使用量。
Git 集成 – 显示分支名称、PR/MR 链接、文件状态计数、CI 状态，与 AI 信息并列显示。
高度可调 – 可选择显示哪些小部件、它们的顺序、颜色、渐变、Powerline 分隔符，甚至最小化模式的原始值。
跨平台 – 支持 macOS、Linux 和 Windows（特殊处理以隐藏辅助窗口）。
可导出配置 – 设置可保存或从 JSON 加载，便于在多台机器间共享布局。

核心功能（如 README 所述）

类别	小部件 / 功能
模型与使用情况	模型名称、输入/输出令牌、总令牌数、使用百分比、周使用量、额外使用（按需付费）小部件、上下文窗口大小、压缩计数器、缓存命中/读取/写入率。
Git 与 CI	分支名称、根目录、PR/MR 链接（GitHub 与 GitLab）、状态（领先/落后、冲突、已暂存/未暂存/未跟踪文件）、CI 检查摘要、可点击链接、宽度限制显示并带省略号。
环境	当前工作目录（可选图标）、沙箱状态、语音输入状态、Claude 账户邮箱、会话名称、内存使用量、终端宽度覆盖。
视觉	Powerline 和灵活分隔符、每个小部件或整行的颜色渐变、自定义图标、暗色样式、极简原始值模式、渐变预设、自定义 Unicode 分隔符。
控制	用于添加、重新排序、克隆或删除小部件的 TUI 编辑器；模糊小部件选择器；颜色选择器；配置导入/导出；版本标志（`ccstatusline --version`）。
性能	使用磁盘缓存进行非阻塞 Git/CI 刷新、后台刷新过期数据、缓存的块计时器指标、可配置的缓存 TTL、对无效 `settings.json` 的安全处理。
平台优化	Windows UTF-8 处理、隐藏辅助进程、使用量 API 的环境变量代理支持、对固定全局安装的安全处理。

如何快速上手

安装 – npm i -g ccstatusline（或使用 Bun）。该包随附支持平台的预构建二进制文件。
运行 – 安装后，启动 Claude Code CLI 时状态行会自动出现。你也可以直接调用 ccstatusline 来预览配置。
配置 – 在 TUI 中按 e 打开编辑器，添加或删除小部件、更改颜色，或切换到 Powerline 模式。设置保存在 ~/.config/ccstatusline/settings.json（或通过 --config 指定自定义路径）。
导出 / 导入 – 使用 Config import/export 小部件（v2.2.27）将当前布局导出为 JSON，编辑后重新导入。

由谁维护？

该仓库由 sirmalloc 拥有，显示活跃维护（频繁发布、提交活动图、以及“Maintained? yes”徽章）。它也被列入 Awesome Claude Code 收集，并被 ClaudeLog 知识库引用。

许可证

MIT – 您可以自由使用、修改和重新分发代码。

TL;DR

ccstatusline 是一个终端 UI 插件，将 Claude Code CLI 转化为仪表板，显示模型使用情况、Git 上下文、CI 状态和许多其他指标，所有内容均可通过基于 JSON 的 TUI 高度配置。它是开发者在终端中使用 Claude 时真正、活跃维护的开源工具。