RSS
Tips

Claude Code version history: all 47 releases since Sep 18, 2026

Claude Code's current version (2.1.329 on latest, 2.1.311 on stable as of Nov 20, 2026), how to check and update yours, and a table of 47 releases since Sep 18 with what each changed.

A computer screen with a bunch of code on it illustrating Claude Code version history
Photo by Chris Ried on Unsplash

As of November 20, 2026, the newest Claude Code release is 2.1.329, published on November 19. The stable release channel serves 2.1.311, from October 26. Run claude --version in your shell to see which version you have, and claude update to install the newest version on your channel.

Below: how to check and update, what the two release channels mean, a table of the 47 releases from September 18 to November 19 with one line on what each changed, and how to pin a version. Dates are from the official changelog and match the GitHub release dates (UTC). Version numbers with no changelog entry or GitHub release are not listed; some of them, such as 2.1.324 and 2.1.315, were published to npm without one.

How to check and update your Claude Code version

  • Check: claude --version prints your version number followed by "(Claude Code)".
  • Update now: claude update. It prints a line ending with "to version <new version>", or "Claude Code is up to date (<version>)" if you already have the newest one on your channel. Homebrew, WinGet and apk installs print "Claude is up to date!" instead.
  • Diagnose: claude doctor prints install health and the result of the last update attempt without starting a session.
  • Native installs update themselves in the background; the new version takes effect the next time you start Claude Code.
  • Homebrew and WinGet do not auto-update by default: run brew upgrade claude-code (or brew upgrade claude-code@latest) or winget upgrade Anthropic.ClaudeCode. To have Claude Code run that upgrade for you in the background, set CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE to 1.
  • apt, dnf and apk always need a manual upgrade: sudo apt update && sudo apt upgrade claude-code, sudo dnf upgrade claude-code, or apk update && apk upgrade claude-code.
  • npm: npm install -g @anthropic-ai/claude-code@latest. The docs advise against npm update -g, which keeps the semver range from your original install and may not reach the newest release.

Latest or stable: which release channel you are on

Claude Code has two release channels, set with autoUpdatesChannel in settings.json or under Auto-update channel in /config. "latest" is the default and gets each release as it ships. "stable" serves a version the docs describe as typically about one week old, skipping releases with major regressions. The gap can be longer: on November 20, stable's 2.1.311 was 25 days old. On November 20, 2026 the channel files on Anthropic's download server read 2.1.329 for latest and 2.1.311 for stable, and npm's dist-tags for @anthropic-ai/claude-code match.

Homebrew picks the channel by cask name: claude-code tracks stable and claude-code@latest tracks latest. The apt, dnf and apk repositories pick it by repository URL. The docs also note that a newly launched model can need a newer version than stable serves; to use it right away, move to latest.

Claude Code releases in November 2026

Eleven releases from November 3 to November 19. In our reading the biggest changes for day-to-day use are Code Mode (2.1.323), an experimental opt-in, and /code-review, which since 2.1.328 reports only bugs and CLAUDE.md violations and since 2.1.329 reviews the whole branch when given no target. After 2.1.329, most scheduled tasks saved by earlier versions need scheduling again in new signed-in sessions, though --resume of their own session still runs them.

Source: Claude Code changelog and GitHub releases, read Nov 20, 2026. Most releases also list many fixes not summarised here.
VersionDateKey changesOur coverage
2.1.329Nov 19Folder trust dialog now says where a folder's hooks are declared; /tasks lists scheduled tasks and /loop wakeups; /code-review with no target reviews the whole branch on most models-
2.1.328Nov 19/code-review reports only bugs and CLAUDE.md violations (cleanups move to /simplify); auto mode for Opus 4.6 and Sonnet 4.6 on Bedrock, Google Cloud, Foundry and the apps gatewayOur 2.1.328 post
2.1.327Nov 17claude mcp add-json <name> - reads a server's JSON from stdin so tokens stay off the command line (not available inside a Claude Code session); /status lists broken agent, skill, command and output style files and other config problemsOur 2.1.327 post
2.1.326Nov 16Code Mode can be turned on while agent teams are enabled; many sandbox and permission fixes, and Claude's file tools now refuse writes to Claude Code's sign-in files such as .credentials.json-
2.1.325Nov 13Security fix for decoding zstd-compressed responses; subagents cut off at the output limit are asked for a shorter full answer; clearer next steps when an organization policy blocks a request-
2.1.323Nov 12Experimental Code Mode, where Claude writes JavaScript to call its tools; plugins can declare a supported Claude Code version rangeOur 2.1.323 post
2.1.322Nov 10Fast mode on Vertex AI in the global, us and eu regions (the only change listed)-
2.1.321Nov 9Claude Fable 5.2 (claude-fable-5-2) becomes the default Fable model; claude remote-control accepts --settings <file>-
2.1.319Nov 6In the terminal, MCP tool calls that run as tasks move to the background; new permissions.denyInsteadOfPrompting setting; /claude-api latency-optimize-
2.1.318Nov 4claude auth status shows when a stored claude.ai sign-in ends, and claude -p warns 10 days before-
2.1.317Nov 3Asks before a web or shell call sends your account email address to the network; Agent SDK hook callbacks can block on failure-

