How Much Claude Left?

该 Skill 用 Bash 脚本创建临时 tmux 会话和 git 仓库，启动 Claude Code CLI、自动处理信任提示，发送 /usage 并解析输出，展示 Pro/Max 套餐、会话与每周使用率及重置时间，最后清理会话。需要 tmux、claude CLI、git 和已登录的 Claude 订阅，单次约 8-10 秒。

mfang0126

热度 67.19

最近更新 2026-05-11 17:29:21

分类：自动化依赖：代码执行 / 读写文件应用场景：工作流 / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add claude-quota-checker

Metadata

name: claude-quota-checker
description: 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 answers the real question: 'Am I about to hit my limit?' Shows remaining % for session and weekly windows, plan type, and exact reset times. Works by automating Claude Code CLI's /usage command via tmux — no API keys, no Admin keys, no reverse engineering. Just your subscription status, instantly. Use whenever someone asks: 'how much Claude do I have left', 'am I rate limited', 'when does my quota reset', 'check my usage', 'claude limits', '还剩多少', '查用量', '还能用吗', 'why is Claude slow'. Also use as a first diagnostic when the user hits rate limits or Claude feels sluggish.

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