Skip to content

Claude Code Version History

This comprehensive changelog tracks Claude Code’s rapid evolution since its preview launch in February 2025. Each version brings significant improvements based on user feedback and real-world usage patterns.

v2.0.67 - December 11, 2025

AI-Powered Prompt Suggestions

  • Prompt Suggestions: Claude now suggests prompts to speed up your workflow - press Tab to accept or Enter to submit
  • Thinking Mode Default: Thinking mode is now enabled by default for Opus 4.5
  • Thinking Config: Thinking mode configuration has moved to /config
  • Permissions Search: Added search functionality to /permissions command with / keyboard shortcut
  • Diagnostics: Show reason why autoupdater is disabled in /doctor
  • Bug Fixes:
    • Fixed false “Another process is currently updating Claude” error
    • Fixed MCP servers from .mcp.json stuck in pending state in non-interactive mode
    • Fixed word deletion/navigation with non-Latin text (Cyrillic, Greek, Arabic, Hebrew, Thai, Chinese)
    • Windows: Fixed plugin MCP servers failing due to colons in log directory paths

v2.0.65 - December 9, 2025

Model Switching While Typing

  • Quick Model Switch: Switch models while writing a prompt using alt+p (Linux/Windows) or option+p (macOS)
  • Status Line: Added context window information to status line input
  • File Suggestions: Added fileSuggestion setting for custom @ file search commands
  • Shell Override: Added CLAUDE_CODE_SHELL environment variable to override automatic shell detection
  • Bug Fixes: Fixed prompt not being saved to history when aborting with Escape

v2.0.64 - December 7, 2025

Named Sessions & Rules Directory

  • Auto-Compacting: Made auto-compacting instant
  • Async Operations: Agents and bash commands can run asynchronously and send messages to wake up the main agent
  • Stats Command: /stats now provides interesting stats: favorite model, usage graph, usage streak
  • Named Sessions:
    • Use /rename to name sessions
    • Use /resume <name> in REPL or claude --resume <name> from terminal
  • Rules Directory: Added support for .claude/rules/ directory (see memory documentation)
  • Image Metadata: Added image dimension metadata when images are resized
  • Resume Screen: Improved /resume screen with grouped forked sessions and keyboard shortcuts (P for preview, R for rename)
  • VS Code: Added copy-to-clipboard button on code blocks and bash tool inputs
  • Bedrock: Improved efficiency of token counting, added support for aws login credentials

v2.0.62 - December 5, 2025

Attribution Settings

  • Recommended Indicator: Added “(Recommended)” indicator for multiple-choice questions
  • Attribution Setting: Added attribution setting to customize commit and PR bylines (deprecates includeCoAuthoredBy)
  • Bug Fixes: Fixed duplicate slash commands, skill files symlink issues, lock file stale issues

v2.0.60 - December 3, 2025

Background Agent Support

  • Background Agents: Agents now run in background while you work
  • CLI Flag: Added --disable-slash-commands flag
  • Commit Attribution: Added model name to “Co-Authored-By” commit messages
  • MCP Toggle: Enabled /mcp enable [server-name] or /mcp disable [server-name] to quickly toggle servers
  • Fetch Optimization: Updated Fetch to skip summarization for pre-approved websites
  • VS Code: Added support for multiple terminal clients connecting to IDE server simultaneously

v2.0.59 - November 28, 2025

Agent Configuration

  • Agent CLI Flag: Added --agent CLI flag to override agent setting for current session
  • Agent Setting: Added agent setting to configure main thread with specific agent’s system prompt, tool restrictions, and model
  • VS Code Fix: Fixed .claude.json config file being read from incorrect location

v2.0.58 - November 26, 2025

Opus 4.5 for Pro Users

  • Pro Access: Pro users now have access to Opus 4.5 as part of their subscription!
  • Timer Fix: Fixed timer duration showing “11m 60s” instead of “12m 0s”
  • Windows: Managed settings now prefer C:\Program Files\ClaudeCode if it exists

v2.0.57 - November 24, 2025

Plan Feedback & Streaming

  • Plan Feedback: Added feedback input when rejecting plans
  • VS Code: Added streaming message support for real-time response display

v2.0.56 - November 22, 2025

Terminal Progress & VS Code Sidebar

  • Progress Bar: Added setting to enable/disable terminal progress bar (OSC 9;4)
  • VS Code: Added support for VS Code’s secondary sidebar (VS Code 1.97+)

v2.0.55 - November 20, 2025

Improved UX

  • Proxy Fix: Fixed proxy DNS resolution being forced on by default (now opt-in via CLAUDE_CODE_PROXY_RESOLVES_HOSTS=true)
  • Auto-Submit: Improved AskUserQuestion tool to auto-submit single-select questions on the last question
  • Fuzzy Matching: Improved fuzzy matching for @ file suggestions

v2.0.51 - November 14, 2025

Claude Opus 4.5 & Desktop App

  • Opus 4.5: Added Claude Opus 4.5! (Announcement)
  • Desktop App: Introducing Claude Code for Desktop (Download)
  • Plan Mode: Plan Mode now builds more precise plans and executes more thoroughly
  • Usage Notifications: Usage limit notifications easier to understand
  • Usage Display: Switched /usage back to ”% used”

v1.0.70 - August 6, 2025

Performance and Windows Fixes

  • Performance: Optimized message rendering for better performance with large contexts
  • Windows: Fixed native file search, ripgrep, and subagent functionality
  • @-mentions: Added support for @-mentions in slash command arguments

v1.0.69 - August 5, 2025

Model Upgrade

  • Opus 4.1: Upgraded Opus to version 4.1 with enhanced capabilities

v1.0.68 - August 4, 2025

Multiple Improvements

  • Model Names: Fixed incorrect model names being used for commands like /pr-comments
  • Windows Enhancements:
    • Improved permissions checks for allow/deny tools and project trust
    • Better sub-process spawning to eliminate “No such file or directory” errors with pnpm
  • Diagnostics: Enhanced /doctor command with CLAUDE.md and MCP tool context for self-serve debugging
  • SDK: Added canUseTool callback support for tool confirmation
  • Settings: Added disableAllHooks setting
  • Performance: Improved file suggestions performance in large repos

v1.0.65 - July 31, 2025

IDE and Windows Stability

  • IDE: Fixed connection stability issues and error handling for diagnostics
  • Windows: Fixed shell environment setup for users without .bashrc files

v1.0.64 - July 30, 2025

Agents and SDK Updates

  • Agents: Added model customization support - specify which model an agent should use
  • Agents: Fixed unintended access to the recursive agent tool
  • Hooks: Added systemMessage field to hook JSON output for displaying warnings and context
  • SDK: Fixed user input tracking across multi-turn conversations
  • Search: Added hidden files to file search and @-mention suggestions

v1.0.63 - July 28, 2025

Windows Functionality Fixes

  • Fixed file search, @agent mentions, and custom slash commands functionality on Windows

v1.0.62 - July 26, 2025

Agent Mentions and Hooks

  • Agent Support: Added @-mention support with typeahead for custom agents (@<your-custom-agent>)
  • Hooks: Added SessionStart hook for new session initialization
  • Commands: /add-dir command now supports typeahead for directory paths
  • Network: Improved network connectivity check reliability

v1.0.61 - July 24, 2025

Transcript Mode and Settings

  • Transcript Mode: Changed Esc to exit transcript mode rather than interrupt (Ctrl+R)
  • Settings: Added --settings flag to load settings from a JSON file

v1.0.60 - July 23, 2025

Custom Subagents

  • Major Feature: Create custom subagents for specialized tasks! Run /agents to get started

v1.0.59 - July 22, 2025

SDK and Hooks Enhancements

  • SDK: Added tool confirmation support with canUseTool callback
  • SDK: Allow specifying env for spawned process
  • Hooks: Exposed PermissionDecision to hooks (including “ask”)
  • Hooks: UserPromptSubmit now supports additionalContext in advanced JSON output
  • Model Fix: Fixed issue where some Max users specifying Opus would still see fallback to Sonnet

v1.0.58 - July 20, 2025

PDF Support and Improvements

  • PDF Reading: Added support for reading PDF files
  • MCP: Improved server health status display in ‘claude mcp list’
  • Hooks: Added CLAUDE_PROJECT_DIR env var for hook commands

v1.0.57 - July 19, 2025

Model Selection and Permissions

  • Slash Commands: Added support for specifying a model in slash commands
  • Permissions: Improved permission messages to help Claude understand allowed tools
  • Fix: Remove trailing newlines from bash output in terminal wrapping

v1.0.56 - July 18, 2025

Windows and WSL Improvements

  • Windows: Enabled Shift+Tab for mode switching on Node.js versions supporting terminal VT mode
  • WSL: Fixes for WSL IDE detection
  • AWS: Fixed issue causing awsRefreshHelper changes to .aws directory not to be picked up

v1.0.55 - July 17, 2025

Model Clarifications and Fixes

  • Models: Clarified knowledge cutoff for Opus 4.5 and Sonnet 4.5 models
  • Windows: Fixed Ctrl+Z crash
  • SDK: Added ability to capture error logging
  • System Prompt: Added --system-prompt-file option to override system prompt in print mode

v1.0.54 - July 16, 2025

Major Improvements

  • Hooks Enhancement: Added UserPromptSubmit hook with current working directory in hook inputs
  • Slash Commands: Support for argument-hint field in custom command frontmatter
  • Windows Improvements:
    • OAuth flow now uses port 45454 with correct browser URL construction
    • Mode-switching shortcut changed to Alt + M (fixing Shift+Tab conflict)
    • Plan mode renders properly in Windows terminals
  • Shell Execution: In-memory shell snapshot prevents file-related errors

v1.0.53 - July 11, 2025

Game-Changing Update

  • Context Expansion: @-mention file content limit increased from 100 to 2000 lines
  • AWS Integration: Helper scripts for credential refresh:
    • awsAuthRefresh for SSO login operations
    • awsCredentialExport for background STS operations

v1.0.52 - July 10, 2025

  • MCP Instructions: Support for Model Context Protocol server instructions
  • Continued MCP integration improvements

v1.0.51 - July 8, 2025

Native Windows Support Launch

  • Windows Native: Runs without WSL (Git for Windows required for Git features)
  • Cloud Integration: Amazon Bedrock support via AWS_BEARER_TOKEN_BEDROCK
  • Diagnostics: /doctor command identifies and fixes invalid configurations
  • Interactive Mode: --append-system-prompt flag now works in interactive mode
  • Performance: Auto-compaction threshold increased from 60% to 80%
  • Telemetry: Enhanced OpenTelemetry metadata (OS, architecture, WSL version)
  • Bug Fixes:
    • Directory names with spaces handled correctly
    • Custom commands in subdirectories register with proper namespacing
    • Plan mode rejection edge case resolved

v1.0.48 - July 7, 2025

Stability and UX Improvements

  • Critical Fix: Resolved freeze-on-launch bug from v1.0.45
  • Bash Tool UX: Real-time progress showing last 5 lines of output
  • MCP Config: Environment variable expansion in server configs
  • Shell Reliability: Snapshots moved to ~/.claude directory
  • New Hook: PreCompact hook for pre-compaction actions
  • Vim Mode: Extended keybindings (c, f/F, t/T motions)

v1.0.44-45 - July 3, 2025

Search and Export Features

  • v1.0.44:
    • New /export command for conversation transcripts
    • MCP resource_link results display properly
    • Ctrl+Z now suspends (resume with fg)
    • Prompt undo remapped to Ctrl+U
  • v1.0.45:
    • Search Tool Overhaul: Redesigned grep tool with new parameters
    • Jupyter notebook diff view disabled (prevents timeouts)
    • Atomic config writes prevent corruption
    • Hooks refinement: Stop vs SubagentStop events
    • Custom command namespacing restored

v1.0.38 - June 30, 2025

Hooks System Introduction

  • User-Defined Hooks: Inject custom behavior at lifecycle events
  • Enables logging, approvals, and integrations
  • Community-driven feature based on GitHub feedback
  • Major extensibility expansion

v1.0.27 - June 18, 2025

Real-Time MCP Integration

  • SSE Support: Server-Sent Events for MCP servers
  • HTTP Transport: Additional transport option
  • OAuth 2.0: Authentication for remote MCP servers
  • Resource Syntax: @server:protocol://path for external data
  • Live connections to external tool servers

v1.0.24-25 - June 25, 2025

Reliability Improvements

  • v1.0.24:
    • Enhanced /mcp command formatting
    • Fixed array merging in nested settings
  • v1.0.25:
    • Fixed: Slash commands not appearing/executing
    • Custom command discovery overhaul
    • Ghostty proxy compatibility
    • Web search reliability improvements

v1.0.23 - June 11, 2025

CLI Package Update

  • Official NPM Package:
    • CLI Tool: @anthropic-ai/claude-code (NPM)
    • Note: No official Python package currently available
  • Enhanced CLI integration features
  • Improved streaming output support

v1.0.17-18 - June 9, 2025

Multi-Directory Support

  • v1.0.17:
    • Sub-task messages in non-interactive mode
    • parent_tool_use_id for task correlation
    • VS Code diff tool crash fixes
    • Process title shows as claude
  • v1.0.18:
    • --add-dir flag for additional directories
    • Streaming stdin support
    • CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR environment variable
    • SSE auto-reconnection for MCP servers

v1.0.10-11 - June 4, 2025

General Availability Features

  • Access Expansion: Available to Pro and Max plans
  • v1.0.10: Markdown table rendering support
  • v1.0.11:
    • /upgrade command for plan switching
    • Enhanced authentication UI
    • Improved to-do list management

v1.0.0 - May 22, 2025

General Availability Launch

  • Status: Graduated from preview to supported product
  • Models: Claude Opus 4.5 and Sonnet 4.5 integration
  • Coincided with Claude 3.7 “Sonnet” model launch
  • v1.0.1:
    • DISABLE_INTERLEAVED_THINKING flag option
    • Provider-specific model names in UI

