CLAUDE_CODE_DISABLE_HELD_MESSAGE_RECOGNITION

Updated November 3, 2026 by Alex Sorokoletov

CLAUDE_CODE_DISABLE_HELD_MESSAGE_RECOGNITION is a Claude Code environment variable. Removed in v2.1.318, so current releases ignore it. 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_DISABLE_HELD_MESSAGE_RECOGNITION=<value>
claude

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

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

Related variables

• CLAUDE_CODE_DISABLE_STOP_OF_HELD_MESSAGES: Set to turn off stopping of held messages; when set the gate returns false, otherwise it falls back to a server-side killswitch.
• CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION: When set to true, uses only the leading admin tier's environment settings instead of merging (unioning) the environment across all admin tiers.
• CLAUDE_CODE_DISABLE_ARTIFACT
• CLAUDE_CODE_DISABLE_ATTACHMENTS: File/image attachments.
• CLAUDE_CODE_DISABLE_AWAITING_USER_IDLE: When set, stops the session from being treated as idle while it waits for user input, so time parked on the user is not counted as idle.
• CLAUDE_CODE_DISABLE_CFC_PROMPT
• CLAUDE_CODE_DISABLE_COMMAND_INJECTION_CHECK: Previously allowed disabling command injection detection.
• CLAUDE_CODE_DISABLE_CRON: Disable cron/scheduled task functionality.

Frequently asked questions

All variables, searchable: Claude Code environment variables.