CLAUDE_CODE_RATE_LIMIT_TIER
Updated by Alex Sorokoletov
CLAUDE_CODE_RATE_LIMIT_TIER is a Claude Code environment variable: Rate-limit bucket for the current session, independent of subscription type. Enterprise customers may have custom limits that differ from their plan defaults — this lets the /usage display render accurate numbers instead of guessing from plan name alone. Added between v2.1.114 and v2.1.117 and still present in v2.1.294. It is not in the official reference.
| Status | Present in v2.1.294 |
|---|---|
| Added | Added between v2.1.114 and v2.1.117 |
| Category | Other |
| Official docs | Not listed |
How to set it
For one session, export it in the shell that starts Claude Code:
export CLAUDE_CODE_RATE_LIMIT_TIER=<value>
claudeTo apply it to every session, add it to the env object of a settings file:
// ~/.claude/settings.json
{
"env": {
"CLAUDE_CODE_RATE_LIMIT_TIER": "<value>"
}
}Release notes that mention it
- Claude Code v2.1.123 — Background Daemons, Agent Fleets, and CoWork Memory
- Claude Code v2.1.118 — 10 New Environment Variables: Forked Subagents Ship, Subscription Tiering Takes Shape
- Claude Code Version Tracker: Undocumented Env Vars, Feature Gates & Models
Related variables
ANTHROPIC_BETAS: Comma-separated beta feature headers.ANTHROPIC_CUSTOM_HEADERS: Custom HTTP headers (newline-separated Key: Value).ANTHROPIC_FEDERATION_RULE_IDANTHROPIC_ORGANIZATION_IDANTHROPIC_WORKSPACE_IDBETA_TRACING_ENDPOINT: Custom endpoint for beta tracing.CLAUDE_AFK_COUNTDOWN_MSCLAUDE_AI_ORIGIN: Overrides the base URL for Claude AI authentication endpoints.
Frequently asked questions
What does CLAUDE_CODE_RATE_LIMIT_TIER do?
Rate-limit bucket for the current session, independent of subscription type. Enterprise customers may have custom limits that differ from their plan defaults — this lets the /usage display render accurate numbers instead of guessing from plan name alone.
Which Claude Code version has CLAUDE_CODE_RATE_LIMIT_TIER?
Added between v2.1.114 and v2.1.117 and still present in v2.1.294.
How do I set CLAUDE_CODE_RATE_LIMIT_TIER?
Export it before starting Claude Code (export CLAUDE_CODE_RATE_LIMIT_TIER=value), or add it to the "env" object in ~/.claude/settings.json to apply it to every session.
All variables, searchable: Claude Code environment variables.