> ## Content Index
> Fetch the complete content index at: https://claudefox.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# Claude Code version history: all 47 releases since Sep 18, 2026
- URL: https://claudefox.com/claude-code-version-history/
- Published: 2026-11-20T09:20:13.000Z
- Updated: 2026-11-20T09:21:42.000Z
- Description: 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.
- Author: hupicake
- Tags: Tips

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.__
| Version | Date   | Key changes                                                                                                                                                                                                                                 | Our coverage                                                                                  |
| ------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| 2.1.329 | Nov 19 | Folder 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.328 | Nov 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 gateway                                                          | [Our 2.1.328 post](https://claudefox.com/claude-code-2-1-328-code-review-simplify-auto-mode/) |
| 2.1.327 | Nov 17 | claude 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 problems | [Our 2.1.327 post](https://claudefox.com/claude-code-mcp-add-json-stdin-tokens/)              |
| 2.1.326 | Nov 16 | Code 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.325 | Nov 13 | Security 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.323 | Nov 12 | Experimental Code Mode, where Claude writes JavaScript to call its tools; plugins can declare a supported Claude Code version range                                                                                                         | [Our 2.1.323 post](https://claudefox.com/claude-code-2-1-323-code-mode-plugin-engines/)       |
| 2.1.322 | Nov 10 | Fast mode on Vertex AI in the global, us and eu regions (the only change listed)                                                                                                                                                            | \-                                                                                            |
| 2.1.321 | Nov 9  | Claude Fable 5.2 (claude-fable-5-2) becomes the default Fable model; claude remote-control accepts --settings <file>                                                                                                                        | \-                                                                                            |
| 2.1.319 | Nov 6  | In the terminal, MCP tool calls that run as tasks move to the background; new permissions.denyInsteadOfPrompting setting; /claude-api latency-optimize                                                                                      | \-                                                                                            |
| 2.1.318 | Nov 4  | claude auth status shows when a stored claude.ai sign-in ends, and claude -p warns 10 days before                                                                                                                                           | \-                                                                                            |
| 2.1.317 | Nov 3  | Asks 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.__
| Version | Date   | Key changes                                                                                                                                                                                                                      | Our coverage |
| ------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| 2.1.316 | Oct 31 | CLAUDE\_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.314 | Oct 30 | permissions.blockWritesOutsideWorkingDirectories setting; idle compaction comes to VS Code and the desktop app's Code tab                                                                                                        | \-           |
| 2.1.312 | Oct 27 | Click a queued message's hint to send it now in fullscreen; usage messages call the 5-hour window the "5-hour limit"                                                                                                             | \-           |
| 2.1.311 | Oct 26 | Faster 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.310 | Oct 23 | Monitor 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.309 | Oct 22 | Faster internal git commands on Windows; clearer errors when the disk is full; sandbox and PowerShell permission fixes                                                                                                           | \-           |
| 2.1.308 | Oct 22 | Bug fixes and reliability improvements (no details listed)                                                                                                                                                                       | \-           |
| 2.1.307 | Oct 21 | /claude-api api-version moves code to API version 2026-10-21; new claude\_code.safety\_event OpenTelemetry event                                                                                                                 | \-           |
| 2.1.306 | Oct 21 | Two fixes: claude -p reporting "Not logged in" in cloud sessions, and a false "prompt is too long" error with many MCP tools                                                                                                     | \-           |
| 2.1.305 | Oct 20 | sandbox.allowNestedUserNamespaces for Linux (Chromium, rootless podman); /usage warnings become one-line fixes                                                                                                                   | \-           |
| 2.1.304 | Oct 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.303 | Oct 18 | Bug fixes and reliability improvements (no details listed)                                                                                                                                                                       | \-           |
| 2.1.302 | Oct 16 | CLAUDE\_CODE\_AUTO\_MODE\_MODEL picks the client-side auto mode classifier model; Idle compaction row in /config                                                                                                                 | \-           |
| 2.1.301 | Oct 15 | % motion in vim mode; auto mode classifier verdicts added to OpenTelemetry tool\_decision events                                                                                                                                 | \-           |
| 2.1.300 | Oct 14 | /advisor on Claude Platform on AWS; OpenTelemetry GenAI attributes on trace spans; more APIs for mods                                                                                                                            | \-           |
| 2.1.299 | Oct 14 | Idle compaction in the terminal for 200K+ token chats left idle about 54 minutes; CLAUDE\_CODE\_DISABLE\_FILE\_MENTIONS                                                                                                          | \-           |
| 2.1.296 | Oct 9  | Read tool gets allow\_large for whole large files; autoCompactWindow in subagent frontmatter; CLAUDE\_CODE\_WORKFLOW\_SUBAGENT\_MODEL                                                                                            | \-           |
| 2.1.295 | Oct 8  | onFailure: "block" for command and HTTP hooks; Program Status Protocol (OSC 7501) lets terminals show whether Claude is working                                                                                                  | \-           |
| 2.1.294 | Oct 8  | Better judging of prompt hooks on Stop and SubagentStop, so Claude is less likely to stop early                                                                                                                                  | \-           |
| 2.1.293 | Oct 7  | Claude Haiku 5.5 (claude-haiku-5-5) becomes the default Haiku model on the Anthropic API                                                                                                                                         | \-           |
| 2.1.292 | Oct 6  | claude plugin install --marketplace; an effort parameter on the Agent tool; security fix for reads from network (UNC) paths                                                                                                      | \-           |
| 2.1.291 | Oct 6  | Fixes two regressions: dropped permission answers in cloud sessions (2.1.290) and lost last messages on quit (2.1.288)                                                                                                           | \-           |
| 2.1.290 | Oct 5  | claude attach <name> and claude logs <name> accept part of a session name; more fields for mod and plugin hooks                                                                                                                  | \-           |
| 2.1.289 | Oct 3  | Reverts a 2.1.288 VS Code change to claude auth status that may have caused more sign-outs                                                                                                                                       | \-           |
| 2.1.288 | Oct 2  | Up 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.287 | Oct 1  | Claude 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.__
| Version | Date   | Key changes                                                                                                                    | Our coverage |
| ------- | ------ | ------------------------------------------------------------------------------------------------------------------------------ | ------------ |
| 2.1.286 | Sep 30 | Stacked permission prompts show a count such as "2 of 5"; Claude is told to run a project skill named verify before committing | \-           |
| 2.1.285 | Sep 29 | claude --desktop opens the desktop app on the current folder; claude plugin configure; allowedProviders managed setting        | \-           |
| 2.1.284 | Sep 28 | Claude Sonnet 5.5 (claude-sonnet-5-5) becomes the default Sonnet model on the Anthropic API; /mcp reconnect all                | \-           |
| 2.1.283 | Sep 25 | /doctor prompt-audit checks CLAUDE.md, skills and agents for prompts written for older models; deniedModels managed setting    | \-           |
| 2.1.282 | Sep 24 | maxProseWidth setting caps prose width in wide terminals; faster resume of very large sessions                                 | \-           |
| 2.1.281 | Sep 23 | "attribution": false hides commit and PR attribution; MCP URL-mode elicitation; MCP checks in claude plugin validate           | \-           |
| 2.1.280 | Sep 22 | Claude Opus 5.5 (claude-opus-5-5) becomes the default Opus model; CLAUDE\_CODE\_MAX\_MCP\_DESCRIPTION\_LENGTH                  | \-           |
| 2.1.278 | Sep 19 | Auto mode defaults to the server-side classifier for API and Enterprise users and on Bedrock, Vertex AI, Foundry and gateways  | \-           |
| 2.1.277 | Sep 18 | Reads AGENTS.md in a project that has no CLAUDE.md; switch it under "Project instructions" in /config                          | \-           |
| 2.1.276 | Sep 18 | Fixes 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.

| Page                                                                                                                   | What it covers                                                    |
| ---------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| [Claude Code features, releases and tips: our full coverage](https://claudefox.com/claude-code-features-and-releases/) | Our hub for Claude Code feature and release posts.                |
| [Claude Code plugins, skills and MCP servers](https://claudefox.com/claude-code-plugins-skills-mcp-servers/)           | Our hub for posts on Claude Code plugins, skills and MCP servers. |

## Related on claudefox

- [Claude Code 2.1.323 adds an experimental Code Mode and version ranges for plugins](https://claudefox.com/claude-code-2-1-323-code-mode-plugin-engines/)
- [Claude Code vs Codex CLI (2026): which coding agent to use](https://claudefox.com/claude-code-vs-codex/)
- [Claude Code features, releases and tips: our full coverage](https://claudefox.com/claude-code-features-and-releases/)
- [Claude Code vs GitHub Copilot (2026): pricing, Claude models, which to use](https://claudefox.com/claude-code-vs-github-copilot/)

Source: [Claude Code changelog (docs)](https://code.claude.com/docs/en/changelog?ref=claudefox.com), [CHANGELOG.md, anthropics/claude-code](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md?ref=claudefox.com), [Claude Code releases on GitHub](https://github.com/anthropics/claude-code/releases?ref=claudefox.com), [Set up Claude Code: update, release channels, install a specific version](https://code.claude.com/docs/en/setup?ref=claudefox.com), [@anthropic-ai/claude-code on npm](https://www.npmjs.com/package/@anthropic-ai/claude-code?ref=claudefox.com)