凌晨两点,你正在和 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,输出两行
开源地址
- Gitee: gitee.com/github-2430…
- GitHub: github.com/ovensi/mini…
觉得好用的话,点个 Star ⭐️ 吧!
写在最后
说实话,凌晨被 Token 用完打断这种事,一次就够了。
这个插件没有多高大上,就是解决一个真实痛点。如果你也在用 MiniMax API 做开发,应该会和我一样觉得实用。
代码开源,有问题提 Issue,一起让工具更好用!
相关链接: