Claude Code v2.1.311 · 26 Oct 2026
/doctor now flags permission rules that may not work as written
/doctor and the warnings list gain a section headed "Permission rules that may not work as written"
Use it now Tier: how much it should matter to you
4 Useful: my rating, 1 to 5
1 Signal: worth watching, 1 to 5
Permissions Area: what it touches
New Features Kind: in v2.1.311, 26 Oct 26
What probably matters to you Section of the release
What
Permission rules are settings that let Claude do some things without asking, or stop it from doing them. /doctor , the command that checks your Claude Code set-up, and the list of warnings now include a section headed "Permission rules that may not work as written".
Why
A rule that silently does nothing can leave you thinking something is allowed or blocked when it is not. This section brings those rules to your attention.
See this entry in the whole of v2.1.311 →
26 Oct 2026 · 425 entries, this one is #46.
Use it now29 You'll notice242 Nothing to try yet10 Under the hood144
Open the release →
Names in this entry
slash /doctor Skill . Run a setup checkup that diagnoses issues and can fix them. Checks installation health, including duplicate or leftover installs, PATH problems, and unparseable settings files. Finds unused skills, MCP servers, and plugins versus their context cost, flags slow hooks , and checks for a newer version on your release channel . Deduplicates local CLAUDE.md files against checked-in ones, trims checked-in CLAUDE.md files by cutting content Claude could derive from the codebase, and migrates the always-loaded guidance that remains into skills and nested CLAUDE.md files that load on demand. Also offers to make auto mode your default and to pre-approve frequently denied read-only commands. Reports findings first and asks for confirmation before changing anything. From the terminal, claude doctor prints read-only installation diagnostics without starting a session. Alias: /checkup. Run /doctor prompt-audit to have Claude audit your CLAUDE.md files, skills, and other configuration for outdated or conflicting instructions instead of running the checkup. The prompt-audit subcommand requires Claude Code v2.1.283 or later. The CLAUDE.md trim check requires Claude Code v2.1.206 or later. Before v2.1.205, /doctor opened a read-only diagnostics screen and pressing f sent the report to Claude
Is this right?
0
0
Feedback
What's wrong with this entry?
Hard to understand Too vague Looks wrong Not relevant to me Too long Missing the detail I wanted Duplicate of another card
Clear Learned something new I can act on this Good catch
Related
Other releases about the same thing. Found by shared names or similar wording; neither means one caused the other.
← Previous · 45 of 425
Shell detection reworked, CLAUDE_CODE_SHELL validated, login shell reported
Use it now Shell
In v2.1.311 What probably matters to you release-page order
Next → · 47 of 425
/ide can install the Claude Code extension and show its progress
Use it now IDE Integration