Claude docs changes for March 29th, 2026 [diff]

Executive Summary

LLM gateway docs now document the X-Claude-Code-Session-Id request header, which proxies can use to aggregate all API requests from a single session
CLAUDE_CODE_SIMPLE / --bare mode now allows MCP tools from --mcp-config to remain available
Skill description budget halved (2%→1% of context window, 16k→8k char fallback) with per-entry 250-char cap; skill names are always included regardless of budget

CLAUDE_CODE_SIMPLE clarified that MCP tools from --mcp-config are still available even in simple/bare mode. [line 77] [Source]
SLASH_COMMAND_TOOL_CHAR_BUDGET default budget updated from 2%/16,000 chars to 1%/8,000 chars. [line 118] [Source]

Added troubleshooting section explaining how to enable macOS notifications via osascript when notifications from Script Editor are silently failing — requires manually granting permission in System Settings > Notifications. [lines 92-100] [Source]

Added documentation for the X-Claude-Code-Session-Id request header, which is sent on every API request and can be used by proxies to aggregate requests from a single session without parsing the request body. [lines 28-33] [Source]

description field documentation now notes that descriptions longer than 250 characters are truncated in the skill listing to reduce context usage, and recommends front-loading the key use case. [line 175] [Source]
Troubleshooting section renamed from "Claude doesn't see all my skills" to "Skill descriptions are cut short" with updated guidance: all skill names are always included, descriptions are shortened to fit the 1%/8,000 char budget, and each entry is capped at 250 chars. [lines 649-653] [Source]

No significant changes.