CLAUDE_CODE_CCR_SKIP_NEEDLESS_STARTUP_READS
Updated by Alex Sorokoletov
CLAUDE_CODE_CCR_SKIP_NEEDLESS_STARTUP_READS is a Claude Code environment variable: When set, skips the worktree-fallback resume lookup while the worker epoch is 1, returning no result, and runs an extra store step after a memory sync. Added between v2.1.321 and v2.1.323 and still present in v2.1.324. It is not in the official reference.
| Status | Present in v2.1.324 |
|---|---|
| Added | Added between v2.1.321 and v2.1.323 |
| Category | Feature toggles |
| Official docs | Not listed |
How to set it
For one session, export it in the shell that starts Claude Code:
export CLAUDE_CODE_CCR_SKIP_NEEDLESS_STARTUP_READS=<value>
claudeTo apply it to every session, add it to the env object of a settings file:
// ~/.claude/settings.json
{
"env": {
"CLAUDE_CODE_CCR_SKIP_NEEDLESS_STARTUP_READS": "<value>"
}
}Related variables
CLAUDE_CODE_CCR_SKIP_FRESH_MIGRATIONS: When set, and other conditions hold, skips running config migrations, instead marking the migration version as current and the migrations as already complete.CLAUDE_CODE_CCR_SKIP_HYDRATE_ON_CURRENT_TIP: When set during connect, supplies the current tip position to hydration reads and the session link; otherwise those run without a tip position.CCR_FORCE_BUNDLECLAUDE_CODE_DISABLE_EMPTY_CLASSIC_DISPATCH_SKIP: When set, prevents skipping a classic hook dispatch even when all its registered handlers satisfy the skip check, so the dispatch always runs.CLAUDE_CODE_DISABLE_STARTUP_WORK_GATE: When set, disables the startup work gate that defers background work until startup settles, so the gate is never armed.CLAUDE_CODE_SKIP_PROMPT_HISTORY: Disable prompt history saving.CLAUDE_RUNNER_SKIP_GIT_VERIFY: Set to 1 to skip checking that a checkout hook left a .git directory, for non-git source control systems; otherwise a missing .git fails the checkout.CLAUDE_CODE_SKIP_HFI_VERSION_CHECK
Frequently asked questions
What does CLAUDE_CODE_CCR_SKIP_NEEDLESS_STARTUP_READS do?
When set, skips the worktree-fallback resume lookup while the worker epoch is 1, returning no result, and runs an extra store step after a memory sync.
Which Claude Code version has CLAUDE_CODE_CCR_SKIP_NEEDLESS_STARTUP_READS?
Added between v2.1.321 and v2.1.323 and still present in v2.1.324.
How do I set CLAUDE_CODE_CCR_SKIP_NEEDLESS_STARTUP_READS?
Export it before starting Claude Code (export CLAUDE_CODE_CCR_SKIP_NEEDLESS_STARTUP_READS=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.