CCometixLine 安装使用配置

项目地址：https://github.com/Haleclipse/CCometixLine

一、背景

用 Claude Code 有一阵子了，终端里那段状态栏信息属实有点寒酸——默认就显示个模型名，想看 Git 分支还得另外敲 git branch，想了解上下文用量还得翻到别的地方。于是乎找到了 CCometixLine 这个工具。

简单说，CCometixLine 是一个基于 Rust 写的 CLI 工具，专门给 Claude Code 的终端状态栏加料——在底部那一行里塞入目录路径、Git 分支和状态、模型名称、上下文窗口 Token 用量百分比等信息，看着一目了然。而且还带一个 TUI 交互式配置界面，不用手动改配置文件就能调整显示效果。

项目协议 MIT，GitHub star 不多但功能挺实用，作者 Haleclipse 还在活跃维护。

它能显示什么

| 段落 | 内容 | 示例 |
||||
| 目录 | 当前工作空间路径 | ~/projects/my-app |
| Git | 分支名 + 状态图标 + 远程跟踪 | main ✓ ↑2 |
| 模型 | 简化后的模型名 | Sonnet 4 |
| 用量 | Token 消耗百分比 | 32% |
| 时间/成本 | 可选，默认关闭 | — |

Git 状态图标说明：
– ✓：干净，无未提交变更
– ●：有未提交变更
– ⚠：有冲突
– ↑n：领先远程 n 个提交
– ↓n：落后远程 n 个提交

emmm，有了这玩意之后，切换项目时扫一眼状态栏就知道当前分支干不干净、有没有落后远程，不用再频繁敲 git status 了，省心不少。

二、安装

2.1 npm 全局安装（推荐）

最简单的方式，全平台通用：

npm install -g @cometix/ccline

国内网络慢的话加个镜像源：

npm install -g @cometix/ccline --registry https://registry.npmmirror.com

装完之后全局就有 ccline 命令了，不需要额外配置 PATH。

也可以用 yarn / pnpm 安装：

yarn global add @cometix/ccline
pnpm add -g @cometix/ccline

2.2 手动下载二进制

如果不想装 npm，直接从 GitHub Releases 下载对应平台的压缩包。

Linux / macOS：

# 创建目录
mkdir -p ~/.claude/ccline

# 下载对应平台压缩包（以 linux-x64 为例）
wget https://github.com/Haleclipse/CCometixLine/releases/latest/download/ccometixline-linux-x64.tar.gz

# 解压
tar -xzf ccometixline-linux-x64.tar.gz -C ~/.claude/ccline/

# 赋予执行权限
chmod +x ~/.claude/ccline/ccline

Linux 有两个版本：
– 动态链接版（需 glibc 2.35+）
– 静态链接版（通用兼容，无依赖）

不确定系统 glibc 版本的选静态链接版就行。

Windows：

# 创建目录
mkdir %USERPROFILE%\.claude\ccline

# 下载解压后把 exe 放进去即可

2.3 从源码构建

如果你有 Rust 环境，也可以自己编译：

git clone https://github.com/Haleclipse/CCometixLine.git
cd CCometixLine
cargo build --release
cp target/release/ccometixline ~/.claude/ccline/ccline

三、集成到 Claude Code

装完了只是有了命令，要让它在 Claude Code 的状态栏里显示，需要改一下 Claude Code 的配置文件。

编辑 Claude Code 的 settings.json，添加 statusLine 配置：

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/ccline/ccline",
    "padding": 0
  }
}

注意：
– Claude Code v2.1.47+ 支持 ~ 路径展开，Windows 也能用，不要用 %USERPROFILE%
– 如果是 npm 全局安装，command 也可以直接写 "ccline"

配置文件的路径：

| 系统 | 路径 |
|||
| macOS | ~/.claude/settings.json |
| Linux | ~/.claude/settings.json |
| Windows | %USERPROFILE%\.claude\settings.json |

改完配置后，重新打开 Claude Code 终端就能看到效果了——底部状态栏会出现目录、Git 分支等信息。

四、配置与美化

4.1 TUI 交互式配置（推荐）

这个功能挺香的——直接在终端里用键盘调整每个显示段落的开关、图标、颜色、分隔符，实时预览效果，所见即所得：

ccline --config

进入 TUI 后可以：

• 启用/禁用各个段落（目录、Git、模型、用量、时间、成本等）
• 换分隔符（默认 |，可以改成别的）
• 换图标（比如 Git 状态前面的小图标）
• 调整颜色

改完退出就生效，不用重启 Claude Code。

4.2 主题切换

内置了 5 套预设主题：

临时切换主题：

ccline --theme gruvbox

永久设置则在 TUI 配置（ccline --config）里选好保存就行。

主题文件放在 ~/.claude/ccline/themes/ 目录，格式是 .toml，也可以自己写。

六、更新与卸载

更新（npm 方式）：

npm update -g @cometix/ccline

卸载：

npm uninstall -g @cometix/ccline
# 手动删配置（如果需要）
rm -rf ~/.claude/ccline

别忘了把 Claude Code settings.json 里的 statusLine 配置也去掉，否则状态栏会报找不到命令。

七、总结

整体来说 CCometixLine 是个小而美的工具，装完几乎零配置就能用，状态栏信息一下丰富了很多。最实用的是 Git 状态和上下文用量显示——以前切项目、敲长对话的时候都得另外查，现在扫一眼状态栏就行。

TUI 配置也做得很用心，所见即所得，不用对着 toml 文件猜效果。补丁功能算是锦上添花，那个 “Context low” 警告确实有点烦人。

适合谁用？
– 日常用 Claude Code 开发的同行
– 经常在多个项目间切换，需要快速确认 Git 状态
– 长对话场景下想留意 Token 用量