CLAUDE_WORKFLOW_NAME_ONLY

Updated October 13, 2026 by Alex Sorokoletov

CLAUDE_WORKFLOW_NAME_ONLY is a Claude Code environment variable: Restricts a remote/headless run to a single named workflow. It appears immediately after CLAUDE_REMOTE_WORKFLOW_SCRIPT and CLAUDE_REMOTE_WORKFLOW_ARGS in the workflow-execution env set — an allowlist knob for the remote workflow runner rather than a free-form script path. Added between v2.1.143 and v2.1.212 and still present in v2.1.294. It is not in the official reference.

How to set it

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

export CLAUDE_WORKFLOW_NAME_ONLY=<value>
claude

To apply it to every session, add it to the env object of a settings file:

// ~/.claude/settings.json
{
  "env": {
    "CLAUDE_WORKFLOW_NAME_ONLY": "<value>"
  }
}

Release notes that mention it

• claude-code-env-vars-v2-1-212

Related variables

• CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS
• CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS
• CLAUDE_INTERNAL_ASSISTANT_TEAM_NAME: Passes the current Agent Teams team name (prefixed assistant-) to a spawned child process.
• CLAUDE_CODE_WORKFLOW_LAUNCH_SHA256
• CLAUDE_CODE_WORKFLOW_PROMPT_PROVENANCE
• CLAUDE_CODE_WORKFLOW_SIZE_WARNING_AGENTS
• CLAUDE_REMOTE_WORKFLOW_ARGS
• CLAUDE_REMOTE_WORKFLOW_SCRIPT

Frequently asked questions

All variables, searchable: Claude Code environment variables.