📋 系统要求

在开始使用之前，请确保您的系统满足以下要求：

必需条件

• Claude Code: 版本 ≥ 1.0.71
• Node.js: 版本 ≥ 18.0.0 (下载安装)
• npm: 通常随Node.js自动安装

检查当前版本

# 检查Claude Code版本
claude --version

# 检查Node.js版本
node --version

# 检查npm版本
npm --version

🚀 快速开始

一步配置，即刻使用

只需要在Claude Code的配置文件中添加一行配置，无需预先安装：

在项目根目录或 $USER 目录创建 .claude/settings.json：

{
  "statusLine": {
    "type": "command", 
    "command": "npx ccsp@latest"
  }
}

💡 兼容说明：旧命令 npx ccsp@latest 仍会继续工作并自动调用新包，但将显示迁移提示。建议尽快将现有配置更新为 npx ccsp@latest 以保持一致。

保存文件后，重新打开Claude Code即可看到专业版状态栏！

验证安装

打开Claude Code，你应该看到类似这样的状态栏：

📁 my-project | 🤖 S4 | 🌿 main | 📊 [████████████░░░] 80.1%(160k/200k) | $21.07 | ✅ Ready

🎯 快速配置指南

预设系统 - 字母组合配置

通过简单的字母组合快速定制状态栏显示内容：

• P = Project (项目名称)
• M = Model (模型信息)
• B = Branch (Git分支)
• T = Tokens (Token使用情况)
• U = Usage (使用量统计)
• S = Status (状态信息)

快速配置命令

注：这些命令全部是写在settings.json中的，并不是在终端直接执行使用（直接执行会打印出预览结果）

# 显示所有组件（推荐）
npx ccsp@latest --preset PMBTUS --theme powerline

# 只显示模型、Token和使用量
npx ccsp@latest --preset MTU --theme classic

# 只显示分支和Token信息
npx ccsp@latest --preset BT --theme capsule

🧩 多行小组件系统

多行系统可以把状态栏扩展为网格布局，嵌入多个可独立刷新的小组件。

• 网格布局：使用 row（从1开始）和 col（从0开始）控制每个小组件的位置，支持跨行/列排布。
• 小组件类型：内置 static（静态文本）与 api（HTTP 请求）两种类型，API 小组件支持模板渲染、环境变量替换。
• 自动检测：通过 detection 段读取环境变量，可配置 equals / contains / pattern 触发条件，也可以配合 force 手动开启或关闭。
• 结果过滤：filter 支持 JSONPath + equals / contains / pattern 匹配，只在命中关键字时刷新；可用于最近请求等场景。
• 模板示例：项目内提供 `configs/components/usage.templa...