Claude Code v2.1.327 is a Anthropic release published 2026-11-17 with 173 listed changes, flagged for breaking changes, security fixes. Summary and full notes below, extracted from the official notes.
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
## What's changed
- Added a confirmation before `/install-github-app` changes a repository
- Added `claude mcp add-json <name> -` to read the server's JSON from stdin, so tokens can stay off the command line; not available inside a Claude Code session
- Added a line when a resumed session's earlier messages can't be loaded
- Added a list in `/status` of broken agent, skill, command and output style files, keybinding errors, an unavailable sandbox, ignored permission settings and hook matchers that never match
- Added a note in `/config` when other settings override a row
- Added `x-claude-code-managed-settings-checksum` to the gateway hint headers; sent where managed settings set `CLAUDE_CODE_GATEWAY_HINT_HEADERS=1`, including where they already do
- Added support for naming a session's billing group with the `attributionProject` setting, for Claude apps gateways that set `admin.billing_group_tag`
- Added `/tui classic` as the name for the non-fullscreen renderer; `/tui default` still works
- Remote Control: Fixed stopping the server in worktree mode deleting a running session's git-ignored files, such as `.env`
- Fixed self-hosted runners with `--use-anthropic-git-proxy` deleting a non-empty directory named by `GIT_CONFIG_GLOBAL` at startup: the runner now keeps it, ignores the variable and warns
- Fixed `claude mcp add` and `claude mcp remove` with project scope deleting other top-level keys from `.mcp.json`, such as `$schema` or another tool's `servers`
- Fixed `/export` overwriting an existing file without asking: the dialog now asks, and `/export <name>` keeps the file and says to run `/export`
- Fixed a command you had allowed still running after you pressed Stop, when the approval arrived after a restart, in cloud and self-hosted runner sessions with no feature flags loaded
- Fixed Enter closing `/teleport`'s load error screen
- Fixed a click followed by Enter in `/plugin` installing or disabling a plugin
- Fixed a half-typed `!` command running on an extra Enter after the usage limit menu
- Fixed some `--disallowedTools` rules with parentheses in their content
- Fixed auto mode ignoring some wildcard PowerShell allow rules that name a script with `.\`, such as `PowerShell(.\scripts\build.ps1 *)`
- Fixed a running Code Mode script in auto mode getting permission prompts and denials once Claude started a second script that auto mode also allowed
- Changed some pre-started background sessions to be discarded after an account change
- Changed a workflow paused at a usage limit in the terminal to stay paused after a login, until the earlier login returns or you type a prompt
- Fixed a nested `claude` with its own token being refused by `forceLoginOrgUUID`: commands that don't get the session's token no longer get its `CLAUDE_CODE_OAUTH_SCOPES`; set it on any that need it
- Fixed headless sessions losing stored messages on resume when a message was sent again with the same UUID after the process was killed
- Fixed cases where a session resumed after an empty reply or a killed command lost an answer, or brought back a rewound prompt, after another crash or a move to the background
- Fixed a remote session forgetting messages sent after Stop was pressed during a restart, if Claude Code then crashed
- Fixed tasks created after `/clear` being lost, and cleared tasks coming back, when a cloud or self-hosted runner session with no feature flags loaded resumed later
- Fixed a compaction right after a reply cut at the output token limit losing that reply's tool call and its result
- Fixed a settings change from `/config` and similar commands failing to save with no warning; a line under the prompt now says so
- Fixed `/rewind` closing without a word when some files could not be restored
- Fixed pasted images being dropped when the prompt starts with a file path such as `/tmp/a.txt`
- Fixed agents passed with `--agents` being lost once plugins loaded or reloaded
- Fixed a plugin's agent being dropped when resuming a session from the `--resume` picker
- Fixed Claude Code refusing to start when `https_proxy` or `HTTPS_PROXY` is a bare `host:port` and neither its input nor its output is a terminal (the desktop app, an SDK, cron)
- Fixed Claude Code on Linux sometimes returning to the shell while restarting itself at startup, such as after the first sign-in to a Claude apps gateway or when turning on Code Mode
- Fixed `claude -p` hanging before its first request when the fetch of a model's settings stalled, such as at a proxy; it now goes on without them after 10 seconds
- Fixed the screen staying blank or frozen after a brief out-of-memory error
- Fixed a rare display fault that could freeze the screen or end the session
- Fixed cloud sessions breaking when a program left thousands of connections open to the session's network proxy
- Fixed a turn hanging when a mod's `$.model.complete` or `$.model.classify` call met a usage limit: the call now gets the API's error at once; mods should handle that error
- Fixed stalls on a compaction reply with thousands of unclosed tags and on some very long WebFetch URLs; WebFetch now refuses a URL over 2,000 characters before any permission prompt
- Fixed a message with thousands of `@` mentions stalling before Claude replies; only the first 100 mentions are now looked up as files
- Fixed the prompt freezing after rejecting a write to a very large file; a rejected write now shows a short preview
- Fixed a crash when a burst of keys reached the search box in `/plugin`
- Fixed a false crash report and exit code when a suspended session resumes, or at exit, where a Linux security policy blocks a process from signalling itself
- Fixed remote MCP servers staying disconnected after a longer outage such as a VPN drop: most servers on other machines reached by hostname over https are now retried in the background for about a day
- Fixed Edit refusing with "File has not been read yet" after a compaction on unchanged files outside the project that Claude had already read in full
- Fixed Grep repeating or skipping results when paging with `head_limit` and `offset`; content and count results are now sorted by file path
- Fixed Read failing on Jupyter notebooks that contain an output of an unknown type
- Fixed NotebookEdit removing the notebook file's final newline
- Fixed the Read tool reporting 512KB instead of the real size when a file of 10 MB or more is too large to read at once
- Fixed the Bash tool's diff of changed files not naming files that are binary, too large or too many to show
- Fixed artifact publishes failing with "the source file changed between approval and publish" when a synced or remote-backed folder had only changed the file's timestamp
- Fixed a new artifact that you approved being refused in a cloud scheduled task's session, in organizations that require approval of each new artifact
- Fixed a new artifact being refused after an app built on the Agent SDK approved it, in organizations that require approval of each new artifact
- Fixed `/artifacts` showing part of your list, or "No artifacts yet", when a request for more of the list failed: it now tries again, then warns if it can't load the whole list
- Fixed in-process agent teammates on a different model from the lead compacting at the lead's context limit and on the wrong model; they now use their own limit and model, at that model's rate
- Fixed a finished subagent resuming on the model and effort of a sibling subagent that messaged it
- Fixed the main conversation not being told a background agent had finished when the subagent that started it ended by itself without reading the result, outside auto mode
- Fixed Claude reporting a background agent as still running when it had waited 30 seconds or more on a permission prompt in the desktop app, on the web and in the SDK
- Fixed Claude not being told in auto mode when a background agent's reply to a follow-up message was dropped, and reduced repeat wake-ups there from agents waiting on background commands
- Fixed the desktop app, Claude Code on the web and VS Code showing a raw task notification as a subagent's prompt after its background task woke it
- Fixed messages sent from another session with "later" priority joining the running turn, instead of waiting for it to end, in Remote Control and Claude Desktop sessions
- Fixed messages to cloud and Remote Control sessions being reported as failed with a stale address after a timeout or rate limit; Claude now says when a message may have arrived
- Fixed cloud sessions giving no error when a `UserPromptSubmit` hook blocks a message sent while Claude works
- Fixed failing hooks showing nothing: SubagentStop in background agents, SessionEnd at `/clear` and `/resume`, and CwdChanged and FileChanged in fullscreen
- Fixed a Stop hook that failed to run being shown as having reported a problem
- Fixed focus view keeping a finished reply hidden while a Stop hook was running
- Fixed Claude getting a long managed PostToolUse hook output twice when a mod added context to the tool call
- Fixed `/model` listing the wrong models in some terminal sessions when a project's `.claude/settings.json` sets `ANTHROPIC_BASE_URL` to an LLM gateway
- Fixed `/statusline` writing to `~/.claude/settings.json` when `CLAUDE_CONFIG_DIR` points to another folder
- Fixed `claudeMdExcludes` patterns on Windows not matching a path whose drive letter is written in the other case
- Fixed `claude agents` and `claude rm` refusing to remove a fully pushed session ("The worktree has unpushed commits") when its worktree has a file or folder named `HEAD` at the top level
- Fixed long ListAgents results hiding most sessions on accounts with many cloud or Remote Control sessions: long lists now come in pages
- Fixed slow turns in resumed sessions for organizations with tens of thousands of connector tool permissions
- Self-hosted runner: Fixed `claude -p` started by a session's script or hook waiting out rate limits, because it inherited the session's own retry setting
- Fixed the spend limit menu reporting a changed limit when the server refused it
- Fixed a second `x` on a task's details in `/tasks` stopping the next task too
- Fixed Esc being ignored on a permission prompt that had just appeared
- Fixed lists that load their rows late sometimes ignoring Enter and the arrow keys
- Fixed `/autofix-pr` holding the keyboard after Esc while it stopped the cloud session; the dialog now closes at once, and a stop that fails is reported afterwards with a link
- Fixed a blank screen and stray mouse codes in the shell after quitting with ctrl+c just after ← opens the agents view
- Fixed Ctrl+C right after the trust question leaving the terminal in fullscreen
- Fixed the shell flashing on screen when ← opens the agents view in fullscreen mode
- Fixed terminal display faults: most scrambled scrollback in Ghostty on resize, link addresses hidden in Windows Terminal under old tmux and in VTE 0.50.0, and no selection highlight with 16 colors
- Fixed some garbled rows in tmux with `allow-passthrough` on inside kitty, Ghostty or iTerm2
- Fixed `/mcp` saying no servers were configured after one was added during a session or declined; it now says what to do
- Fixed `/hooks` leaving out hooks given by `--settings`
- Fixed the `/` menu listing a row for each skill of the same name, though every row ran the first
- Fixed `/teleport` showing no message when the chosen session failed to resume
- Fixed n and N in transcript search skipping matches
- Fixed cancelling a transcript search (ctrl+o, then /) in a long session landing far from where the search started
- Fixed up and down losing the cursor's column over a short or blank line
- Fixed Tab in shell mode filling in a file name after `&&`, `;` or `|`, where a command goes
- Fixed the selected session leaving the screen in `claude --resume` and `/resume` when branch names or folder paths are long
- Fixed the MCP tool list in `/mcp` and `/plugin` losing your place when going back from a tool
- Fixed `/resume` listing one session fewer than the window has room for, and a 'Resend your message' hint after most spend caps, where resending can't help
- Fixed an MCP server's long question being cut off after one row, text fields hiding long pastes with no sign, and a doubled divider line in `/plugin`'s options and `/login`'s Bedrock and Vertex steps
- Fixed the "+N lines" count being too high for command output with links or colors, and the transcript's `?` help hiding how to exit in a short window
- Fixed Ctrl+C twice not closing `/chrome` from its browser list
- Fixed a number and Enter typed too early at an agent's plan approval in screen reader mode causing the next number to be dropped too
- Fixed Claude trying to read design system token files that do not exist when starting a deck or design
- Fixed exit not saying that a worktree was kept
- Fixed `/hooks` help naming input fields that do not exist
- Fixed question dialogs naming ctrl+g after the external editor key was rebound
- Fixed two sign-in error messages that pointed to the Claude subscription option on computers where `forceLoginMethod` is set to `console`
- Fixed `/config` saying the dialog was dismissed instead of "Set theme to …" after changing the theme
- Bug fixes and reliability improvements
- Improved the speed of a session's first Bash command: shell start-up files may now run before it's approved, even if it's refused; set `CLAUDE_CODE_DISABLE_SHELL_HEAD_START=1` to turn this off
- Improved commits on newer models and in PowerShell: Claude is now told not to commit files that likely contain secrets
- Improved sandboxed shell commands: Claude now sees when a command exempt from the sandbox stayed in it because its permission check relied on the sandbox
- Improved the refusal for shell commands with no `rm` that the dangerous `rm` check can't parse, so Claude can resend harmless ones in plain syntax instead of giving up
- Improved resuming very long sessions: a transcript read that ends early is now retried once, so messages are lost less often
- Improved subagent answers that hit the output token limit twice: they now more often come back whole or say up front that they are partial
- Improved long replies on unrecognized models: a reply cut at 32,000 output tokens now continues with a limit of 128,000
- Improved the reminder about a completed subagent after compaction: if Claude can't read the agent's output file, it is now told to ask the agent with `SendMessage`
- Improved the warning shown when an API key and an Anthropic profile are both set: it now says which one is in use and how to switch to the profile
- Improved `/plugin`: the question before removing a marketplace now says that its plugins' settings and saved data are deleted, and a marketplace's page no longer shows another marketplace's error
- Windows: Improved start-up time with no Git Bash and no `pwsh` on PATH by checking PowerShell's standard install locations at once; System32's `powershell.exe` now wins over one earlier on PATH
- Improved startup time on Windows when PATH points to Git for Windows' bin folder, by starting git.exe directly instead of through its launcher
- Windows: Improved PowerShell tool speed by up to about half a second per command
- Improved how soon the Bash tool's diff of changed files is ready in auto and bypass permissions modes
- Improved speed of the Bash permission check on very deeply nested missing paths on macOS and Linux, and of secret masking on very long text with a URL
- Improved transcript search to find text in edits and written files
- Improved speed of reading large PNG images, and the quality of the JPEG sent in their place
- Improved the Artifact tool to read an uploaded file by the address the artifact's page shows; other forms still fail, most with a message that says to read uploads one per call, by id
- Improved the Artifact tool to ignore `prompt`, `limit` and `label` on some calls that do not use them instead of failing the call
- Improved MCP server pages in `/mcp`: local, remote and agent servers share one layout, menus end in Back, and actions are no longer numbered outside screen reader mode; use the arrow keys and Enter
- Improved narrow terminals: `/status`, forms and detail screens lay out better, `/model` and `/effort` fit at about 40 columns, and key hints such as `←/→ to adjust` stay
- Improved `/install-github-app`: the repository, secret and API key steps use the standard list and keys, with shorter messages, a spinner and clearer errors
- Improved `/desktop`: the download question is a standard list instead of y/n
- Changed `ExitWorktree` to ask before removing a worktree that may hold unsaved work; refused in don't-ask mode or with nobody to answer, unless an allow rule, auto or bypass permissions mode allows it
- Changed `claude mcp add --scope project` to stop, instead of overwriting the file, when `.mcp.json` lists its servers at the top level with no `mcpServers` key
- Changed the arrow keys on most permission prompts to stop at No instead of wrapping around; a number past the last answer moves to No
- Changed path checks to refuse some symbolic links
- Changed what counts as inside a working directory, so some paths now ask for permission
- Changed `permissions.blockReadsOutsideWorkingDirectories` to ask about more Bash commands in bypass and auto modes, and to deny some in auto mode
- Changed `permissions.blockReadsOutsideWorkingDirectories` to refuse more Bash commands that name a path under a Read or Edit deny rule, where it used to ask
- Changed auto mode's notice about falling back to billed classifier requests to say that an upcoming release removes the fallback; each action it would have checked will be asked about or denied
- Changed auto mode to ignore more allow rules that run any package, like `Bash(pnpm dlx *)`, and path or version forms of ones it already ignored (`/usr/bin/npm run:*`); the safety check decides those
- Changed `/sandbox` and most `/config` value lists to be unnumbered outside screen reader mode; use the arrow keys and Enter
- Changed Bash commands whose variables expand to very long text to be denied, with a message that says to use shorter values or a file
- Changed the PowerShell tool to ask before one more command, even under a rule naming it; if nothing answers, it's refused unless a whole-tool rule, auto mode or bypass permissions mode allows it
- Changed a subagent resumed by a sibling's message to follow the session's permission settings; it may now ask, or be refused where nobody can answer
- Changed `--worktree` with a relative `--add-dir` beside the launch folder to give the Bash sandbox that folder, not one beside the worktree
- Changed some `--worktree` starts with a relative `--add-dir` above the launch folder, such as `..`, to give the Bash sandbox, and a `--bg` session, only the worktree
- Changed Claude in Chrome to refuse uploading some credential files; attach those to the page yourself
- Changed artifact approval in organizations that require it for each new artifact: an artifact that only a plugin created or allowed can be refused
- Changed sessions with nobody to ask to refuse a new artifact at once, with no permission prompt, in organizations that require approval of each one
- Changed the Artifact tool to refuse calls once settings turn Artifacts off, in sessions already running too
- Changed the Artifact publish prompt to stop offering "don't ask again" in subagents and after a background task result, someone else's message or a compaction
- Changed `claude plugin eval` to keep its deny rules over a plugin's permission hook, and to flag calls the hook let through
- Changed MCP server logs to record the mode, action, and field names of elicitation requests and hook answers, not their full contents
- Changed most prompts to ignore answers other than Esc for a moment after resuming with `fg`
- Changed Code Mode to no longer refuse to start when an installed mod hooks tool calls; an admi