CCometixLine

英文 | 中文

一款用 Rust 编写的高性能 Claude Code 状态栏工具，集成了 Git 功能、使用情况跟踪、交互式 TUI 配置以及 Claude Code 增强工具。

截图

状态栏显示内容：模型 | 目录 | Git 分支状态 | 上下文窗口信息

特性

核心功能

• Git 集成，显示分支、状态和跟踪信息
• 模型显示，采用简化的 Claude 模型名称
• 使用情况跟踪，基于对话记录分析
• 目录显示，展示当前工作区
• 极简设计，使用 Nerd Font 图标

交互式 TUI 功能

• 交互式主菜单，在无参数运行时显示
• TUI 配置界面，支持实时预览
• 主题系统，内置多种预设
• 分段自定义，提供细粒度控制
• 配置管理（初始化、检查、编辑）

Claude Code 增强功能

• 上下文警告禁用器：移除烦人的“上下文不足”提示
• 详细模式启用器：增强输出细节
• 健壮的补丁工具：可应对 Claude Code 版本更新
• 自动备份：安全修改，轻松恢复

安装

快速安装（推荐）

通过 npm 安装（适用于所有平台）：

# 全局安装
npm install -g @cometix/ccline

# 或者使用 yarn
yarn global add @cometix/ccline

# 或者使用 pnpm
pnpm add -g @cometix/ccline

使用 npm 镜像加速下载：

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

安装完成后：

• ✅ 全局命令 ccline 在任何地方均可使用
• ⚙️ 按照下方配置步骤与 Claude Code 集成
• 🎨 运行 ccline -c 打开配置面板以选择主题

Claude Code 配置

将以下内容添加到你的 Claude Code settings.json 中：

跨平台（推荐）

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

Windows 用户注意：从 Claude Code v2.1.47+ 开始，Windows 已支持 Unix 风格的路径解析。~ 符号会自动扩展为用户主目录。请勿使用 %USERPROFILE%，因为在 v2.1.47+ 中已不再可靠。

• 推荐：~/.claude/ccline/ccline（适用于所有平台）
• 替代方案："ccline"（需全局安装 npm）

备用方案（npm 全局安装）：

{
  "statusLine": {
    "type": "command",
    "command": "ccline",
    "padding": 0
  }
}

仅当 PATH 中存在 npm 全局安装时使用

更新

npm update -g @cometix/ccline

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

mkdir -p ~/.claude/ccline
wget https://github.com/Haleclipse/CCometixLine/releases/latest/download/ccline-linux-x64-static.tar.gz
tar -xzf ccline-linux-x64-static.tar.gz
cp ccline ~/.claude/ccline/
chmod +x ~/.claude/ccline/ccline

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/ccline

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/ccline

# 创建目录并下载
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\"

从源码构建

git clone https://github.com/Haleclipse/CCometixLine.git
cd CCometixLine
cargo build --release

# Linux/macOS
mkdir -p ~/.claude/ccline
cp target/release/ccometixline ~/.claude/ccline/ccline
chmod +x ~/.claude/ccline/ccline

# Windows（PowerShell）
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude\ccline"
copy target\release\ccometixline.exe "$env:USERPROFILE\.claude\ccline\ccline.exe"

使用方法

主题覆盖

# 临时使用特定主题（覆盖配置文件）
ccline --theme cometix
ccline --theme minimal
ccline --theme gruvbox
ccline --theme nord
ccline --theme powerline-dark

# 或使用 ~/.claude/ccline/themes/ 中的自定义主题文件
ccline --theme my-custom-theme

Claude Code 增强

# 禁用上下文警告并启用详细模式
ccline --patch /path/to/claude-code/cli.js

# 常见安装路径示例
ccline --patch ~/.local/share/fnm/node-versions/v24.4.1/installation/lib/node_modules/@anthropic-ai/claude-code/cli.js

默认分段

显示内容：目录 | Git 分支状态 | 模型 | 上下文窗口

Git 状态指示器

• 分支名称附带 Nerd Font 图标
• 状态：✓ 未修改，● 已修改，⚠ 存在冲突
• 远程跟踪：↑n 超前，↓n 落后

模型显示

显示简化的 Claude 模型名称：

• claude-3-5-sonnet → Sonnet 3.5
• claude-4-sonnet → Sonnet 4

上下文窗口显示

根据对话记录分析显示令牌使用百分比，并跟踪上下文限制。

配置

CCometixLine 支持通过 TOML 文件和交互式 TUI 进行完整配置：

