How to Update Claude Code (and Read the Changelog)

How to update Claude Code: run claude update, upgrade Homebrew, WinGet and npm installs, pick a release channel, turn off auto-updates and read the changelog.

Josh Pocock7 min read

Update Claude Code cover

AI Coding

Update Claude Code

Stride AI Academy

To update Claude Code, run claude update in your terminal. Native installs also update themselves in the background, so most people never need to. Homebrew, WinGet and npm installs don't, and each has its own upgrade command. Whichever route you use, the new version takes effect the next time you start Claude Code.

This guide covers how to check your version, the update command for each install method, release channels, pinning and turning off auto-updates, and where to read the changelog. Everything here was checked against Claude Code's setup docs, CLI reference, environment variables reference, commands reference and changelog on November 22, 2026. If you haven't installed it yet, start with how to install Claude Code.

Check which version you have

Terminal
claude --version

It prints a version number followed by (Claude Code). The short form claude -v does the same. Inside a session, /status shows your version along with your model and account.

Update Claude Code with claude update

Terminal
claude update

This applies an update straight away instead of waiting for the next background check. When something installs, the output ends with to version <new version>. If you're already current, it reports Claude Code is up to date (<version>). Homebrew, WinGet and apk installs report Claude is up to date! instead.

Then quit and start Claude Code again. Type /exit, then run claude --continue in the same folder to pick your conversation back up.

If you mistype it, Claude Code catches that. The CLI reference says claude udpate prints Did you mean claude update? and exits.

How to update the Claude Code CLI for each install method

Native installs update themselves, and npm installs do when npm's global folder is writable. The others need a command:

Installed with Auto-updates? Upgrade command
Native installer Yes, in the background claude update
Homebrew (stable cask) No brew upgrade claude-code
Homebrew (latest cask) No brew upgrade claude-code@latest
WinGet No winget upgrade Anthropic.ClaudeCode
npm Yes, if npm's global folder is writable npm install -g @anthropic-ai/claude-code@latest
apt No sudo apt update && sudo apt upgrade claude-code
dnf No sudo dnf upgrade claude-code
apk No apk update && apk upgrade claude-code

A few notes from the setup docs:

  • npm: avoid npm update -g. It respects the version range from your original install and may not move you to the newest release. Never add sudo, because an install that needs sudo can't update itself.
  • Homebrew: old versions stay on disk after upgrades. Run brew cleanup now and then.
  • Package managers: the docs list a known issue. Claude Code may tell you about an update before it reaches Homebrew, WinGet or the Linux repositories. If the upgrade fails, wait and try again later.

Not sure how you installed it? On Mac or Linux, which -a claude lists every copy on your PATH. On Windows PowerShell, use where.exe claude. Two copies usually explain an "old version keeps running" problem. Our Claude Code on Windows guide covers the Windows side in more detail.

Let Claude Code upgrade Homebrew or WinGet for you

Set CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE to 1 and Claude Code runs the Homebrew or WinGet upgrade in the background when a new version is out, then shows a restart prompt. It only upgrades the Claude Code package. On WinGet it can fail while Claude Code is running, because Windows locks the file, and then you get the manual command instead. apt, dnf and apk always need a manual upgrade, since they need admin rights.

How Claude Code auto-updates work

On a native install, Claude Code checks for updates when it starts and from time to time while it runs. Updates download and install in the background, then apply on your next start.

To see whether the last attempt worked, run:

Terminal
claude doctor

It prints read-only diagnostics, including the result of the last update attempt.

Pick a release channel

The autoUpdatesChannel setting controls which builds you get, for both auto-updates and claude update:

  • "latest" is the default. New features arrive as soon as they ship.
  • "stable" gives you a version that's usually about a week old and skips releases with major regressions.

Switch it in /config under Auto-update channel, or in your settings.json:

JSON
{
  "autoUpdatesChannel": "stable"
}

Two things to know. First, moving to stable can downgrade you, because stable may be older than what you're on. Second, a newly launched model can need a version newer than stable serves. If you want that model now, stay on latest.

Homebrew picks a channel by cask name instead: claude-code is stable and claude-code@latest is latest. The apt, dnf and apk repositories pick it by repository URL.

Switch to stable without a downgrade

