# Claude Code v2.1.317

> Claude Code v2.1.317, released 2 Nov 2026 (2026-11-02). 440 entries read out of the shipped bundle. Unofficial, and not affiliated with Anthropic.

[Web version](https://changelogs.core-directive.com/v/2.1.317)

You can now turn off MCP task support by setting CLAUDE_CODE_DISABLE_MCP_TASKS. This release has 440 entries, and 284 of them are usable today. Accounts offered Life Sciences use cases get a new /use-case command to pick one. That choice is saved for later sessions. A new app:closeSession shortcut action lets you bind a key to close a session shown under session tabs. Programs that launch Claude Code can pass working directories exactly as given with the new permissions.workingDirectoriesAsGiven setting.

There are 12 entries in the build that are not switched on yet. A Wrap up tool would let Claude end a turn with a short recap and up to two next-step buttons. Claude Code now tracks messages for taking back a sent message with Esc, but the take-back does nothing yet. Hooks of type agent and mcp_tool can be read, but a remote allow list keeps them off and is empty by default. A spot is reserved for a live preview sharing dialog, with no way to open it yet.

Updates on macOS no longer delete the app bundle a running session is using. Saving settings no longer overwrites a config file that appeared while Claude Code was creating its own. Cancelling the theme picker no longer quits Claude Code. SDK hooks set to block on failure now stop the action as intended. Reading an unchanged file again no longer returns a short "file unchanged" note. The CLAUDE_CODE_LAZY_ENV_GETTERS environment variable is no longer recognised.

## Sections

Each section is its own markdown document of whole entries, in pages of about 40 KB. The whole release in one document is [full.md](https://changelogs.core-directive.com/v/2.1.317/full.md).

- [What probably matters to you](https://changelogs.core-directive.com/v/2.1.317/what-probably-matters-to-you.md): 51 entries, 2 pages
- [Improvements](https://changelogs.core-directive.com/v/2.1.317/improvements.md): 201 entries, 6 pages
- [Bug Fixes](https://changelogs.core-directive.com/v/2.1.317/bug-fixes.md): 42 entries
- [In Development](https://changelogs.core-directive.com/v/2.1.317/in-development.md): 5 entries
- [Internal Changes](https://changelogs.core-directive.com/v/2.1.317/internal-changes.md): 137 entries, 4 pages
- [Removed](https://changelogs.core-directive.com/v/2.1.317/removed.md): 4 entries

## What probably matters to you

The first 10 of 51, one line each. The section's own pages have every one in full.

- [New environment variables for subagent handback and host mid-turn prompts](https://changelogs.core-directive.com/v/2.1.317/e/new-env-gated-switch-claude-code-deep-twilight-controls-host.json): Adds CLAUDE_CODE_DISABLE_SUBAGENT_HANDBACK and CLAUDE_CODE_DEEP_TWILIGHT, and lists PARSED_WILLOW and DAPPER_CUPCAKE in more allowlists
- [New agent and mcp_tool hook types, enabled through a remote list](https://changelogs.core-directive.com/v/2.1.317/e/hook-config-loader-gains-agent-and-mcp-tool-hook-kinds-behin.json): Hooks gain `agent` and `mcp_tool` types, accepted only when the remote `tengu_woven_ladder` list names them
- [Plugins can draw a translucent backdrop behind Claude Code](https://changelogs.core-directive.com/v/2.1.317/e/plugin-backdrop-api-new-uibackdrop-function-hook.json): A new ui.backdrop function lets plugins draw a blurred, tinted backdrop, and connecting clients can say they draw a Backdrop
- [Gmail connector can attach local files, with compliance-policy controls for connector file sending](https://changelogs.core-directive.com/v/2.1.317/e/gmail-file-attachments-by-reference-for-mcp-connector.json): Claude can attach local files to Gmail drafts and messages with your approval, and HIPAA or ZDR policies can block connector file sending
- [A keyboard shortcut action for closing a session under session tabs](https://changelogs.core-directive.com/v/2.1.317/e/session-tab-close-keybinding-and-sessiontabs-context-added.json): Claude Code now has an app:closeSession shortcut action and a SessionTabs keybinding context for closing a session shown under session tabs
- [A Wrap up box can end a turn with a recap and next-step buttons](https://changelogs.core-directive.com/v/2.1.317/e/new-wrap-up-tool-lets-the-model-offer-next-step-buttons-at.json): A new Wrap up tool lets Claude end a turn with a short recap and up to two buttons offering what to do next
- [New wrap-up behaviour, on by default for remote sessions with prompt suggestions](https://changelogs.core-directive.com/v/2.1.317/e/wrap-up-behaviour-gated-by-claude-code-enable-wrap-up-defau.json): A new wrap-up feature is controlled by CLAUDE_CODE_ENABLE_WRAP_UP and defaults on for remote sessions with prompt suggestions on
- [New environment variables for remote sessions, including a stall-check interval](https://changelogs.core-directive.com/v/2.1.317/e/ccr-slow-skills-watch-gated-by-claude-code-ccr-slow-skills-w.json): Remote sessions gain new `CLAUDE_CODE_*` settings, such as a stall-check interval and a slow-skills watch, and `CLAUDE_CODE_LAZY_ENV_GETTERS` is dropped
- [Groundwork for taking back a sent message with Esc, not yet active](https://changelogs.core-directive.com/v/2.1.317/e/esc-take-back-rewind-class-is-wired-in-but-its-methods-are-e.json): A new Esc take-back feature for rewinding sent messages is wired in, but its rewind steps are still empty, so nothing happens yet
- [New `/use-case` command to choose a Life Sciences use case](https://changelogs.core-directive.com/v/2.1.317/e/new-use-case-command-for-life-sciences-use-cases.json): Accounts offered Life Sciences use cases get a `/use-case` command and a startup dialog to pick one, saved for later sessions