CLAUDE_CODE_REPO_CHECKOUTS
Updated by Alex Sorokoletov
CLAUDE_CODE_REPO_CHECKOUTS is a Claude Code environment variable: Specifies a directory path (or paths) where Claude Code should create and manage git worktree checkouts. By default, worktrees land in a temporary location adjacent to the main repo. Added between v2.1.104 and v2.1.107 and still present in v2.1.294. It is not in the official reference.
| Status | Present in v2.1.294 |
|---|---|
| Added | Added between v2.1.104 and v2.1.107 |
| 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_REPO_CHECKOUTS=<value>
claudeTo apply it to every session, add it to the env object of a settings file:
// ~/.claude/settings.json
{
"env": {
"CLAUDE_CODE_REPO_CHECKOUTS": "<value>"
}
}Release notes that mention it
- Claude Code v2.1.107 — 6 New Environment Variables: Worktrees, Away Mode, and Stream Resilience
- Claude Code Version Tracker: Undocumented Env Vars, Feature Gates & Models
Related variables
CLAUDE_RUNNER_PRIMARY_REPO_REVISIONCLAUDE_RUNNER_REPO_REFCLAUDE_RUNNER_REPO_SOURCESANTHROPIC_BETAS: Comma-separated beta feature headers.ANTHROPIC_CUSTOM_HEADERS: Custom HTTP headers (newline-separated Key: Value).ANTHROPIC_FEDERATION_RULE_IDANTHROPIC_ORGANIZATION_IDANTHROPIC_WORKSPACE_ID
Frequently asked questions
What does CLAUDE_CODE_REPO_CHECKOUTS do?
Specifies a directory path (or paths) where Claude Code should create and manage git worktree checkouts. By default, worktrees land in a temporary location adjacent to the main repo.
Which Claude Code version has CLAUDE_CODE_REPO_CHECKOUTS?
Added between v2.1.104 and v2.1.107 and still present in v2.1.294.
How do I set CLAUDE_CODE_REPO_CHECKOUTS?
Export it before starting Claude Code (export CLAUDE_CODE_REPO_CHECKOUTS=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.