Pin a minimum version at the same time. Run claude --version, then set minimumVersion to that number:

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

That's the docs' own example. Updates then refuse anything below 2.1.323, so you stay put until stable catches up. In /config, switching the channel to stable offers the same option and fills in your version for you.

For a company rollout, admins can set minimumVersion in managed settings, which users can't override. The managed keys requiredMinimumVersion and requiredMaximumVersion go further and stop Claude Code from starting outside a version range.

Install a specific version

The native installer takes a version number or a channel name:

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

Swap stable for a version number to get that exact build. From an existing install, claude install stable or claude install <version> does the same job.

How to turn off Claude Code auto-updates

Add DISABLE_AUTOUPDATER to the env block in your settings file:

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

Run claude doctor to confirm. The Auto-updates line should read disabled (set by env: DISABLE_AUTOUPDATER).

This only stops the background check. claude update and claude install still work. To block every update path, including manual ones, set DISABLE_UPDATES to 1 instead. The docs suggest that for teams that hand out Claude Code through their own channels. Both variables are covered with the others in our guide to Claude Code environment variables.

Where to find the Claude Code changelog

There are three places to read the release notes:

  1. Inside Claude Code. Run /release-notes. It opens a version picker, and the notes appear in your transcript without being added to the conversation Claude sees.
  2. The docs. The Claude Code changelog page lists each version with Added, Changed and Fixed sections.
  3. GitHub. The docs page is generated from CHANGELOG.md in the claude-code repo.

On November 22, 2026, the newest entry on the changelog page was 2.1.330, dated November 20, 2026. Releases come often, so check the page for the current one.

Why the version matters

Some features and models need a minimum version. The model configuration docs say Opus 5.5 needs v2.1.280 or later, Sonnet 5.5 needs v2.1.284, Haiku 5.5 needs v2.1.293 and Fable 5.2 needs v2.1.321. If a model fails with "Claude Code does not support this model", update first. Our guide to changing the model in Claude Code covers picking one once you're current.

Fix a Claude Code update that didn't work

Problem Fix
claude --version still shows the old number Restart Claude Code. Updates apply on the next start
An old version keeps running You have two installs. Find them with which -a claude or where.exe claude and remove the extra
claude doctor shows a failed update See the install troubleshooting docs for your error
npm can't update Fix permissions on npm's global folder. Don't reinstall with sudo
Homebrew or WinGet says it's up to date, but you were told otherwise The package may not be published yet. Try again later

If you'd rather start from scratch, our guide to uninstalling Claude Code has the remove commands for every install method.

Learn to build with Claude Code

The Stride AI Coding course teaches Claude Code and Codex for building client tools, written for non-programmers, with weekly live calls to review your builds. Many of the free guides cover Claude Code setups, and the Claude Code community is where members compare theirs.

FAQ

How do I update Claude Code?

Run claude update in your terminal, then restart Claude Code. Native installs also update automatically in the background. Homebrew needs brew upgrade claude-code and WinGet needs winget upgrade Anthropic.ClaudeCode.

Does Claude Code update automatically?

Native installs do, and npm installs do when npm's global folder is writable. Homebrew, WinGet, apt, dnf and apk installs don't by default. Setting CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 makes Claude Code run the Homebrew or WinGet upgrade for you.

How do I upgrade Claude Code installed with npm?

Run npm install -g @anthropic-ai/claude-code@latest, without sudo. Don't use npm update -g, because it keeps you inside the version range of your original install and may not reach the newest release.

How do I stop Claude Code from updating?

Set DISABLE_AUTOUPDATER to 1 in the env block of your settings file to stop background updates. claude update still works. To block manual updates too, set DISABLE_UPDATES to 1.

Where are the Claude Code release notes?

Run /release-notes inside Claude Code, or read the changelog page in the Claude Code docs. Both come from CHANGELOG.md in Anthropic's claude-code repository on GitHub.

What is the stable channel in Claude Code?

It's a release channel that serves a version about a week old and skips releases with major regressions. Set "autoUpdatesChannel": "stable" in settings, and set minimumVersion too if you don't want to be moved to an older build.

Build it with us in Stride AI Academy

Four courses, weekly live calls and a community of people building and selling AI. Or start with 320+ free guides.

Keep reading

Free AI Coding guides