Skip to content

Releases · Claude

Claude Code 2.1.311 release notes

Version
2.1.311
Released
Status
Stable release

What's new in Claude Code 2.1.311

The official notes for Claude Code 2.1.311 list 92 changes: 2 new features, 46 fixes, 2 performance improvements, 1 security change and 41 other changes.

  • 2 new features
  • 46 fixes
  • 2 performance improvements
  • 1 security change
  • 41 other changes

Highlights

  • security change Fixed /mcp showing "authenticated" for a remote server that Claude Code sends no credentials to
  • new feature Added --hold-idle-file and --max-hold-min to self-hosted-runner, to keep an idle session while your host reports processes it left running
  • new feature Added a tip for the Explanatory output style, shown when you ask Claude for explanations
  • performance improvement Improved startup time for Pro and Max accounts by skipping two network requests on launches within an hour of the…
  • performance improvement Improved startup time for launches whose only arguments are options and their values, such as claude --model opus

Our short summary: changes are counted and classified automatically from the official notes, and highlights are shortened. The complete, authoritative list is in the official release notes on GitHub.

Full release notes on GitHub (Claude Code 2.1.311)

How to check your version and update Claude Code

  1. Check the installed version:
    claude --version
  2. Native installs update themselves in the background. To update right now:
    claude update
  3. Install exactly 2.1.311 (macOS, Linux, WSL):
    curl -fsSL https://claude.ai/install.sh | bash -s 2.1.311
  4. Homebrew does not auto-update. The claude-code cask follows the stable channel, claude-code@latest the latest one:
    brew upgrade claude-code
  5. WinGet:
    winget upgrade Anthropic.ClaudeCode
  6. npm (use install @latest, not npm update -g):
    npm install -g @anthropic-ai/claude-code@latest

Claude Code has two release channels: latest (the default) gets every version as it ships; stable runs about a week behind and skips releases with major regressions. Change it under /config → Auto-update channel or with the autoUpdatesChannel setting.

Installing for the first time, or on Windows? How to install and update Claude Code.

Commands from the official docs: Claude Code: Advanced setup.

Latest Claude Code version

2.1.312

Released · Official notes on GitHub

All Claude Code release notes · All releases

Also tracked: Claude news · Claude resets · Claude Code release notes · Blog