禾呈

1、ccstatusline 介绍

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

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

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

核心功能特性如下：

50+种可定制组件一模型、Git (含PR/冲突/暂存/0rigin/Upstream/工作树等细分组件)、Token、上下文、会话、费用、速度等
交互式TUI配置一按ccstatusline-zh setup 启动可视化配置界面
Powerline风格一内置多款Powerline主题，支持自定义分隔符，支持主题色跨行延续
极简模式一一键让所有组件切换到"无标签"模式，状态栏更精简
模糊搜索组件一添加组件时支持子串/首字母/模糊匹配，带实时高亮
Claude账户邮箱一状态栏显示当前登录的Claude账户邮箱
多行布局一支持多行状态栏配置
实时预览一配置时即时预览效果
自定义颜色一每个组件支持独立的前景色和背景色设置
自定义命令&文本&符号一可嵌入自定义Shell命令输出、静态文本或单字符符号/Emoji可点击链接一支持OSC8终端超链接(Git分支、Git PR、仓库根目录等可配置)跨平台一支持macOS、Linux、Windows

二、安装前的准备：换国内 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 状态栏更好看