CLAUDE_CODE_ENABLE_AUTO_MODE
Updated by Alex Sorokoletov
CLAUDE_CODE_ENABLE_AUTO_MODE is a Claude Code environment variable: The master switch. Redundant on Bedrock/Vertex/Foundry now that Auto mode is default-on, but still the toggle everywhere else. It gates everything below. Added between v2.1.143 and v2.1.212 and still present in v2.1.318. It is listed in the official reference.
| Status | Present in v2.1.318 |
|---|---|
| Added | Added between v2.1.143 and v2.1.212 |
| Category | Permissions and sandbox |
| Official docs | Listed |
How to set it
For one session, export it in the shell that starts Claude Code:
export CLAUDE_CODE_ENABLE_AUTO_MODE=<value>
claudeTo apply it to every session, add it to the env object of a settings file:
// ~/.claude/settings.json
{
"env": {
"CLAUDE_CODE_ENABLE_AUTO_MODE": "<value>"
}
}Release notes that mention it
Related variables
CLAUDE_CODE_AUTO_MODE_CANDIDATE_WORDING: Chose the auto-mode classifier wording; a truthy value requested the 'candidate' variant and a falsy one the 'baseline'.CLAUDE_CODE_AUTO_MODE_CLASSIFY_EDITS: Turns the classification pass on: every edit runs through the classifier before it touches disk.CLAUDE_CODE_AUTO_MODE_EDIT_REMOVAL: Governs whether Auto mode may delete content as part of an edit.CLAUDE_CODE_AUTO_MODE_EDIT_REMOVAL_CAP: Caps how much a single autonomous edit can remove before it's held for a human.CLAUDE_CODE_AUTO_MODE_EMAIL_SENDER_REPLY_TURN: When true, enables the auto-mode email sender reply-turn rule and includes its reply-handling guidance in the prompt.CLAUDE_CODE_AUTO_MODE_EMAIL_SENDER_TURN: Set to true to force the email-sender-turn guidance (the rule against sending sensitive content to recipients outside the trust boundary) even when no message is marked as an email sender turn.CLAUDE_CODE_AUTO_MODE_EXTERNAL_PERMISSIONS: Hands permission decisions to an external policy engine instead of the built-in prompt.CLAUDE_CODE_AUTO_MODE_GIT_STATUS: Feeds the working tree's git status into the classifier's context.
Frequently asked questions
What does CLAUDE_CODE_ENABLE_AUTO_MODE do?
The master switch. Redundant on Bedrock/Vertex/Foundry now that Auto mode is default-on, but still the toggle everywhere else. It gates everything below.
Which Claude Code version has CLAUDE_CODE_ENABLE_AUTO_MODE?
Added between v2.1.143 and v2.1.212 and still present in v2.1.318.
How do I set CLAUDE_CODE_ENABLE_AUTO_MODE?
Export it before starting Claude Code (export CLAUDE_CODE_ENABLE_AUTO_MODE=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.