DISABLE_PROMPT_CACHING_OPUS

Updated October 13, 2026 by Alex Sorokoletov

DISABLE_PROMPT_CACHING_OPUS is a Claude Code environment variable: Prompt caching for Opus. Its release history is not tracked here. It is listed in the official reference.

Status	Present in v2.1.294
Category	Models and thinking
Official docs	Listed

How to set it

For one session, export it in the shell that starts Claude Code:

export DISABLE_PROMPT_CACHING_OPUS=<value>
claude

To apply it to every session, add it to the env object of a settings file:

// ~/.claude/settings.json
{
  "env": {
    "DISABLE_PROMPT_CACHING_OPUS": "<value>"
  }
}

Related variables

DISABLE_PROMPT_CACHING_FABLE
DISABLE_PROMPT_CACHING_HAIKU: Prompt caching for Haiku.
DISABLE_PROMPT_CACHING_SONNET: Prompt caching for Sonnet.
ANTHROPIC_DEFAULT_OPUS_MODEL: Override Opus model ID.
ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION
ANTHROPIC_DEFAULT_OPUS_MODEL_NAME
ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING: Disable adaptive thinking mode.

Frequently asked questions

What does DISABLE_PROMPT_CACHING_OPUS do?

Prompt caching for Opus

Which Claude Code version has DISABLE_PROMPT_CACHING_OPUS?

Its release history is not tracked here.

How do I set DISABLE_PROMPT_CACHING_OPUS?

Export it before starting Claude Code (export DISABLE_PROMPT_CACHING_OPUS=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.