Follow Discord
Sweep 12 Nov 2026 · 23:00Z Build v2.1.323 540 read Stable v2.1.311 Latest v2.1.323 Next v2.1.323 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.284 ·

Remote-session uploads from git worktrees handle per-worktree config differently

Per-worktree git config now has an 'inert' state with its own error message, and the refuse policy now rejects any worktree config that is present

Group of 2 You'll notice Improvements
JSON All of v2.1.284
You'll noticeTier: how much it should matter to you
1Useful: my rating, 1 to 5
1Signal: worth watching, 1 to 5
GitArea: what it touches
ImprovementsKind: in v2.1.284,
ImprovementsSection of the release

Unclear It is not clear which worktree configuration states exist besides absent, extension and file, or exactly when this check runs.

What

A git worktree is an extra checkout of the same repository in another folder. Such a checkout can have its own settings file, config.worktree, which git uses when extensions.worktreeConfig is turned on. When Claude Code packages a repository to send to a remote or cloud session, it checks for these settings.

  • Detection now has three states: extension, inert (a config.worktree file that contains only harmless keys) and file. Before, there was a single yes-or-no check for the extensions.worktreeConfig extension.
  • If the upload fails at the step that handles the worktree's administrative folder, the inert case now has its own explanation. It says that a per-worktree configuration file (config.worktree) stands in its administrative entry.
  • The tamper check for linked worktrees is stricter. When the policy is "refuse", any worktree config state other than "absent" is treated as tampered. Before, only the "extension" state was refused.
  • Upload diagnostics also record an inert_config worktree check.

Why

If you start remote sessions from a linked worktree, error messages are clearer when a config.worktree file gets in the way. More worktree setups may also be rejected as tampered during sync than before.

Read from
Names in the bundleextensions.worktreeConfig
Since it was published

The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.

Added since A small documentation edit on Set up Claude Code in a monorepo or large codebase touched a line naming extensions.worktreeConfig after this was published. Sparse checkout requires git to enable `extensions.worktreeConfig` in the repository's shared `.git/config` while a sparse worktree exists. Claude Code removes that entry after the last worktree is removed, but only if Claude Code added it… large-codebases see the edit
How sure we are
Something disagreesSomething we can check disagrees with this entry, or the writer said they could not settle it.
The writer flagged doubtIt is not clear which worktree configuration states exist besides absent, extension and file, or exactly when this check runs.
Anthropic's documentation agreesA small documentation edit on Set up Claude Code in a monorepo or large codebase touched a line naming extensions.worktreeConfig after this…

See this entry in the whole of v2.1.284 →

Feedback