Claude Code releases in October 2026

Twenty-six releases. Claude Mods arrived on October 1 (2.1.287), idle compaction on October 14 (2.1.299), and Haiku 5.5 became the default Haiku model on October 7 (2.1.293).

Source: Claude Code changelog and GitHub releases, read Nov 20, 2026. Most releases also list many fixes not summarised here.
VersionDateKey changesOur coverage
2.1.316Oct 31CLAUDE_CODE_DISABLE_ULTRATHINK and CLAUDE_CODE_SUBAGENT_EFFORT; fast mode for Opus 4.8 deprecated and set for removal on Nov 30, 2026, after which those requests return an error (the changelog says to move to Opus 5.5)-
2.1.314Oct 30permissions.blockWritesOutsideWorkingDirectories setting; idle compaction comes to VS Code and the desktop app's Code tab-
2.1.312Oct 27Click a queued message's hint to send it now in fullscreen; usage messages call the 5-hour window the "5-hour limit"-
2.1.311Oct 26Faster startup for Pro and Max accounts; /teleport warns when a compacted cloud session loads. This is the stable channel's version on Nov 20-
2.1.310Oct 23Monitor tool and plugin monitors on Bedrock, Vertex AI and Foundry, and when telemetry or nonessential traffic is off; long foreground sleeps are blocked in those setups too-
2.1.309Oct 22Faster internal git commands on Windows; clearer errors when the disk is full; sandbox and PowerShell permission fixes-
2.1.308Oct 22Bug fixes and reliability improvements (no details listed)-
2.1.307Oct 21/claude-api api-version moves code to API version 2026-10-21; new claude_code.safety_event OpenTelemetry event-
2.1.306Oct 21Two fixes: claude -p reporting "Not logged in" in cloud sessions, and a false "prompt is too long" error with many MCP tools-
2.1.305Oct 20sandbox.allowNestedUserNamespaces for Linux (Chromium, rootless podman); /usage warnings become one-line fixes-
2.1.304Oct 19/auto-mode-setup guided setup; /claude-api managed-agents-secure; on Pro and Max plans, a warning before resuming a chat that would use a noticeable share of the 5-hour limit-
2.1.303Oct 18Bug fixes and reliability improvements (no details listed)-
2.1.302Oct 16CLAUDE_CODE_AUTO_MODE_MODEL picks the client-side auto mode classifier model; Idle compaction row in /config-
2.1.301Oct 15% motion in vim mode; auto mode classifier verdicts added to OpenTelemetry tool_decision events-
2.1.300Oct 14/advisor on Claude Platform on AWS; OpenTelemetry GenAI attributes on trace spans; more APIs for mods-
2.1.299Oct 14Idle compaction in the terminal for 200K+ token chats left idle about 54 minutes; CLAUDE_CODE_DISABLE_FILE_MENTIONS-
2.1.296Oct 9Read tool gets allow_large for whole large files; autoCompactWindow in subagent frontmatter; CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL-
2.1.295Oct 8onFailure: "block" for command and HTTP hooks; Program Status Protocol (OSC 7501) lets terminals show whether Claude is working-
2.1.294Oct 8Better judging of prompt hooks on Stop and SubagentStop, so Claude is less likely to stop early-
2.1.293Oct 7Claude Haiku 5.5 (claude-haiku-5-5) becomes the default Haiku model on the Anthropic API-
2.1.292Oct 6claude plugin install --marketplace; an effort parameter on the Agent tool; security fix for reads from network (UNC) paths-
2.1.291Oct 6Fixes two regressions: dropped permission answers in cloud sessions (2.1.290) and lost last messages on quit (2.1.288)-
2.1.290Oct 5claude attach <name> and claude logs <name> accept part of a session name; more fields for mod and plugin hooks-
2.1.289Oct 3Reverts a 2.1.288 VS Code change to claude auth status that may have caused more sign-outs-
2.1.288Oct 2Up on an empty prompt restores a draft cleared with Ctrl+C; /code-review --max-findings; re-auth prompt when an MCP server needs more OAuth scope-
2.1.287Oct 1Claude Mods: plugins may now modify deeper behavior; built-in "You should know" mod flags things you or Claude might miss-

