marketing-shibata50/claude-code-ultimate-guide
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
claude-code-ultimate-guide/guide/claude-code-releases.md
Florian BRUNIAUX bc6b32ed3a docs: update Claude Code releases to v2.1.31 
- Update latest tracked version: v2.1.29 → v2.1.31
- Add v2.1.31 highlights: Session resume hint, PDF/bash/LSP fixes, system improvements
- Add v2.1.30 highlights: PDF pages support (pages parameter), OAuth pre-config (Slack), /debug command, git flags, task metrics
- Update dates: 2026-02-02 (v2.1.30), 2026-02-03 (v2.1.31)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-04 09:59:39 +01:00

19 KiB
Raw Blame History

Claude Code Release History

Condensed changelog of Claude Code official releases. Full details: github.com/anthropics/claude-code/CHANGELOG.md Machine-readable: claude-code-releases.yaml

Latest: v2.1.31 | Updated: 2026-02-04

Quick Jump

2.1.x Series (January-February 2026)

v2.1.31 (2026-02-03)

  • Session resume hint — Exit message now shows how to continue your conversation later
  • Full-width (zenkaku) space support — Added Japanese IME checkbox selection support
  • Fixed: PDF too large errors permanently locking sessions (now recoverable without starting new conversation)
  • Fixed: Bash commands incorrectly reporting "Read-only file system" when sandbox enabled
  • 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
  • [VSCode] Fixed OAuth token expiration causing 401 errors after extended sessions

v2.1.25 (2026-01-30)

  • Fixed beta header validation for Bedrock and Vertex gateway users — Ensures CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 environment variable works correctly

v2.1.23 (2026-01-29)

  • Customizable spinner verbs — New spinnerVerbs setting allows personalization of spinner action words
  • mTLS and corporate proxy connectivity fixes — Improved support for users behind corporate proxies with client certificates
  • Per-user temp directory isolation — Prevents permission conflicts on shared systems
  • Improved terminal rendering performance — Optimized screen data layout for faster updates
  • Fixed: Prompt caching race condition causing 400 errors
  • Fixed: Async hooks not canceling when headless streaming ends
  • Fixed: Tab completion not updating input field
  • Fixed: Ripgrep search timeouts returning empty results instead of errors
  • Changed: Bash commands show timeout duration alongside elapsed time
  • Changed: Merged PRs show purple status indicator in prompt footer
  • [IDE] Fixed: Model options displaying incorrect region strings for Bedrock users in headless mode

v2.1.22 (2026-01-28)

  • Improved task UI performance with virtualization — Task list now uses virtual scrolling for better responsiveness with many tasks
  • Vim selection and deletion fixes — Fixed visual mode selections and dw command behavior
  • LSP improvements: Kotlin support, UTF-16 range handling, better error recovery
  • Tasks now consistently use task-N IDs instead of internal UUIDs
  • Fixed: # keyboard shortcut not working in task creation fields
  • Fixed: Compact tool use rendering in chat history
  • Fixed: Session URL escaping in git commit messages
  • Fixed: Command output handling improvements

v2.1.21 (2026-01-28)

  • Skills/commands can specify required/recommended Claude Code version — Use minClaudeCodeVersion and recommendedClaudeCodeVersion in frontmatter
  • New TaskCreate fields: category (testing, implementation, documentation, etc.), checklist (subtasks as markdown list), parentId (task hierarchy)
  • Automatic Claude Code update checking at session start (respects auto-update settings)
  • Tasks appear in /context output with 'Disable tasks' shortcut for quick toggling
  • Improved task UI: Delete button added, better empty state messaging
  • Fixed: Task deletion now properly removes all related task data
  • Fixed: Shell environment variables expanded correctly in hook commands
  • Fixed: Pasted URLs with parentheses properly formatted in markdown
  • Fixed: Bash output capture for commands with large output

v2.1.20 (2026-01-27)

  • New: TaskUpdate tool can delete tasks via status="deleted"
  • New: PR review status indicator in prompt footer — Shows PR state (approved, changes requested, pending, draft) as colored dot with clickable link
  • Arrow key history navigation in vim normal mode when cursor cannot move further
  • External editor shortcut (Ctrl+G) added to help menu
  • Support for loading CLAUDE.md from --add-dir directories (requires CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1)
  • Fixed: Session compaction issues causing full history load instead of compact summary
  • Fixed: Agents ignoring user messages while actively working
  • Fixed: Wide character (emoji, CJK) rendering artifacts
  • Improved: Task list dynamically adjusts to terminal height
  • Changed: Background agents prompt for tool permissions before launching
  • Changed: Config backups timestamped and rotated (keeps 5 most recent)

v2.1.19 (2026-01-25)

  • New: CLAUDE_CODE_ENABLE_TASKS environment variable — Set to false to temporarily revert to old task system
  • New: Argument shorthand in custom commands — Use $0, $1, etc. instead of verbose syntax
  • [VSCode] Session forking and rewind functionality enabled for all users
  • Fixed: Crashes on processors without AVX instruction support
  • Fixed: Dangling Claude Code processes when terminal closed (SIGKILL fallback)
  • Fixed: /rename and /tag not updating correct session when resuming from different directory (git worktrees)
  • Fixed: Resuming sessions by custom title from different directory
  • Fixed: Pasted text lost when using prompt stash (Ctrl+S) and restore
  • Fixed: Agent list displaying "Sonnet (default)" instead of "Inherit (default)" for agents without explicit model
  • Fixed: Backgrounded hook commands blocking session instead of returning early
  • Fixed: File write preview omitting empty lines
  • Changed: Skills without additional permissions/hooks allowed without approval
  • [SDK] Added replay of queued_command attachment messages when replayUserMessages enabled

⚠️ Breaking:

  • Indexed argument syntax changed: $ARGUMENTS.0 → $ARGUMENTS[0] (bracket syntax)

v2.1.18 (2026-01-24) ⭐

  • ⭐ Customizable keyboard shortcuts — Configure keybindings per context, create chord sequences, personalize workflow
  • Run /keybindings to get started
  • Learn more: code.claude.com/docs/en/keybindings

v2.1.17 (2026-01-23)

  • 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

⚠️ Breaking:

  • OAuth/API Console URLs changed: console.anthropic.com → platform.claude.com
  • Security fix: Wildcard permission rules could match compound commands

v2.1.6 (2026-01-14)

  • Search functionality in /config command
  • Date range filtering in /stats (press r to cycle)
  • Auto-discovery of skills from nested .claude/skills directories
  • Updates section in /doctor showing auto-update channel

⚠️ Security Fix: Permission bypass via shell line continuation

v2.1.5 (2026-01-13)

  • CLAUDE_CODE_TMPDIR environment variable for custom temp directory

v2.1.4 (2026-01-12)

  • CLAUDE_CODE_DISABLE_BACKGROUND_TASKS environment variable

v2.1.3 (2026-01-11)

  • Merged slash commands and skills (simplified mental model)
  • Release channel toggle (stable/latest) in /config
  • /doctor warnings for unreachable permission rules

v2.1.2 (2026-01-10)

  • Windows Package Manager (winget) support
  • Clickable hyperlinks for file paths (OSC 8 terminals)
  • Shift+Tab shortcut in plan mode for auto-accept edits
  • Large bash outputs saved to disk instead of truncated

⚠️ Breaking:

  • Security fix: Command injection in bash command processing
  • Deprecated: C:\ProgramData\ClaudeCode managed settings path

v2.1.0 (2026-01-08) ⭐ MAJOR

