核心用法
Claude Usage Checker 是一个专为 Claude Code CLI 用户设计的用量查询工具。用户只需简单询问用量、配额或剩余额度，系统即自动通过 PTY 终端与 Claude CLI 交互，执行 /usage 命令获取实时数据。
执行流程：
1. 启动 Claude CLI 并建立 PTY 会话
2. 等待欢迎界面加载完成
3. 发送 /usage 指令
4. 轮询读取用量数据输出
5. 安全退出会话
6. 格式化结果为用户友好的表格
输出格式：包含当前会话用量、全模型周度配额、Sonnet 专属周度配额及额外付费额度的完整表格，所有重置时间统一转换为 HH:MM 格式。
显著优点
- 零配置查询：无需手动操作 CLI，对话中直接获取用量
- 结构化呈现：表格化输出比原始 CLI 输出更易读
- 完整覆盖：涵盖免费层与付费层的全部配额维度
- 智能容错：内置登录状态检测，引导未登录用户完成认证
潜在缺点与局限性
- 依赖本地 CLI：要求用户本地已安装并登录 Claude Code
- PTY 交互延迟：CLI 启动较慢，需多次轮询等待
- 无历史趋势：仅展示当前快照，无法追踪用量变化曲线
- 时区处理：依赖 CLI 输出的本地时间，可能存在歧义
适合人群
- 高频使用 Claude Code/Claude Max 的开发者
- 需要监控团队配额的管理员
- 接近用量上限、担心服务中断的用户
常规风险
- 会话状态依赖：若 CLI 进程异常退出，可能导致查询失败
- 输出解析脆弱性：CLI 界面更新可能破坏正则解析逻辑
- 认证信息暴露：PTY 会话中可能短暂显示敏感信息
该工具属于辅助查询类技能，本身不直接操作生产数据，风险可控。