ccstatusline Skill 技能

技能简介

ccstatusline 是一款专为 Claude Code CLI 打造的开源状态栏格式化工具（MIT 协议，GitHub 星标 1.3 万+），通过 npm 包 ccstatusline 分发。它把 Claude Code 底部的状态栏变成一块可编程的信息面板，实时显示当前模型、Git 分支、Token 用量、每周额度、会话时长等关键指标，并支持 Powerline 风格渲染、多行布局与完全自定义的组件配色，是 Awesome Claude Code 收录的知名周边工具。

核心能力

• 实时指标展示：模型名称、Git 分支、Token 用量、Sonnet/Opus/Fable 每周额度、额外用量上限、语音输入状态、会话时长、上下文压缩次数、区块计时器等一应俱全

• 组件化自由定制：内置按分类搜索的组件选择器，可增删、排序，每个组件独立配色，并支持统一设置内边距、分隔符、加粗与极简模式

• Powerline 美化渲染：箭头分隔、端帽与自定义字体，支持多行独立状态栏与弹性布局

• 交互式 TUI：基于 React/Ink 的终端配置界面，边配置边实时预览状态栏效果

• 可移植配置：配置可导出为 JSON，导入前可预览"替换/合并"两种模式，便于备份与团队共享

• 跨平台零配置：同时兼容 Bun 与 Node.js，开箱即用的默认配置；支持通过 CLAUDE_CONFIG_DIR 指向非标准 Claude 配置目录

• 丰富的状态组件：覆盖 Git CI 状态、沙箱状态、提示词缓存计时器、Claude 服务健康状况、每周模型额度等

安装配置

• 免安装直接运行：执行 npx -y ccstatusline@latest 或 bunx -y ccstatusline@latest 启动配置 TUI

• 固定版本安装：首次设置时选择 Pinned global install，TUI 会用 npm/Bun 全局安装对应版本，并把命令写入 Claude Code 设置

• 配置文件位置：设置自动保存在 ~/.config/ccstatusline/settings.json，可手动备份或进版本库

• 代理与本地化：支持 HTTPS_PROXY/NO_PROXY 环境变量控制用量请求；社区维护有中文版分支 ccstatusline-zh

使用步骤

1. 运行 npx -y ccstatusline@latest 进入交互式配置 TUI

2. 在组件选择器中按分类搜索并添加需要的指标组件，调整顺序、配色与显示条件

3. 实时预览确认后，选择安装到 Claude Code 设置（或固定全局安装）

4. 打开 Claude Code 即可看到新状态栏；后续随时重跑 TUI 调整，或导入他人分享的 JSON 配置

适用场景

• 长时间 Claude Code 会话中监控每周额度与 Token 消耗，避免超额中断

• 多仓库开发时在状态栏一眼确认当前 Git 分支、CI 状态与脏文件情况

• 用 Powerline 多行状态栏打造个性化终端工作台

• 团队统一状态栏样式，通过导出 JSON 在成员间共享配置

适用人群

重度 Claude Code 用户、终端美化爱好者、需要量化 AI 编程消耗与额度的独立开发者，以及希望统一团队终端信息面板的技术负责人。

工作原理

ccstatusline 以独立进程方式被 Claude Code 的 statusLine 钩子调用：Claude Code 每次刷新状态栏时把会话上下文传入命令，工具读取 settings.json 中的组件配置，按需执行 Git 查询、额度查询等短时子命令（统一 5 秒超时并带缓存，避免阻塞渲染），再用 Unicode 宽度计算把各组件按布局规则渲染成一行或多行文本回传终端。新版本还对导入命令做转义确认、保留设置文件权限、支持 NO_PROXY 排除与五秒总时限，保障安全与稳定。

官方链接

• GitHub：https://github.com/sirmalloc/ccstatusline

• npm：https://www.npmjs.com/package/ccstatusline