Highlights:

  • ⭐ Automatic skill hot-reload — Skills modified in ~/.claude/skills or .claude/skills immediately available
  • ⭐ Shift+Enter works OOTB in iTerm2, WezTerm, Ghostty, Kitty
  • ⭐ New Vim motions: ; , y yy Y p P text objects (iw aw i" etc.) >> << J
  • Unified Ctrl+B for backgrounding all running tasks
  • /plan command shortcut to enable plan mode
  • Slash command autocomplete anywhere in input
  • language setting for response language (e.g., language: "japanese")
  • Skills context: fork support for forked sub-agent context
  • Hooks support in agent/skill/command frontmatter
  • MCP list_changed notifications support
  • /teleport and /remote-env commands for web sessions
  • Disable specific agents with Task(AgentName) syntax
  • --tools flag in interactive mode
  • YAML-style lists in frontmatter allowed-tools

⚠️ Breaking:

  • OAuth URLs: console.anthropic.com → platform.claude.com
  • Removed permission prompt for entering plan mode
  • [SDK] Minimum zod peer dependency: ^4.0.0

2.0.x Series (November 2025 - January 2026)

v2.0.76 (2026-01-05)

  • Fix: macOS code-sign warning with Claude in Chrome

v2.0.74 (2026-01-04) ⭐

  • ⭐ LSP (Language Server Protocol) tool for code intelligence (go-to-definition, find references, hover)
  • /terminal-setup for Kitty, Alacritty, Zed, Warp
  • Ctrl+T in /theme to toggle syntax highlighting
  • Grouped skills/agents by source in /context

v2.0.72 (2026-01-02) ⭐

  • ⭐ Claude in Chrome (Beta) — Control browser directly from Claude Code
  • Reduced terminal flickering
  • QR code for mobile app download
  • Thinking toggle changed: Tab → Alt+T

v2.0.70 (2025-12-30)

  • Enter key accepts/submits prompt suggestions immediately
  • Wildcard syntax mcp__server__* for MCP tool permissions
  • Auto-update toggle for plugin marketplaces
  • 3x memory usage improvement for large conversations

⚠️ Breaking: Removed # shortcut for quick memory entry

v2.0.67 (2025-12-26) ⭐

  • ⭐ Thinking mode enabled by default for Opus 4.5
  • Thinking config moved to /config
  • Search in /permissions with / shortcut

v2.0.64 (2025-12-22) ⭐

  • ⭐ Instant auto-compacting
  • ⭐ Async agents and bash commands with wake-up messages
  • /stats with usage graphs, streaks, favorite model
  • Named sessions: /rename, /resume <name>
  • Support for .claude/rules/ directory
  • Image dimension metadata for coordinate mappings

v2.0.60 (2025-12-18) ⭐

  • ⭐ Background agents — Agents run while you work
  • --disable-slash-commands CLI flag
  • Model name in Co-Authored-By commits
  • /mcp enable|disable [server-name]

v2.0.51 (2025-12-10) ⭐ MAJOR

  • ⭐ Opus 4.5 released
  • ⭐ Claude Code for Desktop
  • Updated usage limits for Opus 4.5
  • Plan Mode builds more precise plans

v2.0.45 (2025-12-05) ⭐

  • ⭐ Microsoft Foundry support
  • PermissionRequest hook for auto-approve/deny
  • & prefix for background tasks to web

v2.0.28 (2025-11-18) ⭐

  • ⭐ Plan mode: introduced Plan subagent
  • Subagents: resume capability
  • Subagents: dynamic model selection
  • --max-budget-usd flag (SDK)
  • Git-based plugins branch/tag support (#branch)

v2.0.24 (2025-11-10)

  • Claude Code Web: Web → CLI teleport
  • Sandbox mode for BashTool (Linux & Mac)
  • Bedrock: awsAuthRefresh output display

Breaking Changes Summary

URLs

Version Change
v2.1.0, v2.1.7 OAuth/API Console: console.anthropic.com → platform.claude.com

Windows

Version Change
v2.0.58 Managed settings prefer C:\Program Files\ClaudeCode
v2.1.2 Deprecated C:\ProgramData\ClaudeCode path

SDK

Version Change
v2.0.25 Removed legacy SDK entrypoint → @anthropic-ai/claude-agent-sdk
v2.1.0 Minimum zod peer dependency: ^4.0.0

API Ecosystem

Date Feature
2026-01-29 Structured Outputs GA: output_config.format remplace output_format. Docs

Shortcuts

Version Change
v2.0.70 Removed # shortcut for quick memory entry

Security Fixes

Version Issue
v2.1.2 Command injection in bash command processing
v2.1.6 Shell line continuation permission bypass
v2.1.7 Wildcard permission rules compound commands

Syntax

Version Change
v2.1.19 Indexed argument syntax changed: $ARGUMENTS.0 → $ARGUMENTS[0] (bracket syntax)

Milestone Features

Version Key Features
v2.1.18 Customizable keyboard shortcuts with /keybindings
v2.1.16 New task management system with dependency tracking
v2.1.0 Skill hot-reload, Shift+Enter OOTB, Vim motions, /plan command
v2.0.74 LSP tool for code intelligence
v2.0.72 Claude in Chrome (browser control)
v2.0.67 Thinking mode default for Opus 4.5
v2.0.64 Instant auto-compact, async agents, named sessions
v2.0.60 Background agents
v2.0.51 Opus 4.5, Claude Code for Desktop
v2.0.45 Microsoft Foundry, PermissionRequest hook
v2.0.28 Plan subagent, subagent resume/model selection
v2.0.24 Web teleport, Sandbox mode

Updating This Document

  1. Watch: github.com/anthropics/claude-code/releases
  2. Update: machine-readable/claude-code-releases.yaml (source of truth)
  3. Regenerate: Update this markdown accordingly
  4. Sync landing: Run ./scripts/check-landing-sync.sh

Last updated: 2026-01-28 | Back to main guide