Claude Code SDK #24：Status line 全解——stdin JSON × 本地脚本 × context/cost/git 仪表盘，把长任务状态钉在底部

01 / 它的核心模型：Claude Code 喂 JSON，你的脚本吐文本

• Claude Code 负责提供会话状态，例如模型、工作目录、上下文窗口、费用、rate limit、PR、worktree、vim mode。
• 你的脚本负责决定「哪些字段值得显示」「怎么裁剪」「何时用颜色、进度条或链接」。
• 状态栏脚本在本地运行，不消耗 API token；它会在自动补全、帮助菜单、权限提示等 UI 交互期间暂时隐藏。1

02 / 最小配置：先用 /statusline，再决定要不要手写

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh",
    "padding": 2
  }
}

03 / 什么时候刷新：它不是实时轮询，默认是事件驱动

04 / 可读字段：最有价值的是这六组

05 / 一条可直接改的脚本：模型 + 目录 + context + git

#!/bin/bash
input=$(cat)

MODEL=$(echo "$input" | jq -r '.model.display_name // "Claude"')
DIR=$(echo "$input" | jq -r '.workspace.current_dir // .cwd // ""')
PCT=$(echo "$input" | jq -r '.context_window.used_percentage // 0' | cut -d. -f1)

BRANCH=""
if git rev-parse --git-dir >/dev/null 2>&1; then
  BRANCH=$(git branch --show-current 2>/dev/null)
fi

if [ -n "$BRANCH" ]; then
  echo "[$MODEL] ${DIR##*/} | git:$BRANCH | ctx:${PCT}%"
else
  echo "[$MODEL] ${DIR##*/} | ctx:${PCT}%"
fi

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh"
  }
}

06 / 三个相邻概念别混了

07 / 排障时先看这 6 件事

1. 脚本没执行权限：先跑 chmod +x ~/.claude/statusline.sh。
2. 脚本没有 stdout：status line 只显示 stdout，stderr 不会变成状态栏内容。
3. Windows 路径写反斜杠：在有 Git Bash 的 Windows 上，未加引号的反斜杠会被当作转义；官方建议在 command 里用正斜杠路径，例如 C:/Users/username/.claude/statusline.ps1。1
4. disableAllHooks 开着：这个设置会同时禁用 hooks 和自定义 status line。2
5. 字段是空的：第一次 API response 之前，部分上下文字段本来就可能是 null，用 // 0、// empty 兜底。1
6. 脚本太慢：慢脚本会阻塞状态栏更新；新刷新到来时，旧执行可能被取消。1

08 / 今天就能落地的配置顺序

1. 先运行 /statusline show model name, current directory and context percentage，让 Claude Code 生成第一版。
2. 打开生成的脚本，把显示内容收敛到「模型 + 当前目录 + context % + git branch」。
3. 如果你经常用 worktree，把 worktree.branch 或 workspace.git_worktree 加进去。
4. 如果你跑长任务，把 cost.total_cost_usd 和 cost.total_duration_ms 加进去。
5. 如果脚本开始变慢，再加缓存；不要一开始就把状态栏写成小型监控系统。