CLAUDE_CODE_DESKTOP_WORKFLOW_LIMIT_WAIT

Updated November 6, 2026 by Alex Sorokoletov

CLAUDE_CODE_DESKTOP_WORKFLOW_LIMIT_WAIT is a Claude Code environment variable: When the desktop app is active, applies this value as its workflow limit wait; the variable is then removed from the environment. Added in v2.1.319 and still present in v2.1.319. 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_CODE_DESKTOP_WORKFLOW_LIMIT_WAIT=<value>
claude

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

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

Related variables

• CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS: Raises the Workflow tool's per-run concurrent-agent limit; changelog range 1 to 256.
• CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS
• CLAUDE_CODE_WORKFLOW_PROMPT_PROVENANCE: Toggles whether the automated-trigger provenance preamble is added to workflow prompts; defaults to on.
• CLAUDE_CODE_WORKFLOW_SIZE_WARNING_AGENTS: Set the maximum number of scheduled agents before the workflow-size warning fired; a positive value overrode the default cap.
• CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL: Runs every workflow agent on the named model while other subagents keep their own.
• CLAUDE_REMOTE_WORKFLOW_ARGS: Provides JSON-encoded arguments passed to the environment-delivered remote workflow script; it must be valid JSON within a size limit.
• CLAUDE_REMOTE_WORKFLOW_SCRIPT: Names the workflow script run as the deterministic entry point for a remote session; the command errors when it is not set.
• CLAUDE_WORKFLOW_NAME_ONLY: Restricts a remote/headless run to a single named workflow.

Frequently asked questions

All variables, searchable: Claude Code environment variables.