From 17f1faba730799e7656c8ec85c13ea4c9ad2ef59 Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Thu, 26 Feb 2026 11:12:07 +0500 Subject: [PATCH] updated --- CLAUDE.md | 1 + README.md | 39 ++++--- .../claude-agents-frontmatter.md | 4 +- .../claude-commands-frontmatter.md | 4 +- .../claude-commands.md | 4 +- reports/{live => }/claude-settings.md | 0 .../claude-skills-frontmatter.md | 4 +- reports/claude-usage-and-rate-limits.md | 108 ++++++++++++++++++ 8 files changed, 138 insertions(+), 26 deletions(-) rename reports/{live/agent-command-skills => }/claude-agents-frontmatter.md (96%) rename reports/{live/agent-command-skills => }/claude-commands-frontmatter.md (94%) rename reports/{live/agent-command-skills => }/claude-commands.md (98%) rename reports/{live => }/claude-settings.md (100%) rename reports/{live/agent-command-skills => }/claude-skills-frontmatter.md (97%) create mode 100644 reports/claude-usage-and-rate-limits.md diff --git a/CLAUDE.md b/CLAUDE.md index aecb2cc..f07bbcc 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -116,3 +116,4 @@ From experience with this repository: - `reports/claude-skills-for-larger-mono-repos.md`: Skills discovery and loading behavior in monorepos (static vs dynamic discovery) - `reports/claude-agent-memory.md`: Agent memory frontmatter β€” persistent memory scopes (user, project, local) for subagents - `reports/claude-advanced-tool-use.md`: Advanced tool use patterns β€” Programmatic Tool Calling (PTC), Tool Search, Tool Use Examples +- `reports/claude-usage-and-rate-limits.md`: Usage commands (`/usage`, `/extra-usage`, `/cost`), rate limits, and pay-as-you-go overflow billing diff --git a/README.md b/README.md index 4b5613c..1373061 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,7 @@ # claude-code-best-practice practice makes claude perfect - - GitHub Stars - +![Last Updated](https://img.shields.io/badge/Last_Updated-Feb_26%2C_2026_10%3A45_AM_PKT-white?style=flat&labelColor=555) GitHub Stars

