ccr statusline

显示可自定义的状态栏，实时展示 Claude Code 会话信息，包括工作区、Git 分支、模型、token 使用情况等。

概述

ccr statusline 命令从 stdin 读取 JSON 数据，并在终端中渲染格式精美的状态栏。它设计用于与 Claude Code 的 hook 系统集成，以显示实时会话信息。

使用方法

基本用法

ccr statusline

该命令期望通过 stdin 接收 JSON 数据，通常通过管道从 Claude Code hook 传递：

echo '{"hook_event_name":"...","session_id":"...","..."}' | ccr statusline

Hook 集成

在您的 Claude Code 设置中配置：

{
  "hooks": {
    "postResponse": {
      "command": "ccr statusline",
      "input": "json"
    }
  }
}

可用主题

默认主题

简洁优雅的主题，使用 Nerd Font 图标和彩色文本：

 󰉋 my-project   main  󰚩 claude-3-5-sonnet-20241022  ↑ 12.3k  ↓ 5.2k

Powerline 主题

vim-powerline 风格，带背景色和箭头分隔符：

 󰉋 my-project   main  󰚩 claude-3-5-sonnet-20241022  ↑ 12.3k  ↓ 5.2k

通过在配置中设置 currentStyle: "powerline" 激活。

简单主题

回退主题，不带图标，适用于不支持 Nerd Font 的终端：

my-project  main  claude-3-5-sonnet-20241022  ↑ 12.3k  ↓ 5.2k

当 USE_SIMPLE_ICONS=true 或在不支持的终端上自动使用。

可用模块

状态栏模块显示不同类型的信息：

模块	说明	变量
workDir	当前工作目录名称	`{{workDirName}}`
gitBranch	当前 Git 分支	`{{gitBranch}}`
model	使用的模型	`{{model}}`
usage	Token 使用情况（输入/输出）	`{{inputTokens}}`, `{{outputTokens}}`
context	上下文窗口使用情况	`{{contextPercent}}`, `{{contextWindowSize}}`
speed	Token 处理速度	`{{tokenSpeed}}`, `{{isStreaming}}`
cost	API 成本	`{{cost}}`
duration	会话持续时间	`{{duration}}`
lines	代码变更	`{{linesAdded}}`, `{{linesRemoved}}`
script	自定义脚本输出	动态

配置

在 ~/.claude-code-router/config.json 中配置 statusline：

默认样式示例

{
  "StatusLine": {
    "currentStyle": "default",
    "default": {
      "modules": [
        {
          "type": "workDir",
          "icon": "󰉋",
          "text": "{{workDirName}}",
          "color": "bright_blue"
        },
        {
          "type": "gitBranch",
          "icon": "",
          "text": "{{gitBranch}}",
          "color": "bright_magenta"
        },
        {
          "type": "model",
          "icon": "󰚩",
          "text": "{{model}}",
          "color": "bright_cyan"
        },
        {
          "type": "usage",
          "icon": "↑",
          "text": "{{inputTokens}}",
          "color": "bright_green"
        },
        {
          "type": "usage",
          "icon": "↓",
          "text": "{{outputTokens}}",
          "color": "bright_yellow"
        }
      ]
    }
  }
}

Powerline 样式示例

{
  "StatusLine": {
    "currentStyle": "powerline",
    "powerline": {
      "modules": [
        {
          "type": "workDir",
          "icon": "󰉋",
          "text": "{{workDirName}}",
          "color": "white",
          "background": "bg_bright_blue"
        },
        {
          "type": "gitBranch",
          "icon": "",
          "text": "{{gitBranch}}",
          "color": "white",
          "background": "bg_bright_magenta"
        }
      ]
    }
  }
}

完整功能示例

{
  "StatusLine": {
    "currentStyle": "default",
    "default": {
      "modules": [
        {
          "type": "workDir",
          "icon": "󰉋",
          "text": "{{workDirName}}",
          "color": "bright_blue"
        },
        {
          "type": "gitBranch",
          "icon": "",
          "text": "{{gitBranch}}",
          "color": "bright_magenta"
        },
        {
          "type": "model",
          "icon": "󰚩",
          "text": "{{model}}",
          "color": "bright_cyan"
        },
        {
          "type": "context",
          "icon": "🪟",
          "text": "{{contextPercent}}% / {{contextWindowSize}}",
          "color": "bright_green"
        },
        {
          "type": "speed",
          "icon": "⚡",
          "text": "{{tokenSpeed}} t/s {{isStreaming}}",
          "color": "bright_yellow"
        },
        {
          "type": "cost",
          "icon": "💰",
          "text": "{{cost}}",
          "color": "bright_magenta"
        },
        {
          "type": "duration",
          "icon": "⏱️",
          "text": "{{duration}}",
          "color": "bright_white"
        },
        {
          "type": "lines",
          "icon": "📝",
          "text": "+{{linesAdded}}/-{{linesRemoved}}",
          "color": "bright_cyan"
        }
      ]
    }
  }
}