Claude Code releases in September 2026 (from 2.1.276)

The last ten September releases, from September 18. Opus 5.5 (2.1.280) and Sonnet 5.5 (2.1.284) became the default models for their tiers, and AGENTS.md support landed in 2.1.277.

Source: Claude Code changelog and GitHub releases, read Nov 20, 2026. Most releases also list many fixes not summarised here.
VersionDateKey changesOur coverage
2.1.286Sep 30Stacked permission prompts show a count such as "2 of 5"; Claude is told to run a project skill named verify before committing-
2.1.285Sep 29claude --desktop opens the desktop app on the current folder; claude plugin configure; allowedProviders managed setting-
2.1.284Sep 28Claude Sonnet 5.5 (claude-sonnet-5-5) becomes the default Sonnet model on the Anthropic API; /mcp reconnect all-
2.1.283Sep 25/doctor prompt-audit checks CLAUDE.md, skills and agents for prompts written for older models; deniedModels managed setting-
2.1.282Sep 24maxProseWidth setting caps prose width in wide terminals; faster resume of very large sessions-
2.1.281Sep 23"attribution": false hides commit and PR attribution; MCP URL-mode elicitation; MCP checks in claude plugin validate-
2.1.280Sep 22Claude Opus 5.5 (claude-opus-5-5) becomes the default Opus model; CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH-
2.1.278Sep 19Auto mode defaults to the server-side classifier for API and Enterprise users and on Bedrock, Vertex AI, Foundry and gateways-
2.1.277Sep 18Reads AGENTS.md in a project that has no CLAUDE.md; switch it under "Project instructions" in /config-
2.1.276Sep 18Fixes a 2.1.275 regression where every request failed when ANTHROPIC_BASE_URL pointed at a proxy or gateway-

How to pin or roll back a Claude Code version

The setup docs do not describe rollback as its own command. What they do document are three settings and steps that together let you hold or return to a version on a native install.

1. Install a specific version number. The native installer takes a version number, "stable" or "latest". The example below installs 2.1.311, the stable version on November 20; from 2.1.329 that is a downgrade that drops later fixes, including 2.1.325's zstd security fix, so pick the version you actually need. On macOS, Linux and WSL:

curl -fsSL https://claude.ai/install.sh | bash -s 2.1.311

On Windows PowerShell the same step is:

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.311

Confirm with claude --version, which prints the version you installed. If you pass a channel name (stable or latest) instead of a number, the docs say that channel becomes your default for auto-updates. The installer refuses to run under sudo; it installs into your home directory.

2. Stop background updates, or a native install will update itself again. Add this to settings.json; on a native or npm install, claude doctor should then show Auto-updates as disabled:

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

DISABLE_AUTOUPDATER only stops the background check; claude update still works. DISABLE_UPDATES blocks every update path, including manual ones; the docs aim it at teams that distribute Claude Code through their own channels.

3. Or move to the stable channel. With autoUpdatesChannel set to "stable", the docs say a native install updates to the stable version even when it is older than yours. To switch to stable without going backwards, also set minimumVersion to the version you run now:

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.323"
}

With that file an install on 2.1.323 stays there until stable serves something newer. If you set this up in /config and later switch back to latest there, Claude Code clears the minimum. Organizations can enforce versions in managed settings: minimumVersion there can't be overridden, and requiredMinimumVersion and requiredMaximumVersion make Claude Code refuse to start outside a range.

More on Claude Code releases

We write up the releases that change day-to-day use; they are linked in the tables above. For everything we have covered on Claude Code features, see the features and releases hub.

PageWhat it covers
Claude Code features, releases and tips: our full coverageOur hub for Claude Code feature and release posts.
Claude Code plugins, skills and MCP serversOur hub for posts on Claude Code plugins, skills and MCP servers.

Source: Claude Code changelog (docs), CHANGELOG.md, anthropics/claude-code, Claude Code releases on GitHub, Set up Claude Code: update, release channels, install a specific version, @anthropic-ai/claude-code on npm