CLAUDE_CODE_DIR_SYNC_ARCHIVE
Updated by Alex Sorokoletov
CLAUDE_CODE_DIR_SYNC_ARCHIVE is a Claude Code environment variable: Enabled the archive engine of directory sync, keeping archived copies alongside synced files; read until v2.1.245. Removed between v2.1.245 and v2.1.247, so current releases ignore it. It is not in the official reference.
| Status | Removed between v2.1.245 and v2.1.247 |
|---|---|
| Added | Added between v2.1.238 and v2.1.241 |
| 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_DIR_SYNC_ARCHIVE=<value>
claudeTo apply it to every session, add it to the env object of a settings file:
// ~/.claude/settings.json
{
"env": {
"CLAUDE_CODE_DIR_SYNC_ARCHIVE": "<value>"
}
}Release notes that mention it
Related variables
CLAUDE_CODE_DIR_SYNC_ENGINE: Took a comma-separated list of words controlling directory sync; none, off, 0, false or no turned it off, otherwise it stayed enabled.CLAUDE_CODE_DIR_SYNC_GIT: Enabled the git engine of directory sync, starting the git-based sync worker and opening the sync gate; read until v2.1.284.CLAUDE_CODE_DIR_SYNC_FFWDCLAUDE_CODE_DIR_SYNC_OVERLAYCLAUDE_CODE_CCR_EARLY_SYNC_AFTER_SETTINGS_REFUSAL: When set, still runs the early sync after a settings load fails with an HTTP 403 refusal, instead of taking the default path.CLAUDE_CODE_FEDERATION_CACHE_DIR: Points at the directory holding the exchanged workload-identity-federation credential (default <config>/credentials/federation).CLAUDE_CODE_PROJECT_DIR_NAME: When CLAUDE_CONFIG_DIR is set, picks a short name for the per-project transcript directory so a host that gives each session its own config directory can label it.CLAUDE_CODE_SYNC_REUSE_WITHIN_MS: Number of milliseconds within which a recent sync result may be reused instead of syncing again; only a positive value takes effect.
Frequently asked questions
What does CLAUDE_CODE_DIR_SYNC_ARCHIVE do?
Enabled the archive engine of directory sync, keeping archived copies alongside synced files; read until v2.1.245.
Which Claude Code version has CLAUDE_CODE_DIR_SYNC_ARCHIVE?
Removed between v2.1.245 and v2.1.247, so current releases ignore it.
How do I set CLAUDE_CODE_DIR_SYNC_ARCHIVE?
Export it before starting Claude Code (export CLAUDE_CODE_DIR_SYNC_ARCHIVE=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.