v0.2.125 - May 21, 2025

Final Beta - Breaking Changes

  • Bedrock ARN: Changed from %2F to literal /
  • Logging: DEBUG=true replaced with ANTHROPIC_LOG=debug
  • Preparation for GA release

v0.2.117 - May 20, 2025

  • JSON Output: Changed to nested message objects (breaking change)
  • Settings: cleanupPeriodDays configuration added
  • Debug Mode: Global --debug flag introduced

v0.2.108 - May 18, 2025

Interactive Thinking

  • Real-Time Steering: Send messages while Claude is “thinking”
  • Bash Timeouts: BASH_DEFAULT_TIMEOUT_MS and BASH_MAX_TIMEOUT_MS
  • Fixed thinking mode in non-interactive mode
  • MCP wizard deprecated for dedicated commands

v0.2.105 - May 16, 2025

Web Browsing Capability

  • Web Search: New fetch tool for URLs
  • Status Command: /status replaces welcome message info
  • Vim Motions: Word-level navigation (w, b, e)
  • Performance optimizations for startup and file operations

v0.2.102 - May 14, 2025

  • Thinking Mode: Improved reliability and triggers
  • @-mentions: Better handling of images and directories
  • Input: Multiple large text chunks can be pasted

v0.2.93 - May 1, 2025

Session Management

  • Continue Sessions: claude --continue for recent session
  • Resume by ID: claude --resume <ID> for specific sessions
  • To-Do List: Internal task management for complex operations

v0.2.82 - April 25, 2025

  • Permissions: --disallowedTools flag and config
  • Tool Renaming: Clearer names (LSTool→LS, View→Read)

v0.2.75 - April 20, 2025

Major Interactivity Update

  • Concurrent Queries: Queue messages while Claude is busy
  • Image Support: Drag-and-drop or paste images
  • @-mentions: Reference files directly in prompts
  • MCP One-off: --mcp-config <path> flag
  • Autocomplete: Performance improvements for large projects

v0.2.70 - April 15, 2025

  • Network Tools: curl and similar commands unlocked
  • Parallel Search: Multiple web queries simultaneously
  • Interrupt: ESC key immediately stops Claude in auto-accept mode

v0.2.54 - March 25, 2025

  • Memory: # prefix for persistent context
  • Long Output: Ctrl+R reveals full tool output
  • MCP SSE: Server-Sent Events transport support

v0.2.47 - March 15, 2025

Auto-Compaction & QoL

  • Autocomplete: Tab completion for filenames
  • Auto-Accept: Shift+Tab toggles file edit approvals
  • Infinite Sessions: Automatic conversation compaction
  • Configurable via /config interface

v0.2.44 - March 14, 2025

Thinking Mode Introduction

  • Deep Reasoning: Triggered by “think” in prompts
  • Step-by-step planning before execution
  • “Think harder” and “ultrathink” variations

v0.2.34 - March 8, 2025

Vim Mode & Custom Commands

  • Vim Keybindings: Toggle with /vim
  • Custom Commands: .claude/commands/ directory support
  • Normal and insert modes with hjkl navigation

v0.2.0 - February 24, 2025

Research Preview Launch

  • Initial Release: Agentic coding tool for terminal
  • Core capabilities:
    • Codebase scanning and understanding
    • Intelligent code search
    • File editing with permissions
    • Test suite execution
    • Git operations (commit, push, branch)
    • Shell command execution
  • Permission system for user control
  • Internal testing: 45-minute tasks completed in one pass

Release Frequency

  • Preview Phase: Multiple releases per week
  • Post-GA: 2-3 releases per week average
  • Hotfixes: Within 24-48 hours when needed

Version Numbering

  • Major: Significant feature additions
  • Minor: New capabilities and improvements
  • Patch: Bug fixes and small enhancements

Breaking Changes

  • Clearly marked in changelog
  • Migration guides provided
  • Rare after GA (v1.0.0)
  1. February 2025: Core CLI capabilities and permission system
  2. March 2025: Vim mode, custom commands, thinking mode, auto-compaction
  3. April 2025: Images, @-mentions, concurrent queries, network tools
  4. May 2025: Web browsing, session management, GA launch with new models
  5. June 2025: SDKs, Hooks system, real-time MCP, multi-directory support
  6. July 2025: Native Windows, 2000-line context, enhanced AWS integration, custom subagents
  7. August 2025: Opus 4.1 upgrade, performance optimizations, enhanced diagnostics
  8. November 2025: Claude Opus 4.5, Claude Code for Desktop, Pro users get Opus 4.5
  9. December 2025: Background agents, named sessions, .claude/rules/, prompt suggestions, model switching (alt+p)