Claude docs changes for January 28th, 2026 [diff]

Executive Summary

  • New versions 2.1.21-2.1.22: Automatic Python virtual environment activation in VS Code and improved tool preference for file operations
  • Permission wildcard syntax updated from :* to * (space before asterisk) across all documentation
  • New enterprise Skills governance guide published and desktop app documentation completely rewritten

New Claude Code versions

2.1.21

New features

  • Added support for full-width (zenkaku) number input from Japanese IME in option selection prompts
  • [VSCode] Added automatic Python virtual environment activation, ensuring python and pip commands use the correct interpreter (configurable via claudeCode.usePythonEnvironment setting)

Existing feature improvements

  • Improved read/search progress indicators to show "Reading…" while in progress and "Read" when complete
  • Improved Claude to prefer file operation tools (Read, Edit, Write) over bash equivalents (cat, sed, awk)

Major bug fixes

  • Fixed shell completion cache files being truncated on exit
  • Fixed API errors when resuming sessions that were interrupted during tool execution
  • Fixed auto-compact triggering too early on models with large output token limits
  • Fixed task IDs potentially being reused after deletion
  • Fixed file search not working in VS Code extension on Windows
  • [VSCode] Fixed message action buttons having incorrect background colors

2.1.22

Major bug fixes

  • Fixed structured outputs for non-interactive (-p) mode

Claude Code changes

New Documents

Skills for enterprise [Source]

New comprehensive enterprise guide for Agent Skills governance and management. Covers security review and vetting with risk tier assessment (code execution, instruction manipulation, MCP server references, network access, credentials, file system access). Includes detailed review checklist for evaluating third-party Skills. Provides guidance on evaluation frameworks (triggering accuracy, isolation, coexistence, instruction following, output quality), lifecycle management (plan, create, test, deploy, monitor, iterate/deprecate), organizing Skills at scale (recall limits, consolidation strategies, role-based bundles), and distribution via Git and Skills API with versioning strategies. [lines 1-188]

Changed documents

Best practices [Source]

  • Updated Bash permission examples to use new * wildcard syntax instead of deprecated :* syntax. [line 113] [Source]

CLI reference [Source]

  • Updated --allowedTools and --disallowedTools flag examples to use new * wildcard syntax. [lines 61-62] [Source]

Claude Code on the web [Source]

  • Added three new allowed domains for Limited network access mode: plugins.gradle.org, kotlin.org, and www.kotlin.org. [lines 455-457] [Source]

Common workflows [Source]

  • Added documentation for /commit-push-pr skill that commits, pushes, and opens a PR in one step. [lines 471-479] [Source]
  • Added note about automatic Slack posting when PR URLs are created and Slack MCP server is configured with channels in CLAUDE.md. [lines 481-481] [Source]

Desktop [Source]

  • Complete major rewrite and restructuring of the desktop app documentation. Added new "Getting Started" section with step-by-step installation and setup guide. [lines 7-46] [Source]
  • Added three-tab explanation (Chat, Cowork, Code) clarifying which tab this documentation covers. [lines 14-20] [Source]
  • Added comprehensive "Getting started" tutorial with folder selection, session starting, and change review workflow. [lines 48-82] [Source]
  • Added detailed section on permission modes (Ask, Code, Plan) with explanations and use cases. [lines 107-137] [Source]
  • Added section on session management including parallel sessions and automatic session recovery. [lines 139-159] [Source]
  • Added comprehensive remote sessions section explaining cloud-based sessions for long-running tasks. [lines 161-186] [Source]
  • Added "Extending Claude Code" section covering MCP connectors, skills, and hooks. [lines 188-231] [Source]
  • Added detailed environment configuration section with CLAUDE.md and .claudeignore usage. [lines 233-279] [Source]
  • Added Desktop vs CLI comparison table highlighting key differences and shared capabilities. [lines 281-305] [Source]
  • Added comprehensive troubleshooting section covering common issues and solutions. [lines 307-356] [Source]

Headless [Source]

  • Updated Bash permission examples to use new * wildcard syntax instead of :*. [lines 95-96] [Source]
  • Added clarification that the space before * is significant for word boundary matching. [line 98] [Source]

IAM [Source]

  • Updated Bash permission wildcard syntax documentation, changing from :* to * (space before asterisk) for prefix matching with word boundaries. [lines 199-210] [Source]
  • Added clarification that :* syntax is deprecated but still equivalent to *. [line 210] [Source]
  • Updated all examples throughout the document to use new * syntax. [lines 197-218] [Source]

Interactive mode [Source]

  • Added new /copy command to copy the last assistant response to clipboard. [line 97] [Source]
  • Added clarification that in vim normal mode, arrow keys navigate command history when cursor is at input boundaries and cannot move further. [line 144] [Source]
  • Added new "PR review status" section documenting color-coded PR link indicators in footer (green=approved, yellow=pending, red=changes requested, gray=draft) with Cmd/Ctrl+click to open in browser. [lines 266-277] [Source]

MCP [Source]

  • Fixed MCP server name from "VibeProspecting" to "Vibe Prospecting" with updated command name to vibe-prospecting. [line 223] [Source]

Memory [Source]

  • Added new section on loading memory files from additional directories using CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD environment variable with --add-dir flag. [lines 64-75] [Source]

Sandboxing [Source]

  • Added note that /sandbox menu displays installation instructions when sandbox dependencies are missing. [line 82] [Source]

Settings [Source]

  • Added note that Claude Code automatically creates timestamped backups of configuration files and retains the five most recent backups. [line 93] [Source]
  • Updated all Bash permission examples throughout the document to use new * wildcard syntax instead of :*. [lines 106, 110, 172-174]
  • Replaced two-wildcard syntax table with simplified single glob pattern documentation, emphasizing that space before * matters for word boundary matching. [lines 217-238] [Source]
  • Added note that legacy :* suffix syntax is deprecated but equivalent to *. [line 240] [Source]
  • Added CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD to environment variables table. [line 331] [Source]
  • Updated TaskUpdate tool description to note it can delete tasks from the list. [line 438] [Source]

Skills [Source]

  • Updated all Bash permission examples in skill configurations to use new * wildcard syntax. [lines 94, 147, 173]

Sub-agents [Source]

  • Clarified that background subagents prompt for all required permissions upfront before launching. [line 100] [Source]

API changes

Changed documents

Remote MCP servers [Source]

  • Fixed MCP server name from "VibeProspecting" to "Vibe Prospecting". [line 62] [Source]
  • Updated LSEG server URL from /mcp to /mcp/server-cl. [line 56] [Source]