什么是 Claude 使用量计算器？

Claude 使用量计算器是一款技术型实用工具，旨在提高 Claude Max 订阅额度消耗的透明度。通过分析会话数据，它为开发者和高级用户提供详细的信用额度消耗视图，对比每周预算和 5 小时滑动窗口，确保您在使用 Openclaw Skills 时永远不会触发意外的速率限制。

该工具对于管理成本和优化不同 Claude 模型（如 Opus、Sonnet 和 Haiku）的会话长度至关重要。它填补了原始会话日志与可操作的订阅管理之间的空白，为您的剩余资源提供清晰的可视化呈现。

下载入口:https://github.com/openclaw/skills/tree/main/skills/lemodigital/claude-usage

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Claude 使用量计算器 应用场景

• 在高强度开发阶段监控额度消耗。
• 检查特定 Claude 订阅计划的剩余每周预算。
• 识别哪些特定会话或模型消耗了最多资源。
• 通过检查使用窗口避免 5 小时速率限制导致的降速。
• 审计令牌使用情况，包括输入、输出和缓存写入。

1. 该技能访问位于 agent 目录下的本地会话 JSONL 文件。
2. 它解析指定时间范围内每次交互的输入、输出和缓存写入的令牌数据。
3. 额度使用特定模型的公式计算，该公式对不同令牌类型进行加权，同时将缓存读取视为免费。
4. 脚本将总使用量与用户的特定计划（Pro、5x 或 20x）以及每周重置计划进行对比。
5. 生成一份全面的报告，显示每周预算的进度条以及 5 小时滑动速率限制窗口的警告。

Claude 使用量计算器 配置指南

要开始使用 Openclaw Skills 追踪您的使用情况，您首先需要从 Claude 账户设置中确定您的每周重置时间和计划等级。运行以下命令以保存您的配置：

python3 {SKILL_DIR}/scripts/claude-usage.py "2026-02-09 14:00" --plan 5x --save

请确保您已安装 Python 3.9+，并且您的会话文件位于默认目录 ~/.openclaw/agents/main/sessions/。

Claude 使用量计算器 数据架构与分类体系

该技能通过读取 JSONL 会话文件并应用以下每个模型的信用率来组织数据：

它使用以下公式计算总消耗：credits = (input_tokens + cache_write_tokens) * input_rate + output_tokens * output_rate。系统还会追踪特定计划的阈值，例如 Pro 计划的 550,000 额度限制，以及 20x 计划的 11,000,000 额度限制。

name: claude-usage
description: Calculate Claude Max subscription usage from OpenClaw session data. Shows credits consumed, weekly budget percentage, 5-hour rate limit window, and per-session breakdown.

Claude Max Usage Calculator

Track your Claude Max subscription usage based on the reverse-engineered credits system from she-llac.com/claude-limits.

When to use

When the user asks about Claude usage, credits, subscription consumption, rate limits, or wants to know how much budget is left.

Setup (first time)

Ask the user for:

1. Weekly reset time — visible on claude.ai Settings > Usage (e.g. "Resets Mon 2:00 PM")
2. Plan — pro ($20), 5x ($100), or 20x ($200). Default: 5x

Save it so they never have to repeat:

python3 {SKILL_DIR}/scripts/claude-usage.py "2026-02-09 14:00" --plan 5x --save

Commands

# Weekly overview (uses saved config after first --save)
python3 {SKILL_DIR}/scripts/claude-usage.py

# Override plan or timezone
python3 {SKILL_DIR}/scripts/claude-usage.py --plan 20x --tz "America/New_York"

# Top N sessions only
python3 {SKILL_DIR}/scripts/claude-usage.py --top 5

# Single session detail (substring match on key or id)
python3 {SKILL_DIR}/scripts/claude-usage.py --session "main"
python3 {SKILL_DIR}/scripts/claude-usage.py --session "9aadee"

# JSON output
python3 {SKILL_DIR}/scripts/claude-usage.py --json

What it shows

Weekly overview

• Total credits used vs weekly budget (with progress bar)
• 5-hour sliding window — warns if approaching the per-5h rate limit
• All sessions ranked by credits consumed
• Model breakdown (Opus/Sonnet/Haiku/non-Claude)

Single session detail (--session)

• Credits consumed and % of weekly budget
• % of total usage (how much of your spending this session accounts for)
• Token breakdown (input/output/cache)
• Per-model detail

Credits formula

credits = (input_tokens + cache_write_tokens) × input_rate + output_tokens × output_rate

Cache reads are free. Non-Claude models (Gemini, Codex, etc.) don't consume Claude credits.

Plan budgets

Requirements

• Python 3.9+
• OpenClaw with session JSONL files (auto-detected at ~/.openclaw/agents/main/sessions/)