CLAUDE_CODE_DISABLE_EMPTY_CLASSIC_DISPATCH_SKIP

Updated October 31, 2026 by Alex Sorokoletov

CLAUDE_CODE_DISABLE_EMPTY_CLASSIC_DISPATCH_SKIP is a Claude Code environment variable: When set, prevents skipping a classic hook dispatch even when all its registered handlers satisfy the skip check, so the dispatch always runs. Added in v2.1.311 and still present in v2.1.315. It is not in the official reference.

Status	Present in v2.1.315
Added	Added in v2.1.311
Category	Feature toggles
Official docs	Not listed

How to set it

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

export CLAUDE_CODE_DISABLE_EMPTY_CLASSIC_DISPATCH_SKIP=<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_EMPTY_CLASSIC_DISPATCH_SKIP": "<value>"
  }
}

Related variables

CLAUDE_CODE_CCR_SKIP_FRESH_MIGRATIONS: When set, and other conditions hold, skips running config migrations, instead marking the migration version as current and the migrations as already complete.
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

What does CLAUDE_CODE_DISABLE_EMPTY_CLASSIC_DISPATCH_SKIP do?

When set, prevents skipping a classic hook dispatch even when all its registered handlers satisfy the skip check, so the dispatch always runs.

Which Claude Code version has CLAUDE_CODE_DISABLE_EMPTY_CLASSIC_DISPATCH_SKIP?

Added in v2.1.311 and still present in v2.1.315.

How do I set CLAUDE_CODE_DISABLE_EMPTY_CLASSIC_DISPATCH_SKIP?

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