Claude docs changes for April 14th, 2026 [diff]
Executive Summary
- Version 2.1.105 is a major release: PreCompact hooks can now block compaction, a new
asyncRewakehook type wakes Claude on background failures, and skills get a newwhen_to_usefield with a raised 1,536-character description cap - Bash permission rules gained a detailed "Process wrappers" section documenting which wrappers (
timeout,nice,nohup,xargs, etc.) are stripped before matching, and deny/ask rules are now evaluated regardless of hook return values subagentStatusLineis a new setting that lets you render custom rows in the agent panel, and plugins can now shipmonitorsthat auto-arm at session start- New telemetry events added:
plugin_installedandskill_activated, andOTEL_LOG_TOOL_DETAILSnow also populates trace span attributes - Two new MCP servers listed: Kindora Funder Discovery and AdisInsight (pharmaceutical intelligence)
New Claude Code versions
2.1.105
New features
- Added
pathparameter to theEnterWorktreetool to switch into an existing worktree of the current repository - Added PreCompact hook support: hooks can now block compaction by exiting with code 2 or returning
{"decision":"block"} - Added background monitor support for plugins via a top-level
monitorsmanifest key that auto-arms at session start or on skill invoke /proactiveis now an alias for/loop
Existing feature improvements
- Improved stalled API stream handling: streams now abort after 5 minutes of no data and retry non-streaming instead of hanging indefinitely
- Improved network error messages: connection errors now show a retry message immediately instead of a silent spinner
- Improved file write display: long single-line writes are now truncated in the UI
- Improved
/doctorlayout with status icons; pressfto have Claude fix reported issues - Improved
/configlabels and descriptions for clarity - Improved skill description handling: raised the listing cap from 250 to 1,536 characters and added a startup warning when descriptions are truncated
- Improved
WebFetchto strip<style>and<script>contents from fetched pages - Improved stale agent worktree cleanup to remove worktrees whose PR was squash-merged
- Improved MCP large-output truncation prompt to give format-specific recipes
Major bug fixes
- Fixed images attached to queued messages being dropped
- Fixed screen going blank when the prompt input wraps to a second line in long conversations
- Fixed leading whitespace getting copied when selecting multi-line assistant responses in fullscreen mode
- Fixed garbled bash output when commands print clickable file links
- Fixed alt+enter not inserting a newline in terminals using ESC-prefix alt encoding, and Ctrl+J not inserting a newline (regression in 2.1.100)
- Fixed queued user prompts disappearing from focus mode
- Fixed one-shot scheduled tasks re-firing repeatedly
- Fixed inbound channel notifications being silently dropped after the first message for Team/Enterprise users
- Fixed marketplace plugins with
package.jsonand lockfile not having dependencies installed automatically after install/update - Fixed stdio MCP server emitting malformed output hanging the session instead of failing fast
- Fixed MCP tools missing on the first turn of headless/remote-trigger sessions
- Fixed
/modelpicker on AWS Bedrock in non-US regions persisting invalid model IDs - Fixed 429 rate-limit errors showing a raw JSON dump instead of a clean message
- Fixed crash on resume when session contains malformed text blocks
- Fixed
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICin one project permanently disabling usage metrics for all projects - Fixed washed-out 16-color palette when using Ghostty, Kitty, Alacritty, WezTerm, foot, rio, or Contour over SSH/mosh
- Fixed Bash tool suggesting
acceptEditspermission mode when exiting plan mode would downgrade from a higher permission level
2.1.107
Existing feature improvements
- Show thinking hints sooner during long operations
Claude Code changes
New Documents
whats-new/2026-w15 [Source]
Week 15 (April 6–10, 2026) digest covering releases v2.1.92–v2.1.101. Highlights: Ultraplan enters early preview (plan in the cloud from CLI, review in browser, execute remotely or locally); Monitor tool streams background events into the conversation for live log tailing and reactions; /loop self-pacing when interval is omitted; /team-onboarding generates a teammate ramp-up guide; /autofix-pr enables PR auto-fix from the terminal.
Changed documents
agent-sdk/typescript [Source]
EnterWorktreeInputnow has an optionalpathfield to switch into an existing worktree;nameandpathare mutually exclusive. [line ~1597]
commands [Source]
/doctordescription updated: results now show with status icons and pressingfsends the report to Claude for fixing./loopnow lists/proactiveas an alias.- New
/team-onboardingcommand: generates a team onboarding guide from the last 30 days of Claude Code usage history.
common-workflows [Source]
claude --resumenow accepts custom session names (set with--nameor/rename) in addition to session IDs.
costs [Source]
- Added a reference to
claude.com/pricingfor subscription plan pricing (Pro, Max, Team, Enterprise).
discover-plugins [Source]
- Added troubleshooting guidance for when a plugin is not found: run
/plugin marketplace update claude-plugins-officialto refresh, or/plugin marketplace add anthropics/claude-plugins-officialto add it.
env-vars [Source]
- New
ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIESenv var for specifying capabilities of custom model entries. CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MDupdated: now also loadsCLAUDE.local.mdfrom additional directories (skipped iflocalis excluded from--setting-sources).CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MSupdated: default budget is now auto-raised to the highest per-hook timeout configured in settings files, up to 60 seconds.- New
CLAUDE_ENABLE_BYTE_WATCHDOGenv var: controls a byte-level streaming watchdog (enabled by default for Anthropic API) that aborts when no bytes arrive for the duration set byCLAUDE_STREAM_IDLE_TIMEOUT_MS(minimum 5 minutes). CLAUDE_ENABLE_STREAM_WATCHDOGnow only enables the event-level watchdog (off by default); the byte-level watchdog is the new default mechanism for Anthropic API.CLAUDE_STREAM_IDLE_TIMEOUT_MSupdated with per-watchdog defaults: 5 minutes (minimum) for byte-level, 90 seconds for event-level.OTEL_LOG_TOOL_DETAILSupdated: now also populates tool input in trace span attributes in addition to log events.- New
VERTEX_REGION_CLAUDE_4_5_OPUSandVERTEX_REGION_CLAUDE_4_6_OPUSregion override env vars for Vertex AI.
hooks [Source]
- New
asyncRewakecommand hook field: runs in the background and wakes Claude immediately when it exits with code 2, delivering the hook's stderr as a system reminder. [line ~291] PreCompacthooks can now block compaction via exit code 2 or{"decision":"block"}JSON; previously they were side-effect only. [line ~528]- Documented the two different effects of blocking PreCompact: skips proactive compaction vs. surfaces context-limit error for recovery compaction. [line ~1788]
SessionEndhooks timeout behavior updated: per-hooktimeoutsettings automatically raise the overall budget up to 60 seconds; the env var is now an explicit override rather than an absolute cap. [line ~1863]- Clarified that
PreToolUsehookpermissionDecisionvalues do not bypass deny/ask rules — those are evaluated regardless. [line ~930]
interactive-mode [Source]
Ctrl+Odescription updated: MCP calls now collapse to "Called slack 3 times" style (previously only read and search calls collapsed).
keybindings [Source]
- New
Doctorkeybinding context with adoctor:fixaction (default key:F) to send diagnostics to Claude for fixing. chat:newlinenow has a default binding:Ctrl+J.
mcp [Source]
- New MCP server added: Kindora Funder Discovery — find funders who support causes like yours.
- New MCP server added: AdisInsight — pharmaceutical drug & clinical trial intelligence.
- Updated links for bioRxiv, ChEMBL, Clinical Trials, CMS Coverage, ICD-10 Codes, and NPI Registry servers.
- Asana transport updated from
streamable-httptohttp.
memory [Source]
CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MDnow also loadsCLAUDE.local.mdfrom additional directories; previously onlyCLAUDE.md,.claude/CLAUDE.md, and.claude/rules/*.mdwere loaded.
model-config [Source]
ANTHROPIC_CUSTOM_MODEL_OPTIONnow supports the_NAME,_DESCRIPTION, and_SUPPORTED_CAPABILITIESsuffixes, matching the pattern already available for the default Opus/Sonnet/Haiku model env vars.
monitoring-usage [Source]
- New
claude_code.plugin_installedtelemetry event with attributes including plugin name, version, marketplace source, and install trigger (cliorui). - New
claude_code.skill_activatedtelemetry event with attributes including skill name, source, and owning plugin. OTEL_LOG_TOOL_DETAILSnow also includestool_inputand derived attributes (e.g.,file_path) in trace spans, not just log events.
network-config [Source]
- Chrome integration requires
bridge.claudeusercontent.comto be allowlisted for outbound WebSocket connections.
permissions [Source]
- Clarified that the
:*trailing wildcard is only recognized at the end of a pattern; in the middle (e.g.,Bash(git:* push)) the colon is treated literally. - A single
*matches any sequence including spaces, so one wildcard spans multiple arguments. - New "Compound commands" section: documented recognized command separators (
&&,||,;,|,|&,&, newlines) and that each subcommand must match independently. - New "Process wrappers" section:
timeout,time,nice,nohup,stdbuf, and barexargsare stripped before matching rules. Development environment runners (devbox,mise,npx,docker exec, etc.) are NOT stripped — write rules that include the runner. - Hook decisions clarified: deny/ask permission rules are evaluated regardless of what a
PreToolUsehook returns — a deny rule blocks even when the hook returned"allow". CLAUDE.local.mdis now also loaded from--add-dirdirectories (requiresCLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1and thelocalsetting source).
plugins [Source]
- Plugin
settings.jsonnow supports thesubagentStatusLinekey in addition toagent.
plugins-reference [Source]
- New
monitorsmanifest key: background Monitor configurations that auto-arm when the plugin is enabled at session start or when a skill in the plugin is invoked. - Plugin directory structure updated to include
monitors/monitors.jsonas a recognized location. - Plugin
settings.jsonnow supportssubagentStatusLinein addition toagent.
settings [Source]
- New
viewModesetting: sets the default transcript view mode on startup ("default","verbose", or"focus"), overriding the stickyCtrl+Oselection.
setup [Source]
- Added a comparison table for native Windows vs WSL 2 vs WSL 1, including sandboxing support.
- Expanded Windows setup documentation with clearer guidance on PowerShell vs CMD and how Claude Code uses Git Bash internally.
- Clarified that WSL setups do not require Git for Windows.
skills [Source]
- New "Live change detection" section: skill directories are watched for changes; edits take effect within the current session without restarting.
- New
when_to_usefrontmatter field for skills: additional context on when Claude should invoke the skill, appended todescriptionin the listing. - Skill description cap raised from 250 to 1,536 characters, now covering the combined
description+when_to_usetext.
statusline [Source]
- New
subagentStatusLinesetting: renders custom row bodies in the agent panel for each subagent. The command receives subagent task data via stdin and writes one JSON line per row to override. [line ~569]
sub-agents [Source]
- Clarified that frontmatter hooks in subagent files only fire when the agent is spawned via the
Agenttool or an@-mention, not when it runs as the main session via--agentor theagentsetting.
tools-reference [Source]
EnterWorktreetool description updated: pass apathto switch into an existing worktree instead of creating a new one.- Monitor tool: now also unavailable when
DISABLE_TELEMETRYorCLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICis set.
ultraplan [Source]
- Ultraplan now automatically creates a default cloud environment on first launch if one doesn't exist.
API changes
Changed documents
agents-and-tools/agent-skills/quickstart [Source]
- Code example tabs expanded to include Python and TypeScript variants across all examples.
agents-and-tools/mcp-connector [Source]
- Code example tabs expanded to include more language variants.
agents-and-tools/remote-mcp-servers [Source]
- New MCP server listed: Kindora Funder Discovery — find funders who support causes like yours (
https://kindora-mcp.azurewebsites.net/mcp/). - New MCP server listed: AdisInsight — pharmaceutical drug & clinical trial intelligence (
https://adisinsight-mcp.springer.com/mcp). - Updated link for ICD-10 Codes to point to the official Claude tutorial page.
build-with-claude/adaptive-thinking [Source]
- Fixed contact sales link for requesting full thinking output for Claude 4 models (now uses a plain
mailto:link). - Code example tabs expanded to include more language variants.
managed-agents/agent-setup [Source]
- Code example tabs expanded to include curl, Python, TypeScript, and other language variants.
managed-agents/environments [Source]
- Code example tabs expanded to include more language variants across all examples.
managed-agents/memory [Source]
- Code example tabs expanded to include more language variants across all examples.
managed-agents/sessions [Source]
- Code example tabs expanded to include more language variants across all examples.