自定义脚本

您可以通过执行脚本创建自定义模块：

{
  "type": "script",
  "icon": "🔧",
  "scriptPath": "/path/to/script.js",
  "options": {
    "customOption": "value"
  }
}

脚本格式（CommonJS）：

// my-status-module.js
module.exports = function(variables, options) {
  // 访问变量如 model、gitBranch 等
  // 从配置中访问选项
  return `Custom: ${variables.model}`;
};

// 或异步
module.exports = async function(variables, options) {
  const data = await fetchSomeData();
  return data;
};

颜色选项

标准颜色

black, red, green, yellow, blue, magenta, cyan, white
bright_black, bright_red, bright_green, bright_yellow, bright_blue, bright_magenta, bright_cyan, bright_white

背景颜色

添加前缀 bg_：bg_blue, bg_bright_red 等。

十六进制颜色

使用 24 位 TrueColor 和十六进制代码：

{
  "color": "#FF5733",
  "background": "bg_#1E90FF"
}

可用变量

所有变量都可以在模块文本中使用 {{variableName}} 访问：

变量	说明	示例
`{{workDirName}}`	当前目录名称	`my-project`
`{{gitBranch}}`	Git 分支名称	`main`
`{{model}}`	模型名称	`claude-3-5-sonnet-20241022`
`{{inputTokens}}`	输入 tokens（格式化）	`12.3k`
`{{outputTokens}}`	输出 tokens（格式化）	`5.2k`
`{{tokenSpeed}}`	每秒 tokens 数	`45`
`{{isStreaming}}`	流式传输状态	`streaming` 或空
`{{contextPercent}}`	上下文使用百分比	`45`
`{{contextWindowSize}}`	总上下文窗口	`200k`
`{{cost}}`	总成本	`$0.15`
`{{duration}}`	会话持续时间	`2m34s`
`{{linesAdded}}`	添加的行数	`150`
`{{linesRemoved}}`	删除的行数	`25`
`{{sessionId}}`	会话 ID（前 8 个字符）	`a1b2c3d4`

环境变量

使用环境变量控制行为：

变量	值	说明
`USE_SIMPLE_ICONS`	`true`/`false`	强制使用不带图标的简单主题
`NERD_FONT`	任意值	自动检测 Nerd Font 支持

示例

极简状态栏

{
  "StatusLine": {
    "default": {
      "modules": [
        {
          "type": "model",
          "text": "{{model}}"
        },
        {
          "type": "usage",
          "text": "↑{{inputTokens}} ↓{{outputTokens}}"
        }
      ]
    }
  }
}

输出：claude-3-5-sonnet-20241022 ↑12.3k ↓5.2k

开发者生产力重点

{
  "StatusLine": {
    "default": {
      "modules": [
        {
          "type": "gitBranch",
          "icon": "",
          "text": "{{gitBranch}}",
          "color": "bright_magenta"
        },
        {
          "type": "lines",
          "icon": "📝",
          "text": "+{{linesAdded}}/-{{linesRemoved}}",
          "color": "bright_cyan"
        },
        {
          "type": "duration",
          "icon": "⏱️",
          "text": "{{duration}}",
          "color": "bright_white"
        }
      ]
    }
  }
}

输出： feature/auth 📝 +150/-25 ⏱️ 2m34s

Preset 集成

Statusline 主题可以包含在 presets 中。当您安装带有 statusline 配置的 preset 时，激活该 preset 时会自动应用。

查看 Presets 了解更多信息。

故障排除

图标不显示

在环境中设置 USE_SIMPLE_ICONS=true：

export USE_SIMPLE_ICONS=true

颜色不工作

确保您的终端支持 TrueColor（24 位颜色）：

export COLORTERM=truecolor

Git 分支不显示

确保您在 Git 仓库中并安装了 git 命令。

概述​

使用方法​

基本用法​

Hook 集成​

可用主题​

默认主题​

Powerline 主题​

简单主题​

可用模块​

配置​

默认样式示例​

Powerline 样式示例​

完整功能示例​

自定义脚本​

颜色选项​

标准颜色​

背景颜色​

十六进制颜色​

可用变量​

环境变量​

示例​

极简状态栏​

开发者生产力重点​

Preset 集成​

故障排除​

图标不显示​

颜色不工作​

Git 分支不显示​

相关命令​

概述