肝了一个插件!Claude Code 实时显示 MiniMax Token 用量,告别「额度何时跑完」的焦虑

34 阅读2分钟

凌晨两点,你正在和 Claude 激情对线调 Bug ——

突然弹窗:「当前 Token 已用完,请购买套餐」

那一刻,心态直接爆炸 💥


这不是我编的,是真实经历。用 MiniMax 的 API 做了半个月开发,几乎每周都要被这破事打断一次。

所以我肝了一个 Claude Code 插件,让 Token 用量直接显示在屏幕底部。


先看效果

[claude-hud] Working on Task #42...
Model: MiniMax-M* | Used: 420/600 [======    ] 70% | Resets in: 2h 15m

一眼就知道:

  • 当前额度还剩 30%
  • 距离重置还有 2 小时 15 分
  • 模型是 MiniMax-M* 的套餐

70% 了!代码写得更快点! 💪


这个插件能干啥?

1. HUD 状态栏(最实用的功能)

在 Claude Code 底部实时显示

  • ✅ 当前模型
  • ✅ 已用量 / 总量
  • ✅ 进度条 + 百分比
  • ✅ 下次重置倒计时

和 claude-hud 和平共处,上下两行,互不干扰:

[claude-hud] Initializing...
Model: MiniMax-M* | Used: 420/600 [======    ] 70% | Resets in: 2h 15m

2. Claude Code 命令

输入 /minimax-usage,查看详细用量:

================================
    Minimax Account Usage
================================

Model: MiniMax-M*
--------------------------------
  Period:         2026/04/10 15:00 to 2026/04/10 20:00
  Quota:          600 requests
  Used:           42 requests (7.0%)
  Remaining:      558 requests
  Resets In:      4h 42m

================================
Query Time: 2026/04/10 15:30
================================

3. MCP 服务器

如果你有自己的 MCP 客户端,还能调用 minimax_query_usage 工具。


安装教程(3 分钟搞定)

1. 克隆插件

git clone https://gitee.com/github-24306930/minimax-usage.git ~/.claude/plugins/minimax-usage
# 或 GitHub
git clone https://github.com/ovensi/minimax-usage.git ~/.claude/plugins/minimax-usage

2. 设置环境变量

export MINIMAX_API_KEY='你的MiniMax_API_Key'

3. 安装依赖并编译

cd ~/.claude/plugins/minimax-usage
npm install
npm run build

4. 配置 HUD(可选)

编辑 ~/.claude/settings.json,修改 statusLine.command 指向插件的 combined-hud.sh 脚本。


技术实现

TypeScript + MCP 协议 + Claude Code 插件系统,核心代码 200 行不到

minimax-usage/
├── manifest.json      # 插件声明
├── scripts/
│   ├── mcp-server.ts # MCP 服务器
│   ├── hud.ts         # HUD 渲染器
│   └── hud-cli.ts     # CLI 入口
├── tools/
│   └── minimax-usage.ts
└── dist/              # 编译输出

MCP 服务器 通过 JSON-RPC 与 Claude Code 通信
HUD 渲染器 调用 MiniMax API 查询用量,格式化输出
组合脚本 同时跑 claude-hud 和 minimax-usage,输出两行


开源地址

觉得好用的话,点个 Star ⭐️ 吧!


写在最后

说实话,凌晨被 Token 用完打断这种事,一次就够了。

这个插件没有多高大上,就是解决一个真实痛点。如果你也在用 MiniMax API 做开发,应该会和我一样觉得实用。

代码开源,有问题提 Issue,一起让工具更好用!


相关链接: