← 返回 Skills 市场

How Much Claude Left?

Name: How Much Claude Left?
Author: mfang0126

作者 mfang0126 · GitHub ↗ · v1.1.1

cross-platform ✓ 安全检测通过

318

总下载

当前安装

版本数

在 OpenClaw 中安装

/install claude-quota-checker

功能描述

Check how much Claude Max / Claude Pro subscription quota you have LEFT — not how much you spent. Most usage tools track API billing or token costs. This one...

使用说明 (SKILL.md)

Claude Quota Checker

How much Claude do you have LEFT?

Most tools tell you how much you spent. This one tells you how much you have remaining — the question that actually matters when you're working and worried about hitting limits.

Checks your Claude Max/Pro subscription quota by automating the /usage command via tmux. No API keys needed, no Admin keys, no complex setup.

How It Works

Creates a temporary tmux session with a scratch git repo
Launches Claude Code CLI
Handles the "trust this folder" prompt automatically
Sends /usage command
Captures and parses the output
Cleans up tmux session

Usage

bash ./scripts/check-usage.sh

Note: Run from the skill directory, or use the full path based on where you installed this skill. The script auto-detects its own location.

Output

Plan type: Pro or Max (e.g., "Opus 4.6 — Claude Max")
Session usage: current session % used
Weekly usage: all models % and Sonnet-only %
Reset time: when the weekly quota resets

Error Handling

Problem	Symptom	Fix
tmux not installed	`command not found: tmux`	`brew install tmux`
Claude CLI not in PATH	Session hangs	Install Claude Code CLI, ensure `claude` is in PATH
Auth expired	"Please log in" in output	Run `claude` manually and re-authenticate
Git not installed	Script fails at `git init`	`brew install git`

If the script hangs for >15 seconds, it likely means Claude CLI couldn't start. Kill with: tmux kill-session -t cu-*

Requirements

macOS or Linux
tmux installed
claude CLI in PATH
Active Claude Code authentication (Pro or Max subscription)
git installed (for scratch repo)

Performance

~8-10 seconds (bottleneck: Claude Code CLI startup time).

Limitations

Only checks subscription usage (Pro/Max), not API billing
Requires a running terminal environment (won't work in sandboxed containers)
Output parsing depends on Claude Code CLI's /usage format — may break if Anthropic changes the output layout

安全使用建议

This script appears to do exactly what it says: run your local 'claude' CLI in a temporary tmux session and parse the /usage output. Before running, verify you trust the 'claude' binary you have installed (it will use whatever local auth tokens exist and may perform network calls). You can review the short script (it's included) — it creates a temp directory, runs claude, captures output, and deletes the temp files. If you're cautious, run 'claude' manually to confirm behavior and authentication, or run the script in an isolated environment (VM/container) first. It will not send your system files or credentials anywhere on its own.

功能分析

Type: OpenClaw Skill Name: claude-quota-checker Version: 1.1.1 The skill is a utility designed to check Claude Pro/Max subscription quotas by automating the 'claude' CLI via tmux. The bash script (scripts/check-usage.sh) uses standard system tools (tmux, git, mktemp) to capture and parse usage statistics locally without any evidence of data exfiltration, persistence, or malicious execution.

能力评估

✓ Purpose & Capability

Name and description say it will check Claude subscription quota. The script only requires tmux, git, and the 'claude' CLI and uses them to run '/usage' in a temporary tmux session — exactly what you'd expect for this task.

ℹ Instruction Scope

SKILL.md directs running the included shell script. The script launches the local 'claude' CLI, handles the trust prompt, sends '/usage', captures output, and cleans up. This stays within the stated scope. Note: invoking the local 'claude' binary will cause that binary to perform network activity and use any auth it has — that's expected for querying subscription status but is an external dependency to trust.

✓ Install Mechanism

No install spec; instruction-only plus a small shell script. Nothing is downloaded or extracted from remote URLs, and no third-party packages are installed by the skill itself.

✓ Credentials

The skill declares no environment variables or credentials. The script does not read unrelated files or env vars. It relies on the existing local 'claude' authentication (as it must) but does not attempt to exfiltrate tokens or access other services.

✓ Persistence & Privilege

always is false and the skill does not persist changes to agent config or other skills. It creates only a temporary directory and tmux session and cleans them up on exit.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install claude-quota-checker
安装完成后，直接呼叫该 Skill 的名称或使用 /claude-quota-checker 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.1.1

v1.1.1: Renamed for discoverability — the name is the question everyone's asking.

v1.1.0

v1.1.0: Rewritten description to highlight key differentiator — shows remaining quota %, not spending. Pre-flight diagnostics, error handling, auto trust-prompt.

v1.0.0

Initial release: check Claude Max/Pro subscription usage via tmux + Claude CLI. Auto-handles trust prompt, auth detection, pre-flight checks.

元数据

Slug claude-quota-checker

版本 1.1.1

许可证 —

累计安装 2

当前安装数 2

历史版本数 3

常见问题