Tools / Claude Code / v2.1.323

Claude Code v2.1.323 release notes & breaking changes

breakingsecuritydeprecatedmodelpricing

Claude Code v2.1.323 is a Anthropic release published 2026-11-12 with 294 listed changes, flagged for breaking changes, deprecations, security fixes. Summary and full notes below, extracted from the official notes.

Get breaking changes for Claude Code in your inbox every Monday

One free email: every breaking change, retirement and price change across 23 coding agents. No spam, unsubscribe anytime.

Subscribe free

← All Claude Code releases and breaking changes

Summary

Full notes

## What's changed

- Added Code Mode, an experimental opt-in in which Claude writes JavaScript to call its tools; see https://code.claude.com/docs/en/code-mode to turn it on, or to turn it off for an organization
- Added `engines["claude-code"]` to `plugin.json`: plugins outside their stated Claude Code version range are not installed, updated or loaded, and install and update pick the newest version that fits
- Added type checking of a plugin's TypeScript hooks module to `claude plugin validate`; each finding is a warning, and `--strict` fails on it
- Added to `claude plugin validate` the `$` nouns a mod's `engine.create` hook adds, withholds or replaces
- Added support for `CLAUDE_CODE_AUTO_MODE_MODEL` in managed settings for Claude Desktop sessions on third-party providers (takes effect once Claude Desktop includes this version)
- Added an options menu (stop, switch to usage credits, upgrade) when a model needs usage credits that are turned off or used up
- Added a progress heartbeat every 30 seconds while hooks run long in `claude -p` and SDK sessions, so a host such as Claude Desktop won't end the turn as hung (once it includes this version)
- Added `.docx` support to Artifact tool asset uploads
- Added a `/diff to close` hint to the diff panel, and the keys that focus and close a panel to the `?` shortcut guide
- Added a start-up warning for Bash allow rules with a `*` in a variable's value, such as `Bash(PORT=* npm run dev)`
- Added a warning when a plugin's language server can't start, naming the server and what to check
- Added a one-time startup notice naming `CLAUDE_CODE_PERFORCE_MODE` when Perforce settings are found and the mode is off
- Added `CLAUDE_CODE_DISABLE_AGENT_PROGRESS_SUMMARIES` (available since 2.1.318): set it to `1` to turn off subagent progress summaries and the requests that write them (anthropics/claude-code#86879)
- Added `CLAUDE_CODE_RESUME_HINT_COMMAND`, which a program that starts Claude Code can set to have the exit hint name its own resume command
- Added `unsetOptionCount` to the `claude plugin install --json` result: how many `userConfig` options are not yet set
- Added `isPromptCovered` to the props a mod's pane is drawn with, telling it when a dialog or a field above the prompt covers the prompt
- Fixed running `/compact` again, or after a command such as `/context`, summarizing away a message that Claude had not answered yet
- Fixed a resumed session joining your next message to an old interrupted message that was not resumed
- Fixed a memory spike at the next prompt after Claude changed a very large file
- Fixed a setting saved in a running session undoing a hand edit made to `settings.json` moments earlier; a settings file you delete during a session now stays deleted
- Fixed `claude plugin` commands and `claude mcp list` signing you out of a Console profile when they ended while the token was being renewed
- Fixed Edit and Bash running out of memory on certain `/proc` files, and Edit hanging or running out of memory on devices and named pipes
- Fixed Claude Code failing to start, or to clear stored credentials at sign-out, when saving its configuration file failed with "Out of memory"
- Fixed requests sent without streaming failing on errors that streamed requests recover from, such as a rejected image, thinking block or beta header
- Fixed `ExitWorktree`, the worktree exit dialog and `/resume` leaving the session in the wrong folder when the folder the shell was in before entering the worktree had been deleted
- Fixed accents and other combining marks sometimes landing left of the text, leaving stale copies on screen, or silently disappearing when text wraps
- Fixed the last key of a key chord, such as Enter in ctrl+x enter, acting on a dialog's text field when the chord's own action isn't available there
- Fixed `ps` processes piling up when the process listing Claude Code runs before stopping a command takes too long
- Fixed subagent transcripts and large tool results being saved apart from the session's transcript after entering a worktree created by a `WorktreeCreate` hook or belonging to a nested repository
- Fixed a session on a named Anthropic profile moving to another sign-in when `/fork`, the Left arrow or `--bg` continued it in the background; reopen any session that was open during the update
- Fixed a background session sending a conversation under another sign-in when its named Anthropic profile is missing, changed or overridden; it now stops and says so
- Fixed a session on an API key, auth token or workload identity from its shell (not a setup token) moving to another sign-in in the background; it now stops and says so
- Fixed MCP tool calls ending in the sign-in server's error, such as `TOKEN_EXPIRED`, instead of asking you to sign in again
- Fixed an expired claude.ai login showing "Credit balance too low" when a saved Console key or `ant auth login` profile without credit was used instead
- Fixed a session on a named Anthropic profile being handed to an older background service that could not keep its sign-in; it now says to restart the service
- Fixed a background session's sign-in leaving the previous account's login or other credentials in place; it now clears them for every session on the computer, and a refused sign-in can leave no login
- Fixed background sessions moving between a profile and the stored login when an update restarted them
- Fixed sessions opened before a sign-in keeping signed-out feature flags after the sign-in
- Fixed sessions that kept failing after a Claude apps gateway sign-in expired: once you sign in again with `/login` in another terminal, they carry on at the next message
- Fixed the billing notice naming your `ant auth login` organization when a custom `X-Api-Key` header is set
- macOS: Fixed "Not logged in · Please run /login" coming back right after a successful `/login` or a token refresh when the keychain was slow to answer
- Fixed turns failing in Claude Desktop when an organization's gateway answers an expired token with 403: Claude Code now asks Desktop for a fresh token and retries
- Fixed the error shown when Amazon Bedrock refuses your account a model: it no longer says to refresh your AWS credentials, it says to enable the model
- Fixed the `awsAuthRefresh` or `gcpAuthRefresh` command sometimes running twice for one request when three or more sessions needed a fresh sign-in at once
- Fixed the `claude -p` warning about an ended claude.ai login to say that `claude auth logout` also removes saved MCP server logins and plugin secrets
- Fixed Bash permission prompts offering "don't ask again" for commands that write to sensitive paths such as `.git` or `.claude`, where the saved rule did not stop the next prompt
- Fixed a case where some `lsof` commands ran without a permission prompt
- Fixed Bash commands that write a file with `cat > file <<EOF` being shown as "Read 1 file"
- Fixed a case where Bash permission checks judged an `rm` from the wrong folder and skipped the dangerous-removal prompt under bypass permissions or a Bash allow rule
- Fixed `--permission-mode auto` or a settings `defaultMode: auto` starting in a mode that could allow more when auto mode was unavailable. It now starts in Manual mode, which asks first
- Fixed plan files sometimes being written outside the project when `plansDirectory` is set; a write that can't be shown to stay inside the project is now refused
- Fixed a permission prompt when Claude read the output of its own background command or agent after entering a worktree
- Fixed a case where Bash permission checks missed part of a command
- Fixed a case where the Bash sandbox could switch off during a session
- Fixed Bash allow rules with an attached wildcard, such as `Bash(ls*)`, skipping the permission prompt in some cases; a rule that names a variable, such as `Bash(NODE_ENV*)`, now asks
- Fixed auto mode running behind a gateway at `ANTHROPIC_BASE_URL` on a model whose gateway name contains "haiku"; such a model, other than `claude-haiku-5-5`, is now refused, as Haiku 4.5 is
- Fixed Bash deny and ask rules missing some commands run through `sudo`, `env` and similar wrappers
- Fixed Bash allow rules written with combined `sudo` flags skipping the permission prompt in some cases
- Fixed `sandbox.excludedCommands` letting a command that it does not name run outside the sandbox in some cases
- Fixed a case where the Write and Edit tools could write to a path covered by a `Read` deny rule
- Fixed a case where a Bash command ran without a permission prompt for zsh users with certain non-default shell options set
- Fixed the Bash sandbox not fully protecting Claude Code's own config on installs still using the legacy config file
- Fixed a permission prompt from a mod's `tool.check` hook naming every plugin hooked on the tool instead of the one that asked
- Fixed sandboxed commands being able to read Claude Code's file checkpoint copies under the config directory
- Fixed a rewind sometimes changing your permission mode
- Fixed project settings sometimes being read through a symbolic link that leads to a different folder than the one Claude Code checked
- Fixed HTTP hooks failing with HTTP 500 on Linux when `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` is set and `sandbox.enabled` is off
- Fixed `claude -p` and the Agent SDK running Bash unsandboxed when `--settings` or SDK settings that turn the sandbox on fail validation; Claude Code now stops at start-up and names the invalid setting
- Fixed `/export` silently stopping early after a long run of calls to an MCP tool that is no longer loaded
- Fixed earlier MCP tool calls missing from a resumed conversation, and lines repeating in scrollback, when the server connects late
- Fixed `claude mcp add --help` splitting long example commands across lines in narrow terminals and pipes, so a pasted example ran without its header
- Fixed plugins with `defaultEnabled: false` staying off in a claude.ai chat's cloud session after you turn them on in claude.ai
- Fixed `/fast on` and `/fast off` on Vertex not asking a plugin's `config.set` hook, as the `/fast` menu does
- Fixed documents created through the Claude Docs connector not opening in your browser when you work in a terminal
- Fixed the misleading "not cached" error for a plugin only a repository's settings enable: it now says it isn't installed, gives the install command, and shows in text and stream-json `-p` runs
- Fixed mods being able to reword Claude Code's own confirmation questions
- Fixed a mod's hot reload sometimes ignoring a file created just after a failed reload
- Fixed marketplaces named `npm`, `pip`, `uv`, `cargo`, `github` or `gh` being refused as reserved names
- Fixed a stopped MCP call, or a stopped shell command in fullscreen, reading as "Called" or "Ran" in a collapsed tool group: it now says no result was recorded and shows its input
- Fixed load errors of plugins enabled by managed settings going only to the debug log in SDK and Desktop sessions: `init.plugin_errors` now lists them
- Fixed plugin installs hiding what a plugin's install command wrote to stderr when that command succeeded, such as a note that the plugin has no skills yet
- Fixed one malformed entry in a plugin marketplace's `renames` map making Claude Code ignore the marketplace's other renames
- Fixed `claude --bg --safe-mode` sessions stopping at startup to ask about project MCP servers that safe mode never starts
- Fixed MCP link prompts offering Accept for non-http links without saying the link wouldn't open
- Fixed `/mcp` and `/plugins` opening an MCP server's page with the cursor on "Disable" when the server needs authentication but still holds its sign-in; the page now offers "Reconnect" and opens on it
- Fixed plugins with a version list in `enabledPlugins` staying off with no message: `/plugin` and `claude plugin list` now say why
- Fixed plugins and marketplaces failing to install on Windows when the path of a cloned file reaches 260 characters
- Fixed a Stop pressed right after sending a message showing as an error in remote and SDK sessions while a `UserPromptSubmit` or plugin prompt hook was still running
- Fixed an MCP server staying disconnected with no tools after an Agent SDK app or `claude -p` caller removed and re-added it, when a tool call had tried to reach it in between
- Fixed text-output `claude -p` runs printing nothing to stderr when a `--plugin-dir` mod's hook hangs or crashes the hooks worker
- Fixed SDK sessions giving an MCP server named by `--allowedTools` or an `mcp_tool` hook less than 2s before the first turn when settings lowered `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` after start-up
- Fixed headless sessions ending when an SDK host sent a null entry in an MCP server's tools list
- Fixed WebFetch dropping empty table cells and shifting later values a column left
- Fixed temporary files of a session that had changed directory being left behind when the session expired under `cleanupPeriodDays`
- Fixed managed settings (`managed-settings.json`, `managed-settings.d`) sometimes being missed at start-up while another program was rewriting the file: start-up now reads such a file a second time
- Fixed `.claude/settings.local.json` not being ignored globally when the folder became a git repository later, or on a new machine
- Fixed `/diff` waiting for Claude to finish before closing the diff panel in fullscreen
- Fixed `/memory` showing wrong or roundabout paths for folders whose names start with the working directory's or home folder's name, and losing slashes in the file path on Windows
- Fixed a broken emoji character in a tool call's parameter name being resent with later requests, which strict JSON parsers reject
- Fixed a collapsed tool call looking as if it ran after you rejected it with a reason: it now shows "Not run · rejected"
- Fixed a case where part of a saved session could be lost on NFS or FUSE file systems when Claude Code discarded a reply
- Fixed WebFetch not rechecking organization policy and `CLAUDE_CODE_DISABLE_WEB_FETCH` at each call
- Fixed file titles, app names and session names in @-mentions from claude.ai and the desktop app sometimes being treated as text you typed
- Fixed a multi-row status line being pushed off screen by a long prompt in the fullscreen renderer
- Fixed a case where certificate errors behind a TLS-inspecting proxy persisted when the proxy itself is reached over `https://`
- Fixed Pro and Max accounts being offered feedback drafts that their organization would refuse
- Fixed Claude in Chrome's policy message telling people to contact their admin when no admin setting can turn it on
- Fixed the artifact preview sometimes opening a different artifact than the one Claude just published
- Fixed certificate name-constraint errors being retried for minutes; they now fail at once with a message that says what to fix
- Fixed `claude --teleport` opening an empty session when the server could not find the session's history, and `claude -p --teleport` exiting without an error when the resume failed
- Fixed a misspelled keybinding modifier, such as `ctl+k`, binding the bare key; the binding is now ignored
- Fixed `/btw` answers and recaps sometimes including earlier replies from the conversation
- Fixed start-up requests switching from an organization's managed proxy and CA settings to user-set ones when a read of the managed settings file failed
- Fixed Claude giving a wrong reason when a new message interrupted a file it was sending you
- Fixed `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` re-running a turn that a hook's `continue: false` had stopped
- Fixed Claude being told that automatic model switching is off when safeguards stopped a subagent whose model had no other model to switch to
- Fixed the changed-files list of remote sessions leaving out files added with `git add -N` before the first commit
- Fixed some Claude in Chrome tool calls, such as `browser_batch`, not showing the tool's name in the fullscreen transcript (ctrl+o) or in a subagent's progress
- Fixed subagent progress summaries skipping an update when the reply took between 10 and 20 seconds
- Fixed `claude doctor` and `/status` saying a linked managed settings file is still read when it could not be read
- Fixed an interactive `--chrome` session giving no reason for starting without Claude in Chrome when your organization's policy turns it off: a line now says so
- Fixed the `/rewind` list on network paths and hung folders: it named every tracked file as changed, was slow to show labels, and showed none at all when a file read never returned
- Fixed `--debug` and `--debug-file` replacing a file named `latest` in the debug log's folder
- Fixed a timed-out feedback send being reported as too large; it now says the request timed out
- Fixed screen reader mode cutting off an announcement when the system clock moved forward while it was being read
- Fixed screen reader mode dropping dictated or pasted text, and emoji, typed into an answer to a question or permission prompt
- Fixed the name label under permission and plan dialogs hiding part of some agent names
- Fixed a case where pressing Ctrl+C just as `claude update` finished removed the `claude` command
- Fixed the fullscreen header naming the session's effort level for a viewed subagent on a different model, which that subagent doesn't use
- Fixed the model picker and `/model` showing a picked effort level that `CLAUDE_CODE_EFFORT_LEVEL` overrides
- Fixed the tip after a slow worktree creation suggesting a `sparsePaths` list without `.claude`, which left worktrees without your project settings and rules
- Fixed the newest model's highlight missing from the `/model` picker
- Fixed `/upgrade` and Ctrl+clicked links in fullscreen failing silently when no browser can open: the address is now shown
- Fixed the Claude apps gateway's JSON logs escaping newlines and other control characters in a message twice
- Fixed terminal control sequences in a subagent's message taking effect instead of showing as plain text when the message is expanded
- Fixed Claude in Chrome setup saying `/chrome` finishes the connection; it now tells you to restart with `claude --chrome`
- Fixed the Option-key hint appearing while typing ø or π inside words on Danish, Norwegian, Faroese and Greek keyboard layouts
- Fixed a Claude Desktop session getting stuck as busy after another of your sessions sent it the same message twice or many messages at once
- Fixed long tool results staying on disk after a session run with `--no-session-persistence`; they are now removed on normal exit, Ctrl+C or SIGTERM
- Fixed `PreCompact`, `PostCompact` and post-compaction `SessionStart` hooks not receiving `agent_id` and `agent_type` when a subagent compacts
- Fixed `CLAUDE_CODE_TRANSCRIPT_LOCAL_GC` dropping messages from the saved transcript when another process rewrote the file while it was being trimmed
- Fixed the "Now using usage credits" notice repeating or not showing past the weekly Fable limit when Claude Code made a quick side request on a smaller model, such as naming the session
- Fixed Fable's weekly limit showing no reset time and no options menu in the terminal
- Fixed a wait chosen in the usage limit menu silently moving to a later reset when its request was refused; the menu now opens
- Fixed the spend limit menu offering a lower limit when your current limit couldn't be loaded
- Fixed `/usage` hiding limit bars for setup tokens and `CLAUDE_CODE_OAUTH_TOKEN`: it keeps the session and weekly bars and says why the rest are missing
- Fixed `/usage` showing a whole-session percentage beside a subagent type's name, and saying sessions ran 8 hours when it only counts hours with requests
- Remote Control: Fixed sessions showing as disconnected for a minute or more after a network change such as switching Wi-Fi or reconnecting a VPN
- Fixed Remote Control showing nothing while Claude Code asks whether to use usage credits: the question now also shows in the Claude app
- Fixed Remote C
← Older: v2.1.322 (2026-11-10)Newer: v2.1.325 (2026-11-13)
Weekly digest: every breaking change, retirement and price change across 23 coding agents, one email.

Form not loading? Subscribe here.