用 context-bar.sh 定制 Claude Code 状态行:实时监控模型、Git 状态与上下文用量

发布时间:2026/10/9 4:49:45

用 context-bar.sh 定制 Claude Code 状态行:实时监控模型、Git 状态与上下文用量 AI 技能教程开发工具【免费下载链接】claude-code-tips45 tips for getting the most out of Claude Code, from basics to advanced - includes a custom status line script and Claude Code running itself in a container. Also includes the dx plugin: skills for everyday dev workflows.项目地址https://gitcode.com/gh_mirrors/cl/claude-code-tips点击查看免费下载状态行status line是 Claude Code 界面底部的一行信息栏本仓库claude-code-tips提供了开箱即用的 Bash 脚本 scripts/context-bar.sh用两行文本把你最关心的会话信息一屏呈现当前模型、工作目录、Git 分支、未提交文件数、与远端同步状态、上下文窗口使用率以及你的最后一条消息。读完本文你将掌握状态行的安装配置、10 种颜色主题切换、底层 JSON 元数据解析原理以及脚本如何基于会话 transcript 精确估算 token 用量——还能借助仓库自带的 scripts/setup.sh 一键完成全套配置。状态行能展示什么在原文档示例中状态行输出为两行Opus 4.5 | claude-code-tips | main (scripts/context-bar.sh uncommitted, synced 12m ago) | ██░░░░░░░░ 18% of 200k tokens This is good. I dont think we need to change the documentation as long as we dont say that the default color is orange el...第一行从左到右依次是模型名Opus 4.5取自会话元数据中的model.display_name当前目录claude-code-tips即cwd的 basename让你在多个终端标签页之间快速辨认正在操作哪个项目Git 状态main (scripts/context-bar.sh uncommitted, synced 12m ago)分支名、未提交文件数以及与 upstream 的同步情况synced、N ahead、N behind、no upstream只有 1 个未提交文件时还会直接显示文件名上下文进度条██░░░░░░░░ 18% of 200k tokens10 格宽的视觉条 百分比 上下文窗口总量超过 100 万 token 自动换算为1M显示。第二行的显示会话中你最近一条有实质内容的用户消息自动过滤掉工具结果、被中断的消息和空消息方便在长时间离开后一眼回想起这个会话在做什么。安装两步搞定第一步把脚本复制到 Claude 的脚本目录mkdir -p ~/.claude/scripts cp context-bar.sh ~/.claude/scripts/ chmod x ~/.claude/scripts/context-bar.sh第二步在 settings.json 中注册状态行编辑~/.claude/settings.json{ statusLine: { type: command, command: ~/.claude/scripts/context-bar.sh } }保存后重启 Claude Code或新开会话状态行即生效。type: command告诉 Claude Code 通过执行外部命令的方式渲染状态行而command字段指向脚本路径。如果你不想手动编辑 JSON也可以直接运行仓库的 scripts/setup.sh它会检测settings.json中是否已有statusLine键若没有则自动用jq写入完全相同的配置见 scripts/setup.sh同时把context-bar.sh复制到~/.claude/scripts/并chmod x。脚本支持交互式跳过指定编号的配置项例如输入2即可跳过状态行安装。切换颜色主题脚本支持 10 种可选颜色主题通过修改脚本顶部的COLOR变量实现# Color theme: gray, orange, blue, teal, green, lavender, rose, gold, slate, cyan COLORorange从源码scripts/context-bar.sh可以看到每种主题对应一个固定的 256 色 ANSI 前景色码橙色38;5;173、蓝色38;5;74、青色38;5;37、绿色38;5;71、金色38;5;136等。gray是特例——所有强调色统一使用默认文本灰38;5;245未知值会回退到灰色。主题色只作用于模型名、目录 emoji、进度条实心部分其余文字保持统一的灰色确保可读性。动手前可以运行仓库自带的预览脚本一次性查看全部主题的渲染效果bash scripts/color-preview.sh预览脚本scripts/color-preview.sh用与context-bar.sh完全相同的颜色码构造了示例输出你可以据此挑选最顺眼的主题再改配置。环境要求jq必需用于解析 Claude Code 传入的 JSON 会话元数据和 JSONL 格式的会话 transcriptbash脚本为纯 Bash 实现git可选仅在需要显示分支、未提交文件和同步状态时使用目录不在 Git 仓库中时脚本会跳过 Git 段Claude Code 2.0.65原文档标注该版本已验证可用更早版本可能缺少脚本依赖的 JSON 字段可参考仓库早期 commit 中的旧版脚本。工作原理状态行命令如何拿到会话数据Claude Code 会通过stdin以 JSON 形式向状态行命令注入当前会话的元数据。脚本用jq逐个提取这些字段scripts/context-bar.sh字段含义脚本用途model.display_name模型显示名缺省回退到model.id第一列模型名cwd当前工作目录取 basename 显示目录名context_window.total_input_tokens已用输入 token脚本实际改用 transcript 计算见下节context_window.total_output_tokens已用输出 token同上context_window.context_window_size上下文窗口总大小计算百分比与显示总量默认 200000transcript_path会话 transcript JSONL 文件路径上下文精确计算与最后一条消息提取关键设计上下文用量从 transcript 算而非元数据一个值得注意的实现细节是尽管元数据提供了total_input_tokens和total_output_tokens但脚本有意改用 transcript 计算上下文用量。源码注释给出了原因scripts/context-bar.shtotal_input_tokens不含系统提示、工具定义和 memory 等固定开销用它做百分比会明显偏低而 transcript 中每条 assistant 消息的usage字段携带了真实的input_tokens、cache_read_input_tokens与cache_creation_input_tokens。脚本用一条jq -s管道取最后一条带usage的 assistant 消息排除侧链isSidechain ! true和 API 错误消息isApiErrorMessage ! true把三类 token 求和作为当前上下文长度scripts/context-bar.sh。此外脚本引入了一个20,000 token 的基线常量系统提示约 3k、工具约 15k、memory 约 300加上 git 状态、环境块、XML 框架等动态上下文约 2k。会话刚起步、transcript 尚无可统计消息时进度条显示为~前缀的估算值如~10%一旦拿到真实 usage 就切换到精确值两种情况下百分比都被钳制在 100% 以内。进度条与消息行的渲染进度条共 10 格每格代表 10 个百分点进度 ≥80% 的格子填实心块█≥30% 的格子填半块▄其余填空░scripts/context-bar.sh。最后一条消息行的提取同样走 transcript按type user筛选、逆序取最近一条跳过以[Request interrupted/[Request cancelled开头或内容为空的条目折叠换行与连续空格再按第一行可见长度截断并追加...scripts/context-bar.sh。与 /context 的关系脚本给出的百分比是估算值。需要逐项精确的 token 明细输入、输出、缓存分别多少时直接在会话里运行/context即可两者配合使用状态行负责日常巡检/context负责精确审计。延伸把监控上下文做成自动化状态行脚本的上下文估算逻辑在仓库中还有两个衍生用途scripts/check-context.sh以 Hook 形式挂在Stop事件上用同一套 transcript 统计方法计算用量超过 85% 时返回{decision: block, ...}阻止 Claude 停止并引导其执行/half-clone把长会话的后半段克隆到新会话继续。它同样排除isSidechain与 API 错误消息避免无限循环通过检查stop_hook_active。setup.sh 的配套设置为了让 half-clone 能读取会话记录setup.sh 还会向settings.json的permissions.allow追加Read(~/.claude)和Read(//tmp/**)并写入env.DISABLE_AUTOUPDATER、env.ENABLE_TOOL_SEARCH等推荐项scripts/setup.sh——如果你想以最小改动只装状态行手动编辑 settings.json 即可无需运行整套 setup。小结context-bar.sh 用约 200 行 Bash 实现了一个信息密度很高的双行状态行模型、目录、Git 状态一目了然上下文用量通过 transcript 精确统计而非依赖可能有偏差的元数据字段还内置了 10 色主题与可读性优化。安装只需复制脚本 注册statusLine两步也可以交给 setup.sh 一键完成。把它和/context、check-context.shHook 组合使用就能形成一套监控 → 精确审计 → 超限自动转移的完整上下文管理闭环让长会话始终保持在可控的 token 预算内。相关文件速查scripts/context-bar.sh主脚本、scripts/color-preview.sh主题预览、scripts/setup.sh一键安装、scripts/check-context.sh超限 Hook、scripts/README.md原文档。赞分享AI 技能教程开发工具【免费下载链接】claude-code-tips45 tips for getting the most out of Claude Code, from basics to advanced - includes a custom status line script and Claude Code running itself in a container. Also includes the dx plugin: skills for everyday dev workflows.项目地址https://gitcode.com/gh_mirrors/cl/claude-code-tips点击查看免费下载相关推荐Claude Code Router状态监控实时状态显示与健康检查Claude Code Router状态监控实时状态显示与健康检查 ? 痛点与承诺 还在为Claude Code Router的运行状态而烦恼不知道服务是否后端API网关LLM 网关大模型react-slingshot 大型应用状态监控实时状态追踪工具react slingshot 大型应用状态监控实时状态追踪工具 在大型React应用开发中状态管理复杂度随着业务增长呈指数级上升。开发者常常面临状态变更不前端示例工程Claude HUD 完全指南为 Claude Code 打造实时上下文、工具与 Agent 状态栏Claude HUD 完全指南为 Claude Code 打造实时上下文、工具与 Agent 状态栏 Claude HUD 是一个 Claude Code 插AI 插件开发工具上一篇3个技巧让触控板效率翻倍MiddleClick-Sonoma完整指南下一篇VLAC具身智能新突破机器人真实世界学习效率提升300%创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/10/9 5:54:48

