一、ccstatusline 介绍

ccstatusline 是一款高度可定制的状态栏格式化工具，能在终端中显示 Claude Code 的实时运行指标，目前在 GitHub 上已有 9k+ Star，社区活跃度很高。

支持 50+ 种可定制组件，我常用的包括：

组件类型	具体指标	用途
模型信息	当前使用的模型（Opus/Sonnet/Haiku）	确认 AI "脑子"的档次
Token 用量	输入/输出 Token 数、累计用量	控制成本，避免账单爆炸
响应速度	首 Token 时延、生成速度	判断网络/模型负载状态
Git 信息	当前分支、提交状态、修改文件数	代码上下文一目了然
会话状态	会话 ID、历史轮数	多会话切换时不迷路
系统信息	CPU/内存占用、终端尺寸	排查性能问题

核心功能特性如下：

二、安装前的准备：换国内 npm 源

ccstatusline 通过 npm 安装，但默认官方源在国内访问很慢，甚至超时。建议先换成国内镜像。

1、查看当前 npm 源

npm config get registry

默认官方源：https://registry.npmjs.org/

2、更换为国内最新源，比如更换为淘宝镜像（首选，最新官方地址）

npm config set registry https://registry.npmmirror.com

⚠️ 旧域名 registry.npm.taobao.org 已废弃，不要用

3、其他国内源（备选）

# 阿里云
npm config set registry https://npm.aliyun.com

# 腾讯云
npm config set registry https://mirrors.cloud.tencent.com/npm/

# 华为云
npm config set registry https://mirrors.huaweicloud.com/repository/npm/

4、验证是否生效

npm config get registry

输出对应国内源地址即可。

我试过阿里云和淘宝镜像，稳定性都不错。但淘宝镜像的同步速度更快，新包上线后几乎立刻可用。如果你经常追新，建议用淘宝。

三、安装 ccstatusline

我们可以通过npm命令全局安装ccstatusline；

npm install -g ccstatusline-zh
# 或者
bun install -g ccstatusline-zh

注意：有原版 ccstatusline 和中文版 ccstatusline-zh 两个版本。中文版对中文用户更友好，界面和文档都是中文。我装的是中文版。

配置 Claude Code 启用状态栏

编辑 Claude Code 的配置文件：

macOS/Linux：

~/.claude/settings.json

Windows：

%USERPROFILE%\.claude\settings.json

添加如下配置；

{
  "statusLine": {
    "type": "command",
    "command": "ccstatusline-zh",
    "padding": 0
  }
}

如果使用 npx 或 bunx 运行，可以使用以下命令：

{
  "statusLine": {
    "type": "command",
    "command": "npx -y ccstatusline-zh@latest",
    "padding": 0
  }
}

之后我们打开Claude Code，在输入栏的下方就可以看到ccstatusline显示的信息了。

配置界面（TUI）

默认情况下ccstatusline只会显示第一行信息，我们可以通过它的交互式TUI配置界面来进行配置，通过如下命令来打开TUI配置界面；

ccstatusline-zh setup

这将打开交互式 TUI 配置界面，你可以：

• 添加、删除、重新排列组件
• 设置颜色和样式
• 选择 Powerline 主题
• 实时预览状态栏效果

四、ccstatusline 常用配置

运行 ccstatusline-zh setup 打开交互式配置界面后，可以在配置界面中通过快捷键操作：

按键	功能
↑ ↓	导航
Enter	选择/确认
a	添加组件
d	删除组件
e	编辑组件
w	组件选项
/	搜索
q	退出

配置多行状态栏

选择 主菜单 → 编辑状态行，可以自定义每行显示的内容。

例如，此处我的第二行配置了：

• 思考力度：当前模型的推理深度
• 输出风格：代码风格偏好
• 输入速度：用户输入 Token 的速度
• 输出速度：AI 生成 Token 的速度
• 会话用量：当前会话累计 Token 消耗

自定义分隔符

选择 主菜单 → 全局覆盖 → 默认分隔符，可以调整状态信息之间的分隔样式。

我用的 | 作为分隔符，简洁清晰，当然，你也可以用 ·、›、→ 等符号，看个人喜好。

Powerline 显示模式

选择 主菜单 → Powerline 设置，可以切换到更炫酷的 Powerline 显示模式。

写在最后

ccstatusline 确实是一款非常实用的 Claude Code 工具。

在 AI 编程工具越来越普及的今天，这类「小而美」的辅助工具往往能带来意想不到的体验提升。

ccstatusline 没有复杂的功能，却把「状态栏格式化」这件事做到了极致 —— 可定制、易上手、实用性拉满。无论是追求效率的专业开发者，还是刚接触 Claude Code 的新手，都值得花 10 分钟安装配置一下。

需要注意，本文所提到的ccstatusline有官方原版和中文版两个版本，大家选择自己喜欢的安装即可。

官方原版：

https://github.com/sirmalloc/ccstatusline

中文版：

https://github.com/huangguang1999/ccstatusline-zh