CLAUDE_CODE_ENABLE_TODO_TOOLS
A Claude Code environment variable, read out of the shipped bundle. It has been in the build since v2.1.233, including the newest one read.
What it is
Set to 1 to get the task-tracking tools on the models listed under [Task tool availability](/docs/en/tools-reference#task-tool-availability), where Claude Code otherwise leaves them out. CLAUDE_CODE_ENABLE_TASKS still selects the Task tools or TodoWrite. Requires Claude Code v2.1.233 or later
Anthropic's own wording. Read off Environment variables, captured 2026-08-28.
Presence across releases
| Releases | Reading | Declared type | Default |
|---|---|---|---|
| 2.1.245 – 2.1.250 5 releases | never mined | — | — |
| 2.1.233 – 2.1.243 11 releases | in the build | bool | — |
A row reading never mined is a release with no archived bundle behind it. Nothing was read out of it, so nothing here says whether the name was in it. A declared type or a default is only ever what that release's own bundle stated.
Changelog entries naming it
-
v2.1.233Task tools now follow the todo-tools flag rather than an org denylist
Task tools now turn on via the tasks and todo-tools env vars instead of an organization denylist.
named in this entry
-
v2.1.233Todo tools switched off for several models
Todo tools are now off for several models unless you set CLAUDE_CODE_ENABLE_TODO_TOOLS=true.
named in this entry
-
v2.1.233Team context mentions the shared task list only when task tools exist
Teammate agents only get told about the shared task list when those tools exist.
named in this entry
Documentation pages
- Environment variables reference table Claude Code CLI
- Track todos mentions it Claude Code CLI
- Claude Code changelog mentions it Claude Code CLI
- Interactive mode mentions it Claude Code CLI
- Tools reference mentions it Claude Code CLI
A reference table page is one whose own table defines this name, and it is where the description above came from. A page that mentions it carries the name somewhere in its text and may say nothing about it at all. Every page carrying it.
Names beside it
Every environment variable in the inventory starting claude_code_enable, up to twelve of them.
CLAUDE_CODE_ENABLE_APPEND_SUBAGENT_PROMPTSet to 1 to enable appending extra text to the end of the system prompt of every [subagent](/docs/en/sub-agents) other than a [forked subagent](/docs/en/sub-agents#fork-the-current-conversation). The [--append-subagent-system-prompt](/docs/en/cli-reference#cli-flags) flag supplies the appended text and sets this variable automatically, so you don't need to set it yourself. Requires Claude Code v2.1.205 or later 2.1.138
CLAUDE_CODE_ENABLE_AUTO_MODEAccepted for compatibility with older releases and has no effect. Auto mode is available by default on every provider, including Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, and signed-in [Claude apps gateway](/docs/en/claude-apps-gateway) sessions. In v2.1.158 through v2.1.206, setting this to 1 was required to make [auto mode](/docs/en/permission-modes#eliminate-prompts-with-auto-mode) available on those providers 2.1.158
CLAUDE_CODE_ENABLE_AWAY_SUMMARYOverride [session recap](/docs/en/interactive-mode#session-recap) availability. Set to 0 to force recaps off regardless of the /config toggle. Set to 1 to force recaps on when [awaySummaryEnabled](/docs/en/settings-reference#awaysummaryenabled) is false. Takes precedence over the setting and /config toggle 2.1.138
CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESHSet to 1 to refresh plugin state at turn boundaries in [non-interactive mode](/docs/en/headless) after a background install completes. Off by default because the refresh changes the system prompt mid-session, which invalidates [prompt caching](/docs/en/prompt-caching) for that turn 2.1.138
CLAUDE_CODE_ENABLE_CFCNo description from anybody. 2.1.138
CLAUDE_CODE_ENABLE_DESIGN_MCPNo description from anybody. 2.1.179
CLAUDE_CODE_ENABLE_DESIGN_SYNCNo description from anybody. 2.1.166
CLAUDE_CODE_ENABLE_EXPERIMENTAL_ADVISOR_TOOLThe experimental advisor override no longer skips per-model eligibility checks, only the rank requirement. 2.1.138
CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTELSet to 1 to route the "How is Claude doing?" session quality survey to your own [OpenTelemetry collector](/docs/en/monitoring-usage) when Anthropic-bound nonessential traffic is blocked. Survey ratings are emitted only as OTEL events to your configured collector. No survey data is sent to Anthropic in this mode. Applies when CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, DISABLE_TELEMETRY, or DO_NOT_TRACK is set, and has no effect otherwise. CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY and the organization product feedback policy take precedence 2.1.138
CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMINGControls whether tool call inputs stream from the API as Claude generates them. With this off, a large tool input such as a long file write arrives only after Claude finishes generating it, which can look like it's hanging. Enabled by default on the Anthropic API. On Amazon Bedrock and Google Cloud's Agent Platform, enabled per model where the deployed container supports it. Set to 0 to opt out. Set to 1 to force on when routing through a proxy via ANTHROPIC_BASE_URL, ANTHROPIC_VERTEX_BASE_URL, or ANTHROPIC_BEDROCK_BASE_URL. Off by default on Microsoft Foundry and [gateway](/docs/en/llm-gateway) connections 2.1.138
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERYSet to 1 to populate the /model picker from your gateway's /v1/models endpoint when ANTHROPIC_BASE_URL points at an Anthropic-compatible gateway such as LiteLLM, Kong, or an internal proxy. Off by default because gateways backed by a shared API key would otherwise show every user every model the key can access. Discovered models are still filtered by an [availableModels](/docs/en/settings-reference#availablemodels) allowlist the session receives; deliver the list through [MDM or a managed settings file](/docs/en/managed-settings#delivery-mechanisms), since [server-managed delivery is not available on gateway configurations](/docs/en/server-managed-settings#platform-availability) 2.1.138
CLAUDE_CODE_ENABLE_LAUNCH_COMPOSERNo description from anybody. 2.1.193
Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the environment variable does. All environment variables.