README技术、设计与日常思考
← 返回首页
技术

Claude Code Status Line

在 Claude Code CLI 底部实时显示上下文使用情况、模型信息和压缩次数。

Claude CodePythonGit

Claude Code Status Line

效果

[Opus 4.7] [====----------------] 13% (132k/1M) | effort:xhigh | thinking:on | compact:0
  • 进度条颜色:绿色(<70%) → 黄色(70-90%) → 红色(>90%)

  • compact 计数:每次手动 /compact 后自动 +1

    实际效果

安装

前置要求

  • Python 3
  • Git(Windows 需要,提供 bash 环境)
  • Claude Code CLI v2.1.0+

步骤

  1. statusline.py 复制到 ~/.claude/statusline.py

    • Windows: C:\Users\你的用户名\.claude\statusline.py
    • Mac/Linux: ~/.claude/statusline.py
  2. ~/.claude/settings.json 中添加 statusLine 配置:

    Windows:

    {
      "statusLine": {
        "type": "command",
        "command": "python /c/Users/你的用户名/.claude/statusline.py"
      }
    }
    

    Mac/Linux:

    {
      "statusLine": {
        "type": "command",
        "command": "python3 ~/.claude/statusline.py"
      }
    }
    
  3. 重启 Claude Code,发一条消息后底部就会出现状态栏。

自定义

  • 修改进度条宽度:改脚本中 pct * 20 // 10020
  • 修改颜色阈值:改 pct >= 90pct >= 70 的数值
  • 修改压缩检测灵敏度:改 prev_pct - pct > 3030
  • 去掉不需要的字段:删除 print 语句中对应的部分

注意事项

  • Status line 只在 Claude Code CLI 中生效,桌面应用不支持

  • 需要收到第一条回复后才会显示

  • 压缩计数基于上下文百分比突降检测,每个会话独立计数

  • DISABLE_COMPACT=1 时需要手动 /compact,状态栏帮你判断何时该压缩