CLAUDE_BG_DISPATCH_ENTRYPOINT

Updated November 9, 2026 by Alex Sorokoletov

CLAUDE_BG_DISPATCH_ENTRYPOINT is a Claude Code environment variable: In a background session (session kind bg), supplies the entrypoint identifier used in place of the normal one, when it passes a validity check. Added in v2.1.321 and still present in v2.1.321. 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_BG_DISPATCH_ENTRYPOINT=<value>
claude

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

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

Related variables

• CLAUDE_CODE_BRIDGE_CHILD_CLI_ENTRYPOINT
• CLAUDE_CODE_BRIDGE_CHILD_PROJECTS_ENTRYPOINT
• CLAUDE_AUTO_BACKGROUND_TASKS: Enable automatic background task execution.
• CLAUDE_BG_BACKEND: Set to "daemon" to route background work through a daemon backend.
• CLAUDE_BG_GATEWAY_WITHHELD: Carries the path of an LLM gateway that was set in your shell but not passed through to a background session opened from another folder.
• CLAUDE_BG_ISOLATION: Isolation mode for background agent processes — controls how separated the daemon's process space is from the foreground session.
• CLAUDE_BG_POST_CLEAR_RESPAWN: Marks a background session respawned after a clear; when set, it is treated like a resumed session so the initial agent setup is skipped.
• CLAUDE_BG_RENDEZVOUS_SOCK: Socket path for the IPC channel between a foreground Claude session and the background daemon.

Frequently asked questions

All variables, searchable: Claude Code environment variables.