配置Claude Code状态栏：/statusline命令实时看模型、成本和Git状态

周三晚上刷YouTube，点开前端大神Matt Pocock的编程视频。他噼里啪啦敲命令，我却盯着他Claude Code终端里多出来的那行彩色信息——输入框下方挂着一条状态栏，模型名字、Token用量、花的钱全摆在眼皮底下。我立刻暂停，打开Google。

十分钟后，发现这功能Claude Code早就内置了，只是藏在/statusline命令里。官方文档页面写得清楚，但平时根本翻不到。试了一圈，我把整个配置过程捋成清单，你照着敲就行。

1. 状态栏怎么激活？

Claude Code的/statusline是一个内置命令，不需要装任何插件。你直接在对话里输入/statusline，后面跟一段自然语言描述你想要的风格和数据，Claude就会自动生成一个渲染脚本和settings.json配置文件，放在用户级Claude配置目录里。不同操作系统的路径它自己能判断，不用你手改任何环境变量。

整个原理很简单：Claude运行时会通过stdin向你的脚本推送一个JSON，包含当前会话信息——模型ID、工作目录、Git状态、Token消耗、成本和时间。脚本拿到这些数据，按你指定的格式输出带ANSI颜色的文本，Claude就原样画在终端的状态栏区域。

2. 脚本必须解决的三个约束

开源社区不少配置帖习惯默认你有bash和jq，但Claude Code可能在各种环境里跑，从吃灰的虚拟机到公司锁死的开发机。所以prompt里第一件事就是告诉/statusline：用操作系统上保证可用的脚本语言，别假设有特定shell工具。如果机器上有Python或Node就优先选它们，真正啥都没有才退到POSIX shell。同时脚本要读stdin的JSON，确保每个字段访问都带着fallback，字段丢了也不崩。

我自己测试时在macOS上用zsh，脚本选了Python，本地装了jq但脚本根本不需要它，完全用json.loads解析就行。这一步省掉不少跨环境踩坑。

3. 第一行：模型、目录、分支和Token

状态栏第一行输出四个东西。模型ID用方括号包起来，直接从.model.id取。然后一个图标，接着当前工作目录的basename，一眼就知道在哪个项目里。第三段是Git分支，显示加分支名，如果工作树脏了就补个*号。检测分支时用git命令但加了不会惊扰锁和索引的选项，防止你把文件编辑一半触发了奇怪的冲突。

Token用量放在最右边，数值来自.context_window.total_input_tokens，往下一档取整到千位，后面加个小写k。34,567就显示34k，零头不写。颜色从绿到红分了四档，按对150k阈值的占比来：不到25%绿，25%-50%黄，50%-75%橙，到了75%或更高直接亮红。四个颜色用了256色ANSI码46、226、208、196，叠加亮白色底色，在深色终端上很干净。

4. 第二行：时长和费用

第二行只负责两样：会话跑了多长时间，花了多少钱。时长从.cost.total_duration_ms拿毫秒值，转成人类读得懂的格式：一小时以上显示Xh Xm，不足一小时显示Xm Xs，更短的直接Xs。费用从.cost.total_cost_usd取，格式化成两位小数美元。保持和第一行同样的亮白色基准，简洁不抢眼。

如果你不是Git仓库，提示词里要求直接跳过那一段，别留空占位符。非Git目录状态下第一行就只有模型、目录和Token用量，布局自动调整。我试了几个普通文件夹，确实不会显示多余字符。

5. 你能自己改什么

默认脚本生成后，所有样式全部通过settings.json和对应的渲染文件控制。你可以改颜色阈值、调Token显示的单位（比如加个M）、加更多状态段，甚至把成本换算成其他货币。只要保持stdin JSON的字段访问不乱改，想怎么玩都行。

Matt视频里他那一行状态栏额外显示了上下文窗口还剩多少，显然是加了一段自己解析的扩展。官方文档里给的脚本只是个跳板，真正好用的形态得自己调几版。我用了三天后把Token颜色阈值改成三个区间，200k上限，超过80%变红，因为最近用的模型基本都128k上下文，150k的默认阈值低了点。

踩坑速记

配置中最容易翻车的点有两个。一是脚本执行权限，/statusline生成文件后不会自动chmod，你得手动给渲染脚本加可执行位。二是Git命令的引号问题，在Windows的PowerShell里调用git时路径参数得加额外包裹，我用Python的subprocess直接跑cmdline反而比shell脚本出问题少。至于代码里每个字段都用的safe access，有一次JSON结构变了.token消耗字段半夜消失了，状态栏没崩只是留空，全靠fallback兜底。

目前这个状态栏已经成了我每次开Claude Code必显的东西。看Token像看油表，看费用像看计价器，哪天跑个长任务瞥见数字由绿翻黄，就知道该停手重新规划上下文了。

命令速递

想立刻配出来，直接复制下面这段精华版的prompt，在Claude Code里输入/statusline粘贴：

Create an OS-agnostic status line. Put the script and settings.json config in the user's Claude config dir. Pick whatever scripting language is reliably available on this machine (POSIX shell, or Python/Node if shell tooling isn't guaranteed) — don't assume bash or jq. The script reads the status JSON from stdin. Output two lines:
Line 1: [model.id] cwd branch* | Xk
Line 2: duration $cost
Model ID in square brackets, basename of .workspace.current_dir, git branch (omit if not a git repo, append * if dirty), token usage from .context_window.total_input_tokens rounded down to nearest 1000 with k suffix. Color token count on gradient toward 150k: green <25%, yellow <50%, orange <75%, red >=75% (ANSI 46/226/208/196). Base text bright white.
Session duration from .cost.total_duration_ms formatted Hh Mm / Mm Ss / Ss. Cost from .cost.total_cost_usd formatted $0.00. Same bright-white base. Guard every field access with a default. Make script executable per OS conventions.

等它生成完，别忘了给脚本chmod。下次打开Claude Code，输入框下面就会挂上这条彩色状态栏。