CLAUDE_BRIDGE_USE_CCR_V2

Updated October 13, 2026 by Alex Sorokoletov

CLAUDE_BRIDGE_USE_CCR_V2 is a Claude Code environment variable: Toggle for CCR v2 bridge protocol — companion to the existing CLAUDE_CODE_USE_CCR_V2 introduced in v2.1.69. Suggests the bridge layer (IDE extensions, remote sessions) is being migrated to the same v2 router used by cowork/multi-agent. Removed between v2.1.143 and v2.1.212, so current releases ignore it. It is not in the official reference.

Status	Removed between v2.1.143 and v2.1.212
Added	Added in v2.1.70
Category	Sessions
Official docs	Not listed

How to set it

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

export CLAUDE_BRIDGE_USE_CCR_V2=<value>
claude

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

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

Release notes that mention it

Related variables

CLAUDE_BRIDGE_REATTACH_SEQ: Sequence number for the bridge reconnection protocol.
CLAUDE_BRIDGE_REATTACH_SESSION: Session identity used during bridge reconnection.
CLAUDE_CODE_BRIDGE_SESSION_ID
CLAUDE_BRIDGE_REATTACH_GROUPING
CLAUDE_BRIDGE_REATTACH_NO_BACKFILL
CLAUDE_BRIDGE_REATTACH_OUTBOUND_ONLY
CLAUDE_BRIDGE_REATTACH_OWNER_ACCT
CLAUDE_BRIDGE_REATTACH_OWNER_ORG

Frequently asked questions

What does CLAUDE_BRIDGE_USE_CCR_V2 do?

Toggle for CCR v2 bridge protocol — companion to the existing CLAUDE_CODE_USE_CCR_V2 introduced in v2.1.69. Suggests the bridge layer (IDE extensions, remote sessions) is being migrated to the same v2 router used by cowork/multi-agent.

Which Claude Code version has CLAUDE_BRIDGE_USE_CCR_V2?

Removed between v2.1.143 and v2.1.212, so current releases ignore it.

How do I set CLAUDE_BRIDGE_USE_CCR_V2?

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