Claude Code v2.1.140 Release Notes

Claude Code v2.1.140 brings significant improvements to agent tools, background service stability, and plugin management with enhanced error handling.

May 13, 2026 • 10 min read • By ClaudeWorld

Claude Code v2.1.140 Release Notes

The latest Claude Code update delivers a comprehensive set of improvements focused on enhancing user experience, system stability, and developer workflow efficiency. This release addresses several critical issues while introducing smarter agent tool matching capabilities.

What’s New

Enhanced Agent Tool Matching

Agent tool subagent_type matching has been significantly improved to accept case- and separator-insensitive values. Now you can use formats like "Code Reviewer" which will automatically resolve to code-reviewer, making agent configuration more flexible and user-friendly.

Visual and Interface Improvements

  • Updated agent color palette for better visual distinction and accessibility
  • Improved /goal command feedback - no more silent hanging when disableAllHooks or allowManagedHooksOnly is set. Users now receive clear messages instead of indefinitely spinning indicators
  • Enhanced native terminal cursor behavior that stays positioned at the input caret even when the terminal loses focus

Background Service Stability

Several critical fixes improve the reliability of Claude Code’s background operations:

  • Fixed /claude --bg connection drops during service idle-exit periods
  • Resolved startup failures on enterprise security-enabled machines by extending startup timeouts
  • Improved remote managed settings with automatic retry on 401 errors using force-refreshed tokens

Configuration and Settings

  • Hot-reload improvements - Fixed regression where symlinked settings files caused incorrect change event attribution and spurious ConfigChange hooks
  • Persistent marketplace settings - Fixed managed extraKnownMarketplaces auto-update policy persistence to known_marketplaces.json

Performance Optimizations

  • Efficient loop scheduling - /loop command no longer schedules redundant wakeups for background tasks that already provide completion notifications
  • Windows performance fix - Eliminated recurring event-loop stalls caused by synchronous where.exe re-spawns when checking for missing executables

Tool and Plugin Enhancements

  • Robust Read tool validation - Fixed validation failures when offset parameters contain whitespace padding or + prefixes
  • Improved plugin diagnostics - Plugins now provide warnings in /doctor, claude plugin list, and /plugin when default component folders are ignored due to plugin.json configuration conflicts

How to Update

To update to Claude Code v2.1.140:

  1. Automatic update: If you have auto-updates enabled, the update should install automatically
  2. Manual update: Run claude update in your terminal
  3. Fresh installation: Download the latest version from the official release page

After updating, run claude --version to verify you’re on v2.1.140.