Claude docs changes for February 25th, 2026 [diff]
Executive Summary
- Remote Control is a new feature (research preview for Pro/Max) that lets you control a local Claude Code session from a browser or mobile phone without moving anything to the cloud
- Managed settings now support macOS plist (via MDM configuration profiles) and Windows Registry (via Group Policy/Intune) in addition to JSON files, giving IT admins more deployment options
- npm plugin support is now fully implemented: plugins can be installed from npm packages with version pinning and custom private registries
- Authentication got a major overhaul with a new
claude authset of subcommands (login,logout,status) and improved documentation for all account types - Troubleshooting was massively expanded with a comprehensive installation error table and detailed fix guides for macOS, Linux, and Windows
New Claude Code versions
2.1.51
New features
- Added
claude remote-controlsubcommand for external builds, enabling local environment serving for all users - Added support for custom npm registries and specific version pinning when installing plugins from npm sources
- Added
CLAUDE_CODE_ACCOUNT_UUID,CLAUDE_CODE_USER_EMAIL, andCLAUDE_CODE_ORGANIZATION_UUIDenvironment variables for SDK callers to provide account info synchronously, eliminating a race condition where early telemetry events lacked account metadata
Existing feature improvements
- BashTool now skips login shell (
-lflag) by default when a shell snapshot is available, improving command execution performance (previously required settingCLAUDE_BASH_NO_LOGIN=true) - Tool results larger than 50K characters are now persisted to disk (previously 100K), reducing context window usage and improving conversation longevity
- The
/modelpicker now shows human-readable labels (e.g., "Sonnet 4.5") instead of raw model IDs for pinned model versions, with an upgrade hint when a newer version is available - Managed settings can now be set via macOS plist or Windows Registry
Major bug fixes
- Fixed a security issue where
statusLineandfileSuggestionhook commands could execute without workspace trust acceptance in interactive mode - Fixed a bug where duplicate
control_responsemessages (e.g., from WebSocket reconnects) could cause API 400 errors by pushing duplicate assistant messages into the conversation - Fixed slash command autocomplete crashing when a plugin's SKILL.md description is a YAML array or other non-string type
2.1.53
Major bug fixes
- Fixed a UI flicker where user input would briefly disappear after submission before the message rendered
- Fixed bulk agent kill (Ctrl+F) to send a single aggregate notification instead of one per agent, and to properly clear the command queue
- Fixed graceful shutdown sometimes leaving stale sessions when using Remote Control
- Fixed
--worktreesometimes being ignored on first launch - Fixed multiple crashes on Windows (panic on corrupted value, process spawning, WebAssembly interpreter, Windows ARM64 crash after 2 minutes)
2.1.55
Major bug fixes
- Fixed BashTool failing on Windows with EINVAL error
2.1.56
Major bug fixes
- VS Code: Fixed another cause of "command 'claude-vscode.editor.openLast' not found" crashes
Claude Code changes
New Documents
Remote Control [Source]
New feature (research preview for Pro/Max plans) that connects claude.ai/code or the Claude mobile app to a Claude Code session running on your local machine. Lets you start a task at your desk and continue it from your phone or another browser without moving anything to the cloud. Covers setup requirements, how to start sessions with claude remote-control or /remote-control, connecting from other devices via URL or QR code, security model (outbound HTTPS only, no inbound ports), and comparison with Claude Code on the web.
Terminal Guide [Source]
A beginner-friendly guide for users who have never used a terminal before. Covers how to open a terminal on macOS, Linux, and Windows; install Claude Code; and take first steps. Includes platform-specific troubleshooting for common errors (command not found, SSL errors, Git Bash missing, etc.).
Changed Documents
Authentication [Source]
- Added a new "Log in to Claude Code" section at the top documenting the first-launch browser login flow and all supported account types (Pro/Max, Teams/Enterprise, Console, cloud providers). [lines 1-20] [Source]
- Updated cloud provider list to include Microsoft Foundry (was previously "Microsoft Azure"). [line 92] [Source]
CLI Reference [Source]
- Added three new
claude authsubcommands:claude auth login(with--emailand--ssoflags),claude auth logout, andclaude auth status(outputs JSON;--textfor human-readable; exit code 0 if logged in). [lines 13-15] [Source] - Added
claude remote-controlsubcommand for starting a Remote Control session. [line 18] [Source]
Claude Code on the Web [Source]
- Added Android app link alongside iOS. [line 15] [Source]
- Added reference to Remote Control as an option for using the web UI while running locally. [line 15] [Source]
Data Usage [Source]
- Clarified that Remote Control sessions follow the local Claude Code data flow since all execution happens on the user's machine. [line 42] [Source]
How Claude Code Works [Source]
- Updated the built-in tool categories count from 4 to 5. [line 23] [Source]
- Added a new "Environments and interfaces" section explaining the three execution environments (Local, Cloud, Remote Control) and available interfaces (terminal, desktop, IDE, web, Remote Control, Slack, CI/CD). [lines 58-70] [Source]
Index / Overview [Source]
- Added Windows requirement for Git for Windows to the installation section. [line 57] [Source]
- Added Remote Control to the "Work from anywhere" section and the interface comparison table. [lines 198-210] [Source]
Permissions [Source]
- Clarified that
/pathpatterns are relative to the project root (not the settings file). [line 135] [Source] - Added four new managed-only settings:
allowManagedMcpServersOnly(restricts MCP servers to admin allowlist only),blockedMarketplaces(pre-download blocklist for marketplace sources),sandbox.network.allowManagedDomainsOnly(restricts allowed domains to managed settings only), andallow_remote_sessions(controls whether users can start Remote Control and web sessions). [lines 221-230] [Source] - Updated managed settings description to reflect that settings can now be delivered through MDM/OS-level policies, managed settings files, or server-managed settings. [line 213] [Source]
Plugin Marketplaces [Source]
- Added full documentation for npm package sources, including version pinning (
versionfield) and custom private registries (registryfield). [lines 387-440] [Source] - Added troubleshooting section for git operation timeouts with instructions for the
CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MSenvironment variable. [lines 936-953] [Source] - Removed the warning that npm source is not yet fully implemented.
Quickstart [Source]
- Added link to the new terminal guide for users new to the command line. [line 10] [Source]
- Added Windows requirement note for Git for Windows. [line 60] [Source]
Security [Source]
- Added explanation of how Remote Control sessions work from a security standpoint: traffic flows through the Anthropic API over TLS, code executes locally, no cloud VMs or sandboxing, and uses multiple short-lived narrowly scoped credentials. [line 93] [Source]
Server-Managed Settings [Source]
- Updated endpoint-managed settings description to reflect new delivery options: MDM configuration profiles, registry policies, or managed settings files (in addition to the existing JSON file approach). [lines 18-24] [Source]
Settings [Source]
- Expanded the managed settings section to document three delivery mechanisms: server-managed settings, MDM/OS-level policies (macOS
com.anthropic.claudecodeplist via Jamf/Kandji; WindowsHKLM\SOFTWARE\Policies\ClaudeCoderegistry via Group Policy/Intune), and file-based (managed-settings.json). [lines 27-35] [Source] - Added new settings:
allowManagedMcpServersOnly,blockedMarketplaces, andnetwork.allowManagedDomainsOnly. [lines 43-59] [Source] - Added new environment variables:
CLAUDE_CODE_ACCOUNT_UUID,CLAUDE_CODE_USER_EMAIL,CLAUDE_CODE_ORGANIZATION_UUID(for SDK account info), andCLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS(git operation timeout for plugins). [lines 100-119] [Source] - Added precedence ordering within the managed tier: server-managed > MDM/OS-level >
managed-settings.json> HKCU registry. [line 72] [Source] - Added documentation for the
/statuscommand to verify which settings sources are active and their origins. [lines 80-82] [Source]
Setup [Source]
- Major restructure: added Windows Git Bash requirement to system requirements, added a new "Verify your installation" section, improved the Windows setup section (Git Bash path configuration in settings.json), and reorganized the update and install sections for clarity. [lines 1-200] [Source]
- Deprecated npm installation section now includes explicit migration steps from npm to native binary. [lines 380-415] [Source]
- Binary integrity and code signing information moved and clarified (SHA256 checksums URL format, macOS/Windows signing details). [lines 410-430] [Source]
Sub-Agents [Source]
- Removed the incorrect statement that MCP tools are not available in background subagents. [line 728] [Source]
Troubleshooting [Source]
- Massively expanded with a comprehensive installation troubleshooting section: a quick-reference error table mapping common error messages to solutions, and detailed fix guides for network connectivity, PATH issues, Windows-specific errors (Git Bash, irm not recognized), Linux binary mismatches, macOS binary issues, and more. [lines 1-600] [Source]
API changes
Changed Documents
Remote MCP Servers [Source]
- Reordering of MCP server entries in the listing (no new servers or substantive content changes).