CLAUDE_CODE_USE_CCR_V2
Updated by Alex Sorokoletov
CLAUDE_CODE_USE_CCR_V2 is a Claude Code environment variable: Use Claude Code Router v2 for cowork sessions. Present since v2.1.69 or earlier and still present in v2.1.294. It is not in the official reference.
| Status | Present in v2.1.294 |
|---|---|
| Added | Present since v2.1.69 or earlier |
| Category | Other |
| Official docs | Not listed |
How to set it
For one session, export it in the shell that starts Claude Code:
export CLAUDE_CODE_USE_CCR_V2=<value>
claudeTo apply it to every session, add it to the env object of a settings file:
// ~/.claude/settings.json
{
"env": {
"CLAUDE_CODE_USE_CCR_V2": "<value>"
}
}Release notes that mention it
- Claude Code v2.1.209 — Auto Mode Grows Up
- Claude Code v2.1.70 — 3 New Environment Variables and 1 Removed
- 165 Environment Variables in Claude Code 2.1.69 — What Changed in 50 Versions
Related variables
CLAUDE_CODE_USE_GATEWAY: Routes traffic through an Anthropic-operated gateway (with loopback and log-level tuning).CLAUDE_CODE_USE_NATIVE_FILE_SEARCHUSE_BUILTIN_RIPGREP: Force use of built-in ripgrep.CLAUDE_CODE_CCR_EARLY_HYDRATE_PREFETCHCLAUDE_CODE_CCR_FOLD_FIRST_TURN_RESCANCLAUDE_CODE_CCR_SURFACEANTHROPIC_BETAS: Comma-separated beta feature headers.ANTHROPIC_CUSTOM_HEADERS: Custom HTTP headers (newline-separated Key: Value).
Frequently asked questions
What does CLAUDE_CODE_USE_CCR_V2 do?
Use Claude Code Router v2 for cowork sessions
Which Claude Code version has CLAUDE_CODE_USE_CCR_V2?
Present since v2.1.69 or earlier and still present in v2.1.294.
How do I set CLAUDE_CODE_USE_CCR_V2?
Export it before starting Claude Code (export CLAUDE_CODE_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.