Claude Code mascot jumping @@ -36,6 +34,18 @@ practice makes claude perfect **Extension Overview:** See [Extend Claude Code](https://code.claude.com/docs/en/features-overview) for when to use each feature and how they layer together. +## πŸ’Ž HIDDEN GEMS + +> Reports that are frequently updated as Claude Code evolves. + +| Report | Description | +|--------|-------------| +| [Claude Code Commands Reference](reports/claude-commands.md) | Complete reference of all slash commands, keyboard shortcuts, and input modes | +| [Claude Code Settings Reference](reports/claude-settings.md) | Comprehensive guide to all `settings.json` configuration options | +| [Agents Frontmatter Reference](reports/claude-agents-frontmatter.md) | Complete reference of all agent (`.claude/agents/`) frontmatter fields | +| [Commands Frontmatter Reference](reports/claude-commands-frontmatter.md) | Complete reference of all command (`.claude/commands/`) frontmatter fields | +| [Skills Frontmatter Reference](reports/claude-skills-frontmatter.md) | Complete reference of all skill (`.claude/skills/`) frontmatter fields | + ## MY EXPERIENCE β–  **Workflows** @@ -138,14 +148,14 @@ See [weather-orchestration-architecture](weather-orchestration/weather-orchestra | `/compact` | `/context` | `/model` | `/plan` | `/config` | | `/clear` | `/cost` | `/memory` | `/doctor` | `/rewind` | -[**See Complete List β†’**](reports/live/agent-command-skills/claude-commands.md) +[**See Complete List β†’**](reports/claude-commands.md) ## CLAUDE SETTINGS | | | |---|---| -| [**Claude Settings**](reports/live/claude-settings.md) | [**Global vs Project Settings**](reports/claude-global-vs-project-settings.md) | +| [**Claude Settings**](reports/claude-settings.md) | [**Global vs Project Settings**](reports/claude-global-vs-project-settings.md) | ## MCP SERVERS FOR DAILY USE @@ -164,19 +174,6 @@ Research (Context7/DeepWiki) -> Debug (Playwright/Chrome) -> Document (Excalidra ## REPORTS -### Live Reports -> Reports that are frequently updated as Claude Code evolves. - -| Report | Description | -|--------|-------------| -| [Claude Code Commands Reference](reports/live/agent-command-skills/claude-commands.md) | Complete reference of all slash commands, keyboard shortcuts, and input modes | -| [Claude Code Settings Reference](reports/live/claude-settings.md) | Comprehensive guide to all `settings.json` configuration options | -| [Agents Frontmatter Reference](reports/live/agent-command-skills/claude-agents-frontmatter.md) | Complete reference of all agent (`.claude/agents/`) frontmatter fields | -| [Commands Frontmatter Reference](reports/live/agent-command-skills/claude-commands-frontmatter.md) | Complete reference of all command (`.claude/commands/`) frontmatter fields | -| [Skills Frontmatter Reference](reports/live/agent-command-skills/claude-skills-frontmatter.md) | Complete reference of all skill (`.claude/skills/`) frontmatter fields | - -### Reports - | Report | Description | |--------|-------------| | [Agent SDK vs CLI System Prompts](reports/claude-agent-sdk-vs-cli-system-prompts.md) | Why Claude CLI and Agent SDK outputs may differβ€”system prompt architecture and determinism | @@ -188,3 +185,9 @@ Research (Context7/DeepWiki) -> Debug (Playwright/Chrome) -> Document (Excalidra | [Agent Memory Frontmatter](reports/claude-agent-memory.md) | Persistent memory scopes (`user`, `project`, `local`) for subagents β€” enabling agents to learn across sessions | | [Boris Cherny's 12 Customization Tips](reports/claude-boris-tips-feb-26.md) | 12 ways to customize Claude Code β€” from terminal config to plugins, agents, hooks, and output styles | | [Advanced Tool Use Patterns](reports/claude-advanced-tool-use.md) | Programmatic Tool Calling (PTC), Tool Search, and Tool Use Examples | +| [Usage, Rate Limits & Extra Usage](reports/claude-usage-and-rate-limits.md) | Usage commands (`/usage`, `/extra-usage`, `/cost`), rate limits, and pay-as-you-go overflow billing | +| [Claude Code Commands Reference](reports/claude-commands.md) | Complete reference of all slash commands, keyboard shortcuts, and input modes | +| [Claude Code Settings Reference](reports/claude-settings.md) | Comprehensive guide to all `settings.json` configuration options | +| [Agents Frontmatter Reference](reports/claude-agents-frontmatter.md) | Complete reference of all agent (`.claude/agents/`) frontmatter fields | +| [Commands Frontmatter Reference](reports/claude-commands-frontmatter.md) | Complete reference of all command (`.claude/commands/`) frontmatter fields | +| [Skills Frontmatter Reference](reports/claude-skills-frontmatter.md) | Complete reference of all skill (`.claude/skills/`) frontmatter fields | diff --git a/reports/live/agent-command-skills/claude-agents-frontmatter.md b/reports/claude-agents-frontmatter.md similarity index 96% rename from reports/live/agent-command-skills/claude-agents-frontmatter.md rename to reports/claude-agents-frontmatter.md index 588be7a..7af0643 100644 --- a/reports/live/agent-command-skills/claude-agents-frontmatter.md +++ b/reports/claude-agents-frontmatter.md @@ -4,8 +4,8 @@ Quick-reference tables for defining subagents in `.claude/agents/*.md`. - - + +
← Back to Claude Code Best PracticeClaude← Back to Claude Code Best PracticeClaude
diff --git a/reports/live/agent-command-skills/claude-commands-frontmatter.md b/reports/claude-commands-frontmatter.md similarity index 94% rename from reports/live/agent-command-skills/claude-commands-frontmatter.md rename to reports/claude-commands-frontmatter.md index f64130a..3d9abc6 100644 --- a/reports/live/agent-command-skills/claude-commands-frontmatter.md +++ b/reports/claude-commands-frontmatter.md @@ -4,8 +4,8 @@ Quick-reference tables for defining custom commands in `.claude/commands/. - - + +
← Back to Claude Code Best PracticeClaude← Back to Claude Code Best PracticeClaude
diff --git a/reports/live/agent-command-skills/claude-commands.md b/reports/claude-commands.md similarity index 98% rename from reports/live/agent-command-skills/claude-commands.md rename to reports/claude-commands.md index 62b7672..9160615 100644 --- a/reports/live/agent-command-skills/claude-commands.md +++ b/reports/claude-commands.md @@ -4,8 +4,8 @@ A comprehensive reference of all available slash commands in Claude Code's inter - - + +
← Back to Claude Code Best PracticeClaude← Back to Claude Code Best PracticeClaude
diff --git a/reports/live/claude-settings.md b/reports/claude-settings.md similarity index 100% rename from reports/live/claude-settings.md rename to reports/claude-settings.md diff --git a/reports/live/agent-command-skills/claude-skills-frontmatter.md b/reports/claude-skills-frontmatter.md similarity index 97% rename from reports/live/agent-command-skills/claude-skills-frontmatter.md rename to reports/claude-skills-frontmatter.md index 321a989..0ad3a66 100644 --- a/reports/live/agent-command-skills/claude-skills-frontmatter.md +++ b/reports/claude-skills-frontmatter.md @@ -4,8 +4,8 @@ Quick-reference tables for defining skills in `.claude/skills//SKILL.md`. - - + +
← Back to Claude Code Best PracticeClaude← Back to Claude Code Best PracticeClaude
diff --git a/reports/claude-usage-and-rate-limits.md b/reports/claude-usage-and-rate-limits.md new file mode 100644 index 0000000..92e7ed6 --- /dev/null +++ b/reports/claude-usage-and-rate-limits.md @@ -0,0 +1,108 @@ +# Claude Code: Usage, Rate Limits & Extra Usage + +Understanding how usage limits work in Claude Code and how to keep working when you hit them. + + + + + + +
← Back to Claude Code Best PracticeClaude
+ +--- + +## Overview + +Claude Code on subscription plans (Pro, Max 5x, Max 20x) has usage limits that reset on a rolling window. Three built-in slash commands help you monitor and manage usage: + +| Command | Description | Available To | +|---------|-------------|--------------| +| `/usage` | Check plan limits and rate limit status | Pro, Max 5x, Max 20x | +| `/extra-usage` | Configure pay-as-you-go overflow when limits are hit | Pro, Max 5x, Max 20x | +| `/cost` | Show token usage and spending for the current session | API key users | + +--- + +## `/usage` β€” Check Your Limits + +Shows your current plan's usage limits and rate limit status. Useful for checking how much capacity you have left before hitting a limit. + +--- + +## `/extra-usage` β€” Keep Working Past Limits + +The `/extra-usage` command configures **pay-as-you-go overflow billing** so Claude Code continues working seamlessly when you hit your plan's rate limits, instead of blocking you. + +### How It Works + +1. You hit your plan's rate limit (limits reset every 5 hours) +2. If extra usage is enabled with available funds, Claude Code continues without interruption +3. Overflow tokens are billed at **standard API rates**, separate from your subscription fee + +### Setting It Up + +The `/extra-usage` command in the CLI will guide you through configuration. You can also configure it on the web at **Settings > Usage** on claude.ai: + +1. Enable extra usage +2. Add a payment method +3. Set a **monthly spending cap** (or choose unlimited) +4. Optionally add **prepaid funds** with auto-reload when balance drops below a threshold + +### Key Details + +| Detail | Value | +|--------|-------| +| Daily redemption limit | $2,000/day | +| Billing | Separate from subscription, at standard API rates | +| Limit reset window | Every 5 hours | + +### Known Issue + +As of February 2026, the `/extra-usage` CLI command is [undocumented](https://github.com/anthropics/claude-code/issues/12396) and may open a sign-in window without clear configuration options. Configuring through the **claude.ai web interface** is the more reliable path for now. + +--- + +## `/cost` β€” Session Spending (API Users) + +For users authenticating with an API key (not a subscription plan), `/cost` shows: + +- Total cost for the current session +- API duration and wall time +- Token usage breakdown +- Code changes made + +This command is not relevant for Pro/Max subscription users. + +--- + +## Fast Mode and Extra Usage + +Fast mode (`/fast`) uses Claude Opus 4.6 with faster output. It has a special billing relationship with extra usage: + +- Fast mode usage is **always billed to extra usage** from the first token +- This applies even if you have remaining usage on your subscription plan +- Fast mode does not consume your plan's included rate limits + +This means you need extra usage enabled and funded to use `/fast`. + +--- + +## CLI Startup Flags + +Two startup flags relate to usage budgets (API key users only, print mode): + +| Flag | Description | +|------|-------------| +| `--max-budget-usd ` | Maximum dollar amount for API calls before stopping | +| `--max-turns ` | Limit number of agentic turns | + +See [CLI Startup Flags Reference](claude-cli-startup-flags.md) for the full list. + +--- + +## Sources + +- [Extra usage for paid Claude plans β€” Claude Help Center](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) +- [Using Claude Code with your Pro or Max plan β€” Claude Help Center](https://support.claude.com/en/articles/11145838-using-claude-code-with-your-pro-or-max-plan) +- [/extra-usage slash command is undocumented β€” GitHub Issue #12396](https://github.com/anthropics/claude-code/issues/12396) +- [Claude Code CLI Reference](https://code.claude.com/docs/en/cli-reference)