Claude Code ships updates almost daily, and the 2.1.x line has packed in a lot: a new Opus 4.7 effort tier, flicker-free fullscreen rendering, mobile push notifications, multi-agent review, tighter permission controls, and a long tail of fixes for MCP, sessions, and terminal rendering. Here is a condensed, version-by-version view of what actually changed, focused on what users and teams notice day to day.
Quick answer: Run claude --version to see your installed build, then claude update to move to the latest 2.1.x release.
How to read your version and update
Claude Code is distributed as a CLI with a native installer on macOS, Linux, and Windows, plus a VS Code extension. The changelog is maintained inside the repository and mirrors to the official docs.
Step 1: Check which version you are on. In a terminal, run claude --version. The output matches the tags listed below (for example 2.1.112).
Step 2: Update to the latest release. Run claude update. On Homebrew installs, the cask controls the channel (claude-code is stable, claude-code@latest tracks latest).
Step 3: Inspect recent release notes directly in the CLI. Use /release-notes to open an interactive version picker, or view the full history in the Claude Code changelog.
Highlights across the 2.1.x line
The 2.1.x series has been dominated by three themes: smarter model controls (Opus 4.6 and 4.7, effort tiers, fast mode), a rewritten terminal UI with optional fullscreen rendering, and stronger sandbox and permission handling. Remote Control and mobile integration also matured, letting sessions bridge between the CLI, VS Code, and claude.ai.
| Area | What changed |
|---|---|
| Models | Opus 4.7 with new xhigh effort, Opus 4.6 default, Sonnet 4.6 rollout, Haiku 4.5 option, 1M context for Opus 4.6 on Max/Team/Enterprise. |
| UI | /tui fullscreen, focus view, transcript search, auto-scroll toggle, reduced flicker, native VS Code extension. |
| Permissions | Managed settings drop-in directory, sandbox hardening, Bash permission fixes, allowRead in sandbox filesystem. |
| Hooks | New events: StopFailure, PostCompact, PreCompact blocking, CwdChanged, FileChanged, TaskCreated, Elicitation. |
| MCP | Elicitation support, RFC 9728 OAuth discovery, CIMD client registration fallback, deduping of claude.ai connectors vs local configs. |
| Sessions | Named sessions, /resume picker overhaul, worktree isolation, auto-memory, session recap. |
2.1.112 - 2.1.108: Opus 4.7, effort slider, and prompt caching controls
2.1.112 (April 16, 2026): Fixed the “claude-opus-4-7 is temporarily unavailable” error that affected auto mode.
2.1.111 (April 16, 2026): Opus 4.7 with a new xhigh effort level, sitting between high and max. Auto mode is now available to Max subscribers on Opus 4.7 without the --enable-auto-mode flag. /effort opens an interactive slider when called with no arguments. A new /less-permission-prompts skill scans transcripts for safe, read-only Bash and MCP calls and proposes a prioritized allowlist for .claude/settings.json. A /ultrareview command runs multi-agent code review in the cloud, either on the current branch or a specific GitHub PR. The PowerShell tool is progressively rolling out on Windows behind CLAUDE_CODE_USE_POWERSHELL_TOOL. Read-only bash glob commands like ls *.ts and cd <project-dir> && prefixes no longer trigger permission prompts.
2.1.110 (April 15, 2026): New /tui fullscreen mode gives flicker-free rendering mid-conversation. Mobile push notifications are available through Remote Control. Scheduled tasks survive --resume and --continue. Session recap is on by default for telemetry-disabled users across Bedrock, Vertex, and Foundry. Several MCP transport hangs and fallback retry timeouts were fixed.
2.1.108 (April 14, 2026): New ENABLE_PROMPT_CACHING_1H environment variable opts into a 1-hour prompt cache TTL on API key, Bedrock, Vertex, and Foundry. FORCE_PROMPT_CACHING_5M forces the shorter TTL. A recap feature runs when you return to a session, configurable in /config or via /recap. /undo now aliases /rewind. Error messages distinguish server rate limits from plan usage limits, and the model can discover built-in commands like /init, /review, and /security-review through the Skill tool.
2.1.105 - 2.1.97: Worktrees, plugin polish, and fullscreen UX
2.1.105 (April 13, 2026): EnterWorktree gets a path parameter to switch into existing worktrees. PreCompact hooks can block compaction via exit code 2 or {"decision":"block"}. Plugins can declare background monitors under a new monitors manifest key. Stalled API streams abort after 5 minutes of silence and retry non-streaming.
2.1.101 (April 10, 2026): /team-onboarding generates a ramp-up guide from your local usage. OS CA certificate trust is on by default so enterprise TLS proxies work without extra configuration; switch back with CLAUDE_CODE_CERT_STORE=bundled. Remote-session features like /ultraplan auto-create a default cloud environment. A sizeable set of subagent, worktree, Bedrock auth, and resume fixes landed in this release.
2.1.98 (April 9, 2026): An interactive Vertex AI setup wizard mirrors the Bedrock one. CLAUDE_CODE_PERFORCE_MODE makes Edit/Write/NotebookEdit refuse read-only files with a p4 edit hint. A Monitor tool streams events from background scripts, and Linux subprocess sandboxing gains PID namespace isolation when CLAUDE_CODE_SUBPROCESS_ENV_SCRUB is set. A Bash tool permission bypass involving backslash-escaped flags was closed, and several 429/Retry-After issues were fixed.
2.1.97 (April 8, 2026): Focus view toggle lands in NO_FLICKER mode showing the prompt, a one-line tool summary with edit diffstats, and the final response. A new refreshInterval re-runs the statusline command every N seconds, and workspace.git_worktree lands in statusline JSON input. Cedar policy files get syntax highlighting.
2.1.94 - 2.1.84: Mantle Bedrock, default effort, and PowerShell preview
2.1.94 (April 7, 2026): Added Amazon Bedrock support powered by Mantle via CLAUDE_CODE_USE_MANTLE=1. The default effort level moves from medium to high for API-key, Bedrock/Vertex/Foundry, Team, and Enterprise users; control it with /effort. Slack MCP send-message calls render with a clickable #channel header, and UserPromptSubmit hooks can set a session title through hookSpecificOutput.sessionTitle.
2.1.92 (April 4, 2026): Added a forceRemoteSettingsRefresh policy for fail-closed startup, an interactive Bedrock setup wizard, and a per-model and cache-hit breakdown in /cost. /release-notes became an interactive version picker. The Write tool diff is 60 percent faster on files with tabs and common special characters. /tag was removed, and /vim now lives under /config as an editor mode.
2.1.84 (March 26, 2026): A PowerShell tool preview arrived for Windows behind CLAUDE_CODE_USE_POWERSHELL_TOOL. New ANTHROPIC_DEFAULT_{OPUS,SONNET,HAIKU}_MODEL_SUPPORTS environment variables override effort/thinking capability detection on third-party providers, with _MODEL_NAME and _DESCRIPTION customizing the /model picker label. CLAUDE_STREAM_IDLE_TIMEOUT_MS configures the streaming idle watchdog (default 90 seconds). A new TaskCreated hook fires when tasks are created via TaskCreate.
2.1.83 - 2.1.75: Managed policy fragments, channels, and 1M context for Opus 4.6
2.1.83 (March 25, 2026): A new managed-settings.d/ drop-in directory lets teams deploy independent policy fragments that merge alphabetically. New CwdChanged and FileChanged hook events enable reactive environment setups like direnv. Transcript search lands in transcript mode with / to search and n / N to move between matches. Images now insert an [Image #N] chip at the cursor so they can be referenced positionally.
2.1.81 (March 20, 2026): A --bare flag for scripted -p runs skips hooks, LSP, plugin sync, and skill directory walks. A --channels permission relay allows channel servers to forward tool approval prompts to your phone. Line-by-line streaming is disabled on Windows (including WSL in Windows Terminal) due to rendering issues.
2.1.76 (March 14, 2026): MCP servers can now request structured input mid-task through elicitation, and new Elicitation and ElicitationResult hooks intercept and override responses. A -n / --name flag sets a display name at startup. worktree.sparsePaths lets large monorepos check out only the directories you need via git sparse-checkout. A PostCompact hook fires after compaction completes.
2.1.75 (March 13, 2026): The 1M context window is now default for Opus 4.6 on Max, Team, and Enterprise plans. A /color command sets a prompt-bar color, and memory files now carry last-modified timestamps. Async hook completion messages are suppressed by default. The deprecated Windows managed settings fallback at C:\ProgramData\ClaudeCode\managed-settings.json was removed; use C:\Program Files\ClaudeCode\managed-settings.json.
2.1.74 - 2.1.68: /context hints, deprecated /output-style, and Opus 4.6 medium default
2.1.74 (March 12, 2026): /context surfaces actionable suggestions for context-heavy tools and memory bloat. autoMemoryDirectory configures where auto-memory is stored. A streaming response buffer memory leak on Node.js/npm was fixed, and full model IDs (claude-opus-4-5) now work in agent frontmatter and --agents JSON.
2.1.73 (March 11, 2026): A modelOverrides setting maps model picker entries to custom provider IDs, including Bedrock inference profile ARNs. The default Opus model on Bedrock, Vertex, and Microsoft Foundry is now Opus 4.6 (was Opus 4.1). /output-style is deprecated; configure style at session start via /config. A subtle subagent downgrade issue across Bedrock, Vertex, and Foundry was fixed.
2.1.68 (March 4, 2026): Opus 4.6 defaults to medium effort for Max and Team subscribers. The “ultrathink” keyword is back for high effort on the next turn. Opus 4 and 4.1 were removed from the first-party API for Claude Code; pinned users were moved to Opus 4.6 automatically.
2.1.63 - 2.1.49: Auto-memory, Remote Control, HTTP hooks, and worktree agents
2.1.63 (February 28, 2026): Added /simplify and /batch bundled slash commands, plus HTTP hooks that POST JSON to a URL and receive JSON back instead of running shell commands. Project configs and auto-memory are shared across git worktrees of the same repo. ENABLE_CLAUDEAI_MCP_SERVERS=false opts out of claude.ai MCP servers.
2.1.59 (February 26, 2026): Claude automatically saves useful context to auto-memory, managed through /memory. A new /copy command opens an interactive picker for code blocks or the full response. Prefix suggestions for compound bash commands are smarter, and MCP OAuth token refresh races across concurrent sessions were fixed.
2.1.51 (February 24, 2026): A claude remote-control subcommand for external builds exposes local environment serving to all users. Plugin marketplace git timeout went from 30s to 120s (CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS configurable). BashTool skips login shell by default when a snapshot is available. Tool results larger than 50K characters are persisted to disk instead of eating context.
2.1.49 (February 19, 2026): A --worktree (-w) flag starts Claude in an isolated git worktree, and subagents support isolation: "worktree". Agent definitions gain background: true to always run as background tasks. Sonnet 4.5 with 1M context is being removed from Max in favor of Sonnet 4.6 (which also offers 1M context). A new ConfigChange hook fires when configuration files change during a session.
2.1.45 - 2.1.32: Sonnet 4.6, Agent Teams preview, and Opus 4.6 arrival
2.1.45 (February 17, 2026): Added support for Claude Sonnet 4.6. enabledPlugins and extraKnownMarketplaces are read from --add-dir directories. A spinnerTipsOverride setting customizes spinner tips with tips and optional excludeDefault: true. SDK consumers get SDKRateLimitInfo and SDKRateLimitEvent.
2.1.36 (February 7, 2026): Fast mode is available for Opus 4.6. Details are in the fast mode documentation.
2.1.33 (February 6, 2026): Agent teammate sessions in tmux now send and receive messages reliably. New TeammateIdle and TaskCompleted hook events power multi-agent workflows. Agents can restrict which sub-agents they spawn via Task(agent_type) in the tools frontmatter, and a new memory frontmatter field supports user, project, or local scope.
2.1.32 (February 5, 2026): Claude Opus 4.6 launched. A research preview agent teams feature enabled multi-agent collaboration under CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1. Auto-memory records and recalls context as Claude works, and “Summarize from here” landed in the message selector for partial compaction.
2.1.30 - 2.1.22: PDFs, statusline cost, and structured outputs
2.1.30 (February 3, 2026): The Read tool accepts a pages parameter for PDFs, for example pages: "1-5". PDFs over 10 pages return a lightweight reference when @-mentioned instead of being inlined into context. MCP servers without Dynamic Client Registration (such as Slack) can use --client-id and --client-secret on claude mcp add. A new /debug command helps troubleshoot the current session.
2.1.23 (January 29, 2026): A spinnerVerbs setting customizes spinner text. mTLS and proxy connectivity for corporate environments was fixed, along with a race condition that caused 400 errors when prompt caching scope was enabled.
2.1.22 (January 28, 2026): Fixed structured outputs for non-interactive (-p) mode.
2.1.20 - 2.1.14: Keybindings, tasks, AVX crashes
2.1.20 (January 27, 2026): Vim normal mode arrow keys now fall through to history navigation at the input edges. A PR review status indicator joins the prompt footer, showing approved, changes requested, pending, or draft as a colored dot with a clickable link. CLAUDE.md files can load from additional directories via --add-dir when CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1.
2.1.18 (January 23, 2026): Customizable keyboard shortcuts. Run /keybindings to configure per-context bindings, chord sequences, and more, documented in the keybindings reference.
2.1.17 (January 22, 2026): Fixed crashes on processors without AVX instruction support.
2.1.16 (January 22, 2026): A new task management system with dependency tracking replaced the previous todo flow. The VS Code extension picked up native plugin management and remote session browsing for OAuth users.
2.1.15 (January 21, 2026): Added deprecation notification for npm installations - run claude install or see the Claude Code getting started guide for other options. Rendering performance improved with the React Compiler.
2.1.12 - 2.1.0: Hooks, skills, and Shift+Enter everywhere
2.1.10 (January 17, 2026): A new Setup hook event fires from --init, --init-only, and --maintenance flags for repository setup and maintenance.
2.1.9 (January 16, 2026): An auto:N syntax sets the MCP tool search auto-enable threshold (N is a context window percentage). A plansDirectory setting customizes where plan files live. PreToolUse hooks can return additionalContext to the model.
2.1.7 (January 14, 2026): A showTurnDuration setting hides turn duration messages. MCP tool search auto mode is enabled by default when MCP descriptions exceed 10 percent of the context window; opt out by adding MCPSearch to disallowedTools. OAuth and API Console URLs moved to platform.claude.com.
2.1.3 (January 9, 2026): Slash commands and skills merged into a single mental model. A stable/latest release channel toggle lives in /config. Tool hook execution timeout moved from 60 seconds to 10 minutes.
2.1.2 (January 9, 2026): Images dragged onto the terminal carry source-path metadata. Clickable hyperlinks for file paths work in terminals that support OSC 8 (like iTerm). A command injection vulnerability in bash command processing was fixed, and a tree-sitter memory leak that grew WASM memory over long sessions was closed.
2.1.0 (January 7, 2026): Skills hot-reload in ~/.claude/skills and .claude/skills. Skills and slash commands can run in a forked sub-agent via context: fork. A language setting controls Claude’s response language. Shift+Enter works out of the box in iTerm2, WezTerm, Ghostty, and Kitty. Wildcard patterns work everywhere in Bash permission rules: Bash(npm *), Bash(* install), Bash(git * main). Ctrl+B now backgrounds both bash commands and agents together.
2.0.x: Native VS Code extension, Opus 4.5, and Haiku 4.5
2.0.74 (December 19, 2025): An LSP tool brought code intelligence features like go-to-definition, find references, and hover documentation. /terminal-setup gained Kitty, Alacritty, Zed, and Warp support. A /theme toggle (ctrl+t) flips syntax highlighting on and off.
2.0.72 (December 17, 2025): Claude in Chrome (Beta) works with the Chrome extension to control the browser directly from Claude Code. Terminal flickering was reduced, and thinking toggle moved from Tab to Alt+T to avoid accidental triggers.
2.0.64 (December 10, 2025): Auto-compacting is instant. Agents and bash commands can run asynchronously and message the main agent when done. Named sessions land with /rename and /resume <name>. Rules directories (.claude/rules/) are supported per the memory documentation.
2.0.58 (December 3, 2025): Pro users got access to Opus 4.5 as part of their subscription.
2.0.51 (November 24, 2025): Claude Opus 4.5 became available per the Opus 4.5 announcement, and Claude Code for Desktop arrived for macOS and Windows from the Claude download page. Plan mode builds more precise plans, and usage limit notifications were rewritten for clarity.
2.0.45 (November 18, 2025): Microsoft Foundry support arrived, covered in the Azure AI Foundry documentation. A PermissionRequest hook lets you automatically approve or deny tool permission requests with custom logic.
2.0.20 (October 16, 2025): Added support for Claude Skills.
2.0.17 (October 15, 2025): Haiku 4.5 joined the model selector. Haiku 4.5 uses Sonnet in plan mode and Haiku for execution. An Explore subagent powered by Haiku searches through codebases efficiently to save context.
2.0.12 (October 9, 2025): Plugin system released. /plugin install, /plugin enable/disable, and /plugin marketplace manage plugins. Repository-level configuration works through extraKnownMarketplaces. See the plugin announcement and the plugins documentation.
2.0.10 (October 8, 2025): Rewrote the terminal renderer. MCP servers toggle from /mcp or via @-mention. Tab completion works for shell commands in bash mode, and Ctrl-G opens your prompt in the system editor.
2.0.0 (September 29, 2025): A new native VS Code extension. /rewind undoes code changes in a conversation. /usage shows plan limits. Tab toggles thinking with sticky state. The Claude Code SDK became the Claude Agent SDK. Subagents can be added dynamically via --agents.
1.0.x highlights: Hooks, subagents, native Windows
1.0.71 (August 7, 2025): Background commands (Ctrl-b) run any Bash command in the background. A customizable status line landed via /statusline.
1.0.60 (July 24, 2025): Custom subagents for specialized tasks, created through /agents.
1.0.51 (July 11, 2025): Native Windows support (requires Git for Windows). Bedrock API keys are supported through AWS_BEARER_TOKEN_BEDROCK. The auto-compact warning threshold moved from 60 percent to 80 percent.
1.0.38 (June 30, 2025): Hooks shipped, detailed in the hooks documentation.
1.0.27 (June 18, 2025): Streamable HTTP MCP servers arrived, and remote MCP servers (SSE and HTTP) gained OAuth. MCP resources can be @-mentioned. A /resume slash command switches conversations without leaving Claude Code.
1.0.23 (June 16, 2025): TypeScript SDK released (import @anthropic-ai/claude-code), alongside the Python SDK (pip install claude-code-sdk).
1.0.11 (June 4, 2025): Claude Pro subscriptions can power Claude Code. /upgrade streamlines moving to Max plans.
1.0.0 (May 22, 2025): Claude Code became generally available, alongside Sonnet 4 and Opus 4.
Verifying your changelog locally
To confirm which features are live on your machine, match the version from claude --version against the entries above or in the CHANGELOG.md on GitHub. If a feature is missing after an update, restart the terminal session and re-run the command; macOS users should also check keychain access if OAuth steps fail on first run. Managed settings on Windows now prefer C:\Program Files\ClaudeCode over the deprecated C:\ProgramData\ClaudeCode path.
Release cadence has been rapid, so if a behavior changed in your workflow - permission prompts, model defaults, hook timing, or MCP OAuth flows - a quick update often brings the fix you need.