Claude用量查询

技能简介

该技能用于查询Claude CodeOAuth API的用量限额，包括5小时会话窗口和7天周窗口两种限流指标。通过系统钥匙链获取凭证，调用Anthropic官方接口获取实时用量数据，并以可视化进度条或JSON格式展示。

能做什么

• 实时监控会话级（5小时）和周级（7天）用量占比
• 显示距离限额重置的剩余时间
• 智能缓存避免频繁调用API
• 支持强制刷新获取最新数据
• 输出机器可读的JSON格式
• 自动设置会话刷新提醒

使用说明

安装准备

需先完成Claude Code CLI的OAuth认证，确保系统已存储有效凭证：

• macOS：使用Keychain存储
• Linux：使用secret-tool存储

依赖工具：curl

基础用法

# 默认显示缓存数据（60秒内）
./scripts/claude-usage.sh

# 强制从API刷新
./scripts/claude-usage.sh --fresh

# JSON格式输出
./scripts/claude-usage.sh --json

# 自定义缓存时间（秒）
./scripts/claude-usage.sh --cache-ttl 300

设置自动提醒

# 会话刷新提醒（推荐）
./scripts/session-reminder.sh

# 用量监控（每30分钟检测）
./scripts/setup-monitoring.sh

输入与输出

见下方输入与输出表格。

风险提示

• 需提前完成Claude Code CLI认证，否则无法获取凭证
• 缓存机制可能导致数据延迟，关键决策前建议使用–fresh
• 自动提醒功能依赖cron，需确保系统cron服务正常运行
• 频繁强制刷新可能触发API限流

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/azaidi94/claude-code-usage/SKILL.md
来源类型：GitHub仓库