Omniscio

OmniscioGuidesUsage credits required for 1M context

Claude Code: Usage credits required for 1M context

Last checked against Anthropic's documentation on November 18, 2026. By the Omniscio team. Updated .

What is the exact message?

API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard context

In a session the Claude Desktop app runs, the hint names no commands. It points at the claude.ai usage settings page instead, or on Team and Enterprise at claude.ai/admin-settings/usage.

What does it mean?

A model with a [1m] suffix runs with a 1M-token context window, and for the model you selected that window is only available through usage credits. The selected variant is what triggers the check, so the turn is blocked until you change model or turn credits on.

Anthropic calls this an entitlement check, not a quota exhaustion. It fires even when your session and weekly allowances still have capacity remaining, so waiting for a reset time will not clear it.

Which variants are included differs by plan. Opus 4.6 with 1M context is included on Max, Ultra, Team and Enterprise; Sonnet 4.6 with 1M context needs usage credits on every subscription plan.

Why it appears

  • You picked a [1m] model. The selected variant is itself the request for the extended window, so it is what the entitlement check looks at.
  • You are working near the 200K boundary. Past 200K, Claude Code compacts the conversation back under the standard limit instead of widening the window. The 1M window is used only when the message says you have it.
  • Usage credits are off. Until they are on, the session stays at the standard context limit.
  • A 1M model ID is set somewhere else. If it returns after you switch with /model, one of the configuration locations Anthropic lists still names the 1M model; check them in priority order.

How do I fix it?

  1. Drop the [1m] suffix. Run /model and select the same model without it. This is the one-step fix: the session keeps working at the standard context window and needs no credits.
  2. Or turn the credits on. Run /usage-credits. On Pro, Max and Ultra it turns on metered billing for the 1M variant; on Team and Enterprise it sends the request to your admin. Once they are on, restart Claude Code or start a new session, whichever the message says.
  3. If it keeps coming back after /model, a 1M model ID is set elsewhere and wins at the next start. Check these in Anthropic's priority order: --model at startup, ANTHROPIC_MODEL, the model field in your settings file, then ANTHROPIC_DEFAULT_MODEL. Remove the stale value.
  4. If you never want 1M variants offered, set CLAUDE_CODE_DISABLE_1M_CONTEXT=1 before launching Claude Code. The [1m] variants leave the model picker, and a model with a native 1M window is held to 200K.

Before v2.1.268 the message ended run /usage-credits to turn them on, or /model to switch to standard context and did not mention restarting. On versions before v2.1.172 the error repeated on every request, including /compact; run /clear on those versions to recover.

How do I know it is fixed?

  • The next request gets a reply instead of the error line.
  • /model shows a model with no [1m] suffix, or it shows the 1M variant now that credits are on.
  • The session is running at the limit the message names: standard context, or 1M after a restart.

Where these answers come from

  • The message, quoted word for word, the Desktop app variant, the 200K compaction behaviour and the version notes: Anthropic's error reference, read November 18, 2026.
  • Which plans include 1M context directly and which need usage credits: Extended context, read November 18, 2026.
  • The places a model can be set, in priority order: Setting your model, and CLAUDE_CODE_DISABLE_1M_CONTEXT on Environment variables, both read the same day.

Common questions

Does this mean I ran out of usage?

No. It is an entitlement check, not quota exhaustion, and it fires while your session and weekly allowances still have room. The plan does not include the 1M window on its own.

How do I turn the credits on?

Run /usage-credits. On Pro, Max and Ultra it turns on metered billing for the 1M variant; on Team and Enterprise it asks your admin. Restart Claude Code or start a new session afterwards, as the message says.

How do I get back to the standard context window?

Run /model and pick the same model without the [1m] suffix. The session carries on at the standard context limit without credits.

Will waiting for a reset clear it?

No. A reset time belongs to a usage limit that has run out. This message is about which window your plan is allowed to use, so it stays until you switch models or turn credits on.