我给 Claude Code 装了一块"仪表盘"

如果你也用 Claude Code 写代码，大概碰到过这几种时刻：

• 正写到一半，突然提示额度用完，要等好几个小时；
• 让它做一个大改动，去倒杯水回来，不知道它做到第几步了；
• 聊着聊着回答开始变迟钝，后来才发现上下文早就塞满了。

这些信息其实一直都在，只是看不见。要么切到终端敲命令查，要么全凭感觉。于是我做了一个小插件，叫 Claude Code Panel。装上以后，侧边栏多一块面板，底部状态栏多一行字，该看的东西一眼就能看到。

一行字，看懂现在的状态

最常看的是底部状态栏这一行。从左到右分别是：

• 5h 38%：5 小时额度用了多少；
• 周 24%：这一周的额度用了多少；
• 63%：当前任务走到了哪一步；
• 正在执行命令：此刻 Claude 在干什么，比如思考、改文件、跑命令。

额度快到头时，这一行会自动变黄；快用完时变红。不用刻意盯着，余光就能看到。

三个标签页，各管一件事

点开面板，有三个标签页。

总览：额度、当前会话、正在进行的任务，平时看这一页就够了。额度条上那道细虚线是「匀速线」，表示如果你均匀地用，此刻应该用到哪里。绿条跑到虚线前面，说明用得有点快了。

任务：每个任务一张卡片，列出全部步骤，哪步做完了、哪步正在做，一目了然。每张卡片都写着它属于哪个会话，同时开好几个窗口也不会搞混。任务清单直接来自 Claude Code 自带的待办功能，不用另外设置。

会话：用的什么模型、上下文占了多少、这次对话一共产出多少 token、调用了哪些工具、派出去的子 agent 还在不在干活。

我比较在意的几个设计

不装任何东西，只读本地文件

Claude Code 本来就会把每次对话完整地记在你电脑的 ~/.claude/projects 文件夹里。面板做的事很简单：每隔几秒读一下这些文件，把有用的信息整理出来。

所以它不需要你改任何配置，也不会往 Claude Code 里塞任何东西。没有统计，没有遥测，你的对话内容不会离开你的电脑。

额度数据，先问你再联网

额度是唯一可能需要联网的地方。插件第一次打开时会先问你：额度数字从哪里来？可以读一个本地文件，也可以授权它去 Anthropic 的额度接口查。你不点头，它就不联网。

这一点是我踩过坑才坚持的。我自己有个每分钟查一次额度的小脚本，结果一个月里被接口限流了几百次。所以这个插件就算联网，默认也是五分钟才问一次，被限流了会自动退后、拉长间隔。

进度只说"走到第几步"，不画大饼

任务进度的算法很朴素：做完的步骤算 1，正在做的算 0.5，再除以总步数。

它只告诉你「走到第几步了」，不预测「还要多久」。如果做到一半发现要多做两步，百分比会如实往下掉。我宁可它诚实，也不要一个永远卡在 99% 的进度条。

窄也能看，宽也能看

侧边栏拉窄，它会自动收起次要信息，只留最关键的几样；拉宽或者拖到编辑区，会自动分成两栏、三栏。深色、浅色主题跟着编辑器走，界面语言也跟着编辑器，支持中文和英文。

怎么安装

1. 打开 GitHub 发布页，下载 claude-code-panel-0.1.0.vsix：github.com/karin-lin/claude-code-panel/releases
2. 在终端运行下面其中一行，用 VS Code 选第一行，用 Cursor 选第二行：

code --install-extension claude-code-panel-0.1.0.vsix
cursor --install-extension claude-code-panel-0.1.0.vsix

3. 重新加载编辑器窗口。左侧活动栏会多出一个仪表盘图标，底部状态栏会多出一行字。

不想用命令行的话，也可以在编辑器的扩展面板里点右上角的 ...，选「从 VSIX 安装」。

想按自己的习惯改？

插件留了几个口子，不用改代码就能适配：

• 自己的额度线：比如想在 5 小时额度用到 65% 就收手，可以设一条自己的线。额度条上会画出来，还会显示离线还有几个点。
• 自己的额度来源：任何脚本只要按约定格式写一个小文件，面板就能读。
• 自己的任务进度：任何工具都能写一个进度文件，面板会把它挂到对应的会话下面。

具体格式写在项目的 自定义说明 里。

已知的局限

• 它读的是 Claude Code 本地会话记录的格式，这不是官方承诺稳定的接口。Claude Code 以后更新，可能会让某些功能暂时失灵，我会跟着修。
• 有些版本的 Claude Code 不一定会列待办清单，这时任务页会空着，可以改用自己的进度文件。
• 「可能在等你确认」这个提示是猜的：一个工具调用卡住超过 30 秒，看起来和一条很慢的命令是一样的。
• 我在 macOS 加 Cursor 上测得最多，VS Code、Windows、Linux 测得少一些。遇到问题欢迎到 GitHub 提 issue。

最后

这是我的第一个开源小工具，MIT 协议，免费随便用。源码、安装包和英文说明都在 GitHub：

github.com/karin-lin/claude-code-panel

如果你也每天和 Claude Code 一起写代码，希望它能让你少遇到几次「咦，额度怎么没了」。