# Claude Code v2.1.247

- Product: Claude Code (https://whatsnew.fyi/product/claude-code)
- Vendor: Anthropic
- Date: 2026-08-26
- Version: v2.1.247
- Original notes: https://github.com/anthropics/claude-code/releases/tag/v2.1.247
- Permalink: https://whatsnew.fyi/product/claude-code/releases/v2.1.247

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

---

- **added** — Added the SendFeedback tool to draft feedback reports for sessions with errors, accessible via /feedback and controllable with the feedbackDrafts setting
- **added** — Added id, text, cooldownSessions, and priority entries, tipsFile, and label to spinnerTipsOverride for organizations to rotate custom tips alongside built-in ones
- **added** — Added a tip on Bash permission prompts pointing to auto mode with a one-keystroke option to enable auto mode
- **added** — Added /claude-api cost-optimize command to profile Claude API spend and work through cost optimization levers including caching, token hygiene, batch processing, effort, and model choice
- **changed** — Updated the /claude-api skill with Admin API coverage for organization members, invites, workspaces, API keys, rate limit reports, workload identity federation, and CMEK
- **fixed** — Fixed fast arrow-key and Enter sequences acting on the wrong row in history search, /config, /mcp, /skills, background tasks, and /model
- **fixed** — Fixed sub-agents using the session's fallback model chain on first-call model 404 errors and returning error type, status, request ID, and model to the parent
- **fixed** — Fixed hooks or background agents printing megabytes of error output from overflowing the conversation and wedging the session
- **fixed** — Fixed Ctrl keyboard shortcuts not firing under non-Latin keyboard layouts in kitty-protocol terminals
- **fixed** — Fixed text like <35;150;7M being inserted into the prompt when a mouse report arrived split across reads after the escape prefix
- **fixed** — Fixed the Bash sandbox's cleanup deleting dotfile-managed ~/.claude/settings.json symlinks when repointed outside the writable area
- **fixed** — Fixed /terminal-setup overwriting the entire Zed keymap.json instead of merging in its keybinding
- **fixed** — Fixed /rename silently confirming when the session registry could not be updated
- **fixed** — Fixed /compact and Summarize from here summarizing under the default system prompt instead of the conversation's own in sessions started with --agent
- **fixed** — Fixed background sessions showing opening forever in claude agents after the terminal host process died
- **fixed** — Fixed unbounded memory growth when a hook's or background task's output file could not be written
- **fixed** — Fixed /install-github-app over SSH to show how the sign-in URL was copied and display the URL immediately when no browser can open
- **fixed** — Fixed shell commands from foreground logging internal errors or misleading exit code messages when finishing in background sessions
- **fixed** — Fixed version-less marketplace plugins' live cache directory being deleted and recreated on second-scope install
- **fixed** — Fixed Remote Control sessions not reporting the working-tree diff to connected clients

##### What's changed

- Added the `SendFeedback` tool: when something goes wrong in a session, Claude can draft a feedback report for you to review and send from `/feedback` (turn off with the `feedbackDrafts` setting)
- Added `{id, text, cooldownSessions, priority}` entries, `tipsFile`, and `label` to `spinnerTipsOverride`, so organizations can rotate their own tips alongside the built-in ones
- Added a tip on Bash permission prompts pointing to auto mode, with a one-keystroke "Yes, and switch to auto mode" option
- Added `/claude-api cost-optimize` to profile an existing project's Claude API spend and work through cost levers (caching, token hygiene, batch, effort, model choice) one measured change at a time
- Updated the `/claude-api` skill with Admin API coverage (organization members, invites, workspaces, API keys, rate limit reports, workload identity federation, CMEK)
- Fixed fast arrow-key + Enter sequences acting on the row above the one you navigated to in history search, `/config`, `/mcp`, `/skills`, background tasks, and `/model`
- Fixed sub-agents dying on a first-call model 404: they now use the session's fallback model chain, and the error returned to the parent includes the error type, status, request id, and model
- Fixed a hook or background agent that printed megabytes of error output being able to overflow the conversation and wedge the session on "Prompt is too long"
- Fixed Ctrl keyboard shortcuts not firing under non-Latin (e.g. Cyrillic) keyboard layouts in kitty-protocol terminals
- Fixed text like `<35;150;7M` being inserted into the prompt when a mouse report arrived split across reads right after the escape prefix
- Fixed the Bash sandbox's after-command cleanup deleting a dotfile-managed `~/.claude/settings.json` symlink (nix/home-manager, stow) when it is repointed outside the sandbox's writable area
- Fixed `/terminal-setup` overwriting your entire Zed `keymap.json` instead of merging in its keybinding
- Fixed `/rename` silently confirming when the session registry could not be updated; it now says other sessions may still show the old name
- Fixed `/compact` and "Summarize from here" in sessions started with `--agent` summarizing under the default system prompt instead of the conversation's own
- Fixed a background session showing "opening…" forever in `claude agents` after its terminal host process died; the row now fails within seconds with the reason, and Enter restarts it
- Fixed unbounded memory growth when a hook's or background task's output file could not be written; the file now notes where output was lost
- Fixed `/install-github-app` over SSH: the copy shortcut now says how the sign-in URL was copied instead of always claiming success, and the URL appears immediately when no browser can open
- Fixed shell commands carried over from the foreground logging an internal error or showing a misleading `[exited with code -1]` line when they finish in background sessions
- Fixed a version-less marketplace plugin's live cache directory being deleted and recreated on a second-scope install, which could disrupt a running session using it
- Fixed Remote Control sessions started with `/remote-control` not reporting the working-tree diff to connected clients
- Fixed self-hosted runner sessions reporting `running` before Claude Code had started, which could trigger a premature "Claude is waiting for your input" notification from the Claude desktop app
- Fixed first-run setup exiting with "Unable to connect to Anthropic services" when managed settings configure Claude apps gateway sign-in and Anthropic endpoints are unreachable
- Fixed cloud sessions (Claude Code on the web, desktop and mobile apps) sometimes showing the previous permission mode when you switch modes right after sending a message
- Fixed cloud sessions going silent when the session's container restarts between turns while a background agent, shell, or monitor is still running — the resumed session now reports the lost work
- Improved

_[Truncated at 4000 characters — full notes: https://github.com/anthropics/claude-code/releases/tag/v2.1.247]_