MiniMax Claude Code 使用状态监控工具
npm install minimax-statusminimax status 查看状态
bash
npm install -g minimax-status
`
$3
`bash
npm update -g minimax-status
`
$3
`bash
minimax auth
`
配置信息将保存在 ~/.minimax-config.json 文件中。
获取令牌和组 ID:
1. 访问 MiniMax 开放平台
2. 登录并进入控制台
3. 账户信息中复制 groupID
4. Coding Plan 中创建或获取 API Key
$3
`bash
详细模式
minimax status
紧凑模式
minimax status --compact
持续监控模式
minimax status --watch
`
VSCode 扩展
提供 VSCode 扩展版本，支持在 VSCode 底部状态栏显示使用状态。
$3
方式一：下载 VSIX 文件
1. 访问 GitHub Releases
2. 下载最新的 .vsix 文件
3. 在 VSCode 中按 Ctrl+Shift+P
4. 输入 "Extensions: Install from VSIX..."
5. 选择下载的 VSIX 文件
方式二：从源码构建
`bash
git clone https://github.com/JochenYang/minimax-status.git
cd minimax-status/vscode-extension
npm install
npm run package
在 VSCode 中安装生成的 .vsix 文件
`
$3
1. 安装扩展后，点击状态栏的 "MiniMax 未配置" 按钮
2. 或使用命令 "MiniMax Status: 配置向导"
3. 输入您的 API Key 和 GroupID
4. 配置完成后，状态栏将显示实时使用状态
> 注意: 扩展尚未发布到 VSCode 市场，需要手动安装
Claude Code 集成
将 MiniMax 使用状态显示在 Claude Code 底部状态栏。
$3
1. 安装和配置工具:
`bash
npm install -g minimax-status
minimax auth
`
2. 配置 Claude Code:
编辑 ~/.claude/settings.json:
`json
{
"statusLine": {
"command": "minimax statusline"
}
}
`
3. 重启 Claude Code
集成成功后，底部状态栏将显示:
`
📁 my-app | 🤖 MiniMax-M2 | ⚡ 85% | 200K | ↻ 6%·4227/4500 | ⌛ 1h20m | 到期: 5天
`
显示格式：📁 目录 | 🤖 模型 | 上下文窗口 | ↻ 使用率·剩余次数/总数 | ⌛ 重置时间 | 到期时间
颜色说明:
- 到期时间: ≤3天红色 | ≤7天黄色 | >7天绿色
$3
状态栏会智能显示当前会话的上下文窗口使用情况：
- 有转录数据时: 显示 ⚡ 百分比 · 已用tokens/总容量
- 例如: ⚡ 85% | 200K 表示已使用 200K tokens，占容量的 85%
- 无转录数据时: 仅显示上下文窗口总容量
- 例如: 200K 表示当前模型的上下文窗口大小
智能特性:
- ✅ 自动解析 Claude Code 转录文件（transcript）
- ✅ 支持 Anthropic 和 OpenAI 两种 token 格式
- ✅ 正确计算缓存 tokens（cache creation + cache read）
- ✅ 跨会话查找：当前会话无数据时，自动从项目历史中查找
- ✅ 处理 summary 类型条目和 leafUuid 引用
注意: MiniMax 的配置独立存储在 ~/.minimax-config.json，与 Claude Code 的配置分离。
显示示例
$3
`
┌─────────────────────────────────────────────────────────────┐
│ MiniMax Claude Code 使用状态 │
│ │
│ 当前模型: MiniMax-M2 │
│ 时间窗口: 10:00-15:00(UTC+8) │
│ 剩余时间: 1 小时 26 分钟后重置 │
│ │
│ 已用额度: █████████████████████░░░░░░░░░ 27% │
│ 剩余: 3307/4500 次调用 │
│ │
│ 状态: ✓ 正常使用 │
└─────────────────────────────────────────────────────────────┘
`
$3
`
● MiniMax-M2 27% • 1 小时 26 分钟后重置 • ✓ 正常使用
`
$3
`
✓ MiniMax 状态栏已启动
按 Ctrl+C 退出
?25l● MiniMax-M2 27% • 3307/4500 • 1h26m ⚡
`
命令说明
| 命令 | 描述 | 示例 |
|----------------------|------------------------------------------|----------------------------------|
| minimax auth | 设置认证凭据 | minimax auth |
| minimax status | 显示当前使用状态（支持 --compact、--watch） | minimax status |
| minimax bar | 终端底部持续状态栏 | minimax bar |
| minimax statusline | Claude Code 状态栏集成 | 用于 Claude Code 配置 |
状态说明
$3
| 元素 | 图标 | 说明 |
|------|------|------|
| 目录 | 📁 | 当前工作目录 |
| 模型 | 🤖 | MiniMax 模型名称 |
| 上下文 | ⚡ | 上下文窗口使用率 |
| 使用量 | ↻ | 使用率·剩余次数/总数 |
| 重置 | ⌛ | 额度重置倒计时 |
| 到期 | - | 订阅到期时间（颜色动态变化） |
$3
| 场景 | 颜色 | 说明 |
|------|------|------|
| 使用率 < 60% | 绿色 | 正常使用 |
| 使用率 60-85% | 黄色 | 注意使用 |
| 使用率 ≥ 85% | 红色 | 危险状态 |
| 到期 ≤ 3天 | 红色 | 即将到期 |
| 到期 ≤ 7天 | 黄色 | 即将到期 |
| 到期 > 7天 | 绿色 | 订阅正常 |
配置文件
$3
- 独立配置文件: ~/.minimax-config.json
$3
`json
{
"token": "your_access_token_here",
"groupId": "your_group_id_here"
}
`
$3
Claude Code 只需要配置状态栏命令：
`json
// ~/.claude/settings.json
{
"statusLine": {
"command": "minimax statusline"
}
}
`
$3
凭据仅存储在本地，不会上传到任何服务器。
故障排除
$3
`bash
确保已全局安装
npm install -g minimax-status
重新打开终端
`
$3
`bash
检查令牌和组 ID
minimax status
重新设置认证
minimax auth
`
$3
1. 检查 Claude Code 配置
2. 重启 Claude Code
3. 手动测试: minimax statusline
开发
$3
`bash
git clone
cd minimax-status
npm install
`
$3
`bash
运行示例
node cli/example.js
测试 CLI 命令
node cli/index.js status
``