CLAUDE_CODE_PLAN_MODE_REQUIRED
Updated by Alex Sorokoletov
CLAUDE_CODE_PLAN_MODE_REQUIRED is a Claude Code environment variable: Require agents to use plan mode for all tasks. Present since v2.1.69 or earlier and still present in v2.1.294. It is not in the official reference.
| Status | Present in v2.1.294 |
|---|---|
| Added | Present since v2.1.69 or earlier |
| Category | Other |
| Official docs | Not listed |
How to set it
For one session, export it in the shell that starts Claude Code:
export CLAUDE_CODE_PLAN_MODE_REQUIRED=<value>
claudeTo apply it to every session, add it to the env object of a settings file:
// ~/.claude/settings.json
{
"env": {
"CLAUDE_CODE_PLAN_MODE_REQUIRED": "<value>"
}
}Release notes that mention it
Related variables
CLAUDE_CODE_PLAN_MODE_INTERVIEW_PHASE: Enable interview phase in plan mode.CLAUDE_CODE_PERFORCE_MODE: Activates Perforce VCS integration.CLAUDE_CODE_SAFE_MODECLAUDE_REPL_MODE: Sets the operating mode for the REPL interface.CLAUDE_CODE_PLAN_ARTIFACTSCLAUDE_CODE_TODO_REMINDER_MODEANTHROPIC_BETAS: Comma-separated beta feature headers.ANTHROPIC_CUSTOM_HEADERS: Custom HTTP headers (newline-separated Key: Value).
Frequently asked questions
What does CLAUDE_CODE_PLAN_MODE_REQUIRED do?
Require agents to use plan mode for all tasks
Which Claude Code version has CLAUDE_CODE_PLAN_MODE_REQUIRED?
Present since v2.1.69 or earlier and still present in v2.1.294.
How do I set CLAUDE_CODE_PLAN_MODE_REQUIRED?
Export it before starting Claude Code (export CLAUDE_CODE_PLAN_MODE_REQUIRED=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.