用途：为 Claude Code 提供单一来源的状态栏脚本，支持安装、配置、定制与故障排查，显示当前工作目录、模型、token 计数等信息。
主要能力：默认 minimal 单行布局显示短路径、git 分支、模型名与绝对 token 数；设置 CLAUDE_STATUSLINE_LAYOUT=full 后启用多行布局，额外显示用户、ccusage 会话/每日费用、带颜色阈值的上下文百分比（绿≤50%、黄51–80%、红>80%）以及 git 分支的修改/未跟踪标记。分支通过直接读取 .git/HEAD 实现零 fork，无需 git 二进制。
使用方式：运行 bash scripts/install_statusline.sh 安装，脚本会备份现有文件、复制脚本到 ~/.claude/statusline.sh 并 chmod +x、用 jq 更新 settings.json，最后强制运行健康检查。健康检查命令为 bash scripts/health_check.sh，验证文件权限、settings.json 配置、模拟 stdin 测试和真实 stdin 回放。布局通过环境变量切换，在 ~/.zshrc 或 ~/.bashrc 中设置 export CLAUDE_STATUSLINE_LAYOUT=minimal 或 full，重启 shell 后生效。调试可设置 export CLAUDE_STATUSLINE_DEBUG=1，将 stdin 写入 /tmp/.claude-statusline-last-stdin.json。
适用场景：需要为 Claude Code 配置或修改状态栏、排查状态栏空白或不更新、调整 token 显示方式、定制颜色与自定义段落的用户。
限制与依赖：脚本依赖 jq（缺失时回退 python3）、awk（必需）、git（仅 full 布局的脏状态标记，缺失则静默跳过）、ccusage（仅 full 布局费用，缺失则静默跳过）。安装命令为 brew install jq 或 apt install jq。状态栏为高频刷新路径，应避免在刷新时解析包或频繁 spawn git；本脚本约 0.01s CPU 每次刷新。字段级陷阱（如 used_percentage 在会话开始时为 null、total_input_tokens 语义随版本变化、硬编码 context_window_size）见 references/context-window-schema.md。定制颜色、自定义段落和关闭费用跟踪见 references/customization.md。故障排查见 references/troubleshooting-decision-tree.md。