状态栏最实用的价值，并非把终端底部塞得满满当当，而是让你一眼就能掌握模型名称、项目目录、上下文占用比例以及 Git 状态等关键信息。Claude Code 会将当前会话的所有数据打包为 JSON，传递给一条本地命令，随后将该命令的标准输出直接显示在输入框下方。
动手之前，请先确认两件事：一是 Claude Code 能够正常进入项目会话，二是你已经同意了当前工作目录的信任提示。macOS 和 Linux 的示例通常使用 Bash；Windows 用户如果安装了 Git Bash 就优先使用它，否则可以用 PowerShell。如果脚本需要解析 JSON，可以使用 jq，换成 Python 或 Node.js 也完全可行。另外请注意，状态栏命令在本地执行，不会消耗任何 API 令牌。
先用 /statusline 生成一个基础状态栏
在哪操作：直接在 Claude Code 会话的输入框里输入即可。具体做啥：输入 /statusline，然后用自然语言说明你想显示哪些字段，比如模型名称、当前目录、上下文百分比等；如果弹出文件写入授权提示，请先核对目标路径是否为你自己的 Claude 配置目录，确认无误后再同意。怎么算成了：等你下一次与 Claude Code 交互之后，输入框下方会多出一行独立的显示区域，能够看到模型、项目目录以及上下文比例，这样就成功了。出问题咋整：如果命令执行完毕仍未看到状态栏，请先确认你已经同意了工作区信任，再检查生成的脚本单独运行时能否输出内容，同时查看设置里是否开启了关闭全部 Hook 的选项。
这张图里重点不是提示符，而是它下方独立的那一行：模型名、项目目录和上下文百分比都清晰展示出来，说明 Claude Code 已经读取到状态栏配置，并且成功执行了本地命令。
手动配置脚本和 settings.json
让脚本能够读取会话 JSON
在哪操作：你个人 Claude 配置目录中的状态栏脚本文件。具体做啥：新建一个脚本，从标准输入读取完整的 JSON 数据，然后提取 model.display_name、workspace.current_dir 和 context_window.used_percentage 这几个字段，最后用一条输出语句打印结果即可；如果使用 macOS 或 Linux，记得为脚本添加可执行权限。怎么算成了：向脚本传入一份模拟 JSON，终端只输出一行干净的文本，没有调试日志也没有报错，就说明配置正确。出问题咋整：输出为空时，先检查字段路径是否正确、是否做了空值回退处理；提示权限不足时，重新确认可执行权限；Windows 路径中的反斜杠被吞掉时，可以换成正斜杠或者明确调用 PowerShell 来解决。
把脚本连接到状态栏上
在哪操作：个人设置文件或当前项目的设置文件均可。具体做啥：添加 statusLine 配置项，将类型设为 command，然后让 command 指向你刚才编写的脚本；如果需要额外缩进，可以增加 padding 设置，想要定时刷新则配置 refreshInterval。怎么算成了：保存设置后，再次发送消息进行交互，状态栏会自动刷新，无需重新安装 Claude Code。出问题咋整：界面没有更新时，先检查 JSON 语法是否正确、脚本的绝对路径是否准确，再直接运行一遍那条命令进行测试；注意不要将脚本的错误信息只写到标准错误流中，标准输出也要保留正常内容。
把上下文占用换成进度条
在哪操作：状态栏脚本中处理 context_window.used_percentage 的位置。具体做啥：将百分比换算成固定长度的填充块和空白块，末尾仍然保留原始百分比数值，颜色可以根据低、中、高三个区间进行切换。怎么算成了：输入框下方会出现长度固定的进度条，百分比发生变化后，进度条会在下一次状态更新时同步变化。出问题咋整：首次会话显示空值时，为字段添加零值回退即可；进度条长度不对时，先将小数转换为整数，再限制一下范围；颜色出现乱码时，可以暂时去掉 ANSI 转义序列，先用纯文本的进度条进行测试。
截图中的字符条和右侧的百分比表示的是同一个状态。为什么还要保留数字呢？因为字符宽度可能会受到终端字体的影响，百分比仍然能给你最明确的判断依据。
加上 Git 分支和变更数量
在哪操作：状态栏脚本读取完项目目录之后的位置。具体做啥：先判断当前目录是否为 Git 仓库，如果是，则读取当前分支名称、已暂存的文件数和未暂存的文件数；如果不在仓库中，则直接省略 Git 这部分内容。怎么算成了：进入 Git 项目后，状态栏能够显示分支名以及暂存、修改的数量；切换到普通目录时，也不会出现错误文本。出问题咋整：如果遇到大型仓库明显卡顿，不必每次刷新都执行完整的差异扫描，可以按会话 ID 建立一个短时缓存，将缓存有效期控制在几秒内即可。
图中分支名后面的两组数字，分别对应不同的变更状态。脚本需要做到当数据不存在时自动省略，不要把命令错误等信息挤到状态栏里。
显示会话估算成本和持续时间
在哪操作：脚本中处理 Claude Code 输入 JSON 里成本字段的位置。具体做啥：读取会话的估算成本和持续时间，将成本格式化为易读的小数位数，再把毫秒换算成分钟和秒。怎么算成了：状态栏能够同时显示金额和已用时长，开启新会话后数值会按新会话重新计算。出问题咋整：成本字段暂时为空时，使用零值或者先不显示；请注意，这里的客户端估算值不能替代最终账单，实际费用还是要以账户的计费记录为准。
金额和计时器适合用来观察单次会话的相对消耗。它们与模型名放在同一行即可，没有必要把更多低频字段都堆叠进来。
信息太多就拆成两行
在哪操作：脚本的最终输出区域。具体做啥：把项目相关的信息放在第一行，上下文、成本和时长放在第二行；每行各输出一次，输出的顺序就是界面上显示的顺序。怎么算成了：状态栏变成两行，第一行显示模型、目录和 Git 信息，第二行显示会话指标，即使是窄终端也能看清核心信息。出问题咋整：内容被截断时，先去掉装饰符号和低频字段，再根据 Claude Code 提供的终端列数调整输出；如果多行加颜色后出现错位，先退回单行纯文本测试是否正确。
这张图的层次特别清晰：第一行回答了“我正在哪个项目里工作”，第二行回答了“当前会话用了多少资源”。如果一眼看不出这两个层次，说明字段还需要进一步精简。
在支持的终端里加个仓库链接
在哪操作：状态栏脚本中读取 Git 远程仓库信息的位置。具体做啥：将仓库地址转换成终端支持的 OSC 8 超链接序列，状态栏里只显示仓库名称即可；macOS 用户按住 Command 键单击打开，Windows 和 Linux 用户按住 Control 键单击。怎么算成了：仓库名称显示为可点击的样式，按住对应的修饰键即可从终端打开仓库页面。出问题咋整：文字显示正常但无法点击时，先确认你的终端是否支持 OSC 8；如果系统自带的 Terminal.app 不支持此功能，这不是脚本的问题。如果远程会话或终端复用器里显示转义字符，可以换成能够可靠解释转义序列的输出方式，或者退回到普通的仓库名显示。
悬停提示中能够看到仓库地址，说明终端已经正确识别了链接序列。正文显示的内容仍然要保持简短，只保留仓库名即可。
完成检查清单
- Claude Code 能够正常进入项目会话，当前目录已经同意了工作区信任。
- 状态栏脚本可以独立读取模拟 JSON，并且只向标准输出写入需要显示的内容。
- 设置中的 statusLine 类型为 command，命令路径在当前系统中能够正常执行。
- 下一次交互后能够看到基础状态栏，模型、目录和上下文比例都与当前会话一致。
- Git、成本、时长、进度条或者多行输出，只保留真正需要的字段，窄终端下不会被严重截断。
- 遇到空值、卡顿、乱码或者链接无法点击的情况，已经分别检查了字段回退、缓存、纯文本输出和终端能力。
