项目简介

claude-statusline 是一个专为 Claude Code CLI 设计的终端状态栏增强工具。它能在终端底部显示丰富的实时信息，包括当前使用的模型、上下文使用进度条、Hard/Soft 限制、Git 分支、会话时长等。

对于经常使用 Claude Code 的开发者来说，这个工具解决了”不知道当前会话状态”的痛点，让终端界面更加信息丰富且专业。

核心功能

  • 模型信息显示：实时显示当前使用的 Claude 模型版本
  • 上下文进度条：可视化展示上下文窗口使用情况
  • Token 使用限制：显示 Hard limit 和 Soft limit 状态
  • Git 分支集成：自动检测并显示当前 Git 分支
  • 会话计时器：显示当前 Claude Code 会话的运行时长
  • 跨平台支持：兼容 macOS、Linux 和 Windows

技术实现

项目使用纯 Shell 脚本实现，轻量且易于安装。通过解析 Claude Code 的内部状态文件和系统命令输出，将各种信息整合到一个美观的状态栏中。

安装方式简单，只需将脚本添加到 shell 配置文件即可：

# 下载脚本
curl -fsSL https://raw.githubusercontent.com/AndyShaman/claude-statusline/main/claude-statusline.sh -o ~/.claude-statusline.sh

# 添加到 .bashrc 或 .zshrc
echo 'source ~/.claude-statusline.sh' >> ~/.zshrc

为什么值得关注

  1. 精准解决痛点：Claude Code 默认界面信息有限，这个工具补足了状态可视化的缺失
  2. 零配置开箱即用：无需复杂设置，安装后即可使用
  3. 社区驱动：项目刚刚起步（26 stars），但更新活跃，有潜力成为 Claude Code 用户的标配工具
  4. MIT 开源：可自由 fork 和定制

项目信息

发现更多有趣的开源项目，欢迎关注 gumi.ink