CLAUDE_REMOTE_WORKFLOW_ARGS

Updated October 14, 2026 by Alex Sorokoletov

CLAUDE_REMOTE_WORKFLOW_ARGS is a Claude Code environment variable. Added between v2.1.143 and v2.1.212 and still present in v2.1.295. It is not in the official reference.

Status	Present in v2.1.295
Added	Added between v2.1.143 and v2.1.212
Category	Agents and subagents
Official docs	Not listed

How to set it

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

export CLAUDE_REMOTE_WORKFLOW_ARGS=<value>
claude

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

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

Release notes that mention it

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

Related variables

CLAUDE_REMOTE_WORKFLOW_SCRIPT
CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS
CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS
CLAUDE_WORKFLOW_NAME_ONLY: Restricts a remote/headless run to a single named workflow.
CLAUDE_CODE_WORKFLOW_LAUNCH_SHA256
CLAUDE_CODE_WORKFLOW_PROMPT_PROVENANCE
CLAUDE_CODE_WORKFLOW_SIZE_WARNING_AGENTS
CLAUDE_AGENT: Short-form identifier for the current agent, used in inter-agent messaging and log attribution.

Frequently asked questions

Which Claude Code version has CLAUDE_REMOTE_WORKFLOW_ARGS?

Added between v2.1.143 and v2.1.212 and still present in v2.1.295.

How do I set CLAUDE_REMOTE_WORKFLOW_ARGS?

Export it before starting Claude Code (export CLAUDE_REMOTE_WORKFLOW_ARGS=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.