Claude Code v2.1.126: Enhanced Project Management and Cross-Platform Improvements

Claude Code v2.1.126 delivers significant enhancements to project management workflows, cross-platform compatibility, and developer experience. This release introduces powerful cleanup tools, improves authentication reliability, and addresses numerous platform-specific issues that have been impacting Windows and remote development environments.

What’s New

Project Management & Cleanup

New Project Purge Command: The standout feature of this release is the new claude project purge [path] command, which allows you to completely clean up all Claude Code state for a project. This includes transcripts, tasks, file history, and config entries. The command supports flexible execution modes:

--dry-run to preview what will be deleted
-y/--yes for non-interactive execution
-i/--interactive for selective deletion
--all to purge everything

Gateway & Model Management

Enhanced Gateway Compatibility: The /model picker now intelligently lists models from your gateway’s /v1/models endpoint when ANTHROPIC_BASE_URL points to an Anthropic-compatible gateway, improving integration with custom deployments.

Improved Permission Handling: The --dangerously-skip-permissions flag now bypasses prompts for writes to protected directories like .claude/, .git/, .vscode/, and shell config files, while maintaining safety nets for catastrophic operations.

Authentication & OAuth Improvements

Robust OAuth Flow: claude auth login now gracefully handles scenarios where the browser callback can’t reach localhost (common in WSL2, SSH, and container environments) by accepting OAuth codes pasted directly into the terminal.

Better Error Handling: The system now properly displays guidance for “OAuth not allowed for organization” errors instead of showing the generic login screen.

Developer Experience Enhancements

Enhanced Telemetry: The claude_code.skill_activated OpenTelemetry event now includes an invocation_trigger attribute that distinguishes between “user-slash”, “claude-proactive”, and “nested-skill” invocations.

Visual Feedback Improvements: Auto mode now displays a red spinner when permission checks stall, providing clearer visual feedback about system state.

Platform-Specific Improvements

Windows PowerShell Detection: Significantly improved detection of PowerShell 7 installations across various deployment methods (Microsoft Store, MSI without PATH, .NET global tool). When PowerShell is enabled, Claude now correctly treats it as the primary shell.

Image Handling: Fixed session-breaking issues with large images by implementing automatic downscaling on paste and removing oversized images from history with automatic request retry.

Security & Stability Fixes

Security Enhancement: Resolved a critical issue where allowManagedDomainsOnly and allowManagedReadPathsOnly settings were being ignored when higher-priority managed-settings sources lacked a sandbox block.

Connection Reliability: Fixed multiple timeout and connection issues including “Stream idle timeout” errors after Mac sleep, background session aborts, and OAuth failures on slow or proxied connections.

Performance Optimizations: Addressed trackpad scrolling issues in Cursor and VS Code integrated terminals, and resolved text rendering problems for Japanese, Korean, and Chinese characters on Windows.

How to Update

To update to Claude Code v2.1.126:

Check your current version: claude --version
Update using your package manager or download the latest release
Verify the update: claude --version
Consider using the new claude project purge --dry-run to clean up old project state