Claude Code v2.1.89 Release Notes

Claude Code v2.1.89 introduces deferred permissions, flicker-free rendering, and enhanced MCP support with numerous bug fixes for a smoother development experience.

April 1, 2026 • 10 min read • By ClaudeWorld

The latest Claude Code release brings significant improvements to permission handling, rendering performance, and MCP integration. This update focuses on enhancing the developer experience with better tool management and resolving critical bugs that affected session stability.

What’s New

Enhanced Permission System

  • Deferred Permission Decisions: PreToolUse hooks now support "defer" permission decisions, allowing headless sessions to pause at tool calls and resume with -p --resume for hook re-evaluation
  • Permission Denied Hooks: New PermissionDenied hook fires after auto mode classifier denials, with support for {retry: true} to enable model retries
  • Improved Auto Mode: Denied commands now display notifications and appear in /permissions → Recent tab with retry capability using r

Performance and Rendering Improvements

  • Flicker-Free Rendering: New CLAUDE_CODE_NO_FLICKER=1 environment variable enables flicker-free alt-screen rendering with virtualized scrollback
  • Non-blocking MCP Connections: MCP_CONNECTION_NONBLOCKING=true for -p mode skips MCP connection waits entirely, with 5s bounded server connections

Enhanced User Experience

  • Named Subagents: Added to @ mention typeahead suggestions for easier reference
  • Improved Voice Support: Fixed push-to-talk activation issues and Windows WebSocket problems
  • Better File Handling: Fixed symlink resolution for Edit(//path/**) and Read(//path/**) allow rules

Critical Bug Fixes

  • Session Stability: Fixed crashes with large session files (50MB+) and memory leaks from JSON input retention
  • LSP Server Recovery: Servers now restart on next request after crashes instead of remaining in zombie state
  • Unicode Support: Fixed prompt history issues with CJK characters and emoji at 4KB boundaries
  • Token Counting: /stats now correctly includes subagent usage and preserves historical data
  • Tool Reliability: Fixed StructuredOutput schema cache bug and MCP tool error truncation

How to Update

To update to Claude Code v2.1.89:

  1. Download the latest version from the official release page
  2. Follow the standard installation procedure for your platform
  3. Restart any active Claude Code sessions to benefit from the improvements
  4. Consider enabling flicker-free rendering with export CLAUDE_CODE_NO_FLICKER=1