Cockpit for Claude Code Vibe 项目

项目简介

Cockpit 是一个面向 Claude Code 的实时仪表盘插件（mod），在会话转录文本旁挂出一列面板，让开发者不离开终端就能看清当前这一轮到底在烧多少上下文、多少额度、多少钱，以及子代理和工具都在做什么。面板覆盖上下文占用、限流窗口、费用、子代理、工具调用、文件变更与测试运行，区块均可点开看明细；同时内置守护机制，遇到删除目录、强制推送、修改环境文件这类高危命令时先询问再执行。

核心功能

• 上下文面板：填充进度条与词元数、构成明细（记忆文件、外部数据源、体积最大的工具输出），超过七成时提供一键压缩入口。
• 限流与节奏：五小时窗口、七天窗口的占用率与重置倒计时，并推算窗口何时被填满。
• 费用面板：本轮与累计花费、每小时消耗、缓存命中率、提示词缓存倒计时，并按模型拆分词元与单轮成本。
• 子代理与工具：每个子代理的状态、步数、词元消耗、工具配比与行动时间线；工具侧统计调用次数、错误数、平均与最慢耗时。
• 变更与测试：列出相对版本库头部的改动文件与增删行数，可直接打开差异视图；保存最近六次测试运行的通过与失败计数。
• 风险守护与告警：拦截高危命令并记录放行日志，检测子代理空转循环与上下文压缩事件，全部按时间排列。
• 实时状态行：窄环境下在提示词上方以两行数字带、下方以状态行呈现，例如上下文占用、窗口余量与已花费金额。

技术实现

Cockpit 以插件形式实现，安装后在 Claude Code 会话旁加载独立面板，不改动会话本身：宽终端自动展开完整面板，空间不足时退化为提示词上方的两行实时数字带，保证任何布局都能看到关键指标。数据来自 Claude Code 运行时暴露的会话与插件接口，面板订阅上下文占用、限流窗口、工具调用与文件变更事件，按区块聚合后渲染，点击任一区块可下钻到明细，例如某个工具的最近调用与错误信息、某个文件的完整差异。守护功能采用命令模式匹配加确认交互，在命令真正执行前弹出询问并把结果写入日志，同时提供拦截与放行的可查记录。分发走插件市场机制，可在会话内添加市场并安装，也可从普通终端用命令行完成同一套配置；项目在 macOS 上完成主要测试，并兼容桌面应用的代码标签页。各区块独立渲染，单个区块异常不会拖垮整个会话；另内置演示模式，可在长会话开始前先把数字填满，方便理解每块含义，正式使用时一键关闭即回到真实数据。

快速上手

1. 在 Claude Code 中执行 /plugin marketplace add drkokorev/cockpit-for-claude，把项目加为插件市场。
2. 接着执行 /plugin install cockpit@cockpit-for-claude 完成安装。
3. 也可以在普通终端里运行 claude plugin marketplace add drkokorev/cockpit-for-claude 与 claude plugin install cockpit@cockpit-for-claude 两条命令完成同样配置。
4. 宽终端下面板会自动打开，其他环境输入 /cockpit 唤出；先执行 /cockpit-demo 查看每个区块的示例数据，正式使用时执行 /cockpit-demo off 切回真实数字。

适用人群：长时间使用 Claude Code 的开发者、并行调度多个子代理的工程团队、关心词元与费用消耗的技术负责人，以及希望在执行前拦住高危命令的运维与安全人员。