效果图：

配置项速览

/statusline 是 Claude Code 的自定义状态栏，核心靠 settings.json 配置 + 脚本输出，下面把关键配置项讲清楚，照着就能改。效果

一、基础配置（settings.json）

路径：~/.claude/settings.json（用户级）或 .claude/settings.json（项目级）

json

{
  "statusLine": {
    "type": "command",     // 固定值，必填
    "command": "脚本路径", // 你的状态栏脚本，必填
    "padding": 0            // 左右内边距（字符数），选填，默认0
  }
}

• type：只能填 command，表示用外部命令生成状态栏。

• command：脚本路径（如 ~/.claude/statusline.sh）或单行命令。

• padding：状态栏左右留白，默认 0（贴边）。

二、可直接调用的字段（脚本可用）

Claude 会把会话数据以 JSON 传给脚本，常用字段如下：

1. 模型与上下文

• model.name：当前模型名（如 sonnet-4）。

• context_window.used_percentage：上下文使用率（0-100）。

• context_window.used_tokens：当前会话已用 Token。

• context_window.total_tokens：上下文总容量。

2. 用量与限额

• rate_limit.used：5 小时限额已用。

• rate_limit.remaining：5 小时限额剩余。

• rate_limit.reset_in_seconds：重置倒计时（秒）。

3. 费用统计

• cost.session：当前会话花费。

• cost.daily：当日累计花费。

4. 其他实用项

• cwd：当前工作目录。

• git.branch：当前 Git 分支。

三、快速启用示例

直接用自然语言生成配置，不用手写脚本：

plaintext

/statusline 显示模型名、上下文百分比+进度条、会话Token、5小时用量及重置时间、当日花费

Claude 会自动生成脚本并写入 settings.json，开箱即用。

四、自定义小技巧

• 支持 ANSI 颜色码，可给模型名 / 费用加色。

• 进度条用 ▇/▁ 字符，结合百分比计算长度。

• 刷新频率：会话更新时刷新，最低间隔 300ms。