• 配置文件：~/.claude/ccline/config.toml
• 交互式 TUI：ccline --config 可实时编辑并预览
• 主题文件：~/.claude/ccline/themes/*.toml 用于自定义主题
• 自动初始化：ccline --init 可创建默认配置

可配置分段

所有分段均可进行如下设置：

• 开启/关闭切换
• 自定义分隔符和图标
• 颜色自定义
• 格式选项

支持的分段：目录、Git、模型、使用情况、时间、费用、输出风格

模型配置文件（models.toml）

位置：~/.claude/ccline/models.toml（首次运行时自动创建）

该文件用于配置模型 ID 的显示方式及其上下文窗口限制。Claude 系列模型（Sonnet、Opus、Haiku）会自动识别并提取版本号，因此您只需在需要覆盖默认设置或使用第三方模型时才需编辑此文件。

# 模型条目：基于模型 ID 的简单子字符串匹配
# 这些条目优先于内置的 Claude 模型识别
[[models]]
pattern = "glm-4.5"
display_name = "GLM-4.5"
context_limit = 128000

[[models]]
pattern = "kimi-k2"
display_name = "Kimi K2"
context_limit = 128000

# 上下文修饰符：独立匹配，并可与模型条目组合使用
# 会覆盖 context_limit，并在显示名称后追加 display_suffix
# 例如，模型 "Opus 4" + 修饰符 " 1M" = "Opus 4 1M"
[[context_modifiers]]
pattern = "[1m]"
display_suffix = " 1M"
context_limit = 1000000

系统要求

• Git：版本 1.5 或更高（建议使用 Git 2.22 或更高版本以更好地检测分支）
• 终端：必须支持 Nerd Fonts 才能正确显示图标
  • 安装一种 Nerd Font（例如 FiraCode Nerd Font、JetBrains Mono Nerd Font）
  • 配置终端以使用该 Nerd Font
• Claude Code：用于状态栏集成

开发

# 构建开发版本
cargo build

# 运行测试
cargo test

# 构建优化后的发布版本
cargo build --release

路线图

• 支持 TOML 配置文件
• 提供 TUI 配置界面
• 自定义主题
• 交互式主菜单
• Claude Code 增强工具

贡献

欢迎贡献！请随时提交问题或拉取请求。

相关项目

• tweakcc - 命令行工具，用于自定义您的 Claude Code 主题、思考动词等。

许可证

本项目采用 MIT 许可证 许可。

星标历史

CCometixLine 快速上手指南

CCometixLine 是一款基于 Rust 开发的高性能 Claude Code 状态栏工具，支持 Git 集成、用量追踪、交互式 TUI 配置及 Claude Code 增强功能。

环境准备

在开始之前，请确保满足以下要求：

• 操作系统：Linux (Ubuntu 22.04+/CentOS 9+/Debian 11+), macOS (Intel/Apple Silicon), 或 Windows。
• Git：版本 1.5+（推荐 2.22+ 以获得更好的分支检测）。
• 终端字体：必须安装并配置 Nerd Font（如 FiraCode Nerd Font 或 JetBrains Mono Nerd Font），否则图标无法正常显示。
• Claude Code：已安装并配置好 Claude Code 环境。
• 包管理器：推荐安装 npm、yarn 或 pnpm 以简化安装流程。

安装步骤

推荐使用 npm 进行全局安装，国内用户建议使用淘宝镜像源以提升下载速度。

1. 全局安装

# 使用 npm 镜像源安装（推荐国内用户）
npm install -g @cometix/ccline --registry https://registry.npmmirror.com

# 或者使用 yarn
yarn global add @cometix/ccline

# 或者使用 pnpm
pnpm add -g @cometix/ccline

安装完成后，ccline 命令即可在全局使用。

2. 配置 Claude Code

将以下配置添加到你的 Claude Code settings.json 文件中。该配置适用于所有平台（包括 Windows v2.1.47+）。

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

注意：如果你使用的是纯 npm 全局安装且环境变量配置正确，也可以直接使用 "command": "ccline"，但推荐使用上述绝对路径方式以确保稳定性。

3. 初始化与主题选择

运行以下命令打开交互式配置面板，选择你喜欢的主题：

ccline -c

基本使用

安装配置完成后，CCometixLine 会自动在 Claude Code 的状态栏中显示以下信息： 目录 | Git 分支状态 | 模型名称 | 上下文窗口信息

常用命令

• 打开配置界面（实时预览修改效果）：

  ccline --config
  

• 临时切换主题（不修改配置文件）：

  ccline --theme cometix
  ccline --theme minimal
  ccline --theme gruvbox
  

• 增强 Claude Code 功能（禁用上下文警告并启用详细模式）：

  # 请将路径替换为你实际的 claude-code cli.js 路径
  ccline --patch ~/.local/share/fnm/node-versions/v24.4.1/installation/lib/node_modules/@anthropic-ai/claude-code/cli.js
  

自定义模型显示

如果需要显示非官方 Claude 模型（如 GLM、Kimi 等），可编辑 ~/.claude/ccline/models.toml 文件：

[[models]]
pattern = "glm-4.5"
display_name = "GLM-4.5"
context_limit = 128000

[[models]]
pattern = "kimi-k2"
display_name = "Kimi K2"
context_limit = 128000