CLAUDE_CODE_BRIDGE_SETTINGS_BINDING

Updated November 9, 2026 by Alex Sorokoletov

CLAUDE_CODE_BRIDGE_SETTINGS_BINDING is a Claude Code environment variable: Binds a settings file as a 64-character hex hash and a reference joined by a colon; when set but not in that valid form, the settings file is rejected with an error. 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_CODE_BRIDGE_SETTINGS_BINDING=<value>
claude

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

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

Related variables

• CLAUDE_CODE_BRIDGE_CHILD_MACHINE_SETTINGS
• CLAUDE_BRIDGE_REATTACH_OUTBOUND_ONLY: Set to 1 to run a reattached bridge session's REPL bridge in outbound-only mode instead of fully enabling it; read until v2.1.304.
• CLAUDE_BRIDGE_REATTACH_SEQ: Sequence number for the bridge reconnection protocol.
• CLAUDE_BRIDGE_REATTACH_SESSION: Session identity used during bridge reconnection.
• CLAUDE_BRIDGE_USE_CCR_V2: Toggle for CCR v2 bridge protocol — companion to the existing CLAUDE_CODE_USE_CCR_V2 introduced in v2.1.69.
• CLAUDE_CODE_BRIDGE_CHILD_ARTIFACT: In a bridge child, counts like CLAUDE_CODE_ARTIFACT so artifact handling is not turned off by the SDK default.
• CLAUDE_CODE_BRIDGE_CHILD_AUTO_DEFAULT: Makes a bridge child default to auto mode (a pending auto decision resolves to auto); ignored when auto mode is disabled on an unattended remote session.
• CLAUDE_CODE_BRIDGE_CHILD_START_DIR: Holds the directory the session started in; on startup, if the real working directory no longer matches it, prints an error and exits with code 78.

Frequently asked questions

All variables, searchable: Claude Code environment variables.