运算符重载实战:从底层原理到Python/C++核心实现与避坑指南

1. 从“为什么需要”说起:运算逻辑不该是函数的一堆剪不断理还乱的调用我第一次意识到运算符重载的价值,是在写一个三维向量库的时候。那会儿刚工作不久,心气高,觉得自己能把所有东西都用函数搞定。结果就写出来addVectors(scaleV…

2026/10/9 5:54:48

《嵌入式操作系统》_驱动开发_misc类设备与蜂鸣器_20261008

misc 类设备(杂项设备 / Miscellaneous Device)Linux 把所有无法归入标准大类、功能简单、零散小众的硬件统一收纳到 misc 框架下,共用固定主设备号 10(MISC_MAJOR),靠不同次设备号区分每个独立设备。适用场…

2026/10/9 5:49:48

WDM鼠标驱动开发实战:从源码解析到IRP数据过滤与签名安装

简介:这份资源是面向Windows底层驱动开发学习者的WDM鼠标驱动源代码包,适合已具备C/C基础、希望理解设备驱动模型与HID设备交互机制的开发者参考。压缩包共13个文件,约12KB,以4个h头文件、2个cpp实现文件为主,另有rc资…

2026/10/8 10:03:18

Jev+Agent接管浏览器:browser-use实战与jev-ultrafast性能优化

1. 从“Jev”说起:为什么我要把Agent接进浏览器“Jev”这个词最近在圈子里出现的频率越来越高,很多人第一次听到会以为是某个新模型的名字,其实它更像是一种思路——把Jev模型的能力当作底座,通过Agent的方式去接管浏览器&#xf…

2026/10/8 10:03:20

多智能体集群实战:DeepAgents编排、MCP与A2A协议及Skills体系

1. 从"单兵作战"到"集群协同":多智能体编排到底在解决什么问题如果你最近在折腾 Agent 相关的东西,大概率会有一种感觉:单个 Agent 能做的事情,其实很快就摸到天花板了。你给它一个提示词,挂几个工…

2026/10/8 6:05:44

无源低通滤波器设计实战:从RC到LC,手把手教你避开那些坑

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/9 0:04:27

毕业论文初稿完成后首次进行AIGC疑似度自查的摸底与分流策略

毕业论文初稿完成后首次进行AIGC疑似度自查的摸底与分流策略当数万字的学位论文初稿经历开题、实验、问卷与多轮文献梳理最终成形时,绝大多数研究生都会面临一道全新的形式审查关卡:AIGC 疑似度排查。在高校毕业审核流程中,盲审前的文本检测通…

2026/10/9 0:04:27

食堂节能改造源头工厂,商用厨房设备焕新方案广受好评

商用厨房作为餐饮经营、单位供餐的核心后勤阵地,其设备配置、动线规划与运维体系直接决定后厨作业效率、运营成本与合规性。从基础的灶具、制冷存储设备,到油烟净化、水处理等配套系统,每一个环节的合理性都与食品安全、能耗管控、消防安全挂…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