CLAUDE_CODE_CCR_ONE_PLUGIN_LOAD_PER_RELOAD

Updated November 3, 2026 by Alex Sorokoletov

CLAUDE_CODE_CCR_ONE_PLUGIN_LOAD_PER_RELOAD is a Claude Code environment variable. Added in v2.1.315 and still present in v2.1.318. It is not in the official reference.

How to set it

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

export CLAUDE_CODE_CCR_ONE_PLUGIN_LOAD_PER_RELOAD=<value>
claude

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

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

Related variables

• CLAUDE_CODE_CCR_EARLY_PLUGINS_SYNC: Enables an early plugins sync during startup of a non-interactive session; the sync is skipped when the session is interactive or the variable is unset.
• CLAUDE_CODE_CCR_EARLY_SKILLS_SYNC: Enables an early skills sync during startup of a non-interactive session; the sync is skipped when the session is interactive or the variable is unset.
• CLAUDE_CODE_CCR_SLOW_SKILLS_WATCH: Takes effect only in remote mode; when both this and remote mode are set, slow-skills watching is enabled.
• CLAUDE_CODE_DESKTOP_SKILLS_PLUGIN_DIR: Holds a directory path the desktop app passes for its skills plugin; the client reads it into the desktop-skills plugin directory, then clears it from the environment.
• CLAUDE_CODE_DISABLE_PLUGIN_FORWARDING: When set, disables forwarding this machine's enabled plugins to cloud and remote sessions and hides the cloud-plugins setting.
• CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH: Enables automatic background plugin refresh when the runtime detects updates are needed.
• CLAUDE_CODE_PLUGIN_ATTRIBUTION: Provides per-plugin attribution metadata as JSON (fields such as marketplace name, server plugin id, installation preference and marketplace kind), looked up by plugin and used before the default source; capped at 65536 bytes.
• CLAUDE_CODE_PLUGIN_CACHE_DIR: Local cache directory for downloaded plugins.

Frequently asked questions

All variables, searchable: Claude Code environment variables.