CCometixLine 状态栏插件
让 Claude Code 状态栏显示模型、Git 分支、Token 用量等实用信息
📋 简介
CCometixLine（简称 ccline）是一款 Claude Code 状态栏增强插件，用 Rust 编写，性能极佳。安装后，你的 Claude Code 底部状态栏会实时显示当前模型名称、Git 分支状态、Token 用量百分比等信息，还支持多种主题和自定义配置。
⚠️ 适用环境
- Windows 10 及以上
- macOS 12 (Monterey) 及以上（Intel / Apple Silicon 均支持）
- Linux（主流发行版）
🚨 前置条件
使用 ccline 前，请确保你已经完成了 Claude Code 部署，并且 Claude Code 能正常使用。ccline 是 Claude Code 的增强插件，不能独立运行。
🔗 相关链接
| 资源 | 地址 |
|---|---|
| GitHub 仓库 | https://github.com/Haleclipse/CCometixLine |
| npm 包 | @cometix/ccline |
| 下载页面 | Releases |
✨ 功能特点
- 实时显示当前使用的 AI 模型名称（自动简化，如
claude-sonnet-4-6显示为Sonnet 4.6） - Git 分支名 + 状态指示（
●有修改、⚠冲突、↑↓远程同步状态） - Token 上下文窗口用量百分比
- API 费用追踪（USD）
- 多种内置主题（cometix、minimal、gruvbox、nord、powerline-dark）
- 交互式 TUI 配置界面，实时预览效果
- 支持 Powerline 风格箭头分隔符
🛠️ 安装 ccline
有两种安装方式：npm 全局安装（推荐）和手动下载二进制文件。
方式一：npm 全局安装（推荐）
💡 前提
需要已安装 Node.js 环境。如果还没装，请先参考 Node.js 安装指南。
npm install -g @cometix/ccline国内网络较慢的话，可以用镜像源加速：
npm install -g @cometix/ccline --registry https://registry.npmmirror.com也支持其他包管理器：
# yarn
yarn global add @cometix/ccline
# pnpm
pnpm add -g @cometix/ccline方式二：手动下载二进制文件
如果你不想用 npm，可以直接下载编译好的二进制文件。
Windows
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude\ccline"
Invoke-WebRequest -Uri "https://github.com/Haleclipse/CCometixLine/releases/latest/download/ccline-windows-x64.zip" -OutFile "ccline-windows-x64.zip"
Expand-Archive -Path "ccline-windows-x64.zip" -DestinationPath "."
Move-Item "ccline.exe" "$env:USERPROFILE\.claude\ccline\"macOS（Apple Silicon）
mkdir -p ~/.claude/ccline
wget https://github.com/Haleclipse/CCometixLine/releases/latest/download/ccline-macos-arm64.tar.gz
tar -xzf ccline-macos-arm64.tar.gz
cp ccline ~/.claude/ccline/
chmod +x ~/.claude/ccline/cclinemacOS（Intel）
mkdir -p ~/.claude/ccline
wget https://github.com/Haleclipse/CCometixLine/releases/latest/download/ccline-macos-x64.tar.gz
tar -xzf ccline-macos-x64.tar.gz
cp ccline ~/.claude/ccline/
chmod +x ~/.claude/ccline/cclineLinux
mkdir -p ~/.claude/ccline
wget https://github.com/Haleclipse/CCometixLine/releases/latest/download/ccline-linux-x64.tar.gz
tar -xzf ccline-linux-x64.tar.gz
cp ccline ~/.claude/ccline/
chmod +x ~/.claude/ccline/ccline⚙️ 配置 Claude Code 使用 ccline
npm 安装的用户
通过 npm 全局安装后，ccline 会自动配置好 Claude Code 的状态栏，无需手动编辑任何文件。重新打开 Claude Code 即可看到效果。
手动安装的用户
如果你是手动下载二进制文件的，需要编辑 Claude Code 的 settings.json，添加状态栏配置。
💡 settings.json 在哪？
- macOS / Linux：
~/.claude/settings.json - Windows：
%USERPROFILE%\.claude\settings.json
在 settings.json 中添加以下内容：
{
"statusLine": {
"type": "command",
"command": "~/.claude/ccline/ccline",
"padding": 0
}
}验证效果
重新打开 Claude Code，底部状态栏应该会显示模型名称、Git 分支等信息。如果没有显示：
- 完全关闭并重新打开 Claude Code
- 在终端运行
ccline确认命令可以正常执行 - 如果用的是手动安装，确认二进制文件有执行权限（
chmod +x）
🎨 主题与自定义
切换内置主题
ccline 内置了 5 种主题，可以通过命令行快速切换：
ccline --theme cometix # 默认主题
ccline --theme minimal # 简约风格
ccline --theme gruvbox # Gruvbox 配色
ccline --theme nord # Nord 配色
ccline --theme powerline-dark # Powerline 深色交互式配置界面
想要更精细的自定义？用 TUI 配置界面：
ccline --config在 TUI 界面中你可以：
- 选择和预览主题
- 开关各个状态栏段（模型、Git、Token 用量等）
- 自定义颜色、图标、分隔符
- 实时预览修改效果
💡 配置文件位置
所有配置保存在 ~/.claude/ccline/config.toml，你也可以直接编辑这个文件。
🔧 进阶功能
自定义模型显示名称
如果你使用小麦API 的自定义模型，可以编辑 ~/.claude/ccline/models.toml 来配置显示名称：
[[models]]
pattern = "claude-sonnet-4-6"
display_name = "Sonnet 4.6"
context_limit = 200000
[[context_modifiers]]
pattern = "[1m]"
display_suffix = " 1M"
context_limit = 1000000Claude Code 增强补丁
ccline 还提供了一个可选的增强补丁，可以禁用上下文窗口警告弹窗并启用详细模式：
ccline --patch /path/to/claude-code/cli.js⚠️ 注意
补丁功能会修改 Claude Code 的源文件，更新 Claude Code 后可能需要重新执行。如果不确定 cli.js 的路径，可以用以下命令查找：
which claude && ls -la $(which claude)📦 更新 ccline
npm 安装的用户
npm update -g @cometix/ccline手动安装的用户
重新下载最新版本的二进制文件，覆盖 ~/.claude/ccline/ 目录下的旧文件即可。
常见问题
安装后状态栏没有变化？
- 确认
settings.json中的配置已保存 - 完全关闭并重新打开 Claude Code
- 在终端运行
ccline确认命令可以正常执行 - 如果用的是手动安装，确认二进制文件有执行权限（
chmod +x）
状态栏图标显示为方块或乱码？
ccline 使用 Nerd Fonts 图标。你需要在终端中使用支持 Nerd Fonts 的字体，推荐：
Git 信息不显示？
确保当前目录是一个 Git 仓库，并且系统已安装 Git 1.5+（推荐 2.22+）。