CLAUDE_CODE_DISABLE_TURN_HANDOFF

Updated October 14, 2026 by Alex Sorokoletov

CLAUDE_CODE_DISABLE_TURN_HANDOFF is a Claude Code environment variable. Added between v2.1.269 and v2.1.283 and still present in v2.1.295. It is not in the official reference.

Status	Present in v2.1.295
Added	Added between v2.1.269 and v2.1.283
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_TURN_HANDOFF=<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_TURN_HANDOFF": "<value>"
  }
}

Related variables

CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION
CLAUDE_CODE_DISABLE_ARTIFACT
CLAUDE_CODE_DISABLE_ATTACHMENTS: File/image attachments.
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.
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS: Experimental beta API features.
CLAUDE_CODE_DISABLE_EXPLORE_INHERIT_CAP: Lets the built-in Explore search agent run at the parent model instead of a cheaper capped default.

Frequently asked questions

Which Claude Code version has CLAUDE_CODE_DISABLE_TURN_HANDOFF?

Added between v2.1.269 and v2.1.283 and still present in v2.1.295.

How do I set CLAUDE_CODE_DISABLE_TURN_HANDOFF?

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