You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
New: ⭐ Opus 4.6 default maximum output tokens raised to 64k; upper bound for Opus 4.6 and Sonnet 4.6 raised to 128k tokens
New: allowRead sandbox filesystem setting to re-allow read access within denyRead regions
New: /copy N to copy the Nth-latest assistant response directly
New: /branch command (replaces /fork; /fork still works as an alias)
New: SendMessage now auto-resumes stopped agents in the background instead of returning an error
Fixed: ⚠️Security — PreToolUse hooks returning "allow" could bypass deny permission rules including enterprise managed settings
Fixed: Auto-updater accumulating tens of gigabytes of memory when slash-command overlay repeatedly opened/closed, triggering overlapping binary downloads
Fixed: --resume silently truncating recent conversation history due to a race between memory-extraction writes and the main transcript
Fixed: "Always Allow" on compound bash commands (e.g. cd src && npm test) saving a single rule for the full string instead of per-subcommand, leading to dead rules and repeated permission prompts
Fixed: Write tool silently converting line endings when overwriting CRLF files or creating files in CRLF directories
Fixed: Cost and token usage not tracked when API falls back to non-streaming mode
Fixed: CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS not stripping beta tool-schema fields, causing proxy gateways to reject requests
Fixed: Bash tool reporting errors for successful commands when system temp directory path contains spaces
Fixed: Paste being lost when typing immediately after pasting; Ctrl+D in /feedback deleting forward instead of exiting
Fixed: Various rendering fixes: ordered list numbers, CJK bleeding, background colors in tmux, hyperlinks opening twice in VS Code
Fixed: Teammate panes not closing when leader exits; iTerm2 session crash when selecting text inside tmux over SSH
Breaking: Agent tool no longer accepts a resume parameter — use SendMessage({to: agentId}) to continue a previously spawned agent
VSCode: Fixed gitignore patterns with commas silently excluding filetypes from @-mention file picker; improved scroll wheel responsiveness; improved plan preview tab titles
Performance: Faster startup on macOS (~60ms) by reading keychain credentials in parallel with module loading; faster --resume on fork-heavy sessions (up to 45% faster, 100-150MB less peak memory)
v2.1.76 (2026-03-14)
New: ⭐ MCP elicitation support — MCP servers can now request structured input mid-task via an interactive dialog (form fields or browser URL)
New: Elicitation and ElicitationResult hooks to intercept and override MCP input responses before they're sent back to the server
New: PostCompact hook that fires after compaction completes
New: -n / --name <name> CLI flag to set a display name for the session at startup
New: worktree.sparsePaths setting for claude --worktree in large monorepos — check out only needed directories via git sparse-checkout
New: /effort slash command to set model effort level
Fixed: Deferred tools (loaded via ToolSearch) losing their input schemas after conversation compaction — array and number parameters were being rejected with type errors
Fixed: Auto-compaction retrying indefinitely after consecutive failures — circuit breaker now stops after 3 attempts
Fixed: Bash(cmd:*) permission rules not matching when a quoted argument contains #
Fixed: Slash commands showing "Unknown skill"
Fixed: Plan mode asking for re-approval after the plan was already accepted
Fixed: Voice mode swallowing keypresses while a permission dialog or plan editor was open
Fixed: /voice not working on Windows when installed via npm
Fixed: Bridge sessions failing to recover after extended WebSocket disconnects
Changed: Opus 4.6 now defaults to medium effort for Max and Team subscribers (sweet spot between speed and thoroughness)
New: Re-introduced ultrathink keyword to enable high effort for the next turn specifically
Breaking: Opus 4 and Opus 4.1 removed from Claude Code on first-party API — users auto-migrated to Opus 4.6
v2.1.66 (2026-03-04)
Fixed: Reduced spurious error logging
v2.1.63 (2026-02-27)
New: HTTP hooks — hooks can now POST JSON to a URL and receive JSON back, instead of running a shell command. Useful for CI/CD integrations and stateless backend endpoints (v2.1.63+)
New: Project configs & auto-memory now shared across all git worktrees of the same repository
New: /simplify and /batch bundled slash commands
New: ENABLE_CLAUDEAI_MCP_SERVERS=false env var to opt out of claude.ai MCP server exposure
Improved: /model command shows currently active model in picker
Fixed: Major wave of memory leaks — WebSocket listeners, MCP caches, git root detection cache, JSON parsing cache, bash prefix cache, subagent AppState after compaction, MCP server fetch caches on reconnect
Fixed: VSCode remote sessions not appearing in conversation history
Fixed: /clear not resetting cached skills (stale skill content persisted to new conversation)
Fixed: Local slash command output (e.g. /cost) appearing as user messages in UI
v2.1.62 (2026-02-27)
Fixed: Prompt suggestion cache regression that reduced cache hit rates
v2.1.61 (2026-02-27)
Fixed: Concurrent writes corrupting config file on Windows
v2.1.59 (2026-02-26)
New: Auto-memory — Claude automatically saves useful context to memory; manage with /memory
New: /copy command — interactive picker when code blocks are present, select individual blocks or full response
Improved: Smarter "always allow" prefix suggestions for compound bash commands (per-subcommand prefixes instead of treating whole command as one)
Fixed: MCP OAuth token refresh race condition when running multiple Claude Code instances simultaneously
Fixed: Shell commands not showing clear error message when working directory has been deleted
Fixed: Config file corruption that could wipe authentication when multiple Claude Code instances ran simultaneously
v2.1.58 (2026-02-26)
Expanded: Remote Control available to more users
v2.1.56 (2026-02-25)
Fixed: VSCode: Another cause of "command 'claude-vscode.editor.openLast' not found" crashes
v2.1.55 (2026-02-25)
Fixed: BashTool failing on Windows with EINVAL error
v2.1.53 (2026-02-25)
Fixed: UI flicker where user input briefly disappeared after submission before rendering
Fixed: Bulk agent kill (ctrl+f) now sends single aggregate notification instead of one per agent, and properly clears command queue
Fixed: Graceful shutdown sometimes leaving stale sessions when using Remote Control (parallelized teardown)
Fixed: --worktree flag sometimes being ignored on first launch
Fixed: Panic ("switch on corrupted value") on Windows
Fixed: Crash when spawning many processes on Windows
Fixed: Crash in WebAssembly interpreter on Linux x64 & Windows x64
Fixed: Crash that sometimes occurred after 2 minutes on Windows ARM64
v2.1.52 (2026-02-24)
Fixed: VSCode extension crash on Windows ("command 'claude-vscode.editor.openLast' not found")
v2.1.51 (2026-02-24)
New: claude remote-control subcommand for external builds — enables local environment serving for all users
New: Custom npm registries and specific version pinning when installing plugins from npm sources
New: SDK: CLAUDE_CODE_ACCOUNT_UUID, CLAUDE_CODE_USER_EMAIL, CLAUDE_CODE_ORGANIZATION_UUID env vars to provide account info synchronously (eliminates race conditions in early telemetry)
Changed: BashTool now skips login shell (-l flag) by default when shell snapshot is available — performance improvement (previously required CLAUDE_BASH_NO_LOGIN=true)
Changed: Tool results larger than 50K characters now persisted to disk (previously 100K threshold)
Improved: /model picker now shows human-readable labels (e.g., "Sonnet 4.5") instead of raw model IDs for pinned versions, with upgrade hint when newer version available
Fixed: Security issue where statusLine and fileSuggestion hook commands could execute without workspace trust acceptance in interactive mode
Fixed: Duplicate control_response messages from WebSocket reconnects causing API 400 errors
Fixed: Slash command autocomplete crashing when a plugin's SKILL.md description is a YAML array or other non-string type
v2.1.50 (2026-02-21)
New: WorktreeCreate and WorktreeRemove hook events — custom VCS setup/teardown when agent worktree isolation creates or removes worktrees
New: isolation: worktree in agent definitions for declarative worktree isolation (no longer requires setting in each call)
New: claude agents CLI command to list all configured agents
New: startupTimeout configuration for LSP servers
New: CLAUDE_CODE_DISABLE_1M_CONTEXT env var to disable 1M context window support
New: Pre-configured OAuth client credentials for MCP servers that don't support Dynamic Client Registration (Slack); use --client-id and --client-secret with claude mcp add
New: VSCode /extra-usage command support
Changed: Opus 4.6 (fast mode) now includes full 1M context window
Changed: CLAUDE_CODE_SIMPLE mode now also disables MCP tools, attachments, hooks, and CLAUDE.md loading for fully minimal experience
Fixed: Bug where resumed sessions could be invisible when working directory involved symlinks
Fixed: disableAllHooks setting to respect managed settings hierarchy (non-managed settings can no longer disable managed hooks)
Fixed: Linux: native modules not loading on systems with glibc older than 2.30 (RHEL 8)
Fixed: Memory leak in agent teams where completed teammate tasks were never garbage collected
Fixed: Memory leak where completed task state objects were never removed from AppState
Fixed: Memory leak where LSP diagnostic data was never cleaned up after delivery
Fixed: Unbounded memory growth in long sessions (file history snapshots capped; circular buffer fix; stream buffers released after use)
Fixed: MCP tools not discovered when tool search is enabled and prompt passed as launch argument
Fixed: Prompt suggestion cache regression that reduced cache hit rates
Improved: Startup performance for headless mode (-p) by deferring Yoga WASM and UI component imports
Improved: Memory usage during long sessions by clearing internal caches after compaction and clearing large tool results after processing
v2.1.49 (2026-02-20)
New: --worktree / -w CLI flag to start Claude in an isolated git worktree
New: Subagents support isolation: "worktree" for working in a temporary git worktree
New: background: true field in agent definitions to always run as a background task
New: ConfigChange hook event — fires when configuration files change during a session (enterprise security auditing + blocking)
New: Plugins can ship settings.json for default configuration
New: --from-pr flag to resume sessions linked to a specific GitHub PR (+ sessions auto-linked when created via gh pr create)
New: PreToolUse hooks can return additionalContext to the model
New: plansDirectory setting to customize where plan files are stored
New: auto:N syntax for configuring MCP tool search auto-enable threshold
New: Setup hook event triggered via --init, --init-only, or --maintenance CLI flags
Changed: Sonnet 4.5 1M context removed from Max plan — Sonnet 4.6 now has 1M context (switch in /model)
Changed: Simple mode now includes file edit tool (not just Bash)
Fixed: File-not-found errors now suggest corrected paths when model drops repo folder
Fixed: Ctrl+C and ESC silently ignored when background agents running + main thread idle (double-press within 3s now kills all agents)
Fixed: Plugin enable/disable auto-detects correct scope (no longer defaults to user scope)
Fixed: Context window blocking limit calculated too aggressively (~65% instead of ~98%)
Fixed: Memory issues causing crashes with parallel subagents
Fixed: Memory leak in long sessions where stream resources not cleaned up
Fixed: @ symbol incorrectly triggering file autocomplete in bash mode
Fixed: Background agent results returning raw transcript data instead of final answer
Improved: MCP connection: list_changed notification support for dynamic tool updates without reconnection
Improved: Skills invoke progress display; skill suggestions prioritize recently/frequently used
Improved: Incremental output for async agents; token count includes background agent tokens
v2.1.47 (2026-02-19)
Improved: VS Code plan preview auto-updates as Claude iterates; commenting enabled only when plan is ready for review; preview stays open when rejected for revision
New: ctrl+f kills all background agents simultaneously (replaces double-ESC); ESC now cancels main thread only, background agents keep running
New: last_assistant_message field added to Stop and SubagentStop hook inputs (access final response without parsing transcript files)
New: chat:newline keybinding action; added_dirs in statusline JSON workspace section
Fixed: Compaction failing when conversation contains many PDF documents (strips document blocks alongside images)
Fixed: Edit tool corrupting Unicode curly quotes (""'') by replacing with straight quotes
Fixed: Parallel file write/edit — single file failure no longer aborts sibling operations
Fixed: OSC 8 hyperlinks only clickable on first line when link text wraps across multiple terminal lines
Fixed: Bash permission classifier now validates match descriptions against actual input rules (prevents hallucinated permissions)
Fixed: Config backups timestamped and rotated (5 most recent kept) instead of overwriting
Fixed: Session name lost after context compaction; plan mode lost after compaction
Fixed: Hooks (PreToolUse, PostToolUse) silently failing on Windows (now uses Git Bash)
Fixed: Custom agents/skills not discovered in git worktrees (main repo .claude/ now included)
Fixed: 70+ additional rendering, session, permission, and platform fixes
v2.1.46 (2026-02-19)
Fixed: Orphaned Claude Code processes after terminal disconnect on macOS
New: Support for using claude.ai MCP connectors in Claude Code
v2.1.45 (2026-02-17)
New: Claude Sonnet 4.6 model support
New: spinnerTipsOverride setting — customize spinner tips via tips array, opt out of built-in tips with excludeDefault: true
New: SDK SDKRateLimitInfo and SDKRateLimitEvent types for rate limit status tracking (utilization, reset times, overage)
Fixed: Agent Teams teammates failing on Bedrock, Vertex, and Foundry (env vars now propagated to tmux-spawned processes)
Fixed: Sandbox "operation not permitted" errors on macOS temp file writes
Fixed: Task tool (backgrounded agents) crashing with ReferenceError on completion
Improved: Memory usage for large shell command outputs (RSS no longer grows unboundedly)
Improved: Startup performance (removed eager session history loading)
Improved: Plugin-provided commands, agents, and hooks available immediately after install (no restart needed)
Fixed: Structured-outputs beta header being sent unconditionally on Vertex/Bedrock
Fixed: Spurious warnings for non-agent markdown files in .claude/agents/ directory
v2.1.42 (2026-02-14)
Improved: Startup performance via deferred Zod schema construction (faster on large projects)
Improved: Prompt cache hit rate by moving date outside the system prompt (avoids daily cache invalidation)
New: Opus 4.6 effort callout for eligible users (one-time onboarding)
Fixed: /resume showing interrupt messages as session titles
Fixed: Image dimension limit errors now suggest using /compact instead of opaque failure
v2.1.41 (2026-02-13)
New: Guard against launching Claude Code inside another Claude Code session
New: claude auth login, claude auth status, claude auth logout CLI subcommands
New: Windows ARM64 (win32-arm64) native binary support
Added speed attribute to OTel events and trace spans for fast mode visibility
Improved: /rename auto-generates session name from conversation context when called without arguments
Improved narrow terminal layout for prompt footer
Fixed: Agent Teams using wrong model identifier for Bedrock, Vertex, and Foundry customers
Fixed: Crash when MCP tools return image content during streaming
Fixed: /resume session previews showing raw XML tags instead of readable command names
Fixed: Opus 4.6 launch announcement showing for Bedrock/Vertex/Foundry users
Fixed: Hook blocking errors (exit code 2) not showing stderr to the user
Fixed: Structured-outputs beta header sent unconditionally on Vertex/Bedrock
Fixed: File resolution for @-mentions with anchor fragments (e.g., @README.md#installation)
Fixed: FileReadTool blocking on FIFOs, /dev/stdin, and large files
Fixed: Background task notifications not delivered in streaming Agent SDK mode
Fixed: Auto-compact failure error notifications shown to users
Fixed: Stale permission rules not clearing when settings change on disk
Fixed: Permission wait time included in subagent elapsed time display
Fixed: Proactive ticks firing while in plan mode
Improved: Model error messages for Bedrock/Vertex/Foundry with fallback suggestions
v2.1.39 (2026-02-10)
Improved: Terminal rendering performance
Fixed: Fatal errors being swallowed instead of displayed
Fixed: Process hanging after session close
Fixed: Character loss at terminal screen boundary
Fixed: Blank lines in verbose transcript view
v2.1.38 (2026-02-10)
Fixed: VS Code terminal scroll-to-top regression introduced in 2.1.37
Fixed: Tab key queueing slash commands instead of autocompleting
Fixed: Bash permission matching for commands using environment variable wrappers
Fixed: Text between tool uses disappearing when not using streaming
Security: Improved heredoc delimiter parsing to prevent command smuggling
Security: Blocked writes to .claude/skills directory in sandbox mode
v2.1.37 (2026-02-08)
Fixed /fast not immediately available after enabling /extra-usage
v2.1.36 (2026-02-08) ⭐
⭐ Fast mode now available for Opus 4.6 — Same model, faster output. Toggle with /fast. Learn more
v2.1.34 (2026-02-07)
Fixed a crash when agent teams setting changed between renders
Security fix: Commands excluded from sandboxing (via sandbox.excludedCommands or dangerouslyDisableSandbox) could bypass the Bash ask permission rule when autoAllowBashIfSandboxed was enabled
v2.1.33 (2026-02-06)
Highlights:
Agent teams fixes — Improved tmux session handling and availability warnings
New hook events — TeammateIdle and TaskCompleted for multi-agent workflows
Agent frontmatter enhancements:
memory field for user/project/local scope memory selection
Task(agent_type) syntax to restrict sub-agent spawning in agent definitions
Plugin identification — Plugin name now shown in skill descriptions and /skills menu
Fixed: Plan mode crash when project config missing default fields
Fixed: temperatureOverride being silently ignored in streaming API path
Fixed: LSP shutdown/exit compatibility with strict language servers
Improved: System prompts now guide model toward Read/Edit/Glob/Grep tools instead of bash equivalents
Improved: PDF and request size error messages show actual limits (100 pages, 20MB)
Reduced: Layout jitter when spinner appears/disappears during streaming
v2.1.30 (2026-02-02)
⭐ PDF page range support — pages parameter in Read tool for PDFs (e.g., pages: "1-5") with lightweight references for large PDFs (>10 pages)
⭐ Pre-configured OAuth for MCP servers — Built-in client credentials for servers without Dynamic Client Registration (Slack support via --client-id and --client-secret)
⭐ New /debug command — Claude can help troubleshoot current session issues
Additional git flags — Support for git log and git show read-only flags (--topo-order, --cherry-pick, --format, --raw)
Task tool metrics — Results now include token count, tool uses, and duration
Reduced motion mode — New config option for accessibility
Fixed: Phantom "(no content)" text blocks in API history (reduces token waste)
Fixed: Prompt cache not invalidating when tool schemas changed
Fixed: 400 errors after /login with thinking blocks
Fixed: Session resume hang with corrupted parentUuid cycles
Fixed: Rate limit showing wrong "/upgrade" for Max 20x users
Fixed: Permission dialogs stealing focus while typing
Fixed: Subagents unable to access SDK MCP tools
Fixed: Windows users with .bashrc unable to run bash
Improved: Memory usage for --resume (68% reduction for many sessions)
Improved: TaskStop displays stopped command description instead of generic message
Changed: /model executes immediately instead of queuing
[VSCode] Added multiline input in "Other" text fields (Shift+Enter for new lines)
[VSCode] Fixed duplicate sessions in session list
v2.1.29 (2026-01-31)
Performance: Fixed startup performance issues when resuming sessions with saved hook context
Significantly improved session recovery speed for long-duration sessions
v2.1.27 (2026-01-29)
New: --from-pr flag to resume sessions linked to a specific GitHub PR number or URL
New: Sessions automatically linked to PRs when created via gh pr create
Added tool call failures and denials to debug logs
Fixed context management validation error for Bedrock/Vertex gateway users
Fixed /context command not displaying colored output
Fixed status bar duplicating background task indicator when PR status was shown
[Windows] Fixed bash command execution failing for users with .bashrc files
[Windows] Fixed console windows flashing when spawning child processes
Fix: Crashes on processors without AVX instruction support
v2.1.16 (2026-01-22) ⭐
⭐ New task management system with dependency tracking
[VSCode] Native plugin management support
[VSCode] OAuth users can browse and resume remote sessions from Sessions dialog
Fixed: Out-of-memory crashes when resuming sessions with heavy subagent usage
Fixed: "Context remaining" warning not hidden after /compact
[IDE] Fixed race condition on Windows where sidebar view container wouldn't appear
v2.1.15 (2026-01-22)
⚠️ Deprecation notice for npm installations — Run claude install or see docs
Improved UI rendering performance with React Compiler
Fixed: MCP stdio server timeout not killing child process, which could cause UI freezes
v2.1.14 (2026-01-21)
History-based autocomplete in bash mode — Type ! followed by a partial command and press Tab to complete from bash history
Search functionality in installed plugins list
Support for pinning plugins to specific git commit SHAs for exact version control
Fixed: Context window blocking limit calculated too aggressively (~65% instead of ~98%)
Fixed: Memory issues and leaks in long-running sessions with parallel subagents
Fixed: @ symbol incorrectly triggering file autocomplete in bash mode
Fixed: Slash command autocomplete selecting wrong command for similar names
Improved: Backspace deletes pasted text as single token
v2.1.12 (2026-01-18)
Bug fix: Message rendering
v2.1.11 (2026-01-17)
Fix: Excessive MCP connection requests for HTTP/SSE transports
v2.1.10 (2026-01-17)
New Setup hook event (--init, --init-only, --maintenance flags)
Keyboard shortcut 'c' to copy OAuth URL
File suggestions show as removable attachments
[VSCode] Plugin install count + trust warnings
v2.1.9 (2026-01-16)
auto:N syntax for MCP tool search threshold — Configure when Tool Search activates: ENABLE_TOOL_SEARCH=auto:5 (5% context), auto:10 (default), auto:20 (conservative). See architecture.md for details.
plansDirectory setting for custom plan file locations
Session URL attribution to commits/PRs from web sessions
PreToolUse hooks can return additionalContext
${CLAUDE_SESSION_ID} string substitution for skills
v2.1.7 (2026-01-15)
showTurnDuration setting to hide turn duration messages
MCP Tool Search auto mode enabled by default — Lazy loading for MCP tools when definitions exceed 10% of context. Based on Anthropic's Advanced Tool Use API feature. Result: 85% token reduction on tool definitions, improved tool selection accuracy (Opus 4: 49%→74%, Opus 4.5: 79.5%→88.1%)
Inline display of agent final response in task notifications